Conector do Microsoft Teams

::: (info) () Para fazer o download do aplicativo, visite: Biblioteca::::

Conector do Microsoft Teams

Integração da Tulip com o Microsoft Teams

Introdução

A API do Microsoft Teams permite que os usuários criem, leiam e editem equipes e canais da Microsoft no Teams com o acesso correto definido para suas contas da Microsoft. O objetivo desse conector é integrar a Tulip com a Microsoft usando a API Graph da Microsoft (v1.0) usando conectores HTTP e fornecer aos nossos clientes um conector pronto para uso que pode ser importado para sua instância.

Objetivo

Vamos destacar diferentes funções de conector que podem ser criadas por meio de chamadas HTTP para a API Graph da Microsoft (v1.0) para interagir com o M365 Teams e mostrar várias ações de leitura e gravação nas equipes que podem ser aproveitadas para vários casos de uso.

Documento da API

Documentação da API do Microsoft Graph

Pré-requisitos

1. Criar uma conta no Microsoft 365 e configurar as credenciais do OAuth 2.0 no Microsoft Entra ID.
2. Registre a API com os escopos necessários no portal da Microsoft. Azure - Entra ID

Vídeo de configuração do conector para o Excel:

Você pode seguir as mesmas etapas para configurar o conector de equipes também.

Detalhes da conexão Tulip

As informações a seguir precisariam ser configuradas no Tulip's

Conectores.

1. Em execução: host do conector de nuvem
2. Host: graph.microsoft.com
3. Porta:443
4. TLS: Sim

OAuth 2: A autenticação será levada adiante para todas as

as funções do conector

**Importante observar:**1. É uma conexão da Tulip com a Microsoft por https. 2. O acesso é controlado pela autenticação no lado da Microsoft. Dependendo da conta do Teams usada para autenticar, o usuário terá o mesmo acesso. Nas funções do conector, você pode configurar ainda mais as permissões e os níveis de acesso.

Funções do conector

1) Obter todos os Teams

Objetivo

Esse conector buscará todas as equipes das quais um usuário faz parte usando sua conta do Microsoft Teams.

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade - https://graph.micrsoft.com:443/v1.0/me/joinedTeams

Entrada necessária

Não são necessárias entradas

Extrator de saída obrigatório

1. teamID: identificador exclusivo da equipe que será usada para executar as outras tarefas.
2. teamName: O nome de exibição da equipe.
3. teamDescription (descrição da equipe): A descrição da equipe.

2) Obter todos os canais de uma equipe

Objetivo

Esse conector buscará todos os canais de uma equipe passando o teamID como entrada.

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Entrada obrigatória

A seguir estão os parâmetros de URL que devem ser passados

1. ID da equipe

Extrator de saída obrigatório

1. channelId: Identificador exclusivo do canal que será usado para executar as outras tarefas.
2. channelName: O nome de exibição do canal.
3. channelDescription: A descrição do canal.

3) Criar um novo canal

Objetivo

1. Os usuários podem passar o ID da equipe, o nome do canal e a descrição do canal como entrada e a Tulip criará um novo canal com o nome do canal fornecido. A resposta da API será os metadados e várias propriedades do canal. Isso pode ser usado posteriormente para buscar e atualizar dados do canal.
2. As informações extraídas da API do Microsoft Graph V1.0 podem ser usadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip que seriam canalizadas para outras funções do conector.

Ponto de extremidade

Chamada HTTP POST para o ponto de extremidade - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Entrada obrigatória

A seguir estão os parâmetros que são enviados como corpo da solicitação

1. ID da equipe
2. Nome do canal
3. Descrição do canal

Extrator de saída obrigatório

1. channelId: Identificador exclusivo do canal que será usado para executar as outras tarefas.
2. channelName:O nome de exibição do canal.
3. channelDescription:A descrição do canal.

4) Atualizar propriedades do canal

Objetivo

1. Os usuários podem passar o ID da equipe, o ID do canal, o nome do novo canal e a descrição do novo canal como entrada e a Tulip atualizará um novo canal com o novo nome e a nova descrição fornecidos. A resposta da API será os metadados e várias propriedades do canal. Isso pode ser usado posteriormente para buscar e atualizar dados do canal.
2. As informações extraídas da API do Microsoft Graph V1.0 podem ser usadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip que seriam canalizadas para outras funções do conector.

Ponto final

Chamada HTTP PATCH para o endpoint https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

Entrada obrigatória

A seguir estão os parâmetros que são enviados como parte do URL e/ou do corpo da solicitação

1. ID da equipe
2. ID do canal
3. Nome do canal
4. Descrição do canal

Extrator de saída obrigatório

Não exigimos nenhum extrator de saída.

5) Enviar uma mensagem para um canal

Objetivo

Os usuários podem passar o ID da equipe, o ID do canal, o assunto e o conteúdo da mensagem como entrada e a Tulip enviará uma mensagem com o conteúdo fornecido.

Ponto final

Chamada HTTP POST para o ponto de extremidade - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages

Entrada obrigatória

A seguir estão os parâmetros que são enviados como parte do URL e/ou do corpo da solicitação

1. ID da equipe
2. ID do canal
3. Assunto
4. Conteúdo da mensagem

Extrator de saída obrigatório

Não exigimos nenhum extrator de saída.

6) Obter todas as mensagens de um canal específico

Objetivo

Esse conector buscará todas as mensagens de um canal específico.

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}/messages

Entrada obrigatória

A seguir estão os parâmetros de URL que devem ser passados.

1. ID da equipe
2. ID do canal

Extrator de saída obrigatório

1. messageId: Identificador exclusivo da mensagem que será usada para executar as outras tarefas.
2. messageContent: O conteúdo da mensagem.
3. messageFrom: O nome de exibição do remetente.

7) Responder a uma mensagem

Objetivo

Os usuários podem passar um ID de equipe, ID de canal, assunto e conteúdo da mensagem como entrada para responder a uma mensagem e a Tulip enviará uma resposta com o conteúdo da mensagem fornecida.

Ponto final

Chamada HTTP POST para o ponto de extremidade - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages/{messageID}/replies

Entrada obrigatória

A seguir estão os parâmetros que são enviados como parte do URL e/ou do corpo da solicitação

1. ID da equipe
2. ID do canal
3. ID da mensagem
4. Conteúdo da mensagem

Extrator de saída obrigatório

Não exigimos nenhum extrator de saída.

8) Excluir um canal

Objetivo

Os usuários podem passar um ID de equipe e um ID de canal como entrada e o Tulip excluirá o canal específico com as entradas fornecidas.

Ponto final

Chamada HTTP DELETE para o ponto final -https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

Entrada obrigatória

A seguir estão os parâmetros de URL que devem ser passados

1. ID da equipe
2. ID do canal

Extrator de saída obrigatório

Não exigimos nenhum extrator de saída.

9) Obter a lista de membros de uma equipe

Objetivo

Esse conector buscará todos os membros de uma equipe específica.

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade https://graph.microsoft.com:443/v1.0/teams/{teamID}/members

Entrada obrigatória

A seguir estão os parâmetros de URL que devem ser passados.

1. ID da equipe

Extração de saída obrigatória

1. Id do membro: Identificador exclusivo do membro.
2. Nome do membro: O nome de exibição do membro.
3. Member EmailID: O ID de e-mail do membro.
4. Função do membro: A função de um membro no Canal da Equipe.

Leitura adicional

Confira mais informações sobre os conectores da Microsoft

• Conector do Microsoft Calendar
• Conector do Microsoft Outlook
• Conector do Microsoft Excel