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

# Como o aciona.me funciona

> O caminho completo de um alerta: ingestão, roteamento, acionamento, notificação, escalonamento e resolução.

O aciona.me tem um único fluxo central. Entender esse fluxo é suficiente para configurar o produto inteiro e para diagnosticar quase todo problema operacional.

## O fluxo em uma linha

**Alerta recebido → serviço identificado → time responsável → plantonista do momento → acionamento criado → pessoa notificada → reconhecimento → escalonamento (se ninguém responder) → resolução.**

```mermaid theme={null}
flowchart LR
  A["Ferramenta de monitoramento"] -->|"webhook + token"| B["Fonte de alerta"]
  B --> C["Alerta normalizado"]
  C --> D["Serviço afetado"]
  D --> E["Time responsável"]
  E --> F["Plantonista atual"]
  F --> G["Acionamento"]
  G --> H["Notificações"]
  H --> I["ACK / assumir"]
  I --> J["Resolução"]
  G -.->|"sem ACK no prazo"| K["Escalonamento"]
  K --> H
```

## 1. Ingestão

Cada ferramenta de monitoramento aponta para uma **fonte de alerta** própria dentro do aciona.me. Cada fonte tem uma URL e um token exclusivos:

```bash theme={null}
POST https://ingress.aciona.me/webhooks/<idDaFonte>
X-Aciona-Token: <tokenDaFonte>
```

A fonte determina a organização dona do alerta e como o payload será interpretado — o aciona.me nunca confia em identificadores de organização vindos do corpo da requisição.

O aciona.me responde `202 Accepted` assim que persiste o alerta. O processamento acontece logo em seguida, de forma assíncrona, para que sua ferramenta de monitoramento nunca fique esperando.

<Info>
  O payload original é sempre armazenado junto do alerta, para auditoria e diagnóstico. Veja [Retenção e limites](/pt-br/referencia/planos-e-limites).
</Info>

## 2. Normalização

Cada tipo de fonte tem um tradutor próprio que transforma o payload da ferramenta em um formato interno comum, com os campos:

| Campo         | Significado                                        |
| ------------- | -------------------------------------------------- |
| `title`       | Título legível do alerta                           |
| `description` | Detalhe ou razão do disparo                        |
| `severity`    | `critical`, `high`, `warning` ou `info`            |
| `state`       | `firing` (abrindo) ou `resolved` (fechando)        |
| `externalId`  | Identificador estável do ciclo do alerta na origem |
| `serviceHint` | Pista de qual serviço foi afetado                  |
| `labels`      | Rótulos adicionais da origem                       |
| `externalUrl` | Link de volta para a ferramenta de origem          |

Severidades livres (`P1`, `sev2`, `error`, `warn`…) são convertidas para o conjunto fechado do aciona.me. Veja [Severidades](/pt-br/referencia/severidades).

## 3. Roteamento

Com o alerta normalizado, o aciona.me responde três perguntas, nesta ordem:

<Steps>
  <Step title="Qual serviço foi afetado?">
    Pelo serviço padrão configurado na fonte de alerta ou pela pista de serviço (`serviceHint` / label `service`) enviada pela ferramenta. Se a pista apontar para um serviço que ainda não existe, ele pode ser registrado automaticamente.
  </Step>

  <Step title="Qual time responde por esse serviço?">
    Cada serviço tem um time responsável. É esse vínculo que transforma um alerta técnico em uma responsabilidade humana.
  </Step>

  <Step title="Quem está de plantão nesse time agora?">
    A escala ativa do time define o plantonista do momento, respeitando fuso horário, rotação e substituições vigentes.
  </Step>
</Steps>

## 4. Acionamento

Se não existir acionamento aberto correspondente, um novo é criado com status `triggered`, associado à organização, ao serviço, ao time e ao plantonista.

Se **já existir** um acionamento aberto para a mesma origem, o alerta é agregado a ele em vez de criar um duplicado. Veja [Agrupamento e auto-resolução](/pt-br/acionamentos/agrupamento-e-auto-resolucao).

## 5. Notificação

O acionamento gera notificações pelos canais configurados: e-mail, push (navegador e celular), Slack e Microsoft Teams. Quando pelo menos um canal entrega, o acionamento passa para `notified`.

## 6. Reconhecimento e escalonamento

A partir daí, o relógio corre. Se ninguém reconhecer o acionamento dentro do prazo, ele é escalado automaticamente para o próximo alvo — o próximo participante da escala ou o próximo nível da política. Se a escalada se esgotar sem resposta, os owners da organização são avisados.

Reconhecer (ACK), assumir ou resolver o acionamento interrompe o escalonamento.

## 7. Resolução

O acionamento pode ser resolvido por uma pessoa no painel ou **automaticamente**, quando a ferramenta de origem envia o evento de recuperação. Depois de resolvido, ele pode ser encerrado.

<Card title="Ver o ciclo de vida completo" icon="siren" href="/pt-br/acionamentos/ciclo-de-vida" horizontal>
  Todos os status, quem pode mudar cada um e o que aparece na linha do tempo.
</Card>