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

# Solução de problemas

> Diagnóstico dos problemas mais comuns, do alerta que não chega ao acionamento que não fecha.

Comece identificando **em que ponto do fluxo** as coisas param. Isso reduz o diagnóstico a uma página específica.

```mermaid theme={null}
flowchart TD
  A["A ferramenta enviou o alerta?"] -->|não| A1["Alerta não chegou"]
  A -->|"sim, mas deu erro"| A2["Erro no webhook"]
  A -->|"sim, 202"| B["O acionamento foi criado?"]
  B -->|não| B1["Alerta sem acionamento"]
  B -->|sim| C["Alguém foi notificado?"]
  C -->|"não há responsável"| C1["Nenhum plantonista"]
  C -->|"há responsável, sem notificação"| C2["Notificação não recebida"]
  C -->|sim| D["O acionamento fechou sozinho?"]
  D -->|não| D1["Sem auto-resolução"]
```

## Por sintoma

<Columns cols={2}>
  <Card title="O alerta não chegou ao aciona.me" icon="unplug" href="/pt-br/solucao-de-problemas/alerta-nao-chegou" horizontal>
    Nenhum registro da ferramenta aparece no painel.
  </Card>

  <Card title="O webhook retornou erro" icon="circle-x" href="/pt-br/solucao-de-problemas/erro-no-webhook" horizontal>
    401, 403, 404, 400, 413 — cada código tem uma causa específica.
  </Card>

  <Card title="Alerta chegou, sem acionamento" icon="ghost" href="/pt-br/solucao-de-problemas/alerta-sem-acionamento" horizontal>
    Respondeu 202 mas nada apareceu em Acionamentos.
  </Card>

  <Card title="Ninguém recebeu notificação" icon="bell-off" href="/pt-br/solucao-de-problemas/notificacao-nao-recebida" horizontal>
    O acionamento existe, mas o celular não tocou.
  </Card>

  <Card title="Nenhum plantonista encontrado" icon="user-x" href="/pt-br/solucao-de-problemas/sem-plantonista" horizontal>
    Acionamento criado sem responsável.
  </Card>

  <Card title="Não resolveu automaticamente" icon="triangle-alert" href="/pt-br/solucao-de-problemas/sem-auto-resolucao" horizontal>
    O problema passou, mas o acionamento continua aberto.
  </Card>
</Columns>

## Primeiras verificações

Antes de mergulhar em qualquer página, confirme estes quatro pontos — eles resolvem a maioria dos casos:

<Steps>
  <Step title="A fonte de alerta está ativa">
    Fontes inativas recusam alertas com `403`.
  </Step>

  <Step title="O token está correto">
    Se o token foi rotacionado, a ferramenta externa precisa ser atualizada.
  </Step>

  <Step title="O serviço existe e tem time responsável">
    Serviços auto-registrados começam sem time.
  </Step>

  <Step title="O time tem escala ativa com participantes válidos">
    Sem isso, não há plantonista para acionar.
  </Step>
</Steps>
