Menu da documentação
Painel e análises
Runners gerenciados
Equipe e notificações
Faturamento e planos
Arquivos de workflow
Integração com Slack
Conecte a Latchkey a um canal do Slack com OAuth, escolha o que é publicado e teste a conexão.
Resumo
- Owners/admins conectam via OAuth em Settings, Notifications: Add to Slack, escolha o canal durante a autorização, pronto. Nenhum webhook para colar.
- Test, Reconnect (para trocar o canal) e Remove gerenciam a conexão.
- Escolha quais tipos de evento são publicados no Slack na matriz de notificações.
A integração com Slack publica as notificações da Latchkey em um canal que sua equipe já acompanha. A configuração é um fluxo OAuth único feito por um owner ou admin do workspace.
Conectando#
Abra Settings, Notifications
O cartão Slack Integration fica ao lado das preferências de notificação. Ele é gerenciável por owners e admins.
Clique em Add to Slack
Você é enviado ao Slack para autorizar a Latchkey e escolher o canal durante a própria autorização; não há URLs de webhook para copiar e colar. O Slack retorna você à página de configurações quando terminar.
Confirme a conexão
O cartão agora mostra Connected com o nome do seu canal, além dos botões Test, Reconnect e Remove. Envie uma mensagem de teste para garantir que ela chegue.
Escolha o que é publicado no Slack
Na matriz de notificações, ative o canal Slack para os tipos de evento que sua equipe quer no canal (muitas equipes começam com o nível Critical mais os avisos de free-tier e trial). Os botões do Slack na matriz são apenas para admins; os membros mantêm suas escolhas pessoais de e-mail, push e resumo.
O que chega ao canal#
Conceitualmente, cada mensagem é construída da mesma forma: qual evento disparou e um link de volta ao dashboard onde o detalhe reside. O Slack recebe a manchete; o dashboard tem a história: a execução, os números, o relatório. Espere um convite para clicar e ir além, não um muro de dados no canal.
Por causa disso, a escolha do canal importa mais que a formatação. Escolha um canal que a equipe realmente acompanha: alertas publicados em um canal geral movimentado rolam para longe, enquanto um canal de alertas dedicado mantém o sinal de CI visível. O Slack segue a mesma matriz por tipo e os mesmos períodos de espera por tipo que todos os outros canais, então um pipeline barulhento não vai inundar o canal com duplicatas.
Solução de problemas#
| Sintoma | O que fazer |
|---|---|
| A mensagem de teste não chega | Confirme que o cartão mostra Connected com o canal que você espera, então envie outro teste. Se ainda falhar, use Reconnect para refazer a autorização. |
| As mensagens pararam de chegar | Se o cartão mostrar Not connected com o dia em que o Slack parou de aceitar mensagens, use Reconnect no cartão e escolha um canal atual. Se o cartão ainda mostrar Connected, use Reconnect no painel e escolha um canal atual durante a autorização do Slack; isso atualiza a conexão de ponta a ponta. |
| Um tipo de evento específico nunca é publicado | O Slack é ativado por tipo de evento: verifique se o canal Slack está ligado para aquele tipo na matriz de notificações. |
| Você não consegue ver o cartão do Slack | As configurações do Slack são apenas para owners e admins; os membros não gerenciam a integração. |
| Você quer a Latchkey fora do Slack por completo | Remove desconecta a integração; o histórico de notificações no dashboard não é afetado. |
Para a lista completa de tipos de evento e níveis que você pode rotear para o Slack, veja Notificações.
Como conecto o Slack ao Latchkey?
Owners e admins vão em Settings, Notifications e escolhem Add to Slack. Você escolhe o canal durante a etapa de autorização do próprio Slack, e essa é toda a configuração: não há URL de webhook para gerar ou colar.
Como mudo qual canal do Slack recebe as mensagens?
Use Reconnect, que repete o fluxo OAuth e permite escolher outro canal. O Test envia uma mensagem para você confirmar a conexão antes de depender dela, e o Remove desconecta o workspace.
Toda notificação vai para o Slack?
Os tipos de evento que você seleciona na matriz de notificações, mais "Managed runner blocked" e "Free tier running out", que são publicados por padrão assim que um workspace é conectado. O Slack é um canal entre e-mail e push do navegador, escolhido por evento, então dá para enviar eventos críticos a um canal sem publicar os informativos ali também.