El Bloque de inicio determina qué criterios debe cumplir tu contacto para entrar en el flujo de trabajo. Determinarás los criterios seleccionando un tipo de disparador y configurando tu audiencia.

1. Opciones de activación del flujo de trabajo:
   • Evento de suscripción: Desencadena el flujo de trabajo cuando un contacto se suscribe a una, varias o todas las listas de contactos.
   • Evento de actualización de una propiedad de contacto (CPU): Desencadena el flujo de trabajo cuando se actualiza una propiedad de un contacto.

   • Disparador comportamental (OPEN/CLICK): Se activa cuando un contacto abre un email o hace clic en un enlace, con filtros opcionales por Campañas, Etiquetas y Remitentes.

     Para más detalles sobre los disparadores comportamentales, ve a la sección « Disparadores comportamentales » de este artículo.

   • Evento externo (Webhook): Activa un flujo cuando tu sistema (sitio web, app, CRM, etc.) envía un evento a Mailjet mediante la API. Puedes seleccionar uno o más calificadores de webhook (los “nombres” de los eventos) para decidir qué eventos externos pueden iniciar el flujo.

     

     Para obtener más detalles sobre los webhooks, ve a la sección « Eventos externos (Webhooks) » de este artículo.
2. Segmenta tu audiencia (opcional):
   • Selecciona o crea un segmento a partir de tus segmentos existentes.
   • Crea un filtro personalizado: Segmenta tu audiencia creando un segmento que solo esté disponible dentro del flujo de trabajo.

Ejemplos de configuración:

• El contacto se suscribe a cualquier lista de contactos y se encuentra en Francia.
• Contactos que se suscriben a la lista de contactos "Newsletter".
• Contactos que se suscriben a "Newsletter" o "Promociones" y que pertenecen al segmento "Usuario activo".
• Comportamental (OPEN): el contacto abre un email de la campaña «Spring_Sale_2026» o «VIP_Offers».
• Comportamental (CLICK): el contacto hace clic en un enlace etiquetado con pricing o upgrade en cualquier campaña.
• Comportamental (OPEN + Remitentes): el contacto abre un email enviado desde news@mail.example.com o offers@mail.example.com.
• Comportamental (CLICK + Campañas + Etiquetas): el contacto hace clic en un enlace etiquetado con shoes o sneakers en las campañas «Summer_Catalog» o «Back_To_School».
• Evento externo (Webhook): El contacto activa el evento externo purchase_completed.

Una vez que hayas configurado tu bloque de inicio para definir qué criterios debe cumplir tu audiencia para entrar en el flujo de trabajo, empezarás a diseñar el recorrido del cliente.

Envía automáticamente un email predefinido a los contactos cuando alcanzan esta etapa del workflow.

• Editar diseño: Personaliza el contenido de tu plantilla de email.
• Nombre de la campaña: Introduce un nombre para identificar tu campaña.
• Datos del webhook: La opción Usar datos del webhook permite que el bloque Enviar un email utilice los datos recibidos de un webhook entrante o de un evento externo. Esto permite personalizar el email con los valores enviados en el payload del webhook, y no solo con las propiedades de contacto estándar.

👉Ejemplo: Usar datos de un webhook

Imagina que tienes una tienda online. Cada vez que un cliente completa una compra, tu sitio web envía una solicitud HTTP POST al endpoint del webhook de Mailjet Workflows. Este evento activa la acción correspondiente en tu workflow de automatización.

El webhook envía este tipo de datos:

{
    "Tag": "purchase_completed",
    "contactMail": "localpart@domainpart.tld",
    "Data": {
        "Variables": {
            "firstname": "John",
            "product_name": "Running Shoes",
            "order_number": "ORD-45821",
            "delivery_date": "25 June",
            "discount_code": "THANKYOU10"
        }
    }
}

Tu automatización podría ser:

Evento externo/webhook recibido → Enviar un email

En el bloque Enviar un email, activa la opción Usar datos del webhook.

