Conector do Microsoft Teams¶

Resumo¶

O Harmony Microsoft Teams Connector 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 Conexões 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 atividades 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).

Juntos, 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 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 chat existente ou cria um novo chat no Microsoft Teams e deve ser usado como alvo em uma operação.

• Enviar mensagem: Envia uma mensagem para uma equipe e canal específico no Microsoft Teams e se destina a ser usado 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 mais tarde. Essas versões do agente baixam automaticamente a versão mais recente do conector quando necessário.

O conector do Microsoft Teams usa a API REST do Microsoft Graph 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 exige que um aplicativo seja criado e registrado no Microsoft Azure Active Directory 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 dá suporte ao OAuth 2.0 usando o processo de registro do aplicativo Microsoft Azure Active Directory.

Problemas Conhecidos¶

O conector do Microsoft Teams tem este problema conhecido:

• O teste de uma consultar em uma atividade de Lista de Canais do Microsoft Teams falhará se o nome de uma equipe contiver espaços

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

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

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 da conexão para garantir que a conexão seja bem-sucedida e garantir que a versão mais recente do conector seja baixada para o agente (a menos que você use a Desativar atualização automática do conector política da organização).

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

3. Habilite o registro de depurar de operação (para Agentes em Nuvem ou para Agentes Privados) para gerar arquivos de log e dados adicionais.

4. Se estiver usando Agentes Privados, você pode ativar registro detalhado do conector para este conector usando esta entrada de configuração específica de nome e nível do criador de logs:

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

5. Se estiver usando Agentes Privados, você pode verificar os logs do agente Para maiores informações.