Conector do Microsoft Teams

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

Conector do Microsoft 365

Para integração com aplicativos da Microsoft, como Teams, Outlook e Office Suite.

Objetivo

Use este documento para integrar seus aplicativos Tulip com produtos do Microsoft 365, como Teams, Office Suite e Outlook.

Pré-requisitos

Observação: as informações de autenticação Oauth2 devem ser geradas no Entra ID antes de usar esse conector. Siga este guia para gerar as credenciais necessárias.
Conecte a API do MS Graph ao Tulip com Oauth2::::

Documentação da API

Documentação da API do Microsoft Graph

Escopos necessários para este conector

Funções do conector

1) Obter todas as equipes

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 final

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 necessá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