A continuación, en el contenido del bloque Enviar un email, puedes utilizar el lenguaje de plantillas de Mailjet (https://documentation.mailjet.com/hc/es/articles/16886347025947-Mailjet-Templating-Language) y, en concreto, las variables de tipo var. Los valores de sustitución de estas variables se envían mediante la llamada a https://api.mailjet.com/V3/REST/workflow2/event:

Hola {{var:firstname:""}},
Gracias por tu pedido {{var:order_number:""}}.
Has comprado: {{var:product_name:"tu artículo"}}
La fecha estimada de entrega es {{var:delivery_date:"próximamente"}}.
Aquí tienes un descuento para tu próximo pedido: {{var:discount_code:""}}

El destinatario recibiría:

Hola John,
Gracias por tu pedido ORD-45821.
Has comprado: Running Shoes.
La fecha estimada de entrega es 25 June.
Aquí tienes un descuento para tu próximo pedido: THANKYOU10

Sin la opción Usar datos del webhook, el email solo utilizaría los datos de contacto estándar ya almacenados en Mailjet, como las propiedades de contacto, que pueden recuperarse mediante variables de tipo data y no mediante variables de tipo var. El email no podría utilizar valores temporales del webhook, como el número de pedido, el nombre del producto o el código de descuento.

👉Definición del endpoint

Los eventos del webhook se envían al siguiente endpoint:

POST /v3/REST/workflow2/event

Campos del payload

Si el objeto Data se incluye en el payload del evento, los datos se almacenan temporalmente en el estado del workflow del contacto. Después, pueden utilizarse en un bloque Enviar un email posterior del mismo workflow.

Estos datos se eliminan del estado del workflow una vez utilizados o cuando el contacto sale del workflow.

Campos disponibles en el objeto Data

El objeto Data puede incluir campos compatibles con la API Send de Mailjet.

Ejemplo de payload

{ 
  "ContactMail": "john@example.com", 
  "Tag": "purchase_completed", 
  "Data": { 
    "Variables": { 
      "firstname": "John", 
      "product_name": "Running Shoes", 
      "order_number": "ORD-45821", 
      "delivery_date": "25 June", 
      "discount_code": "THANKYOU10"
    }, 
    "TrackOpens": "enabled", 
    "TrackClicks": "account_default", 
    "CustomID": "order-confirmation-ORD-45821" 
  } 
}

En este ejemplo:

• ContactMail identifica el contacto que debe entrar en el workflow.
• Tag define el nombre del evento utilizado para activar el workflow.
• Variables contiene valores temporales que pueden utilizarse en un bloque Enviar un email posterior.
• TrackOpens activa el seguimiento de aperturas para este mensaje.
• TrackClicks utiliza la configuración de seguimiento definida en la cuenta de Mailjet.
• CustomID añade un identificador personalizado al mensaje.

Para utilizar en el email los valores del objeto Variables, activa la opción Usar datos del webhook en el bloque Enviar un email.

A continuación, puedes hacer referencia a estas variables en la plantilla de email mediante el lenguaje de plantillas de Mailjet, por ejemplo:

Hola {{var:firstname:""}},
Gracias por tu pedido {{var:order_number:""}}.
Has comprado: {{var:product_name:"tu artículo"}}
La fecha estimada de entrega es {{var:delivery_date:"próximamente"}}.
Aquí tienes tu código de descuento: {{var:discount_code:""}}

Te permite gestionar tus contactos dentro de listas específicas:

• Suscribir a una lista: Añade y suscribe al contacto a una lista seleccionada.
• Añadir a una lista y volver a suscribir: Añade el contacto y vuelve a suscribirlo si ya está presente.
• Añadir a una lista sin suscribir: Añade el contacto sin alterar el estado de suscripción.
• Dar de baja de una lista: Elimina la suscripción del contacto de la lista seleccionada.
• Eliminar de una lista: Elimina completamente el contacto de la lista seleccionada.

Permite actualizar las propiedades existentes de tus contactos:

• Selecciona la propiedad del contacto que deseas actualizar de entre las disponibles (p. ej. edad, ciudad, cumpleaños...).
• Define el nuevo valor a aplicar.

Al utilizar el bloque de condiciones puedes evaluar el contacto según unos criterios para determinar en qué ruta del flujo de trabajo entrará seleccionando un segmento.

• Los criterios de la condición se establecen por segmentos o filtros personalizados.
• Los contactos que no cumplan ninguna condición pasarán por una ruta predeterminada "alternativa".

Ejemplo:

Se puede aplicar una condición para determinar si el contacto ha interaccionado recientemente creando un filtro con "Ha abierto un email en los últimos X días". Si el destinatario ha abierto un correo enviado en los últimos X días, saldrá del flujo de trabajo. Si no han abierto ninguno, recibirán un nuevo email.

El bloque de eventos espera a que se produzca un evento antes de que el contacto avance en el flujo de trabajo. Para configurar el bloque de eventos seleccionarás:

Tipos de eventos

• Suscripción a lista — añadido/suscrito a una lista.
• Actualización de propiedad de contacto — cambia un valor.
• Comportamental: OPEN — el contacto abre un email (se puede filtrar).

• Comportamental: CLICK — el contacto hace clic en un enlace (se puede filtrar).

  Para más detalles sobre los disparadores comportamentales, ve a la sección « Disparadores comportamentales » de este artículo.

• Evento externo (Webhook) — el flujo se pausa hasta que tu sistema envía un evento externo coincidente (calificador de webhook) para ese contacto.
  

  Para obtener más detalles sobre los webhooks, ve a la sección « Eventos externos (Webhooks) » de este artículo.

Configura el temporizador alternativo: Esto garantiza que un contacto nunca se quede atascado en el flujo de trabajo porque el evento nunca se produzca.

Este bloque te permite determinar cuándo pasará el contacto al siguiente paso del trayecto estableciendo un temporizador con retraso, un filtro de fecha personalizado o un temporizador con una propiedad de fecha.

• El temporizador con retraso te permite retrasar el siguiente paso del flujo de trabajo en minutos, horas o días.
• El temporizador de fecha personalizada retrasará el siguiente paso en función de una fecha establecida. Una vez seleccionada la fecha, determinarás si quieres que ocurra una sola vez, o que se repita anual o mensualmente.

• El temporizador con una propiedad de fecha te permite retrasar el siguiente paso en función de una fecha de propiedad del contacto. (p. ej. la fecha de cumpleaños).

Si quieres más precisión sobre cuándo se envía el email, los tres tipos de temporizador te permiten especificar a qué hora del día quieres que se envíe el correo y en qué días de la semana quieres que se envíe.

El bloque de salida representa el final de un flujo de trabajo para el contacto. Un flujo de trabajo puede tener muchos bloques de salida para cada ruta representada en el flujo de trabajo, y cada bloque de salida te permite determinar si se debe permitir que el contacto vuelva al flujo de trabajo si coincide de nuevo con los criterios de activación del bloque de salida.

👉 404 — El contacto no existe

Lo que verás

HTTP/2 404
content-type: application/json; charset=utf-8
{"Code":"","Message":"The requested resource does not exist","Status":404,"Details":null}

Significado
Mailjet no pudo encontrar el contacto referenciado en tu solicitud (por ejemplo, el email del contacto no está presente en los contactos de tu clave API).

Cómo solucionarlo

• Confirma que el contacto existe en tu audiencia de Mailjet antes de enviar el evento.

• Verifica que estás usando la cuenta / clave API correcta (donde está almacenado el contacto).

• Revisa cuidadosamente el valor enviado en contactMail (errores tipográficos, espacios extra, dominio incorrecto).

👉 204 — Mailjet recibió correctamente tu solicitud

Una respuesta 204 significa que Mailjet recibió correctamente tu solicitud, pero no devuelve un cuerpo de respuesta. Un 204 no indica de forma fiable si se activó una acción del flujo.

Lo que verás

HTTP/2 204

Significado

A) Solicitud recibida y se activó una acción del flujo

