Event Streams

• Eventos de mensajes push (enviados, recibidos, clicados, fallidos, cancelación de suscripción)
• Eventos de email (enviados, abiertos, clicados, rebotados, cancelación de suscripción, etc.)
• Eventos de SMS (enviados, fallidos, cancelación de suscripción, etc.)
• Eventos de mensajes in-app (impresión, clicados, etc.)
• Eventos de Live Activity (enviados, entregados, entrega confirmada, fallidos, cancelación de suscripción, clicados)

​

Casos de uso comunes

• Centralizar datos de participación — Transmite eventos a un CRM, CDP o almacén de datos para que la actividad multicanal (aperturas, clics, rebotes) esté en un solo lugar en lugar de distribuida entre herramientas desconectadas.
• Análisis, informes y cumplimiento — Almacena cada evento de mensaje en un almacén para análisis de tendencias, auditoría o conservación de registros normativos.
• Monitorear la desvinculación — Rastrea cancelaciones de suscripción, rebotes y descartes en tus propios sistemas para detectar riesgos de retención temprano.
• Activar flujos de trabajo externos — Dispara automatizaciones en otras herramientas cuando un usuario abre o hace clic en un mensaje (p. ej., actualizar una puntuación de leads, iniciar una secuencia de seguimiento).
• Reemplazar sincronizaciones por lotes e integraciones adicionales — Reacciona a eventos en tiempo real y conecta OneSignal directamente a tu destino, reduciendo herramientas intermediarias y costos de mantenimiento.

​

Cómo poner en marcha a tu equipo técnico

1. Decidir sobre un destino y alcance — Acordar dónde deben llegar los eventos (tu propia API, un almacén de datos, un CDP, etc.), qué tipos de eventos transmitir (push, email, SMS, IAM, Live Activity) y una estimación del volumen de mensajes para que el endpoint tenga el tamaño adecuado.
2. Configurar un endpoint HTTP — Construir o configurar un endpoint públicamente accesible que acepte solicitudes POST. Debe registrar eventos rápidamente sin procesamiento pesado para mantener los tiempos de respuesta bajos. Consulta Reintentos / Deshabilitación para las expectativas de rendimiento y lo que sucede cuando el endpoint se queda atrás.
3. Configurar el Event Stream en OneSignal — En Datos > Event Streams, selecciona eventos, establece la URL y los encabezados de autenticación, y define el cuerpo JSON usando los campos de Datos de Event Streams con sintaxis Liquid.
4. Probar de extremo a extremo — Usa webhook.site para verificar la forma del payload y los encabezados antes de cambiar a tu endpoint de producción (consulta Pruebas).

​

Configuración

• Una URL o dirección IP válida para un endpoint HTTP(S) públicamente accesible
• Las URLs y direcciones IP deben ser enrutables públicamente
• Los dominios deben incluir un dominio de nivel superior reconocido (por ejemplo, “.com”, “.net”)

​

Selección de eventos

​

Filtros de event stream

​

Configurar el Event Stream

​

Encabezados de autenticación

• Encabezado de autorización: Agrega un encabezado Authorization, donde YOUR_TOKEN es proporcionado por tu sistema o un tercero como:
  • Basic {{YOUR_TOKEN}}
  • Bearer {{YOUR_TOKEN}}
  • ApiKey {{YOUR_API_KEY}}
• Encabezados personalizados: También puedes agregar encabezados personalizados como:
  • X-API-Key: {{YOUR_API_KEY}}

​

Probando tu configuración

​

Encabezados no permitidos

• content-length
• referer
• metadata-flavor
• x-google-metadata-request
• host
• x-onesignal*

​

Cuerpo

​

Personalización

​

Ejemplo de cuerpo

