> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Eventos

> Nomeie fatos do seu sistema e dispare jornadas quando eles acontecem.

<Tip>
  **Evento** = **nome** do fato (`pedido.pago`). Seu backend **dispara**; automações **ENABLED** com aquele gatilho criam **runs**. Não confunda com webhooks da Notifique de entrega de canal.
</Tip>

## O que é um evento?

É um **contrato de nome** entre seu sistema e as automações. Você cadastra (opcionalmente com `schemaJson`), liga automações ao `eventName` e dispara com **Enviar evento**.

## Evento × webhook da automação × mensagem recebida

|             | **Evento (API)** | **Webhook HTTP**         | **Mensagem recebida**    |
| ----------- | ---------------- | ------------------------ | ------------------------ |
| Quem inicia | Seu backend      | Sistema externo (POST)   | Cliente no canal         |
| Config      | Nome + schema    | URL/segredo na automação | Gatilho inbound no grafo |
| Dados       | `payload` JSON   | Corpo do POST            | Texto/mídia da mensagem  |

Este artigo foca em **eventos pela API**. Os outros gatilhos configuram-se no **editor** da automação.

## Cadastrar

```json theme={null}
{
  "name": "pedido.pago",
  "schemaJson": {
    "orderId": "string",
    "total": "number"
  }
}
```

Escopo: **`events:write`**. Rotas na spec **Automações e eventos**.

## Disparar

```json theme={null}
{
  "event": "pedido.pago",
  "email": "cliente@example.com",
  "payload": {
    "orderId": "ORD-99",
    "total": 150.0
  }
}
```

* Destinatário: `contactId`, `email` ou `phone`
* Header **`Idempotency-Key`** recomendado
* Resposta: lista de `runs` (uma por automação ligada)

## Boas práticas

* Nomes estáveis: `order.paid`, `user_created`
* Payload pequeno (IDs, valores, datas)
* Um disparo pode acionar **várias** automações, planeje volume e créditos

## Escopos

| Ação                                 | Escopo         |
| ------------------------------------ | -------------- |
| Listar / buscar                      | `events:read`  |
| Criar, editar, excluir, **disparar** | `events:write` |

## Próximos passos

* [Quick Start](/automations-api/como-funciona/quick-start)
* [Introdução](/automations-api/como-funciona/introducao)
* [Escopos](/automations-api/como-funciona/escopos-da-api-key)