# Automatizaciones

> Las automatizaciones ejecutan pasos como enviar un email, esperar o actualizar un contacto cuando se activa un disparador. Conoce los contextos, los estados, las ejecuciones, los créditos y la API.

Una automatización es un flujo de trabajo que se pone en marcha solo: cuando se activa un disparador, como que un contacto se una a una lista o que un email rebote, Emailit inicia una ejecución que recorre los pasos que has conectado, como enviar un email, esperar un día o actualizar el contacto. Usa las automatizaciones para emails de bienvenida, secuencias de onboarding, emails de cumpleaños, reenvíos y avisos.

> **Automatizaciones está en beta:** Las automatizaciones funcionan en todos los espacios de trabajo, pero algunas opciones aún se están terminando. Cuando el panel y la API difieren, estas páginas lo indican.

## Cómo funciona

1. **Se activa un disparador.** Toda automatización empieza con un disparador, por ejemplo **Added to audience**. Los filtros opcionales lo acotan.
2. **Emailit inicia una ejecución** para el contacto o el email que la ha provocado y cobra 3 créditos.
3. **La ejecución recorre los pasos** conectados al disparador, uno tras otro. Los pasos **Wait** pausan la ejecución, y los pasos **Condition** la envían por una rama **Yes** o **No**.
4. **La ejecución termina** cuando llega al último paso de su rama, o falla si falla un paso.

Construyes el flujo en un lienzo del panel, o lo envías a la API como una lista de pasos y conexiones. Consulta [Disparadores](/es/docs/automations/triggers/) y [Pasos](/es/docs/automations/steps/).

## Contextos

Cada automatización tiene un contexto, que determina a qué corresponde una ejecución y qué disparadores y pasos están disponibles. Lo eliges al crear la automatización y no se puede cambiar después.

| Contexto | Etiqueta | Cada ejecución corresponde a | Útil para | Disparadores |
| --- | --- | --- | --- | --- |
| **Contact** | Easy | Un contacto | Series de bienvenida, onboarding, reactivación | Pertenencia a listas, cambios en el contacto, aniversarios de fechas |
| **Email** | Medium | Un email | Gestión de respuestas, reenvíos automáticos, avisos de rebote | Eventos de email, como entregado, rebotado o recibido |
| **Event** | Advanced | Una llamada a la API | Flujos controlados desde la API, integraciones personalizadas | Un disparador manual que llamas con la API |

En el panel, el contexto **Event** muestra el distintivo **Soon** y todavía no se puede seleccionar. Puedes crear automatizaciones de tipo Event con la API.

## Crear una automatización

1. **Empieza.** Ve a **Email Marketing → Automations** y selecciona **New automation**.

2. **Elige el contexto.** Elige **Contact** o **Email**.

3. **Elige una plantilla.** Elige una de las [recetas ya preparadas](/es/docs/automations/recipes/) o **Start from scratch** para obtener un lienzo en blanco con solo un disparador.

4. **Ponle nombre.** Introduce un **Name** y, si quieres, una **Description**, y selecciona **Create**. La automatización se abre como borrador.

5. **Construye el flujo.** En la pestaña **Editor**, selecciona el disparador y cada paso para configurarlos, y añade pasos con los botones de suma. Selecciona **Save**.

6. **Iníciala.** Selecciona **Start**. A partir de ese momento, cada disparador que coincida inicia una ejecución.

La página de listado tiene pestañas para las automatizaciones **Contact**, **Email** y **Event**, y muestra de cada una su **Name**, su **Status**, la hora de **Last triggered** y la fecha de **Created**.

## Estados

| Estado | Los disparadores inician ejecuciones | Editable en el panel | Cómo se llega a él |
| --- | --- | --- | --- |
| **Draft** | No | Sí | Toda automatización nueva empieza como borrador. |
| **Running** | Sí | No | Selecciona **Start** en una automatización en borrador o en pausa. |
| **Paused** | No | Sí | Selecciona **Pause** en una automatización en marcha. **Start** la reanuda. |
| **Stopped** | No | No | Solo con el endpoint [stop](/es/docs/api-reference/automations/stop/) de la API, que además cancela todas las ejecuciones en curso. |

Al pausar, dejan de iniciarse ejecuciones nuevas, pero las que ya están en curso continúan, incluidas las que esperan en un paso **Wait**. **Delete**, en el menú de la parte superior de la automatización, la elimina en cualquier estado.

### Reglas de edición

La pestaña **Editor** solo está disponible mientras la automatización está en borrador o en pausa. En una automatización en marcha, la pestaña muestra **Pause to edit**.

**Save** comprueba todo el flujo y resalta los pasos que necesitan atención, por ejemplo un paso **Send email** sin plantilla o una espera de más de 30 días. Corrígelos y vuelve a guardar antes de seleccionar **Start**: al iniciar, las comprobaciones no se vuelven a ejecutar.

