> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/alarm/escalation-and-response.md).

# Escalonamento e Resposta

Crie cadeias de escalonamento nos alarmes Kilo IoT — passos ordenados disparam ao longo do tempo até à resolução com aviso multicanal.

Os incidentes de produção que ficam por reconhecer tornam-se indisponibilidades de produção. As cadeias de escalonamento garantem que, quando o responsável principal não atua dentro da janela esperada, o alarme chega automaticamente e pelo canal apropriado ao nível seguinte — supervisor, gestor do local ou reserva de prevenção.

## Como funciona o escalonamento

Cada definição de alarme inclui uma **Cadeia de escalonamento** — uma sequência ordenada de passos de notificação que é executada em resposta a um evento de alarme não resolvido.

A primeira etapa é acionada **imediatamente** quando o alarme é acionado. Se o alarme continuar por resolver após um atraso configurável, a etapa seguinte é acionada, notificando destinatários adicionais através de canais adicionais. A cadeia continua por cada etapa configurada até o alarme ser resolvido ou até todas as etapas terem sido executadas.

**A resolução interrompe o escalonamento.** Quando um membro da equipa marca o alarme como resolvido na [Caixa de entrada](/kilo-docs-pt/kilo-iot-server/alarm/inbox-and-resolution.md), não são executadas mais etapas de escalonamento para esse evento. Este é o mecanismo pretendido para reconhecer e encerrar o ciclo de um alerta operacional.

## Configurar uma cadeia de escalonamento

A **Cadeia de escalonamento** secção aparece dentro de cada [definição de alarme](/kilo-docs-pt/kilo-iot-server/alarm/notification-rules.md). Está estruturada como uma lista ordenada de etapas.

### Primeira etapa (Imediata)

A primeira etapa está sempre presente e não pode ser removida. O seu atraso está fixado em **Imediato** — os destinatários desta etapa recebem notificação no momento em que o evento de alarme é criado.

Cada etapa é configurada com:

* **Notificar** — Um ou mais membros da organização selecionados no **Selecionar destinatários** menu pendente. Os destinatários são escolhidos da lista de utilizadores da organização atual. **Obrigatório** — pelo menos um destinatário deve ser selecionado antes de a definição poder ser guardada.
* **Via** — Canais de entrega. Email e SMS podem ser selecionados em cada etapa. As notificações push aparecem quando ativadas para a conta e chegam aos responsáveis através da [App IoT Alerts](/kilo-docs-pt/kilo-iot-server/alarm/iot-alerts-app.md) (ver [Canais de entrega](/kilo-docs-pt/kilo-iot-server/alarm/notification-channels.md)).

<figure><img src="https://585438662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-c5330f2fac2f974f23a6fe9745a1c9bb48c815e6%2Falarm-escalation-chain.jpg?alt=media" alt="The Escalation chain section of an alarm definition with an Immediate step, its Notify recipients dropdown and Via channel, and the Add step control"><figcaption></figcaption></figure>

### Etapas adicionais

Clica em **Adicionar etapa** para acrescentar um nível de escalonamento. Cada etapa adicional acrescenta:

* **Após** — Um atraso configurável antes de esta etapa ser acionada. O alarme deve permanecer por resolver para que a etapa seja executada. Se o alarme for resolvido antes de o atraso expirar, a etapa é ignorada.
* **Notificar** — Destinatários para este nível (normalmente um conjunto diferente dos níveis anteriores — um supervisor ou um substituto de prevenção).
* **Via** — Canais para este nível.

As etapas adicionais podem ser removidas com o botão de eliminação. Apenas a primeira etapa é permanente.

## Exemplo: escalonamento operacional

Um alarme de excedência de temperatura de armazenamento refrigerado é acionado às 3 da manhã:

1. **Etapa 1 (Imediata):** O técnico de refrigeração de prevenção recebe email e uma notificação push.
2. **Etapa 2 (após um atraso configurável):** Se não for resolvido, o supervisor do turno recebe SMS e email.
3. **Etapa 3 (após um atraso configurável):** Se continuar por resolver, o gestor de operações do local recebe SMS — indicando um possível evento de conformidade que requer a atenção da gestão.

Em qualquer momento, o técnico, supervisor ou gestor pode resolver o alarme na Caixa de entrada. A resolução interrompe imediatamente qualquer escalonamento adicional para esse evento.

## Conceber o escalonamento para ambientes de produção

**Alinhe as etapas com a sua hierarquia de resposta.** A primeira etapa deve chegar a quem é responsável pela triagem imediata. As etapas subsequentes devem seguir a política de escalonamento da sua organização — da prevenção ao supervisor e à gestão.

**Use canais distintos por nível.** Se o Nível 1 usa email, o Nível 2 deve incluir SMS. Isto reduz o risco de uma falha num único canal bloquear toda a cadeia.

**Considere os horários de turno.** Combine o escalonamento com a [configuração de horário](/kilo-docs-pt/kilo-iot-server/alarm/notification-rules.md) para encaminhar os alarmes para a rotação de prevenção correta. Fora do horário agendado, os alarmes continuam a ser acionados, mas podem ser direcionados para uma cadeia de escalonamento diferente através de uma definição de alarme separada para condições fora do horário.

**Mantenha as cadeias acionáveis.** Cada etapa deve chegar a alguém que tenha tanto a autoridade como a capacidade de responder. Notificar dez pessoas na primeira etapa cria ruído; uma cadeia direcionada com dois ou três níveis produz uma resposta mais rápida e mais responsável.

**Teste em condições realistas.** Execute um alarme de teste controlado através da cadeia de escalonamento completa para verificar se cada etapa chega aos destinatários corretos pelos canais corretos dentro do prazo esperado.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/alarm/escalation-and-response.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
