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

# Discord

> Envie acionamentos para um canal do Discord com um webhook de canal.

A integração com Discord publica cada acionamento em um canal do seu servidor, com o contexto do alerta e botões que levam direto ao painel.

## Configurando

<Steps>
  <Step title="Crie um webhook no canal">
    No servidor do Discord, abra **Configurações do canal → Integrações → Webhooks → Novo webhook**, escolha o canal que deve receber os acionamentos e clique em **Copiar URL do webhook**. A URL tem o formato `https://discord.com/api/webhooks/<id>/<token>`.
  </Step>

  <Step title="Adicione a integração no aciona.me">
    Em **Integrações → Discord**, cole a URL em **Configuração da Organização**. Opcionalmente, dê um **nome de exibição** (ex.: `Canal #acionamentos-prod`) para reconhecer o destino depois. Owners e admins podem fazer isso.
  </Step>

  <Step title="Teste o envio">
    Clique em **Testar**. Uma mensagem de teste deve aparecer no canal em poucos segundos.
  </Step>
</Steps>

<Tip>
  Você não precisa ajustar nome nem avatar no Discord: as mensagens já chegam como **aciona.me**, com o ícone oficial.
</Tip>

## Um canal por time

A configuração da organização é o **padrão** para todos os times. Em **Overrides por Time**, você pode apontar um time específico para outro canal (ou desabilitá-lo). Times sem override continuam usando o webhook da organização.

Remover o override de um time faz com que ele volte a usar a configuração da organização, se existir.

## O que chega no canal

Um embed no idioma da organização, colorido pela severidade, com:

* Título e severidade do acionamento.
* Serviço afetado, fonte do alerta e responsável atual, quando houver.
* Horário do evento, exibido no fuso de quem está lendo.
* Botões **Abrir acionamento**, **Reconhecer** e **Atribuir para mim**, que abrem o painel autenticado.

A mensagem acompanha o ciclo de vida: criação, reconhecimento, atribuição, escalonamento e resolução geram mensagens correspondentes. Reconhecimento, atribuição e resolução chegam **sem som nem push** no Discord — só a abertura e o escalonamento chamam atenção.

<Note>
  Menções como `@everyone`, `@here` ou `@usuario` que vierem no texto do alerta **nunca notificam ninguém**. O conteúdo do alerta é exibido como texto literal.
</Note>

<Note>
  Assim como Slack e Teams, o Discord recebe o acionamento **independentemente** de haver destinatários pessoais. Mesmo que a escala não aponte ninguém, o canal vê o acionamento.
</Note>

## Boas práticas

<AccordionGroup>
  <Accordion title="Use um canal dedicado" icon="hash">
    Um canal como `#acionamentos` mantém o histórico legível e permite configurar as notificações do próprio Discord só para ele.
  </Accordion>

  <Accordion title="Discord não substitui push" icon="triangle-alert">
    Mensagem em canal é visibilidade, não acionamento. Quem está de plantão precisa de push no celular.
  </Accordion>

  <Accordion title="Trate a URL do webhook como segredo" icon="key-round">
    Quem tem a URL pode postar no canal. Se ela vazar, exclua o webhook no Discord, crie outro e atualize a integração no aciona.me.
  </Accordion>
</AccordionGroup>

## Solução de problemas

| Sintoma | O que verificar |
| - | - |
| A URL não é aceita | Use a URL copiada do Discord, começando com `https://discord.com/api/webhooks/`. Outros endereços são recusados. |
| O teste falha | O webhook pode ter sido excluído no Discord, ou o canal foi apagado. Gere uma URL nova. |
| Nada chega no canal | A integração (ou o override do time) está **Ativa** e o serviço pertence ao time esperado. |
| Chega no canal errado | Confira se o time tem um override apontando para outro webhook. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.