Conecte o Microsoft Teams: guia passo a passo
Publica o resumo da execução em um canal do Teams e, com NEXUS_TEAMS_NOTIFY=true, uma mensagem por teste com falha. Este guia leva você do zero a uma conexão verificada e lista os erros que podem ocorrer com suas causas e soluções.
Última atualização:
Mantenha suas credenciais em sigilo. Nunca cole um token, uma chave, uma senha ou uma URL de webhook em uma conversa. Insira esses dados apenas em Studio → Configurações → Integrações, onde são salvos no arquivo .env do seu espaço de trabalho e exibidos como pontos. O mesmo vale para um assistente de IA: ele pode orientar você neste guia, mas nunca precisa do seu token.
O que você precisa
- Um canal do Teams no qual você possa adicionar um fluxo de trabalho.
- Uma URL de webhook do Workflows para esse canal.
Obtenha as credenciais
- No Teams, abra o menu ··· do canal → Fluxos de trabalho e adicione "Postar em um canal quando uma solicitação de webhook for recebida".
- Copie a URL do webhook fornecida. Ela termina em logic.azure.com (conectores antigos: webhook.office.com). A própria URL é o segredo.
- Mantenha-o na área de transferência. Não o cole em nenhum lugar além do Studio (próxima etapa).
Conecte no Studio
- No Studio, abra Configurações → Integrações → Microsoft Teams.
- Cole a URL do webhook e pressione Salvar & enviar teste. Uma mensagem de teste é enviada ao canal.
- Ative
TEAMS_ENABLED. Para receber uma mensagem por teste com falha, ative tambémNEXUS_TEAMS_NOTIFY.
Verifique se funciona
- Enviar mensagem de teste retorna "Enviada." e a mensagem aparece no canal.
- Execute qualquer teste. O resumo da execução chega ao canal.
Erros comuns
| O que você vê | Causa | Solução |
|---|---|---|
| "Nenhum webhook" | TEAMS_WEBHOOK_URL está vazio. | Cole a URL do webhook em Configurações → Integrações e salve. |
"TEAMS_WEBHOOK_URL não é um webhook do Teams" | O valor não é uma URL https em logic.azure.com ou webhook.office.com. | Copie novamente a URL do gatilho "Postar em um canal quando uma solicitação de webhook for recebida" do fluxo de trabalho. |
| Uma resposta HTTP 4xx ou 5xx do Teams | O fluxo de trabalho foi desativado ou excluído, ou seu proprietário saiu ou perdeu a licença, então ele não é mais executado. | Abra o fluxo de trabalho no Teams (Fluxos de trabalho → gerenciar), ative-o ou crie um novo e salve a nova URL. |
| "não foi possível acessar o Teams (ENOTFOUND)" ou "não respondeu em 20 s" | Este PC não consegue acessar a Microsoft: uma VPN ou um proxy está impedindo o acesso, ou não há conexão de rede. | Verifique a rede no mesmo PC e tente novamente. |
| O teste funciona, mas as falhas não são publicadas | TEAMS_ENABLED está definido como false, ou apenas o resumo da execução está ativado: mensagens por teste exigem NEXUS_TEAMS_NOTIFY=true. | Ative as duas opções. |
Chaves de configuração
| Chave | O que faz | Valor válido | Como verificar |
|---|---|---|---|
TEAMS_ENABLED | Enviar alertas para o Microsoft Teams | true ou false | Ative depois que a mensagem de teste chegar. |
TEAMS_WEBHOOK_URL | Canal do Teams para alertas (secreto, salvo apenas neste computador) | Uma URL https://…logic.azure.com ou …webhook.office.com | Enviar mensagem de teste publica no canal. |
NEXUS_TEAMS_NOTIFY | Alerta do Teams por falha | true ou false | Uma mensagem por teste com falha é enviada, não apenas o resumo da execução. |
Mais: todas as integrações, o guia de Configurações, solução de problemas. Outros guias: Jira Cloud, Azure Boards, Slack, Telegram, GitHub Issues.
Ainda com dificuldades? Escreva para [email protected] com a linha exata do erro exibido pelo Studio. Não inclua nenhum token.