Ir para o conteúdo

Conexão do Microsoft Teams

Introdução

Uma conexão do Microsoft Teams, criada usando o conector do Microsoft Teams, estabelece acesso ao Microsoft Teams. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Microsoft Teams associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Criar ou editar uma conexão do Microsoft Teams

Uma nova conexão do Microsoft Teams é criada usando o conector do Microsoft Teams a partir de uma destas localizações:

Uma conexão existente do Microsoft Teams pode ser editada a partir destas localizações:

Configurar uma conexão do Microsoft Teams

Cada elemento da interface do usuário da tela de configuração da conexão do Microsoft Teams é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis do Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão do Microsoft Teams e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint do Microsoft Teams, que se refere tanto a uma conexão específica quanto às suas atividades.

  • ID do locatário: Insira o ID do locatário. O ID do locatário pode ser obtido ao fazer login no Microsoft Entra ID.

  • ID do cliente: Insira o ID do cliente. Tanto o ID do cliente quanto o valor do segredo do cliente são atribuídos quando seu aplicativo é registrado seguindo as instruções em Pré-requisitos do Microsoft Teams.

  • Segredo do cliente: Insira o valor do segredo do cliente. Tanto o ID do cliente quanto o valor do segredo do cliente são atribuídos quando seu aplicativo é registrado seguindo as instruções em Pré-requisitos do Microsoft Teams.

  • Nome de usuário: Insira o nome de usuário que você usa para fazer login no Microsoft Entra ID.

  • Senha: Insira a senha que você usa para fazer login no Microsoft Entra ID.

  • Configurações opcionais: Clique para expandir essas configurações opcionais:

    • Escopo: Insira as permissões da API do Microsoft Teams habilitadas para o registro do seu aplicativo. Por padrão, este campo contém todas as 31 permissões da API necessárias para usar todas as atividades, conforme descrito em Pré-requisitos.

      Dica

      Se você não estiver inserindo todas as 31 permissões da API, pode inserir .default neste campo. O escopo .default inclui todas as permissões da API concedidas ao registro do seu aplicativo, que podem incluir permissões adicionais não exigidas pelo conector do Microsoft Teams.

    • Usar configurações de proxy (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar as configurações de proxy do agente privado.

  • Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a Desativar Atualização Automática do Conector política de organização.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Possível erro de conexão

Você pode receber o erro O usuário ou administrador não consentiu em usar o aplicativo se quaisquer permissões da API do Microsoft Graph não tiverem recebido consentimento do administrador.

Para resolver, conceda consentimento do administrador para qualquer permissão de API que exija, conforme documentado em Permissões da API do Microsoft Graph em Pré-requisitos.

Próximos passos

Após uma conexão do Microsoft Teams ter sido criada, você coloca um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis a partir do painel do projeto e da paleta de componentes de design. Para detalhes, veja Menus de ações em Noções básicas sobre conectores.

Estes tipos de atividade estão disponíveis:

  • Listar Canais: Recupera uma lista de canais para uma equipe no Microsoft Teams e é destinado a ser usado como um alvo em uma operação.

  • Adicionar Membros: Adiciona membros a um canal em uma equipe no Microsoft Teams e é destinado a ser usado como um alvo em uma operação.

  • Adicionar Canais: Cria canais (com a opção de adicionar membros) em uma equipe no Microsoft Teams e é destinado a ser usado como um alvo em uma operação.

  • Chat: Recupera um chat existente ou cria um novo chat no Microsoft Teams e é destinado a ser usado como um alvo em uma operação.

  • Enviar Mensagem: Envia uma mensagem para uma equipe e canal específicos no Microsoft Teams e é destinado a ser usado como um alvo em uma operação.