Saltar al contenido principal
Esta página forma parte de App de ejemplo: una integración completa de OneSignal, que sigue una app real de principio a fin. La app es Clean Beans, un turno de limpieza para hogares compartidos, creada con Expo (React Native) y un backend de Supabase. Cada domingo, cada hogar recibe un email que resume su semana: sesiones, tareas, minutos, una clasificación y las cifras de cada persona.
El email del informe semanal de Clean Beans

El informe semanal: totales del hogar, tu propia semana y la clasificación.

El problema interesante es la personalización. Todas las personas de un hogar ven la misma clasificación, pero cada una debería ver su propio nombre y sus estadísticas. Enviar una solicitud por persona funcionaría, pero hay una forma mejor.

Una solicitud por hogar, personalizada para cada persona \

La función envía una solicitud por hogar. Pasa todos los datos en custom_data, incluido un objeto users indexado por External ID. Después, la plantilla selecciona la entrada correcta para la persona para la que se está generando.
supabase/functions/weekly-report/index.ts
En la plantilla, una línea de Liquid selecciona los datos del destinatario actual.
email-templates/weekly-report.html
A partir de ahí, user contiene las estadísticas de esta persona, y todo lo que se lee directamente de message.custom_data es compartido por el hogar.
email-templates/weekly-report.html
El segundo ejemplo de Liquid está simplificado a partir de la plantilla para mostrar la lógica sin el marcado de la tabla.

Mantenerse dentro del límite de tamaño \

El custom_data para email está limitado a 10 KB. Un hogar grande podría superarlo, así que la función mide el payload y recorta la clasificación si es necesario.
supabase/functions/weekly-report/index.ts

Programación y preferencias \

Una programación semanal llama a la función cada domingo a las 09:00 UTC, con el mismo patrón de pg_cron que los recordatorios push y la expresión 0 9 * * 0. Solo se incluyen los usuarios que tienen activado Weekly Email Summary. Configuración del panel. En Mensajes > Plantillas, crea una plantilla de email, pega el HTML y copia el ID de la plantilla en los secretos de tu backend. custom_data solo funciona con una plantilla, así que template_id es obligatorio.

La alternativa: Data Feeds \

Hay una segunda forma de incluir datos por persona en un email, y Clean Beans decidió no usarla. Merece la pena entenderla, porque para algunas apps es la opción más adecuada. Con custom_data, tu backend envía los datos a OneSignal cuando hace el envío. Con un Data Feed, OneSignal obtiene los datos de tu API en el momento en que se envía cada email. El envío en sí lo inicia un Journey, no tu backend.
Los ejemplos de esta subsección son ilustrativos. Muestran cómo se habría creado el informe semanal con un Data Feed. No están tomados de la app.
Así es como habría funcionado el informe semanal.
1

Exponer un endpoint que devuelva la semana de una persona

Una función del backend recibe un ID de usuario y devuelve las estadísticas de ese usuario y la clasificación de su hogar en JSON.
Response from your API
2

Crear el Data Feed en el panel

En Configuración > Data feeds, asigna un alias al feed y apúntalo al endpoint. La URL y las cabeceras aceptan Liquid, así que se puede pasar el External ID del destinatario.
Data Feed configuration
3

Adjuntar el feed a la plantilla de email y leer de él

En la plantilla, los valores proceden de data_feed, seguido del alias.
Email template
4

Enviarlo desde un Journey recurrente

Un Journey con una franja horaria del domingo por la mañana como primer paso, y una regla de reentrada, envía la plantilla cada semana. No hay código de programación ni de envío en tu backend.

Cuál usar \

Elige custom_data cuando tu backend ya es quien decide enviar. Ese es el caso del informe semanal. El backend se ejecuta de forma programada, sabe qué hogares han dado su consentimiento y tiene todas las cifras a mano, así que pasar los datos no cuesta nada más. Una solicitud cubre todo un hogar, no hay ningún endpoint que proteger y un fallo aparece en tus propios registros. El precio es que el momento y la audiencia viven en el código, y el payload tiene un límite de tamaño fijo. Elige un Data Feed cuando el envío pertenece a un Journey. Un Journey decide por sí mismo cuándo enviar un mensaje a alguien, días después de un evento o una vez que se cumple una condición de espera, y tu backend no está ahí para aportar los datos en ese momento. Un Data Feed cubre ese hueco, y permite que quienes gestionan la mensajería cambien la programación, añadan una rama o prueben variantes sin un despliegue. El precio es que se llama a tu API una vez por destinatario y debería responder en aproximadamente un cuarto de segundo, cada plantilla solo puede usar un feed y una llamada fallida significa que esa persona no recibe nada, sin aviso. Para Clean Beans, los factores decisivos fueron sencillos. El backend ya tenía los datos y la programación, la clasificación la comparte un hogar, así que una solicitud es mucho más barata que una llamada por persona, y las preferencias se guardan en la base de datos de la app, donde el backend puede comprobarlas directamente.

Personalizar con custom_data

Límites de tamaño y patrones de acceso con Liquid.

Data feeds

Incorpora datos en tiempo real a emails y SMS de Journeys.

Usar la sintaxis Liquid

Filtros, bucles y condiciones.