Saltar al contenido principal

​
Descripción general

En este tutorial, configurará un flujo de trabajo de reserva común:
  • Enviar un correo de confirmación de reserva después de que un usuario complete una reserva.
  • Enviar un correo de recuperación si un usuario comienza una reserva pero no la completa a tiempo.
Al final, tendrá:
  • Dos Eventos Personalizados (booking_started, booking_complete)
  • Un Journey que se ramifica según la finalización vs el abandono
  • Un Data Feed de reserva para detalles de confirmación
  • Un Data Feed de cupón opcional para incentivos de recuperación
Esta guía se centra en configurar OneSignal. Su sistema de reservas y backend se pueden implementar en cualquier lenguaje o framework.

​
Flujo de configuración

  1. Su aplicación rastrea un evento personalizado booking_started.
  2. Esto ingresa al usuario en un Journey.
  3. El Journey espera un evento booking_complete y si no se recibe a tiempo, envía recordatorios de seguimiento.
  4. Si la reserva se completa, OneSignal llama a un Data Feed de reserva al momento del envío y envía un correo de confirmación con los últimos detalles de la reserva.
  5. Si la reserva no se completa dentro de la ventana de espera, el Journey sigue la ruta de expiración y envía un correo de recuperación.

​
Configuración

​
Requisitos previos

Antes de comenzar, asegúrese de tener:
  • Una aplicación OneSignal con el canal de Email habilitado
  • Un endpoint backend que pueda devolver datos de reserva y/o cupón como JSON
  • Un identificador de usuario estable compartido entre su aplicación, backend y ID Externo de OneSignal
  • Acceso a Eventos Personalizados

​
1. Rastrear eventos de reserva

Rastree los siguientes Eventos Personalizados. Estos pueden ser desde su aplicación (usando nuestro SDK) o desde su backend (usando nuestra API REST). Nombres de eventos:
  • booking_started — cuando el usuario comienza el flujo de reserva
  • booking_complete — cuando la reserva se completa exitosamente
Use el método trackEvent() en nuestro SDK Móvil y/o SDK Web para enviar eventos personalizados directamente desde su aplicación/sitio web.
Ejemplo
OneSignal.User.trackEvent("booking_started");
OneSignal.User.trackEvent("booking_complete");
Use la misma identidad de usuario al rastrear eventos y al devolver datos desde su backend. Los IDs que no coinciden son la causa más común de personalización faltante.

​
2. Crear alias de Data Feed

En OneSignal, vaya a Configuraciones > Data Feeds y cree los siguientes alias. Data Feed de Reserva: Use este feed para obtener los últimos detalles de la reserva al momento del envío.
  • Alias: booking_data
  • Método: GET
  • URL:
Ejemplo de endpoint
https://your-domain.com/datafeed/booking?user_id={{subscription.external_id}}
Ejemplo de respuesta:
JSON
{
  "first_name": "Sam",
  "last_booking": {
    "service_type": "Consultation",
    "booking_date": "January 22, 2026",
    "booking_time": "2:00 PM",
    "price": 45
  }
}
Data Feed de Cupón (opcional): Use este feed opcional si desea incluir un código de cupón en su correo de recuperación.
  • Alias: coupon
  • Método: GET
  • URL:
Ejemplo de endpoint
https://your-domain.com/datafeed/coupon?user_id={{subscription.external_id}}
Ejemplo de respuesta:
JSON
{
  "first_name": "Sam",
  "code": "PROMO8F3K2",
  "discount_text": "10%",
  "expires_in_hours": 2,
  "deep_link": "https://your-domain.com/checkout?coupon=PROMO8F3K2"
}
Asegure sus endpoints de Data Feed. En producción, envíe una clave API en los headers de solicitud (por ejemplo x-api-key) y configure ese header en Configuraciones > Data Feeds en lugar de incrustar secretos en la URL.

​
3. Crear plantillas de email

​
Email de confirmación de reserva:

Asunto: 
Sus detalles de reserva
Cuerpo: 
Hola {{ data_feed.booking_data.first_name | default: "cliente" }},

¡Gracias por su reserva! Aquí están los detalles de su cita:

Servicio: {{ data_feed.booking_data.last_booking.service_type }}
Fecha: {{ data_feed.booking_data.last_booking.booking_date }}
Hora: {{ data_feed.booking_data.last_booking.booking_time }}
Precio: ${{ data_feed.booking_data.last_booking.price }}

¡Esperamos verle!

​
Email de recuperación de reserva

Asunto: 
Complete su reserva y ahorre
Cuerpo: 
Hola {{ data_feed.coupon.first_name | default: "cliente" }},

Termine su reserva en las próximas {{ data_feed.coupon.expires_in_hours }} horas y ahorre
{{ data_feed.coupon.discount_text }} con este código:

