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.
Nota: Utiliza la última versión de API soportada para Eventos Personalizados. La API v3 y la API v5 están obsoletas. No inicies nuevas integraciones utilizando ninguna de las versiones.
Si tu integración personalizada utiliza su propia clave de API para llamar a API v3 o v5, Omnisend puede mostrar una advertencia en tu cuenta.Sigue la guía de migración para actualizar tu integración.La API v5 se cerrará el 30 de junio de 2027.
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 flujo de trabajo para un tipo diferente de acción, necesitarás usar un Evento Personalizado.
Los Eventos Personalizados pueden ser:
Creado manualmente a través de API, o
Agregado automáticamente a través de la integración con una aplicación de terceros.
Si no has trabajado con APIs antes, recomendamos encarecidamente involucrar a un desarrollador para ayudar a configurar Eventos Personalizados.
La documentación de API explica cómo funciona la integración, pero un desarrollador está mejor equipado para implementarlo correctamente utilizando los detalles técnicos proporcionados.
Los eventos personalizados solo aparecen en el menú desplegable de disparadores 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.
4e1 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 de vuelta en stock– Activa el flujo cuando un artículo de la lista de deseos está de vuelta en stock.
Campos personalizados: detalles del producto.
Junip: Reseña creada Activa el flujo de trabajo cuando se envía una revisión de producto.
Campos personalizados: información del producto, enlace de envío de revisión.
Crea 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. Accede a Eventos Personalizados.
Navega a Ajustes de la Tienda → API → Eventos personalizados → Haz clic en Crear evento personalizado para comenzar.
Paso 2. Configura 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 la última versión como la versión de referencia de la API;
Navega 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 de API al Encabezado.
En la documentación de la API, selecciona Encabezado y pega tu Clave de API en el campo Encabezado.
Paso 5. Completa los Parámetros del Cuerpo.
Sigue el asistente para ingresar los detalles del evento requeridos:
Contacto Debes incluir al menos un identificador de contacto: una dirección de correo electrónico o un número de teléfono de un contacto que deseas pasar con el evento.
También puedes incluir datos adicionales como dirección, etiquetas, fecha de nacimiento, o propiedades personalizadas. Estos 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 de trabajo (ver la estructura de ejemplo a continuación).
Una vez completado, haz clic en Prueba para crear el evento.
Paso 6. Prueba tu evento.
Verifica 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.
4A1 Dispara un evento de prueba:
Usa el POST /events endpoint para activar el evento manualmente. Esto lo hace aparecer en los disparadores de automatización.
Notas Importantes:
Para editar un Evento Personalizado, debes eliminar el evento existente y crear uno nuevo utilizando la documentación de API.
Desactivar un Evento Personalizado detendrá su funcionamiento, y cualquier automatización que lo use como disparador será descontinuada.
Rehabilitar un Evento Personalizado no no reactivará automáticamente el flujo asociado. Debes 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 pueden ser utilizados en filtros de flujo de trabajo, 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 pase a Omnisend, puedes revisar las propiedades del evento sincronizadas yendo a Configuración 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 las propiedades son etiquetas internas utilizadas para hacer referencia a los datos en automatizaciones y personalización de mensajes.
Los nombres de las propiedades no pueden ser cambiados 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 al enviar 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 soportado para los campos de propiedades es cadena.
4e1 Recomendamos consultar a tu 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 de Trabajo.
Ve a Automatizaciones Crear flujo de trabajo Crear desde cero.
En el menú desplegable de disparadores, encuentra tu Evento Personalizado.
Paso 2: Configurar la configuración del Flujo.
Una vez que agregues el disparador de Evento Personalizado, todas las configuraciones del flujo se poblarán con datos del evento:
Filtro de disparador – Filtrar por valores de campo personalizado (estas son las propiedades del evento que definiste a través de API).
Bloque de división – Ramas de flujos basadas 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 del 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 usar 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 obligatorio 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 de Flujo de Trabajo haciendo clic en el bloque de disparador y ajustando las preferencias.
Resolución de problemas
Problema 1: El evento personalizado no aparece en el menú desplegable de disparadores de automatización.
Esto es esperado 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 disparadores de automatización.
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 provienen del lado del remitente, no de Omnisend.
Para resolver esto, ve a Configuración de la tienda → API → Registros de API y revisa los errores 400.
4e1 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:
Usa 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, consulta el artículo Integrar Shopify Flow con Omnisend.
Problema 4: El evento estaba funcionando, pero 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 disparador.
Revisa los registros de la API en Ajustes de la Tienda API registros de la API para errores recientes o solicitudes fallidas.
FAQ
¿Por qué la documentación de la API los llama "propiedades del 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 del Evento?
Contacto propiedades personalizadasse 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 del contacto y pueden ser reutilizados 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 del evento, como filtrar por nombre de producto, puntuación de reseña o total del pedido dentro de flujos 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?
Usa la última versión de API soportada que se muestra en la documentación actual de API.La API v3 y la API v5 están obsoletas.
¿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 a través del chat en la aplicación.