Comunicação
Microsoft Teams no seu produto e nos seus agentes de IA, por uma API
O toolkit do Microsoft Teams cobre equipes, canais (listar, criar), mensagens de canal e respostas (ler, publicar, responder) e chats (listar chats, membros e mensagens, enviar mensagem), como o usuário conectado. O cliente conecta uma conta corporativa ou escolar por OAuth no seu próprio app, e o Connect renova os tokens e registra cada execução.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/microsoft_teams_create_channel/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"team_id": "<team_id>",
"displayName": "<displayName>"
}
}Como funciona
Do cliente conectado à primeira chamada no Microsoft Teams.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Microsoft Teams. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Microsoft Teams.
Avisar um canal pelo seu produto
Liste as equipes e os canais do usuário, escolha um e publique uma mensagem com Send channel message quando algo precisar da atenção do time.
Responder dentro de uma conversa
Leia as mensagens raiz de um canal e suas respostas, e responda na mesma conversa com Reply to channel message, por um bot ou um agente de IA.
Assistente de chat para uma pessoa
Liste os chats do usuário, leia as mensagens recentes com List chat messages e envie uma mensagem em um chat existente depois que o usuário aprovar o texto.
Tools
12 tools do Microsoft Teams
- Listar equipesGETLista as equipes de que o usuário é membro direto, com id, displayName, description e isArchived. Use o id como team_id nas outras tools.
- Listar canaisGETLista os canais de uma equipe que o usuário pode ver, com id, displayName, description, membershipType e webUrl. Canais privados e compartilhados aparecem apenas para seus membros. Use o id como channel_id nas tools de mensagem.
- Criar canalPOSTCria um canal padrão, aberto a todos os membros da equipe, e o retorna com seu id. Canais privados e compartilhados precisam de uma lista de membros e não são suportados aqui.
- Listar mensagens do canalGETLista as mensagens raiz de um canal, sem as respostas, 20 por página e ordenadas pela atividade mais recente de cada conversa. Só a primeira página volta: o @odata.nextLink da resposta não pode ser seguido aqui. Leia uma conversa com List channel message replies.
- Ler mensagem do canalGETRetorna uma mensagem raiz de um canal, com seu corpo, o remetente em from, createdDateTime e webUrl. As respostas não estão incluídas.
- Listar respostas da mensagem do canalGETLista as respostas a uma mensagem raiz de um canal. A mensagem raiz não está incluída: leia-a com Get channel message. Só a primeira página volta.
- Enviar mensagem no canalPOSTPublica uma nova mensagem em um canal como o usuário e a retorna com seu id. Os termos da Microsoft proíbem usar o Teams como log, então envie apenas mensagens que pessoas vão ler.
- Responder mensagem do canalPOSTPublica uma resposta na conversa de uma mensagem raiz de um canal, como o usuário, e a retorna com seu id. Envie apenas mensagens que pessoas vão ler.
- Listar chatsGETLista os chats individuais, em grupo e de reunião do usuário, com id, topic, chatType e webUrl. Chats individuais não têm topic: use List chat members para ver quem está em um chat. Só a primeira página volta.
- Listar membros do chatGETLista as pessoas de um chat, com displayName, email e userId.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/microsoft_teams, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.
Perguntas sobre o toolkit do Microsoft Teams
Preciso implementar a API do Microsoft Teams?
Não. O Connect já traz 12 tools do Microsoft Teams descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Microsoft Teams?
Pelo modo que o toolkit aceita: OAuth com o app do seu produto. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