{{ data_feed.coupon.code }}

Úselo aquí:
{{ data_feed.coupon.deep_link }}
Siempre incluya filtros default en Liquid para prevenir contenido en blanco si falta un campo del Data Feed.

​
4. Construir el Journey

  1. En OneSignal, vaya a Mensajes > Journeys > Crear Journey
  2. Configure el Trigger de Entrada como:
    • Evento Personalizado: booking_started
  3. Agregue un paso Esperar Hasta:
    • Condición: Ocurre Evento Personalizado
    • Nombre del evento: booking_complete
    • Tiempo máximo de espera: 10 minutos
    • Habilite la ruta de expiración
  4. Configure las ramas:
    • Completado: Enviar email de confirmación de reserva
      • Data Feed: booking_data
    • Expirado: Enviar email de recuperación
      • Data Feed: coupon
La rama de expiración le permite manejar el abandono sin lógica adicional en su aplicación. Vea:

​
5. Probar y verificar

​
Verificar eventos

Dispare los eventos personalizados desde su aplicación o backend y confirme. En OneSignal, vaya a Analytics > Eventos Personalizados y confirme que ve:
  • Eventos booking_started aparecen para su ID Externo
  • Eventos booking_complete aparecen para su ID Externo

​
Verificar Data Feeds

Llame manualmente a sus endpoints de Data Feed usando un ID de usuario conocido y confirme:
  • Se devuelve una respuesta 200
  • Todos los campos esperados están presentes

​
Verificar emails

Envíe mensajes de prueba desde el editor de Journey y confirme:
  • Los emails de reserva contienen detalles de reserva reales
  • Los emails de recuperación contienen un cupón válido
  • Ninguna variable de Liquid se renderiza vacía
Si falta personalización, confirme que el ID de usuario en la solicitud del Data Feed coincide con el usuario que disparó el Journey.

​
Ejemplo: Implementación de Data Feed

Este ejemplo muestra una implementación mínima de Express para Data Feeds de confirmación de reserva y recuperación. Su lenguaje backend, framework y fuente de datos pueden diferir siempre que la forma de respuesta JSON coincida con sus plantillas de email.

​
Ejemplo de Data Feed de Reserva

import express from "express";

const app = express();

function dataFeedAuth(req, res, next) {
  if (req.headers["x-api-key"] !== process.env.DATAFEED_API_KEY) {
    return res.status(401).json({ error: "Unauthorized" });
  }
  next();
}

app.get("/datafeed/booking", dataFeedAuth, async (req, res) => {
  const { user_id } = req.query;

  if (!user_id) {
    return res.status(400).json({ error: "Missing user_id" });
  }

  const booking = await getLatestBookingForUser(user_id);

  if (!booking) {
    return res.status(404).json({ error: "No booking found" });
  }

  res.json({
    first_name: booking.first_name,
    last_booking: {
      service_type: booking.service_type,
      booking_date: booking.booking_date,
      booking_time: booking.booking_time,
      price: booking.price
    }
  });
});

​
Ejemplo de Data Feed de Cupón

app.get("/datafeed/coupon", dataFeedAuth, async (req, res) => {
  const { user_id } = req.query;

  if (!user_id) {
    return res.status(400).json({ error: "Missing user_id" });
  }

  const coupon = await generateCouponForUser(user_id);

  res.json({
    first_name: coupon.first_name,
    code: coupon.code,
    discount_text: coupon.discount_text,
    expires_in_hours: coupon.expires_in_hours,
    deep_link: coupon.deep_link
  });
});

​
Pautas de implementación

  • Mantenga las respuestas rápidas (los Data Feeds se llaman al momento del envío)
  • Siempre devuelva una estructura JSON predecible
  • Use 404 cuando no existan datos
  • Asegure endpoints con una clave API enviada vía headers de solicitud

​
Problemas comunes

​
El email muestra valores vacíos

  • El Data Feed devolvió 404
  • Los nombres de campo cambiaron en la respuesta JSON
  • Discrepancia de identidad de usuario

​
El Journey no se ramifica

  • Evento booking_complete no rastreado
  • Discrepancia de nombre de evento (sensible a mayúsculas)
  • El evento ocurre fuera de la ventana de espera

​
El Data Feed devuelve 401 o 403

  • Clave API faltante o inválida
  • Header no configurado en las configuraciones del Data Feed

​
Próximos pasos

  • Agregar propiedades de evento (tipo de servicio, precio) para condiciones de Journey más avanzadas
  • Agregar pasos de recuperación adicionales como recordatorios push o SMS
  • Usar reglas de salida de Journey para prevenir mensajes de recuperación repetidos