{
  "Event Data": {
    "event.kind": "{{ event.kind }}",
    "event.id": "{{ event.id }}",
    "event.timestamp": "{{ event.timestamp }}",
    "event.datetime": "{{ event.datetime }}",
    "event.app_id": "{{ event.app_id }}",
    "event.subscription_device_type": "{{ event.subscription_device_type }}",
    "event.subscription_id": "{{ event.subscription_id }}",
    "event.onesignal_id": "{{ event.onesignal_id }}",
    "event.external_id": "{{ event.external_id }}",
    "event.data.page_name": "{{ event.data.page_name}}",
    "event.data.page_id": "{{ event.data.page_id}}",
    "event.data.target_name": "{{ event.data.target_name}}",
    "event.data.target_id": "{{ event.data.target_id}}",
    "event.data.failure_reason": "{{ event.data.failure_reason}}"
  },
  "Message Data": {
    "message.id": "{{ message.id }}",
    "message.name": "{{ message.name }}",
    "message.title": "{{ message.title.en }}",
    "message.contents": "{{ message.contents.en }}",
    "message.template_id": "{{ message.template_id }}",
    "message.url": "{{ message.url }}",
    "message.app_url": "{{ message.app_url }}",
    "message.web_url": "{{ message.web_url }}"
  }
}

​

Usando Sintaxis Liquid en JSON

• Cadenas → Deben envolverse en comillas.
• Números → No envolver en comillas.
• Objetos → No deben envolverse en comillas.

{
  "user_id": "{{ user.onesignal_id }}"
}

{
  "user_id": {{ user.onesignal_id }}
}

{
  "user_score": {{ user.tags.score }}
}

{
  "user_score": "{{ user.tags.score }}"
}

{
  "user_data": {{ user.tags }}
}

{
  "user_data": "{{ user.tags }}"
}

1. Usa verificaciones directas de idioma: Siempre verifica user.language directamente en los condicionales, no en variables como userLang, para mejor compatibilidad.
2. Comienza simple: Empieza con frases básicas, luego agrega complejidad gradualmente.
3. Evita el anidamiento excesivo: Mantén los condicionales planos para prevenir problemas de análisis.
4. Prueba la puntuación básica primero: Comienza con oraciones simples y puntuación antes de usar caracteres especiales.
5. Usa respaldos: Asegura un idioma predeterminado (por ejemplo, inglés) en caso de traducciones faltantes.
6. Apégate a claves estándar: Usa claves estándar de OneSignal como content/title/en para confiabilidad.

​

Resultados y depuración

​

Reintentos / Deshabilitación

1. Los administradores de la aplicación y la organización reciben un correo electrónico cuando el volumen de fallos se vuelve significativo (antes de deshabilitar) y nuevamente cuando el stream se deshabilita.
2. También aparece un banner en la página de índice de Event Streams en el panel.
3. Soluciona el problema subyacente, prueba con la pestaña Registros o webhook.site y vuelve a habilitar el stream.

• Registra eventos rápidamente — Escribe el evento entrante en una cola o almacén de datos sin procesamiento inline pesado.
• Evita respuestas lentas y 429s — Los tiempos de respuesta consistentemente lentos o las respuestas de límite de tasa hacen que los eventos se acumulen, lo que lleva a OneSignal a deshabilitar el stream.
• Dimensiona para tu volumen de envío — Si envías 100k mensajes, espera hasta 100k eventos por tipo de evento seleccionado. Revisa el volumen de mensajes de tu plan y aprovisiona en consecuencia.

​

Consejos para el éxito

• Apunta los streams a tus propios servidores primero. Puedes conectarte directamente a una API de terceros, pero el depurado, el manejo de límites de tasa y la gestión de volumen son más difíciles cuando no controlas el extremo receptor.
• Almacena en búfer antes de enviar a terceros. OneSignal envía eventos tan rápido como los usuarios los activan — un envío grande puede producir una ráfaga que abruma los límites de tasa externos o aumenta los costos (especialmente con proveedores de SMS). Construye un servicio ligero que acepte eventos, los ponga en cola y los reenvíe a APIs externas a un ritmo que controles.
• Consulta los documentos de la API de terceros. Muchos servicios exponen APIs HTTP públicas a las que puedes apuntar con un event stream. Busca sus documentos sobre autenticación, formato de payload aceptado y límites de tasa antes de configurar tu stream.

​

Limitaciones de datos de eventos de mensajes

​

Pruebas

• Host: la dirección IP de donde provino la solicitud. Consulta Descripción general de la API REST para una lista de IPs posibles.
• Request Content los datos enviados dentro del cuerpo del event stream.