Conexão com o Microsoft Teams

Introdução

Uma conexão do Microsoft Teams, criada usando o conector do Microsoft Teams, estabelece acesso ao Microsoft Teams. Depois que uma conexão é configurada, você pode criar instâncias de atividades do Microsoft Teams associadas a essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (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 de um destes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A página Global Endpoints (consulte Criar um endpoint global em Endpoints globais).

Uma conexão existente do Microsoft Teams pode ser editada nestes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
• A página Endpoints globais (consulte Editar um endpoint global em Endpoints globais).

Configurar uma conexão do Microsoft Teams

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

• 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 a uma conexão específica e suas atividades.

• ID do locatário: Insira o ID do locatário. O ID do locatário pode ser obtido acessando Microsoft Entra ID.

• ID do cliente: Insira o ID do cliente. Tanto o ID do cliente quanto o valor secreto 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: Digite o nome de usuário que você usa para fazer login no Microsoft Entra ID.

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

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

  • Escopo: Insira as permissões da API do Microsoft Teams habilitado para o registro do seu aplicativo. Por padrão, este campo contém todas as 31 permissões de 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 de API, você pode inserir .default neste campo. O .default O escopo inclui todas as permissões de API concedidas ao registro do seu aplicativo, o que pode incluir permissões adicionais não exigidas pelo conector do Microsoft Teams.

  • Usar configurações de proxy (somente Agente privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar 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 permite suspender o download da versão mais recente do conector usando a política da organização Desativar Atualização Automática do Conector.

• Salvar alterações: Clique para salvar e fechar a configuração de 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 solicitará que você confirme se 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 (consulte Dependências, exclusão e remoção de componentes). Uma mensagem solicitará que você confirme se deseja excluir a conexão.

Possível erro de 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.

Próximos passos

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

As ações de menu para uma conexão e seus tipos de atividade podem ser acessadas no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Estes tipos de atividades estão disponíveis:

• Listar Canais: Recupera uma lista de canais para uma equipe no Microsoft Teams e deve ser usada como um 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 um alvo em uma operação.

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