Feeds de datos

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

• El saldo actual de recompensas de un usuario
• El estado más reciente del pedido
• Recomendaciones de productos personalizadas

​

Cómo funcionan los Feeds de datos

1. Crea un Feed de datos – Configura cómo OneSignal se conecta a tu API.
2. Adjunta el Feed de datos a una plantilla de mensaje.
3. Inserta campos de respuesta en tu mensaje usando sintaxis Liquid.
4. En el momento del envío, OneSignal hace una llamada a la API para cada destinatario, analiza la respuesta e inyecta los datos en tu mensaje.

​

Ejemplo: Mostrar puntos de recompensa

Hola {{ first_name }},

¡Tienes {{ data_feed.rewards.points }} puntos!
Tu estado de membresía es {{ data_feed.rewards.status_level }}.

¡Sigue comprando para ganar más puntos!

​

Crear y usar un Feed de datos

​

1. Configurar tu Feed de datos

• Name: Un nombre descriptivo como “Customer Rewards API” para ayudarte a distinguirlo en tu lista de feeds. Se recomienda que sean únicos, pero no es obligatorio.
• Alias: Un identificador corto como rewards que se usa en la sintaxis Liquid (p. ej., {{ data_feed.rewards.points }}). Debe ser único, en minúsculas, alfanumérico, sin espacios ni caracteres especiales.
• Method: El método HTTP que OneSignal usa para contactar tu API. Por lo general es GET, pero también se admite POST.
• URL: Tu endpoint de API. Admite sintaxis Liquid para que OneSignal pueda obtener datos específicos del usuario.

https://acme.com/customers/user_id={{ external_id }}/rewards

• Headers: Pares clave-valor requeridos por tu API (p. ej., tokens de autenticación). Admite sintaxis Liquid.
• Body: Cuerpo de solicitud JSON opcional. Admite sintaxis Liquid, igual que los webhooks de Journey.

{
	"customer_id": "{{ subscription.external_id }}"
}

​

2. Adjuntar el Feed de datos a tu plantilla de mensaje

1. Navega a Messages > Templates
2. En la sección Message, selecciona el botón Personalization

3. Activa Data Feeds y selecciona tu feed

4. Guarda tu plantilla

​

3. Usar los datos en tu mensaje

{
	"external_id": "a1-b2c3",
	"points": 193,
	"status_level": "Gold"
}

¡Tienes {{ data_feed.rewards.points }} puntos!
Tu estado de membresía es {{ data_feed.rewards.status_level }}.

• Usa un Feed de datos
• Usa el Feed de datos rewards
  • Recuerda: el feed rewards sabe llamar a la API con el external_id del destinatario
• De la respuesta, inserta el valor del elemento points (193) y el elemento status_level (Gold)

​

Requisitos y límites

• Aceptar autenticación de un solo paso con tokens de autenticación en encabezados
• Responder rápidamente. Se recomienda menos de 250ms (esto afecta directamente la velocidad de envío)
• Devolver JSON. Otros formatos no están soportados en este momento.
  • Si necesitas un formato diferente, comparte tu caso de uso.
• Manejar tu volumen de envío. Un límite de tasa bajo en tu API ralentiza la entrega de mensajes.
• Devolver cargas útiles de tamaño razonable. Mantén las respuestas por debajo de 50 KB para un mejor rendimiento.

• Un Feed de datos por plantilla. Obtén todo lo que necesitas en una sola respuesta de API.
• Una llamada API por Feed de datos por mensaje.
• Solo Journeys. Aún no disponible para otros métodos de envío.
• No se permiten llamadas encadenadas. La carga útil de un Feed de datos no puede usarse para llamar a otro.

​

Configurar tu API

​

Autenticación

Authorization: Bearer YOUR_TOKEN

X-API-Key: YOUR_KEY

​

Cuerpo de solicitud JSON

​

Respuesta JSON

​

Parámetros de personalización

https://api.example.com/users/{{external_id}}/data
https://api.example.com/rewards?email={{email | url_encode}}