Esto ocurre cuando el evento coincide con todo lo que el flujo espera:

• el contacto existe y es identificable mediante contactMail

• el calificador del webhook (Tag) coincide con un calificador seleccionado en el bloque Inicio o Evento

• el contacto cumple cualquier filtro adicional del bloque Inicio/Evento (pertenencia a segmento, condiciones, etc.)

Qué hacer

• Revisa el avance del contacto en la UI de Automatización (p. ej., el contacto avanzó más allá del bloque Inicio/Evento o entró en el siguiente paso).

• Si el siguiente paso del flujo envía un email, confirma que el mensaje aparece en el historial/actividad del contacto.

B) Solicitud recibida, pero no se activó ninguna acción del flujo

Un 204 también puede ocurrir cuando la solicitud es válida pero no coincide con las condiciones de la automatización, por ejemplo:

• el calificador (Tag) no coincide con los calificadores seleccionados en el bloque

• el contacto no coincide con los filtros del flujo (segmento / condiciones)

• el contacto no es elegible para entrar/reentrar en el flujo debido a la configuración del flujo (por ejemplo, “Los contactos no pueden reentrar”)

• el contacto no está actualmente esperando en el bloque Evento específico que querías satisfacer

Qué hacer

• Verifica que la ortografía/mayúsculas coincida exactamente con lo configurado en el builder.

