
El informe semanal: totales del hogar, tu propia semana y la clasificación.
Una solicitud por hogar, personalizada para cada persona \
La función envía una solicitud por hogar. Pasa todos los datos encustom_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
email-templates/weekly-report.html
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 \
Elcustom_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 depg_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. Concustom_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.
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.