# Integração com Slack

> Conecte a Latchkey a um canal do Slack com OAuth, escolha o que é publicado e teste a conexão.

Source: https://latchkey.dev/pt/documentation/slack-integration

## Summary

- 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

1. **Abra Settings, Notifications** O cartão Slack Integration fica ao lado das preferências de notificação. Ele é gerenciável por owners e admins.
2. **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.
3. **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.
4. **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.

> ****
> Para trocar o canal de destino, use **Reconnect** e escolha um canal diferente durante a autorização do Slack. **Remove** desconecta a integração inteiramente; o histórico de notificações no dashboard não é afetado.

## 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 | Use **Reconnect** 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](/documentation/notifications).

### 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?

Apenas os tipos de evento que você seleciona na matriz de notificações. 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.

---

Latchkey runs CI/CD that repairs its own failures. Agent entry points: https://latchkey.dev/agent.txt, https://latchkey.dev/openapi.json, https://latchkey.dev/llms.txt