• Confirma que el contacto cumple el segmento/los filtros usados en el bloque Inicio/Evento.

• Confirma las reglas de entrada (reentrada) del flujo y dónde está actualmente el contacto dentro del flujo.

Recomendación: trata 204 como “aceptado” y verifica el resultado en la UI

Como 204 puede corresponder a ambos resultados anteriores, trátalo como solicitud aceptada y confirma el resultado revisando:

• la posición/progreso del contacto en el flujo

Verificar el resultado de un 204 vía API (endpoint Messages)

Como 204 No Content solo confirma que la solicitud fue aceptada (y no incluye un cuerpo de respuesta), puedes validar si el flujo realmente envió un email consultando el recurso Messages de Mailjet para ese contacto dentro de una ventana de tiempo definida.  (Para más detalles, consulta nuestra documentación para desarrolladores aquí.)

1) Consultar mensajes enviados a un contacto específico

Usa el ContactID del contacto y un timestamp de inicio:

GET https://api.mailjet.com/v3/REST/message?Contact=$ContactID&FromTS=2026-01-19T00:00:00

Cómo interpretar el resultado

• Mensajes devueltos (Count > 0 / el array Data contiene registros): el flujo activó el envío de un email para ese contacto dentro del periodo solicitado.

• No se devuelven mensajes (Count = 0 / Data vacío): o no se envió ningún email en ese rango de tiempo, o necesitas ampliar la ventana (o verificar que estás usando el ContactID/cuenta correctos).

Buenas prácticas

• Usa una ventana FromTS suficientemente amplia al probar (por ejemplo, empieza 15–60 minutos antes de tu llamada de prueba).

• Usa una zona horaria consistente en tus logs y timestamps (UTC recomendado).

2) Si no tienes el ContactID

Si tu sistema solo dispone de la dirección de email, recupera primero el ContactID (vía los recursos Contacts) y luego llama al endpoint Messages con el filtro Contact. Encuentra más información aquí.

3) Qué confirma esto (y qué no)

Esta comprobación confirma que existe un objeto de mensaje para ese contacto en el rango de tiempo. No prueba, por sí sola, qué bloque lo activó; así que al hacer troubleshooting, combínalo con:

• la progresión en la UI del flujo (posición del contacto en el flujo), y/o

• los logs de tu sistema (timestamp + calificador/tag enviado + request GUID).

