Los eventos personalizados activan flujos de trabajo de automatización a través de la API y pasan datos adicionales para la personalización. Cada evento puede incluir campos personalizados, como números de seguimiento, detalles del producto o enlaces de revisión, para su uso en el contenido del flujo.
Mientras que los desencadenantes estándar (como Pedido Realizado o Carrito abandonado) cubren eventos comunes, los Eventos Personalizados te permiten automatizar acciones únicas como revisión enviada o tarjeta de regalo creada que van más allá de los desencadenantes integrados de Omnisend.
Antes de empezar
Cuando integras tu tienda con Omnisend, un conjunto de eventos estándar se vuelve disponible, incluyendo Suscrito a Marketing, Pedido Realizado y Carrito abandonado. Si deseas activar un Evento Personalizado para un tipo diferente de acción, necesitarás usarlo.
Los Eventos Personalizados pueden ser:
Creado manualmente a través de la API, o;
Agregado automáticamente a través de la integración con una aplicación de terceros.
Omnisend soporta y recomienda usar solo la API v5 para Eventos Personalizados. Las versiones anteriores, como la v3, siguen siendo funcionales pero ya no están soportadas activamente.
Si no has trabajado con APIs antes, recomendamos encarecidamente involucrar a un desarrollador para ayudar a configurar Eventos Personalizados.
La documentación de la API explica cómo funciona la integración, pero un desarrollador está mejor preparado para implementarla correctamente utilizando los detalles técnicos proporcionados.
Los eventos personalizados solo aparecen en el menú desplegable de triggers de automatización después de que se hayan activado al menos una vez.
Los eventos personalizados requieren un contacto identificado (correo electrónico o número de teléfono) para funcionar. Los visitantes anónimos devolverán un error 400.
🔁 Ejemplos de Eventos Personalizados Agregados por Herramientas de Terceros
AfterShip: Información Recibida– Activa el flujo cuando un pedido es enviado.
Campos personalizados: número de seguimiento, URL de seguimiento.
Intercom: Reseña Creada– Activa el flujo cuando un contacto deja un comentario para un agente de soporte.
Campos personalizados: calificación, contenido de la reseña.
Growave: Lista de deseos Back in Stock– Activa el flujo cuando un artículo de la lista de deseos está de nuevo en stock.
Campos personalizados: detalles del producto.
Junip: Reseña Creada– Activa el flujo cuando se envía una revisión del producto.
Campos personalizados: información del producto, enlace para enviar reseñas.
Crear un Evento Personalizado
Para que el evento personalizado comience a funcionar, necesitarás añadirlo a tu cuenta de Omnisend y configurarlo en el lado del tercero.
Paso 1. Acceder a Eventos Personalizados.
Navega a Ajustes de la Tienda → API → Eventos personalizados → Haz clic en Crear evento personalizado para comenzar.
Paso 2. Configurar a través de la documentación de la API.
Serás redirigido a la documentación de la API, donde tu desarrollador puede completar la configuración y crear el Evento Personalizado. Aquí, necesitas:
Selecciona v5 como la versión de referencia de API;
Navegar a API de Eventos → Eventos → Enviar evento del Cliente.
Paso 3. Copia la Clave API.
Ve a Configuración de la Tienda → API → Crear clave API y copia tu Clave API.
Paso 4. Agrega la Clave API al Encabezado.
En la documentación de la API, selecciona Encabezado y pega tu Clave API en el campo Encabezado.
Paso 5. Completar los Parámetros del Cuerpo.
Sigue el asistente para ingresar los detalles requeridos del evento:
Contacto – Debes incluir al menos un identificador de contacto: una dirección de correo electrónico o número de teléfono de un contacto con el que deseas pasar el evento.
También puedes incluir datos adicionales como dirección, etiquetas, fecha de nacimiento, o propiedades personalizadas. Estas se almacenan en el perfil del contacto y persisten con el tiempo.
ID del evento – Por ejemplo,
60ba330da4a60c8ed682c5bd:Nombre del evento – Por ejemplo,
Revisión enviada;Hora del evento -Opcional. Si se usa, debe ser una fecha pasada o presente. Las fechas futuras harán que el evento falle.
Versión del evento - Opcional. Puede dejarse vacío para Eventos Personalizados.
Origen - Esto debe siempre estar configurado como
"api"Propiedades (opcional) – Agrega cualquier dato adicional para personalizar tu flujo (ver la estructura de ejemplo a continuación.
Una vez completado, haz clic en Prueba para crear el evento.
Paso 6. Prueba tu Evento.
Verificar la creación del evento:
Verifica un código de estado 200 en la respuesta de la API después de hacer clic en "Probar".
Ve a Ajustes de la Tienda → API → Eventos personalizados para confirmar que el evento aparece en tu lista.
Si encuentras errores, revisa Ajustes de la Tienda → API → registros de la API para más detalles.
💡 Disparar un evento de prueba:
Utiliza el POST /events endpoint para activar el evento manualmente. Esto hace que aparezca en los triggers de automatización.
Notas Importantes:
Para editar un Evento Personalizado, debes eliminar el evento existente y crear uno nuevo utilizando la documentación de la API.
Desactivar un Evento Personalizado detendrá su funcionamiento, y cualquier automatización que lo use como un trigger será descontinuada.
Rehabilitar un Evento Personalizado no no reactivar automáticamente el flujo asociado. Debe volver a habilitar la automatización manualmente.
Eliminar la clave API creada para el Evento Personalizado hará que tu evento falle.
Agregar Propiedades del Evento
Propiedades(también etiquetadas como campos personalizados en Omnisend)pasa datos adicionales con cada evento (por ejemplo, nombre del producto, URL de seguimiento, calificación de la reseña). Estos datos se pueden utilizar en filtros de flujo, condiciones de división y personalización de mensajes.
Para agregar Propiedades del Evento, ve a Propiedades → Objeto de Propiedades. Ingresa el nombre de la propiedad y su valor. Para incluir propiedades adicionales, haz clic en Agregar campo, luego ingresa el siguiente nombre de propiedad y su valor.
Una vez que tu evento personalizado se haya pasado a Omnisend, puedes revisar las propiedades del evento sincronizado yendo a Ajustes de la Tienda → API → Eventos personalizados.
Haz clic en el nombre del evento para ver los campos personalizados asociados.
Nota: Una vez que el evento personalizado se sincroniza con Omnisend, las propiedades del evento aparecen en la interfaz como campos personalizados. Estos términos se refieren a los mismos datos; la única diferencia es la etiqueta utilizada, dependiendo de si los estás viendo en la documentación de la API o dentro de Omnisend.
Notas Importantes:
Los nombres de propiedad son etiquetas internas utilizadas para hacer referencia a los datos en automatizaciones y personalización de mensajes.
Los nombres de las propiedades no se pueden cambiar después de que se crea el evento. Para actualizar un nombre de propiedad, elimina y vuelve a crear el evento.
Los valores de las propiedades pueden cambiar con el tiempo enviando nuevos eventos con valores actualizados.
Ejemplo: Si un contacto deja una reseña de 1 estrella, envía un evento con
reviewType: "1 estrella". Si luego lo actualizan a 2 estrellas, envía un nuevo evento conreviewType: "2 estrellas".
No puedes pasar múltiples valores en una sola propiedad (por ejemplo,
"1 estrella, 2 estrellas"). Envía un evento por cada cambio de valor.El único tipo de valor admitido para los campos de propiedad es cadena.
💡 Recomendamos consultar a su desarrollador o proveedor de integración de terceros para determinar el formato de datos correcto para cada campo personalizado.
Usar Eventos Personalizados en Automatización
Paso 1: Crea un flujo.
Ve a Automatizaciones → Crear flujo → Crear desde cero.
En el menú desplegable de trigger, encuentra tu Evento Personalizado.
Paso 2: Configura la configuración del flujo.
Una vez que agregues el trigger de Evento Personalizado, todas las configuraciones del flujo se llenarán con datos del evento:
Filtro de disparador – Filtrar por valores de campo personalizado (estas son las propiedades de evento que definiste a través de la API).
Bloque de división – Ramifica flujos de trabajo basados en campos personalizados.
Paso 3: Personalizar el Contenido del Mensaje
Puedes usar los datos de campos personalizados para personalizar el contenido de tus mensajes, incluyendo Correo electrónico, SMS y Notificaciones Push.
Si estás pasando un enlace como una propiedad de evento, también puedes usarlo con un botón en tu correo electrónico.
Usar Enlace de Cancelación de Suscripción en Automatización
Al utilizar un Evento Personalizado para activar un flujo de automatización, el bloque de contenido del pie de página incluye un enlace de cancelación de suscripción por defecto.
Recomendamos incluir este enlace en todos los mensajes. Sin embargo, no es necesario si el mensaje es transaccional (por ejemplo, relacionado con un pedido que el cliente realizó).
Importante: Flujos de trabajo de automatización desencadenados por Eventos Personalizados enviará mensajes a contactos no suscritos por defecto. Si no quieres enviar mensajes a contactos no suscritos, actualiza el Configuraciones del Canal del Flujo haciendo clic en el bloque del trigger y ajustando las preferencias.
Resolución de problemas
Problema 1: El evento personalizado no aparece en el menú desplegable de triggers de automatización.
Esto es de esperar ya que los eventos aparecen en la lista de disparadores de automatización solo después de haber sido activados al menos una vez.
Utiliza el POST /events endpoint para activar el evento manualmente. Esto hace que aparezca en los desencadenadores de automatización.
Ejemplo de llamada a la API (v5):
POST https://api.omnisend.com/v5/events
Headers:
X-API-KEY: your-api-key
Content-Type: application/json
Body:
{
"origin": "api",
"email": "[email protected]",
"eventName": "Product Back in Stock",
"fields": {
"productName": "Blue Widget",
"productURL": "https://yourstore.com/products/blue-widget"
}
}
Problema 2: Obtener un error 400 al activar el evento.
Un error 400 indica un problema relacionado con la carga útil, lo que significa que la solicitud enviada a Omnisend es inválida. Estos errores se originan del lado del remitente, no de Omnisend.
Para resolver esto, ve a Ajustes de la Tienda → API → registros de la API y revisa los errores 400.
💡 Puedes usar el filtro desplegable para mostrar solo errores de nivel 400.
Problema 3: campos personalizados de Shopify Flow no aparecen.
Shopify Flow utiliza un endpoint y una estructura JSON diferentes de la API estándar de Omnisend, por lo que los campos personalizados pueden no aparecer como se esperaba.
Para resolver esto:
Utiliza la sintaxis de variable de plantilla
##{{}}al mapear campos en las acciones de Shopify Flow.Asegúrate de que los nombres de los campos coincidan exactamente como se definen en Ajustes de la Tienda → API → Eventos personalizados (son sensibles a mayúsculas y minúsculas).
Ten en cuenta: los eventos de Shopify Flow no aparecen en los registros de la API en Omnisend, ya que este es un comportamiento esperado.
Para obtener instrucciones completas de configuración, consulte el artículo Integrar Shopify Flow con Omnisend.
Problema 4: El evento funcionaba, ahora no se activa.
Si tu evento deja de activarse repentinamente:
Ve a Ajustes de la Tienda → API → Eventos personalizados para verificar si el evento sigue habilitado.
Si el evento fue eliminado, necesitarás recrearlo y actualizar cualquier flujo de trabajo que lo use como un trigger.
Revisa los registros de la API bajo Ajustes de la Tienda → API → registros de la API para errores recientes o solicitudes fallidas.
Preguntas Frecuentes
¿Por qué la documentación de la API los llama "propiedades de evento" pero Omnisend los llama "campos personalizados"?
Esta es una diferencia de terminología entre la documentación de la API y la interfaz de Omnisend. Cuando creas propiedades de evento en la documentación de la API, se sincronizan con Omnisend y se muestran como campos personalizados en los flujos de trabajo de automatización, activadores, divisiones y personalización de mensajes. Ambos términos se refieren a los mismos datos: la información adicional pasada con cada evento personalizado.
¿Cuál es la diferencia entre las Propiedades Personalizadas de Contacto y las Propiedades de Evento?
Las propiedades personalizadas de Contactose almacenan en el perfil del contacto y persisten con el tiempo. Se pasan utilizando el
objeto customProperties dentro delbloque del objeto de contacto en la carga útil del evento. Estos valores son visibles en el perfil de contacto y se pueden reutilizar en campañas, automatizaciones y segmentación.Las propiedades del evento, por otro lado, se pasan en el
bloque de propiedades del evento. Están vinculadas solo al evento que se activó, etiquetadas como campos personalizados, y no persisten en el perfil del contacto. Estos son útiles para condiciones específicas de eventos, como filtrar por nombre de producto, puntuación de reseña o total de pedido dentro de flujos de trabajo de automatización.
¿Puedo editar los nombres de las propiedades del evento después de crear un evento?
No. Los nombres de las propiedades no se pueden cambiar una vez que se ha creado el evento. Si necesitas renombrar una propiedad, deberás eliminar el evento existente y crear uno nuevo con el nombre de propiedad actualizado.
Nota: Eliminar un evento activo desactivará cualquier flujo de trabajo que lo use como un trigger.
¿Qué versión de API debo usar para Eventos Personalizados – v3 o v5?
Usa v5: https://api.omnisend.com/v5/events e incluye "origin": "api" en el cuerpo de tu solicitud.
Si bien los eventos creados en la interfaz son compatibles con v3 y v5, v5 es el estándar actual y recomendado para todas las nuevas implementaciones.
¿Puedo pasar URLs en las propiedades del evento?
Sí. Las URLs se pueden pasar como valores de cadena en las propiedades del evento. Pueden ser utilizados en filtros de automatización, condiciones de división, reglas de segmentación, o directamente en el contenido del mensaje utilizando variables de personalización como [[event.referralLink]].
Para obtener más ayuda con eventos personalizados, no dudes en contactarnos en [email protected] o en el chat de la aplicación.