Conectar o Slack: guia passo a passo
Publica o resumo da execução em um canal e, com NEXUS_SLACK_NOTIFY=true, uma mensagem por teste com falha, instável, de caos ou de regressão visual. Uma mensagem sobre uma falha inclui o link do chamado no Jira, quando houver. Este guia acompanha você do zero até 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 espaço de trabalho do Slack onde você possa adicionar um aplicativo.
- Uma URL de webhook de entrada para o canal que deve receber as mensagens.
Obtenha as credenciais
- No Slack, crie um app com um webhook de entrada (https://api.slack.com/messaging/webhooks) e escolha o canal.
- Copie a URL do webhook. Ela começa com https://hooks.slack.com/services/. 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 → Slack.
- Cole a URL do webhook e pressione Salvar & enviar teste. Uma mensagem de teste é enviada ao canal.
- Ative
SLACK_ENABLED. Para receber uma mensagem por teste com falha, ative tambémNEXUS_SLACK_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" | SLACK_WEBHOOK_URL está vazio. | Cole a URL do webhook em Configurações → Integrações e salve. |
"SLACK_WEBHOOK_URL não é um webhook de entrada do Slack" | O valor não começa com https://hooks.slack.com/services/. | Copie novamente a URL do webhook na página de webhooks de entrada do seu app do Slack. |
| HTTP 404 "no_service" ou HTTP 403 "invalid_token" | O webhook foi revogado ou excluído, ou o app foi removido do espaço de trabalho. | Crie um novo webhook de entrada e salve a nova URL. |
| HTTP 404 "channel_not_found" ou HTTP 410 "channel_is_archived" | O canal no qual o webhook publica foi excluído ou arquivado. | Crie um novo webhook para um canal ativo. |
| "não foi possível acessar o Slack (ENOTFOUND)" ou "não respondeu em 20 s" | Este PC não consegue acessar o Slack: uma VPN ou um proxy está interferindo, 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 | SLACK_ENABLED está definido como false, ou apenas o resumo da execução está ativado: as mensagens por teste exigem NEXUS_SLACK_NOTIFY=true. | Ative as duas opções. |
Chaves de configuração
| Chave | O que faz | Valor válido | Como verificar |
|---|---|---|---|
SLACK_ENABLED | Enviar alertas para o Slack | true ou false | Ative depois que a mensagem de teste chegar. |
SLACK_WEBHOOK_URL | Canal do Slack para alertas (segredo, salvo apenas neste computador) | https://hooks.slack.com/services/… (nenhum outro valor é aceito) | Enviar mensagem de teste publica no canal. |
NEXUS_SLACK_NOTIFY | Alerta no Slack 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, Microsoft Teams, Telegram, GitHub Issues.
Ainda com dificuldades? Escreva para [email protected] com a linha exata do erro exibido pelo Studio. Não inclua nenhum token.