Conector do Microsoft Teams para Jitterbit Integration Studio

Resumo

O conector do Microsoft Teams estabelece acesso ao Microsoft Teams.

O conector do Microsoft Teams fornece uma interface para criar uma conexão do Microsoft Teams, a base usada para gerar instâncias de atividades do Microsoft Teams. Essas atividades, uma vez configuradas, interagem com o Microsoft Teams por meio da conexão.

O conector do Microsoft Teams é acessado na aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão do Microsoft Teams. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades que devem ser usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Juntas, uma conexão específica do Microsoft Teams e suas atividades são chamadas de endpoint do Microsoft Teams:

• Listar Canais: Recupera uma lista de canais para uma equipe no Microsoft Teams e deve ser usada como alvo em uma operação.

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

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

• Bater papo: Recupera um bate-papo existente ou cria um novo bate-papo no Microsoft Teams e deve ser usado como alvo em uma operação.

• Enviar mensagem: Envia uma mensagem para uma equipe e um canal específicos no Microsoft Teams e deve ser usada como alvo em uma operação.

Pré-requisitos e versões de API suportadas

O conector do Microsoft Teams requer o uso de uma versão do agente 10.1 ou posterior. Essas versões de agente baixam automaticamente a versão mais recente do conector quando necessário.

O conector do Microsoft Teams usa a Microsoft Graph REST API v1.0. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

O conector do Microsoft Teams requer que um aplicativo seja criado e registrado com Microsoft Entra ID com um conjunto específico de permissões. Crie e configure este aplicativo conforme descrito em Pré-requisitos do Microsoft Teams antes de configurar o conector.

O conector do Microsoft Teams oferece suporte ao OAuth 2.0 usando o processo de registro do aplicativo Microsoft Entra ID.

Problemas conhecidos

O conector do Microsoft Teams tem este problema conhecido:

• O teste de uma consultar em uma atividade de canais de lista do Microsoft Teams falha se o nome de uma equipe contiver espaços

  • Resumo: Testar uma consultar na etapa 2 de uma atividade Listar canais do Microsoft Teams falha com um erro Consulta inválida se o nome da equipe do Microsoft Teams contiver espaços.

  • Informações adicionais: O problema é limitado ao teste da consultar. A configuração da atividade ainda pode ser concluída. No tempo de execução, a operação retornará os detalhes do canal esperados.

Solução de problemas

Se você tiver problemas com o conector do Microsoft Teams, estas etapas de solução de problemas são recomendadas:

1. Clique no botão Testar na configuração de conexão para garantir que a conexão seja bem-sucedida e que a versão mais recente do conector seja baixada para o agente (a menos que você esteja usando a política da organização Desativar atualização automática do conector).

2. Certifique-se de que todos os registros de aplicativo do Microsoft Entra ID associados à conexão não estejam usando o Azure AD Graph obsoleto.

3. Verifique os registros de operação para qualquer informação escrita durante a execução da operação.

4. Habilite o registro de depurar da operação (para agentes de nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

5. Se estiver usando agentes privados, você pode habilitar conector verbose logging para este conector usando esta entrada de configuração específica de nome e nível do registrador:

   <logger name="org.jitterbit.connector.teams" level="DEBUG"/>
   

6. Se estiver usando agentes privados, você pode verificar os registros do agente para mais informações.

7. Para considerações adicionais sobre solução de problemas, consulte Solução de problemas de operação.

8. Conexão: Ao testar a conexão, você pode receber o erro The user or administrator has not consented to use the application se alguma permissão da API do Microsoft Graph não tiver recebido consentimento do administrador.

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