{
	"customer_id": "{{ external_id }}",
	"email": "{{ subscription.email }}"
}

​

Límites de tasa

​

Manejo de errores

​

Lista de verificación para comenzar

• ¿Qué datos quiero mostrar en mi mensaje? Trabajar hacia atrás desde un esquema simple con los elementos que se poblarán desde tu API identificados te ayudará a organizar tu pensamiento.
• ¿Estos datos están disponibles a través de un único endpoint de API?
• ¿Cómo autenticaré las solicitudes de API?
• ¿Qué identificador u otro elemento de datos usaré para obtener datos personalizados?
• ¿Ese identificador ya está almacenado en OneSignal? Si no, ¿cómo se poblará?
• ¿Puede mi API manejar el volumen de solicitudes que generaré?
• ¿Qué sucede si mi API no tiene datos para un usuario?

​

Ejemplos y casos de uso avanzados

• Iterar con bucles: carrito abandonado
• Propiedades de eventos personalizados
• Visualización condicional: estado del pedido
• Automatización sin personalización
• Códigos de cupón personalizados

Digamos que tienes un Feed de datos cart que devuelve un array de artículos en el carrito del usuario, más el monto total del carrito en dólares:

{
  "items": [
    {
      "name": "Blue Running Shoes",
      "price": 84.00,
      "image_url": "https://acme.com/blue-running-shoes.png"
    },
    {
      "name": "Protein Bar",
      "price": 5.99,
      "image_url": "https://acme.com/protein-bar.png"
    }
  ],
  "total": 89.99
}

Si deseas mostrar cada artículo en el carrito, más el total del carrito, puedes usar un bucle for en Liquid:

<ul>
  {% for item in data_feed.cart.items %}
    <li>
      <strong>{{ item.name }}</strong><br>
      ${{ item.price }}<br>
      <img src="{{ item.image_url }}" alt="{{ item.name }}">
    </li>
  {% endfor %}
</ul>

<p>Total del carrito: ${{ data_feed.cart.total }}</p>

Esto resultará en:

- Blue Running Shoes
- $84.00
- <imagen de zapatos para correr>
- Protein Bar
- $5.99
- <imagen de barra de proteína>
Total del carrito: $89.99

Si estás usando el editor de bloques de correo electrónico, al insertar este tipo de sintaxis Liquid compleja, particularmente si necesitas incluir imágenes o enlaces, para mejores resultados usa el elemento de bloque HTML personalizado.

¿Quieres ver cómo activar este correo electrónico de carrito abandonado usando eventos personalizados? Consulta la pestaña Propiedades de eventos personalizados para el flujo de trabajo completo.

Continuando con el ejemplo anterior de carrito abandonado, ¿cómo podríamos saber cómo obtener ese carrito en particular en primer lugar?Un método podría ser crear un Journey activado por un evento personalizado cart_abandoned, donde las propiedades incluyen un cart_id. En este ejemplo, ese evento se está enviando a OneSignal a través de API:

curl --request POST \
  --url https://api.onesignal.com/apps/{app_id}/custom_events \
  --header 'Accept: application/json' \
  --data '{
  "events": [
    {
      "name": "cart_abandoned",
      "external_id": "user_12345",
      "properties": {
        "cart_id": 98765
      }
    }
  ]
}'

El usuario user_12345 entra al journey cuando se dispara este evento, luego llega a un nodo que envía un correo electrónico. Esa plantilla de correo electrónico está configurada con el Feed de datos cart, donde la URL está configurada para recuperar el contenido de un carrito en particular así:

https://acme.com/carts/{{ journey.event.cart_abandoned.data.cart_id }}

Por lo tanto, cuando este evento particular se ingiere y activa el Journey:

1. El valor cart_id de 98765 se almacenará en el Journey
2. Cuando se alcance el paso de correo electrónico, el Feed de datos cart hará referencia a ese valor cart_id y lo usará para llamar a la API del carrito
3. Las propiedades JSON devueltas se analizarán e insertarán en el correo electrónico como en el ejemplo anterior

