> 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/first-operational-alert.md).
# O Seu Primeiro Alerta
Tutorial — crie o seu primeiro alarme operacional, ligue-o a uma regra, veja-o disparar na Caixa de Entrada e resolva o evento.
Este guia passo a passo leva-o do zero até um alarme operacional a funcionar. No final, terá criado uma definição de alarme, ligado-a a uma regra no Motor de Regras, visto-a disparar na Caixa de Entrada e resolvido o evento. Este é o caminho feliz — um alarme, uma regra, um dispositivo.
Para a referência completa de todos os campos da definição de alarme, consulte [Definições de alarmes](/kilo-docs-pt/kilo-iot-server/alarm/notification-rules.md).
## Pré-requisitos
* Pelo menos um dispositivo registado e a reportar dados de sensores.
* Um contacto de e-mail verificado nas [Canais de Entrega](/kilo-docs-pt/kilo-iot-server/alarm/notification-channels.md) definições.
## Passo 1 — Criar a definição de alarme
1. Abra **Alarme** a partir da barra lateral.
2. Mude para **Definições de alarmes** .
3. Clique em **Adicionar regra de alarme**.
4. Preencha o formulário:
* **Nome do alarme:** "Alerta de armazenamento a frio" (ou algo que descreva a condição que está a monitorizar).
* **Severidade:** Escolha **Alta** para este teste. Pode alterá-la mais tarde.
* **Cadeia de escalonamento:**
* **Passo 1 (Imediato):** Selecione o técnico de prevenção em **Notificar**. Selecione **Email** em **Via**. Esta pessoa é notificada no momento em que o alarme dispara.
* Clique em **Adicionar passo** para adicionar um segundo nível.
* **Passo 2 (Após atraso configurável):** Selecione o supervisor do turno em **Notificar**. Selecione **Email** e **SMS** em **Via**. Se o técnico não resolver o alarme dentro da janela configurada, o supervisor é notificado automaticamente — sem necessidade de intervenção manual.
* **Tema:** "Excedência de temperatura no armazenamento a frio."
* **Corpo da mensagem:** "A leitura do sensor excedeu o limite operacional. Verifique a instalação."
5. Deixe por agora os valores predefinidos de Agenda, Intervalo de notificação personalizado e Suprimir duplicados.
6. Clique em **Adicionar nova regra de alarme**.
A sua definição de alarme é criada e aparece na **Definições de alarmes** lista.
## Passo 2 — Ligá-la a uma regra no Motor de Regras
A definição de alarme que acabou de criar não monitoriza sensores por si só — ela define a resposta. Precisa de uma regra no [Motor de Regras](/kilo-docs-pt/kilo-iot-server/rules-engine.md) para avaliar os dados dos sensores e disparar o alarme quando as condições forem cumpridas.
1. Abra **Motor de regras** a partir da barra lateral.
2. Crie uma nova regra (ou edite uma existente).
3. No editor visual, adicione um **Definir Alarme** nó ao painel de automação.
4. Nas propriedades do nó Definir alarme, selecione a sua definição "Alerta de armazenamento a frio" no menu pendente **Escolher alarme** .
5. Preencha a **Mensagem de motivação** — esta é uma expressão CEL que produz o texto da notificação. Para um teste simples: `"A leitura da temperatura excedeu o limite"`.
6. Ligue o nó Definir alarme ao seu fluxo de automação (após uma condição de gateway que verifica o limite do sensor).
7. **Salvar**, depois **Construir**, depois **Implante** a automação.
A regra está agora em execução e irá disparar o alarme quando os dados do sensor corresponderem às suas condições.
## Passo 3 — Ver o alarme na Caixa de Entrada
Assim que a regra disparar (quer seja com dados reais do sensor ou com uma condição de teste), o evento de alarme aparece no separador **Caixa de Entrada** na página de Alarmes:
* O evento aparece com o estado **Ativo** (triângulo de aviso).
* A severidade é codificada por cores como **Alta**.
* A mensagem corresponde ao que configurou na definição.
## Passo 4 — Resolver o alarme
Clique em **Marcar como resolvido** no evento de alarme. O estado muda para **Resolvido** (marca de verificação). Se o alarme ainda estivesse no Passo 1 quando o resolveu, o Passo 2 nunca dispara — o supervisor não é notificado porque o técnico tratou dele. Se o alarme já tivesse escalado para o Passo 2, resolvê-lo interrompe quaisquer notificações adicionais desse evento.
O evento resolvido permanece na Caixa de Entrada como registo histórico.
## O que vem a seguir
| Objetivo | Para onde ir |
| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Adicionar passos de escalonamento para alarmes não resolvidos | [Escalonamento e Resposta](/kilo-docs-pt/kilo-iot-server/alarm/escalation-and-response.md) |
| Configurar o tempo de repetição ao nível de severidade | [Severidade da notificação](/kilo-docs-pt/kilo-iot-server/alarm/notification-delivery-settings.md) |
| Referência completa dos campos da definição de alarme | [Definições de alarmes](/kilo-docs-pt/kilo-iot-server/alarm/notification-rules.md) |
| Configurar entrega por SMS ou push | [Canais de Entrega](/kilo-docs-pt/kilo-iot-server/alarm/notification-channels.md) |
---
# 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/first-operational-alert.md?ask=&goal=
```
`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.