👉 400 — Tag no válido (caracteres no compatibles, p. ej., usar “-”)

Lo que verás

HTTP/2 400
content-type: application/json; charset=utf-8
{"Code":"MJ-0001","Message":"invalid Tag: should contain only alphanumeric ASCII characters and underscores","Status":400,"Details":null}

Significado
El calificador del webhook (Tag) contiene caracteres no válidos. Los tags deben usar solo caracteres ASCII alfanuméricos y guiones bajos (por ejemplo: purchase_completed). No se permiten guiones (-).

Cómo solucionarlo

• Sustituye los guiones por guiones bajos:

  • purchase-completed → purchase_completed

• Estandariza una convención de nombres para los calificadores en tus sistemas (recomendado: minúsculas + guiones bajos).

👉 400 — Estructura de payload no válida (intento de enviar Tag como un array)

Lo que verás

HTTP/2 400
content-type: application/json; charset=utf-8
{"Code":"MJ-0001","Message":"error casting payload into associated model","Status":400,"Details":null}

Significado
El cuerpo de la solicitud no coincide con el esquema esperado. Tag debe ser una cadena única, no un array.

Cómo solucionarlo

• Envía un calificador por solicitud (un valor Tag).

• Si necesitas activar varios calificadores, envía varias llamadas a la API — una por calificador.

👉 400 — ContactMail no válido (formato de email no válido)

Lo que verás

HTTP/2 400
content-type: application/json; charset=utf-8
{"Code":"MJ-0001","Message":"invalid ContactMail: mail: missing '@' or angle-addr","Status":400,"Details":null}

Significado
contactMail no tiene un formato de email válido (por ejemplo, falta @).

Cómo solucionarlo

• Valida las direcciones de email en tu sistema antes de llamar al endpoint.

• Asegúrate de enviar una dirección de email simple (sin formato de nombre para mostrar), por ejemplo:

  • Válido: user@example.com

  • No válido: John Doe <user@example.com>

Con el generador de automatizaciones de Mailjet, puedes crear fácilmente flujos de trabajo que se activen en fechas recurrentes, ideales para cumpleaños, aniversarios de suscripción o recordatorios de renovación.

A continuación, te mostramos un ejemplo paso a paso para configurar un flujo de correo electrónico de cumpleaños:

Estructura del flujo de trabajo

El flujo consta de tres pasos principales:

1. Disparador: cuando se actualiza la fecha de cumpleaños del contacto.
2. Temporizador: esperar hasta la próxima ocurrencia anual del cumpleaños.
3. Acción: enviar un correo electrónico de cumpleaños.

1. Definir el disparador (actualización de propiedad del contacto)

Comienza creando un nuevo flujo de trabajo y selecciona el disparador "Actualización de propiedad del contacto".

• Establece el filtro de propiedad en cumpleaños (propiedad de tipo fecha y hora).
• Aplica un segmento: añade la condición "Está en la lista" y selecciona la lista de contactos que deseas utilizar (por ejemplo: MyFirstTest).

2. Añadir un temporizador (esperar hasta la siguiente fecha)

Añade un bloque Temporizador después del disparador.

• Selecciona la propiedad cumpleaños.
• Configúralo en "Activar en la próxima ocurrencia anual".

• Opcional: puedes especificar una hora del día, días de la semana o aplicar un retraso si es necesario.

3. Configurar el correo (Enviar correo)

Agrega un bloque Enviar correo después del temporizador.

• Crea tu plantilla de cumpleaños.
• Ejemplo de asunto: “🎂 ¡Feliz cumpleaños de parte de todo el equipo!”

4. Activar la repetición anual

Conecta el final del flujo de trabajo de nuevo al temporizador para que se repita cada año en el cumpleaños del contacto.

📝 Consejos

• Realiza pruebas con contactos ficticios para verificar el flujo.
• Puedes reutilizar esta configuración para otros eventos recurrentes como aniversarios, recordatorios de renovación o hitos de fidelidad.