¿Quieres ver cómo mostrar condicionalmente el contenido del Feed de datos según el estado del pedido? Consulta la pestaña Visualización condicional: estado del pedido para obtener más información.

Digamos que deseas incluir el estado del pedido de un cliente, pero solo incluir un enlace de número de seguimiento si el pedido ha sido enviado. Puedes usar una declaración if para hacerlo:

¡Tu pedido está {{data_feed.order.status}}!

{% if data_feed.order.tracking_number != empty %}
Rastréalo aquí: {{data_feed.order.tracking_url}}
{% endif %}

Aquí, el enlace de seguimiento solo se mostrará si el tracking_number existe.

Los Feeds de datos se pueden usar para insertar automáticamente información actualizada en tus mensajes sin necesariamente necesitar ser personalizada por destinatario.Por ejemplo, tal vez insertes una imagen de banner en la parte superior de tus correos electrónicos y la cambies mensualmente para mantenerte al día con las festividades y otros eventos mensuales. En lugar de recordar subir una nueva imagen a OneSignal y cambiar todas tus plantillas cada mes, podrías configurar un Feed de datos que obtenga la URL de la imagen de banner actual desde tu CMS u otra ubicación de gestión de activos.Configurarías un Feed de datos banner que apunte a un endpoint sin ninguna variable en la URL así:

https://acme.com/assets/email-banner

Que devuelve una respuesta con la URL del banner actual:

{
	"banner_url": "https://acme.com/assets/email-banner/2025july.png"
}

Configurarías tu plantilla de correo electrónico para usar {{ data_feed.banner.banner_url }} como la URL de fuente de imagen, automatizando este proceso en adelante.

Este ejemplo cubre cómo enviar códigos de cupón personalizados de un solo uso en correos electrónicos usando un Feed de datos que obtiene un valor único de tu API para cada destinatario.

​

Objetivo

Enviar un correo electrónico como:

Hola George, Completa tu reserva en las próximas 2 horas y ahorra 10% con tu código personal: XYZ123ABC

Cada usuario recibe un código de cupón único, generado en vivo a través de una llamada API externa cuando se envía el correo electrónico, válido para la ventana de tiempo dada y limitado a ese usuario.

​

Requisitos previos

• Canal de correo electrónico configurado en OneSignal (tu aplicación tiene la capacidad de correo electrónico habilitada)
• Una API externa que acepta un identificador de usuario (por ejemplo, external_id) e identificador de campaña, y devuelve JSON con el código de cupón, descuento y vencimiento
• Un identificador único (como external_id) para cada usuario que tu API pueda usar para generar cupones
• Un segmento o activador (por ejemplo, “búsqueda abandonada en las últimas 24h”) utilizado para enviar el correo electrónico a través de un Journey de OneSignal

​

Paso 1: Crear el Feed de datos

1

Navegar a Feeds de datos

En tu aplicación de OneSignal, selecciona Data feeds en la barra de navegación, luego haz clic en New data feed.

2

Configurar el Feed de datos

Configura los siguientes campos:

• Data Feed Name: coupon_code_generator
• Alias: coupon
• Method: GET
• URL: https://api.example.com/generate-coupon?userId={{ external_id }}&campaign=AbandonedBooking10
• Headers:
  {
    "Authorization": "Bearer YOUR_API_TOKEN"
  }
  

3

Referenciar la respuesta de la API

Cuando la API devuelve JSON como este:

{
  "code": "AB10-5F3K-HT9L",
  "discount_percent": "10%",
  "expires_in_hours": 2
}

Puedes referenciar sus valores en tu plantilla de correo electrónico como:

• {{ data_feed.coupon.code }}
• {{ data_feed.coupon.discount_percent }}
• {{ data_feed.coupon.expires_in_hours }}

4

Probar y activar el Feed de datos

Haz clic en Send Test para verificar tu configuración, luego haz clic en Activate para hacer que el Feed de datos esté disponible para usar en plantillas.

​

Paso 2: Crear la plantilla de correo electrónico

1. En OneSignal, ve a Messages → Email → New Template
2. Usa el alias del Feed de datos y los campos dentro del cuerpo de tu mensaje. Por ejemplo:

