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

> Nombra hechos de tu sistema y activa viajes cuando sucedan.

<Tip>
  **Evento** = hecho **nombre** (`order.paid`). Su backend **disparadores**; **HABILITADO** las automatizaciones con ese activador crean **ejecuciones**. No es lo mismo que los webhooks de entrega del canal Notifique.
</Tip>

## ¿Qué es un evento?

Un **contrato de nombre** entre su sistema y las automatizaciones. Lo registra (opcionalmente con `schemaJson`), adjunta automatizaciones a `eventName` y activa con **Enviar evento**.

## Evento × webhook de automatización × mensaje entrante

|            | **Event (API)** | **HTTP webhook**         | **Inbound message**      |
| ---------- | --------------- | ------------------------ | ------------------------ |
| Who starts | Your backend    | External system (POST)   | Customer on channel      |
| Config     | Name + schema   | URL/secret on automation | Inbound trigger in graph |
| Data       | JSON `payload`  | POST body                | Message text/media       |

Esta página se centra en **eventos API**. Otros activadores se configuran en el **editor** de automatización.

## Registro

Scope: **`events:write`**. Routes in **Automations and events** spec.

## Trigger

* Destinatario: `contactId`, `email` o `phone`
* **`Idempotency-Key`** encabezado recomendado
* Respuesta: lista de `runs` (una por automatización vinculada)

## Mejores prácticas

* Nombres estables: `order.paid`, `user_created`
* Pequeña carga útil (ID, cantidades, fechas)
* Un activador puede iniciar **varias** automatizaciones, volumen del plan y créditos.

## Alcances

| Action                              | Scope          |
| ----------------------------------- | -------------- |
| List / get                          | `events:read`  |
| Create, update, delete, **trigger** | `events:write` |

## Próximos pasos

* [Inicio Rápido](/es/automations-api/como-funciona/quick-start)
* [Introducción](/es/automations-api/como-funciona/introducao)
* [Alcances](/es/automations-api/como-funciona/escopos-da-api-key)