Descripción generalBeta
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.
Cómo funciona
- Se activa un disparador. Toda automatización empieza con un disparador, por ejemplo Added to audience. Los filtros opcionales lo acotan.
- Emailit inicia una ejecución para el contacto o el email que la ha provocado y cobra 3 créditos.
- 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.
- 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 y Pasos.
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 |
| 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
-
Empieza. Ve a Email MarketingAutomations y selecciona New automation.
-
Elige el contexto. Elige Contact o Email.
-
Elige una plantilla. Elige una de las recetas ya preparadas o Start from scratch para obtener un lienzo en blanco con solo un disparador.
-
Ponle nombre. Introduce un Name y, si quieres, una Description, y selecciona Create. La automatización se abre como borrador.
-
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.
-
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 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.
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.
Usar la API
La API de automatizaciones gestiona las automatizaciones y lee sus ejecuciones. Necesita una clave de API con Full Access.
| Endpoint | Para qué sirve |
|---|---|
| Crear, actualizar, obtener, listar y eliminar | Gestionar automatizaciones. Los pasos y las conexiones se envían juntos. |
| Iniciar, pausar y detener | Cambiar el estado. |
| Lanzar una ejecución | Activar un disparador Manual, con un payload opcional. La automatización tiene que estar en marcha. Solo es posible con la API. |
| Listar ejecuciones, obtener una ejecución, estadísticas y estadísticas por paso | 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.
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 para activarla.