## Ejecuciones

Una ejecución es una pasada por la automatización para un contacto, un email o una llamada a la API. Cada ejecución tiene un estado:

| Estado de la ejecución | Significado |
| --- | --- |
| **Running** | La ejecución está recorriendo sus pasos o esperando. |
| **Completed** | Todos los pasos del recorrido de la ejecución han terminado. |
| **Failed** | Ha fallado un paso, o el espacio de trabajo no tenía créditos suficientes cuando empezó la ejecución. |
| **Canceled** | La automatización se detuvo con la API mientras la ejecución estaba en curso. |

Por defecto, cada disparador inicia una ejecución nueva, aunque el mismo contacto o email ya tenga una en curso. Un mismo evento nunca inicia dos ejecuciones de una misma automatización. Para el historial de ejecuciones y la depuración, consulta [Ejecuciones y estadísticas](/es/docs/automations/runs/).

## Créditos

| Acción | Créditos |
| --- | --- |
| Cada ejecución | 3, que se cobran al iniciarse la ejecución |
| Cada email enviado por un paso **Send email** | 1 |
| Cada email enviado por un paso **Forward email** | 1 |

Si el espacio de trabajo no tiene 3 créditos cuando se activa un disparador, la ejecución se crea con el estado **Failed** y el motivo `insufficient_credits` en su `meta`. Si los créditos se agotan en mitad de una ejecución, el paso **Send email** o **Forward email** falla. Consulta [Créditos](/es/docs/billing/credits/).

## Usar la API

La [API de automatizaciones](/es/docs/api-reference/automations/) gestiona las automatizaciones y lee sus ejecuciones. Necesita una clave de API con **Full Access**.

| Endpoint | Para qué sirve |
| --- | --- |
| [Crear](/es/docs/api-reference/automations/create/), [actualizar](/es/docs/api-reference/automations/update/), [obtener](/es/docs/api-reference/automations/get/), [listar](/es/docs/api-reference/automations/list/) y [eliminar](/es/docs/api-reference/automations/delete/) | Gestionar automatizaciones. Los pasos y las conexiones se envían juntos. |
| [Iniciar](/es/docs/api-reference/automations/start/), [pausar](/es/docs/api-reference/automations/pause/) y [detener](/es/docs/api-reference/automations/stop/) | Cambiar el estado. |
| [Lanzar una ejecución](/es/docs/api-reference/automations/trigger/) | Activar un disparador **Manual**, con un `payload` opcional. La automatización tiene que estar en marcha. Solo es posible con la API. |
| [Listar ejecuciones](/es/docs/api-reference/automations/runs/), [obtener una ejecución](/es/docs/api-reference/automations/run/), [estadísticas](/es/docs/api-reference/automations/stats/) y [estadísticas por paso](/es/docs/api-reference/automations/step-stats/) | Leer el historial de ejecuciones y los resultados de cada paso. |

La API también acepta `settings` de automatización que el panel todavía no muestra:

| Ajuste | Valor por defecto | Efecto |
| --- | --- | --- |
| `allow_reentry` | `true` | Ponlo en `false` para omitir las ejecuciones nuevas de un contacto o email que ya tiene una ejecución en curso. |
| `max_concurrent_runs` | `0` (sin límite) | Omite las ejecuciones nuevas mientras haya este número de ejecuciones en curso. |
| `cooldown_seconds` | `0` | Omite las ejecuciones nuevas de un contacto o email que inició una ejecución hace menos de este número de segundos. |
| `on_step_failure` | `stop` | `stop` hace fallar la ejecución cuando falla un paso. `skip` deja que la ejecución continúe. |

Las ejecuciones omitidas no se crean y no consumen créditos.

```bash
curl https://api.emailit.com/v2/automations \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "context": "contact",
    "name": "Welcome email",
    "settings": { "allow_reentry": false },
    "steps": [
      { "key": "trigger-1", "type": "trigger", "trigger": "contact.added_to_audience", "config": { "audience_id": "aud_5hJ2kL8mNp4Qr" } },
      { "key": "send_email-1", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "welcome" } }
    ],
    "connections": [
      { "from": "trigger-1", "to": "send_email-1", "branch": "default" }
    ]
  }'
```

La automatización se crea como borrador. Llama a [Iniciar una automatización](/es/docs/api-reference/automations/start/) para activarla.

## Próximos pasos

  - [Disparadores](/es/docs/automations/triggers/): Todos los disparadores y sus opciones.
  - [Pasos](/es/docs/automations/steps/): Todos los pasos, sus ajustes y cómo funcionan las ramas.
  - [Recetas](/es/docs/automations/recipes/): Las seis plantillas ya preparadas.
  - [Ejecuciones y estadísticas](/es/docs/automations/runs/): Sigue las ejecuciones y depura los fallos.

---
Fuente: https://emailit.com/es/docs/automations/