Referencia
Disparadores de las automatizaciones
Referencia de todos los disparadores de las automatizaciones por contexto, con sus opciones y filtros, qué los activa y las claves que se usan en la API.
Un disparador determina cuándo una automatización inicia una ejecución. Esta página lista todos los disparadores disponibles en cada contexto, qué los activa, sus opciones y la clave que usas para cada uno en la API.
Cómo funcionan los disparadores
- Un disparador por automatización en el panel. Selecciona el disparador en el lienzo y cámbialo con Trigger type. Con la API, las automatizaciones de tipo Contact y Email pueden tener varios disparadores, siempre que todos se conecten al mismo primer paso. Las de tipo Event tienen exactamente uno. Cada disparador que se activa inicia su propia ejecución, así que un solo registro puede iniciar dos: un formulario que añade el contacto a una lista activa Form submitted y Added to audience a la vez. Para una sola ejecución, en la pestaña Settings pon Same contact again while a run is in progress en Don’t start another run (
allow_reentry: false). - La automatización tiene que estar en marcha. Los disparadores de las automatizaciones en borrador, en pausa o detenidas se ignoran. Los eventos anteriores al inicio de una automatización no inician ejecuciones más tarde.
- Las ejecuciones se inician en cuestión de segundos. Emailit recoge los eventos nuevos cada pocos segundos. Los disparadores de fecha se comprueban cada 5 minutos.
- Las automatizaciones de tipo Contact necesitan un contacto. Un evento que no se puede asociar a un contacto del espacio de trabajo, como una apertura de una dirección que no es un contacto, no inicia ninguna ejecución.
- Las automatizaciones pueden iniciarse entre sí. Los cambios que hace un paso, como añadir una etiqueta o añadir un contacto a una lista, activan los disparadores de otras automatizaciones. Una automatización nunca se inicia a sí misma de esta forma, y una cadena de automatizaciones que se inician unas a otras se detiene después de 5 eslabones.
Filtros
Contact updated, Custom event, Placed an order, Abandoned a cart, Viewed a product, Product back in stock y todos los disparadores de email admiten un filtro opcional. Cada regla compara un campo del evento con un valor:
- Operadores: Equals, Not equals, Contains, Not contains, Greater than, Less than, Is set, Is not set, In, Not in, Starts with y Ends with. Greater than y Less than comparan números. El resto compara texto y distingue entre mayúsculas y minúsculas.
- Modo de coincidencia: All rules match o Any rule matches.
Con la API, un filtro es { "match": "all", "rules": [{ "field": "...", "operator": "equals", "value": "..." }] } en el config.filter del disparador, con match en all o any. Los campos son rutas dentro del objeto del evento, por ejemplo to, link.url o, para un evento personalizado, properties.total. Para comprobar el propio contacto (etiquetas, listas, puntuación), añade un paso Condition después del disparador.
Disparadores de contacto
| Disparador | Clave en la API | Opciones | Inicia una ejecución cuando |
|---|---|---|---|
| Added to audience | contact.added_to_audience |
Audience. Déjalo vacío para cualquier lista. | Un contacto se une a la lista, o se vuelve a añadir después de haberse dado de baja. |
| Removed from audience | contact.removed_from_audience |
Audience. Déjalo vacío para cualquier lista. | Se elimina la pertenencia de un contacto a la lista. |
| Added to segment | contact.added_to_segment |
Tracked segment (obligatorio) y si se incluyen los miembros actuales | Un contacto empieza a coincidir con un segmento con seguimiento. |
| Removed from segment | contact.removed_from_segment |
Tracked segment (obligatorio) | Un contacto deja de coincidir con un segmento con seguimiento. |
| Contact created | contact.created |
Ninguna | Se crea un contacto. |
| Contact updated | contact.updated |
Field that changed, filtro opcional | Cambian los campos, los campos personalizados, las etiquetas, la puntuación o el estado de marketing de un contacto. |
| Tag added | contact.tag_added |
Tag. Déjalo vacío para cualquier etiqueta. | El contacto recibe la etiqueta. |
| Tag removed | contact.tag_removed |
Tag. Déjalo vacío para cualquier etiqueta. | Se quita la etiqueta del contacto. |
| Score changed | contact.score_changed |
Crosses y Direction | La puntuación de lead del contacto cambia o cruza un umbral. |
| Unsubscribed | contact.unsubscribed |
Audience. Déjalo vacío para cualquiera. | El contacto se da de baja de una lista o de todos los emails de marketing. |
| Email opened | contact.loaded_email |
Solo los emails enviados por esta automatización | El contacto carga un email con seguimiento enviado a su dirección. |
| Link clicked | contact.clicked_in_email |
Link contains, solo los emails enviados por esta automatización | El contacto hace clic en un enlace con seguimiento de un email enviado a su dirección. |
| Date in contact field | contact.on_date |
Date field, desfase, hora, zona horaria, Repeat | Llega una fecha guardada en el contacto, o falta un número determinado de días para ella. |
| Date anniversary | contact.date_anniversary |
Date field, desfase, hora, zona horaria | Cada año, en el mes y el día de una fecha del contacto. |
| Custom event | contact.on_event |
Event name. Déjalo vacío para cualquiera. | Tu aplicación envía un evento de espacio de trabajo o personalizado para el contacto con la API de eventos, como una compra. Planes Business y Custom. |
| Form submitted | form.submitted |
Form. Déjalo vacío para cualquier formulario. | Alguien envía un formulario con una dirección de email. |
| Placed an order | contact.on_purchase |
Filtro opcional | Un contacto realiza un pedido nuevo. |
| Abandoned a cart | contact.abandoned_cart |
Filtro opcional | Se abandona el carrito de un contacto. |
| Viewed a product | contact.viewed_product |
Filtro opcional | Un contacto ve un producto en tu web. |
| Product back in stock | contact.back_in_stock |
Filtro opcional | Un producto por el que preguntó un contacto vuelve a estar disponible. |
Added to audience
Se activa cuando alguien se añade a una lista desde el panel (Add subscriber, Add to audience, Add contact con listas), con la API (Añadir un suscriptor o Crear un contacto con audiences), con la acción masiva Add to audience o con el paso Add to audience, Subscribe / unsubscribe o Create contact de otra automatización. Volver a añadir a alguien que se había dado de baja también lo activa.
No se activa con los contactos añadidos mediante una importación de archivo o un alta por la URL de suscripción, y volver a activar Subscribed en un suscriptor existente desde el panel tampoco cuenta.
Removed from audience
Se activa cuando se elimina un suscriptor: Delete en la página de la lista, Remove from audience, Eliminar un suscriptor, una actualización del contacto cuya lista audiences deja fuera esa lista o el paso Remove from audience de otra automatización. Eliminar un contacto lo activa una vez por cada lista en la que estaba el contacto. Darse de baja no lo activa, porque la persona sigue en la lista; para eso, usa Unsubscribed.
Para detener las ejecuciones de una secuencia cuando el contacto sale de su lista, no necesitas una segunda automatización: activa Leave when removed or unsubscribed from the audience that started the run en la pestaña Settings. Consulta Condiciones de salida y objetivos.
Disparadores de segmento
Added to segment y Removed from segment se activan cuando un contacto entra en un segmento con seguimiento o sale de él. Igual que los segmentos, están en alfa y solo están abiertos al equipo de Emailit. Elige el segmento en Tracked segment. Solo se listan y se aceptan los segmentos con seguimiento, porque los demás segmentos no registran las entradas y salidas.
- Cuándo se activan. Cuando un contacto cambia, se vuelven a comprobar sus segmentos, y las ejecuciones suelen empezar en menos de un minuto. Las importaciones y las listas de contactos eliminadas se comprueban cuando terminan. Las reglas que avanzan con el tiempo, como Created en los últimos 30 días, se comprueban en una sincronización diaria a las 00:30 UTC.
- Las ediciones del segmento no inician ejecuciones. Los contactos que entran o salen porque has cambiado el origen o los filtros del segmento se registran y se envían a los webhooks, pero no inician automatizaciones.
- El primer recuento no inicia ejecuciones. Al crear un segmento con seguimiento, o al reanudar el seguimiento después de subir de plan, se registran los miembros actuales sin iniciar ejecuciones.
- Incluir a los miembros actuales. En Added to segment, selecciona Also start for contacts already in the segment when the automation is first started para iniciar también una ejecución para cada miembro actual. Ocurre una sola vez, en el primer inicio de la automatización. Se siguen aplicando los ajustes de reentrada.
En una ejecución, {{payload.object.segment.name}} contiene el nombre del segmento, y {{payload.object.reason}}, por qué el contacto entró o salió: contact, schedule, o existing_member en las ejecuciones iniciadas para los miembros actuales del segmento.
Con la API, asigna a config.segment_id el ID seg_ del segmento y, para contact.added_to_segment, opcionalmente config.include_current_members: true. Un segmento que se usa en automatizaciones no se puede eliminar hasta que cambies esas automatizaciones.
Contact updated
Se activa cada vez que se actualiza un contacto en el panel, con la API o mediante un paso de automatización, incluidos los cambios de etiquetas y de puntuación y las acciones masivas Unsubscribe y Resubscribe. Field that changed lo limita a un campo, por ejemplo un campo personalizado purchased que rellena tu CRM. El filtro puede comprobar los valores actuales de Email, First name, Last name, Unsubscribed y los campos personalizados, y sus valores anteriores, que aparecen como Previous email, Previous first name, etc. Los valores anteriores solo están presentes en los campos que han cambiado.
Por ejemplo, para reaccionar cuando un contacto pasa al plan pro, añade dos reglas con All rules match: custom_fields.plan Equals pro y Previous plan (previous.custom_fields.plan) Not equals pro.
Tag added y Tag removed
Se activan cuando se añade o se quita una etiqueta del contacto por cualquier vía: el panel, la API, el servidor MCP o un paso de automatización. Las etiquetas se comparan en minúsculas, así que VIP y vip son la misma etiqueta.
Score changed
Se activa cuando cambia la puntuación de lead del contacto. Con Crosses definido, solo se activa cuando la puntuación pasa por ese valor: hacia arriba (Going up, la opción por defecto) significa que la puntuación anterior estaba por debajo y la nueva está en ese valor o por encima, así que «los leads con más de 50 entran en el flujo de ventas» se activa una sola vez, no con cada punto. Going down se activa cuando la puntuación baja de ese valor.
Unsubscribed
Se activa cuando el contacto se da de baja de una lista (con un enlace de baja, desde el panel, con la API o con un paso Subscribe / unsubscribe) o de todos los emails de marketing. Con Audience definido, solo se activa para esa lista y para las bajas de todo.
Email opened y Link clicked
Se activan cuando el contacto carga un email con seguimiento enviado a su dirección o hace clic en él: campañas, emails enviados con la API y por SMTP, y emails de automatizaciones. El seguimiento necesita la configuración de seguimiento del dominio de envío y un CNAME de seguimiento verificado. Only emails sent by this automation los limita a los emails de la propia automatización, y Link contains, a los enlaces cuya URL contiene el texto, por ejemplo /pricing.
Para reaccionar a la apertura o al clic de un email que acaba de enviar la ejecución, usa en su lugar un paso Wait until con Something happens. Consulta Wait until.
Date in contact field y Date anniversary
Elige un Date field, un campo personalizado de tipo fecha como una fecha de renovación o un cumpleaños, y después cuándo empezar:
- Days con Unit (
daysoweeks) y When (before the dateoafter the date), por ejemplo 3 días antes de una renovación.0significa el mismo día. - At time (por defecto,
00:00) en Timezone (un nombre IANA comoEurope/Prague; por defecto, UTC). - Repeat en Date in contact field: Once, on that date o Every year (anniversary). Date anniversary siempre se repite cada año; el año del campo no importa, así que
1990-04-12inicia una ejecución cada 12 de abril. En los años no bisiestos, los aniversarios del 29 de febrero se inician el 28 de febrero.
Emailit mira con 5 minutos de antelación e inicia cada ejecución en el minuto que has definido. Cada contacto recibe una ejecución por fecha (o por año, en los aniversarios), y cada comprobación gestiona hasta 100.000 contactos por automatización.
Con la API, asigna a config.date_field la clave del campo personalizado, a offset el valor { "amount": 3, "unit": "days", "direction": "before" } y, opcionalmente, time, timezone y repeat: "yearly".
Custom event
Este disparador está incluido en los planes Business y Custom. En Pay as you go y Pro, una automatización que lo añade no se puede guardar (403 con "error": "plan_required"). Las automatizaciones que ya lo usan lo conservan después de bajar de plan.
Se activa cuando tu aplicación envía un evento personalizado (eventos c:) o un evento de espacio de trabajo (eventos w:) para el contacto con la API de eventos. Los eventos del script de seguimiento no inician ejecuciones, porque cualquiera que tenga tu clave de seguimiento pública puede identificar a cualquier visitante. Indica su nombre en Event name:
purchasecoincide conc:purchasey conw:purchase.- Un nombre con su prefijo, como
w:webinar.attended, solo coincide con ese. - Déjalo vacío para que se inicie con cualquier evento de espacio de trabajo o personalizado.
El campo sugiere los eventos de espacio de trabajo que has definido y los eventos personalizados que tu espacio de trabajo ha enviado recientemente. En Only when the properties match (optional), filtra por las propiedades del evento, por ejemplo properties.total Greater than 100. En un evento de espacio de trabajo, la lista de campos muestra sus propiedades definidas.
El evento debe identificar a un contacto del espacio de trabajo por su ID o su dirección de email. Los eventos de visitantes anónimos, o de direcciones que no son contactos, no inician ejecuciones. En la ejecución, {{payload.object.properties.total}} y similares contienen las propiedades.
Placed an order
Como Comercio electrónico, este disparador está en alfa y solo está abierto al equipo de Emailit. Las automatizaciones que ya lo usan siguen funcionando.
Se activa una vez por cada pedido nuevo de un contacto, desde la API de pedidos o con el comando purchase del script de seguimiento. Los pedidos importados como historial y los pedidos sin contacto no lo activan, y las actualizaciones de un pedido no lo vuelven a activar. El filtro puede comprobar Order total, Currency, Status, Source y Coupon codes del pedido, y los emails pueden usar el pedido como {{payload.object.total}}, {{payload.object.external_id}}, etc.
Abandoned a cart
Como Comercio electrónico, este disparador está en alfa y solo está abierto al equipo de Emailit. Las automatizaciones que ya lo usan siguen funcionando.
Se activa cada vez que se abandona un carrito: un carrito de un contacto conocido que tiene artículos y no ha cambiado durante el plazo definido en la configuración de Comercio electrónico (60 minutos por defecto). El filtro puede comprobar Cart total, Currency y Source. En los emails, {{cart}} muestra el carrito; consulta Productos, cupones y el carrito.
Los pasos Send email de una ejecución iniciada por este disparador se omiten en cuanto ese carrito se convierte en un pedido, para que los compradores no reciban recordatorios de lo que acaban de comprar. Consulta la receta de carrito abandonado.
La API también acepta contact.visits_url, pero todavía nada lo activa.
Viewed a product
Como Comercio electrónico, este disparador está en alfa y solo está abierto al equipo de Emailit. Las automatizaciones que ya lo usan siguen funcionando.
Se activa cuando un contacto ve un producto en tu web, con el comando product del script de seguimiento o con el píxel de Emailit en Shopify. Cualquiera con tu clave de seguimiento pública puede enviar vistas, así que solo lo activan las vistas de un contacto que llegó desde uno de tus emails (un enlace firmado) o que se suscribió a una lista. El filtro puede comprobar Product ID (shop), Product title y Price. Los emails pueden usar {{payload.object.product.title}}, o mostrar todo lo que vio el contacto con {{products "recently_viewed"}}.
Una visita suele tener varias vistas de productos. Para el abandono de navegación, configura Wait between runs for the same contact (hours), espera antes del email y sal con Placed an order, como hace la plantilla Browse abandonment.
Product back in stock
Como Comercio electrónico, este disparador está en alfa y solo está abierto al equipo de Emailit. Las automatizaciones que ya lo usan siguen funcionando.
Se activa cuando un producto por el que un contacto preguntó con el formulario de reposición de tu tienda Shopify vuelve a estar disponible, una vez por solicitud. El filtro puede comprobar Product ID (shop), Product title y Variant ID. Los emails pueden usar {{payload.object.product.title}}, {{payload.object.product.url}}, {{payload.object.product.image_url}} y {{payload.object.variant.title}}. La plantilla Back in stock envía su email como transaccional, porque el contacto lo pidió.
Disparadores de email
Los disparadores de email se activan con los emails de tu espacio de trabajo: todo lo que envías con la API o por SMTP, los emails de campañas y de automatizaciones, y el email entrante en el caso de Email received. Cada ejecución corresponde a un email.
| Disparador | Clave en la API | Inicia una ejecución cuando | Campos de filtro |
|---|---|---|---|
| Email delivered | email.delivered |
El servidor del destinatario ha aceptado el email. | From, To, Subject, Status |
| Email bounced | email.bounced |
El email ha fallado de forma permanente. | From, To, Subject, Status |
| Email failed | email.failed |
No se ha podido enviar el email por un error. | From, To, Subject, Status |
| Email suppressed | email.suppressed |
El email no se ha enviado porque el destinatario está bloqueado. | From, To, Subject, Status |
| Email complained | email.complained |
El destinatario ha marcado el email como spam. | From, To, Subject, Status |
| Email received | email.received |
Ha llegado un email entrante. Consulta Emails entrantes. | From, To, Subject |
| Email loaded | email.loaded |
El destinatario ha cargado un email con seguimiento. | Recipient, Sender, Subject, IP address, User agent |
| Email clicked | email.clicked |
El destinatario ha hecho clic en un enlace con seguimiento. | Recipient, Sender, Subject, Link URL, IP address, User agent |
El editor también muestra Email accepted, Email scheduled, Email attempted y Email rejected. Las automatizaciones con estos disparadores todavía no se pueden guardar, así que elige uno de los disparadores anteriores. Con la API también puedes usar email.canceled, que se activa cuando se cancela un email programado o en cola.
Disparadores de evento
Por ahora, las automatizaciones de tipo Event solo se pueden crear con la API.
| Disparador | Clave en la API | Inicia una ejecución cuando |
|---|---|---|
| Manual trigger | system.manual |
Llamas a Lanzar una ejecución. |
| Schedule | system.schedule |
Reservado. Todavía nada lo activa, así que llama al endpoint de disparo desde tu propio programador de tareas, como una tarea cron. |
Manual trigger
Llama al endpoint de disparo de una automatización en marcha, con un objeto payload opcional:
curl https://api.emailit.com/v2/automations/aut_3Mv8Xq2nKp5Lt/trigger \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "payload": { "email": "ada@example.com", "plan": "pro" } }'El endpoint devuelve { "message": "Automation trigger dispatched." }, o 422 si la automatización no está en marcha. Solo inicia una ejecución de esa automatización. Los pasos pueden leer el payload como {{payload.email}}, {{payload.plan}}, etc. Emailit añade automation_id al payload.
system.manual también funciona como disparador en las automatizaciones de tipo Contact y Email creadas con la API. Incluye contact_id (un ID con_) o email_id en el payload para ejecutar la automatización para ese contacto o email.
Datos disponibles para los pasos
Los ajustes de los pasos, como el destinatario de Send email, los valores de Update contact fields o el cuerpo de un Webhook, pueden incluir marcadores que se rellenan en cada ejecución:
| Marcador | Contiene |
|---|---|
{{contact.<field>}} |
El contacto de la ejecución en las automatizaciones de tipo Contact, por ejemplo {{contact.email}}, {{contact.score}} o {{contact.custom_fields.plan}}. |
{{cf.<key>}} |
Un campo personalizado del contacto, por ejemplo {{cf.plan}}. |
{{tags}} |
Las etiquetas del contacto, separadas por comas. |
{{global.<key>}} |
Un valor global, por ejemplo {{global.webinar_date}}. |
{{email.<field>}} |
El email de la ejecución en las automatizaciones de tipo Email, por ejemplo {{email.rcpt_to}} o {{email.subject}}. |
{{payload.<path>}} |
El evento que inició la ejecución. En los eventos de estilo webhook, los datos del evento están en payload.object, por ejemplo {{payload.object.to}}. En los disparadores manuales, es tu payload. |
{{meta.<path>}} |
Datos adicionales que Emailit guarda sobre la ejecución. |
{{run.id}} |
El ID de la ejecución (aur_…). |
Las plantillas de email que envía Send email usan Temple con los mismos datos. Consulta Pasos.