MENU
    Conector do Microsoft Teams
    • 13 Jan 2025
    • 4 Minutos para Ler
    • Contribuintes

    Conector do Microsoft Teams


    Resumo do artigo

    To download the app, visit: Library

    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

    Note: Oauth2 authentication information must be generated in Entra ID before using this Connector. Follow this guide to generate the required credentials. Connect the MS Graph API to Tulip with Oauth2

    Documento 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 endpoint - 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


    Este artigo foi útil?