<h2>Hi {{ first_name }},</h2>
<p>
Complete your booking in the next {{ data_feed.coupon.expires_in_hours }} hours and save
{{ data_feed.coupon.discount_percent }} with your personal code:
<strong>{{ data_feed.coupon.code }}</strong>
</p>

<p><a href="https://example.com/checkout?coupon={{ data_feed.coupon.code }}">Use Code Now →</a></p>

• Usa la sintaxis Liquid en la forma {{ data_feed.<alias>.<field> }}
• Asegúrate de que el Feed de datos esté adjunto a la plantilla
• Si usas el editor de arrastrar y soltar con lógica Liquid personalizada, usa un bloque HTML

​

Paso 3: Adjuntar el Feed de datos y activar el correo electrónico

1. En el compositor de plantillas, bajo Personalization, activa Data Feeds y selecciona tu feed (coupon_code_generator)
2. Esto asegura que OneSignal haga la llamada a la API en el momento del envío para cada destinatario, complete los datos y los inyecte en el correo electrónico
3. Configura un Journey para automatizar el mensaje:
   • Condición de entrada: Segmento como “búsqueda abandonada en las últimas 24 horas”
   • Wait until: Crea un evento personalizado booking_completed. Configura la espera para salir del Journey si este evento se activa, o continuar después de 1 hora. Si completan una reserva, salen sin recibir el correo electrónico; de lo contrario, continúan para recibir el cupón.
   • Enviar correo electrónico: Usa la plantilla de correo electrónico de cupón personalizado
   • Asegúrate de que el Journey use el canal de correo electrónico y que los destinatarios estén suscritos al correo electrónico

​

Paso 4: Gestionar el canje y seguimiento de cupones

Tu backend debe:

1. Registrar cada código generado junto con userId, code, campaign, expiration_time, y una bandera redeemed
2. Validar y marcar los códigos como canjeados al momento del pago
3. Registrar los datos de canje (usuario, campaña y hora) para el análisis de ROI

​

Ejemplo de flujo de trabajo completo

Paso	Evento	Acción
1	El usuario activa el segmento “búsqueda abandonada”	El usuario ingresa al Journey a través del segmento
2	El Journey activa el envío de correo electrónico	OneSignal adjunta el Feed de datos, llama a tu API con el external_id del usuario y el nombre de la campaña
3	La API devuelve JSON	OneSignal completa los campos de cupón del feed de datos y envía el correo electrónico
4	El usuario recibe el correo electrónico	Ejemplo: “¡Hola George! Ahorra 10% con tu código personal: AB10-5F3K-HT9L”
5	El usuario canjea el código	El backend valida y registra el canje

​

Pruebas

• Prueba con un usuario que tenga un external_id conocido
• Llama a tu API manualmente para confirmar respuestas JSON correctas
• Usa Preview en el editor de plantillas de OneSignal para verificar que los campos de cupón del feed de datos se completen
• Verifica los registros de la API para detectar latencia y errores
• Si una llamada al Feed de datos falla, OneSignal omitirá el envío del mensaje a ese destinatario

​

Preguntas frecuentes

​

Los valores de mi Feed de datos no aparecen en el mensaje. ¿Qué debo verificar?

1. El Feed de datos está adjunto a la plantilla (en Personalization > Data Feeds).
2. Tu sintaxis Liquid coincide exactamente con la estructura de la respuesta JSON — {{ data_feed.<alias>.<field> }}.
3. El endpoint de la API devuelve JSON válido cuando se llama manualmente con los mismos identificadores.
4. El destinatario tiene el identificador requerido (p. ej., external_id) almacenado en OneSignal.

​

¿Por qué los mensajes se envían lentamente?

​

¿Por qué algunos destinatarios no reciben mensajes?

​

¿Puedo usar más de un Feed de datos en una plantilla?

​

¿Los Feeds de datos están disponibles para notificaciones push o SMS?

​

¿Qué sucede si mi API está caída cuando se envía el mensaje?

​

Páginas relacionadas