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

# Introducción

> Cuando algo sucede en su sistema o en un canal, Notifique ejecuta una secuencia de pasos.

<Tip>
  Una **automatización** es un **libro de estrategias**: cuando suceda X, ejecute los pasos (enviar, esperar, IA, condición…). Un **evento** es el nombre del hecho. Una **ejecución** es cada vez que se ejecuta el libro de jugadas para una persona.
</Tip>

## ¿Qué son las Automatizaciones en Notifique?

El **motor de viaje**: creas un gráfico de pasos en el panel o mediante API. Cuando se activa el **disparador**, una **ejecución** recorre los envíos de plantillas, los retrasos, los asistentes de IA, las actualizaciones de contactos y más.

Puede:

* **Activador** desde tu API (`order.paid`, `user.created`)
* **Recibir** webhooks HTTP de herramientas externas (Zapier, ERP)
* **Reaccionar** a mensajes entrantes (WhatsApp, SMS, widget…)
* **Inspeccionar** ejecuciones y auditar lo que sucedió

Pensemos en un **guión de teatro**: el gatillo levanta el telón; cada paso es una escena.

## Mapa conceptual

| Concept            | What it is                                                   |
| ------------------ | ------------------------------------------------------------ |
| **Automation**     | Full flow (step graph), enabled or paused                    |
| **Event**          | Registered name for a system fact (`order.paid`)             |
| **Run**            | One execution of the flow for a recipient                    |
| **Trigger**        | How the flow **starts** (event, webhook, or inbound message) |
| **AI assistant**   | Conversation “brain”, instructions + model + knowledge + MCP |
| **Knowledge base** | Indexed docs the AI queries (RAG)                            |
| **MCP**            | External tools for the AI (Gmail, calendar, your API)        |

**Campaña** (pestaña Contactos) = envío masivo de una sola vez. **Automatización** = secuencia **repetible** cada vez que el gatillo se dispara nuevamente.

<Note>
  **Webhook de automatización** (inicia el flujo) ≠ **Notifique webhook** (estado de entrega del canal, etc.). Ver [Webhooks](/es/guides/webhooks/index) en Guías.
</Note>

## Tres formas de activar

| Way                                                    | Who starts                    | Example                             |
| ------------------------------------------------------ | ----------------------------- | ----------------------------------- |
| **[Event](/es/automations-api/como-funciona/eventos)** | Your backend via API          | `POST` Send event with `order.paid` |
| **HTTP webhook**                                       | External system (POST to URL) | Zapier, ClickUp, ERP                |
| **Inbound message**                                    | Customer on channel           | Chatbot with AI assistant           |

## Tipos de pasos comunes

| Type               | What it does                              |
| ------------------ | ----------------------------------------- |
| **Trigger**        | Starting point (one per flow)             |
| **Send template**  | Message via email, SMS, WhatsApp…         |
| **Delay**          | Time pause                                |
| **Condition**      | `true` / `false` branches (both required) |
| **AI assistant**   | Reply using knowledge base and/or MCP     |
| **Update contact** | Tag, field, or topic                      |
| **End**            | Stops the branch                          |

Estado de automatización: **HABILITADO** (se activa) o **PAUSED** (no se activa). Detenga una ejecución activa a través de API con `automations:write`.

## ¿Qué hay en la API v1?

Rutas con el prefijo **`/v1/`** y autenticación **Clave API** (`sk_live_...` / `sk_test_...`):

* **Eventos**, registro y activación (`events:read`, `events:write`)
* **Automatizaciones**, gráficos, flujo de parada, ejecuciones de lista (`automations:read`, `automations:write`)

Referencia completa en la especificación **Automatizaciones y eventos** en la barra lateral.

<Info>
  Cada clave API pertenece a **un** espacio de trabajo. En v1 **no enviar** `x-workspace-id`. Utilice **`Idempotency-Key`** al enviar eventos.
</Info>

## Panel de control (fuera de la API v1)

**Las bases de conocimiento**, los **asistentes** y las **integraciones MCP** se configuran **en el panel** (Automatizaciones → Bases, Asistentes, MCP). No existen rutas `/v1/` públicas para estos en esta documentación, utilice [Asistentes](/es/automations-api/como-funciona/assistentes), [Base de conocimientos](/es/automations-api/como-funciona/base-de-conhecimento), e [Integraciones MCP](/es/automations-api/como-funciona/integracoes-mcp).

## ¿Cuándo usarlo?

Ideal para **secuencias posteriores al evento**, **chatbots** y **seguimientos** (espera + segundo mensaje). Para un envío **único** sin repetición, use [templates](/es/template-api/como-funciona/quick-start) o la API del canal.

## Próximos pasos

* [Inicio Rápido](/es/automations-api/como-funciona/quick-start): primer evento y flujo
* [Eventos](/es/automations-api/como-funciona/eventos): registrar y disparar
* [Eventos de webhook](/es/automations-api/como-funciona/eventos-do-webhooks): ejecuciones y estados vía webhook
* [Asistentes](/es/automations-api/como-funciona/asistentes): configurar AI
* [Base de conocimientos](/es/automations-api/como-funciona/base-de-conhecimento) · [Integraciones MCP](/es/automations-api/como-funciona/integracoes-mcp)
* [Casos de uso](/es/automations-api/como-funciona/casos-de-uso)
* [Ámbitos de clave API](/es/automations-api/como-funciona/escopos-da-api-key)