> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aciona.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Envie acionamentos para um canal do Slack com um Incoming Webhook.

A integração com Slack dá **visibilidade coletiva**: o time inteiro vê o acionamento, quem reconheceu e como ele evoluiu.

## Configurando

<Steps>
  <Step title="Crie um Incoming Webhook no Slack">
    No workspace do Slack, crie um app (ou use um existente), habilite **Incoming Webhooks** e gere uma URL de webhook para o canal que deve receber os acionamentos.
  </Step>

  <Step title="Adicione a integração no aciona.me">
    Em **Integrações**, adicione a integração de Slack e cole a URL do webhook. Owners e admins podem fazer isso.
  </Step>

  <Step title="Ajuste nome e ícone (opcional)">
    Nas configurações do Incoming Webhook no Slack, defina o nome como `aciona.me` e use o ícone oficial. Isso torna os cards imediatamente reconhecíveis no canal.
  </Step>

  <Step title="Envie um alerta de teste">
    Dispare um acionamento de teste e confirme que o card chega ao canal.
  </Step>
</Steps>

## O que chega no canal

Um card em português com:

* Severidade e título do acionamento.
* Serviço afetado e origem do alerta.
* Responsável atual, quando houver.
* Link **Abrir acionamento**, que leva ao painel autenticado.

O card acompanha o ciclo de vida: criação, reconhecimento, atribuição, escalonamento e resolução geram mensagens correspondentes.

<Note>
  As mensagens de Slack são enviadas **independentemente** de haver destinatários pessoais. Mesmo quando a escala não aponta ninguém, o canal recebe o acionamento — é uma rede de segurança importante.
</Note>

## Boas práticas

<AccordionGroup>
  <Accordion title="Use um canal dedicado" icon="hash">
    Um canal como `#acionamentos` mantém o histórico legível. Misturar com um canal de conversa faz o acionamento sumir no meio das mensagens.
  </Accordion>

  <Accordion title="Slack não substitui push" icon="triangle-alert">
    Notificação de canal não acorda ninguém de forma confiável. Slack é para visibilidade; push é para acionamento.
  </Accordion>

  <Accordion title="Trate a URL do webhook como segredo" icon="key-round">
    Quem tem a URL pode postar no canal. Se ela vazar, revogue no Slack e gere outra.
  </Accordion>
</AccordionGroup>

## Solução de problemas

| Sintoma              | O que verificar                                                                 |
| -------------------- | ------------------------------------------------------------------------------- |
| Nada chega no canal  | A integração está ativa no aciona.me e a URL do webhook é válida                |
| Chegava e parou      | O Incoming Webhook foi revogado ou o app foi removido do workspace              |
| Card no canal errado | Incoming Webhooks são fixos por canal — gere uma URL nova para o canal desejado |