Paquete de bienvenida — bienvenida de check-in en varios pasos

El paquete de bienvenida es lo que tu huésped ve en cuanto llega su reservación. En lugar de un solo mensaje de "bienvenida", puedes crear una secuencia ordenada de mensajes de WhatsApp, cada uno con su propia plantilla y su propio retraso, que va soltando la información poco a poco para no abrumar al huésped.

Una estructura común: saludar a la llegada, compartir el WiFi 30 segundos después, mandar una guía local 5 minutos después y ofrecer un upsell 30 minutos después. Cada paso se edita por separado, se puede reordenar, desactivar sin borrarlo y previsualizar con datos de un huésped de ejemplo.

Dónde encontrarlo

Comms → Arrival message (Mensaje de llegada) en la barra lateral. La página es por propiedad: elige la propiedad en la barra lateral y se carga su paquete. La línea de estado de arriba te dice si el mensaje de llegada se va a enviar o no, y el editor del paquete de bienvenida está debajo.

Crear un paso

Cada paso tiene cuatro cosas por definir:

1. Plantilla — elige del catálogo de plantillas de Meta ya aprobadas. La v1 incluye:
   • Check-in welcome (image header) — tarjeta de saludo con tu marca, imagen y un botón de check-in. Ideal como Paso 1.
   • Hotel check-in (text only) — un seguimiento más ligero, sin imagen.
   • Info card with CTA — encabezado + cuerpo + botón. Úsala para WiFi, guías locales y upsells.
2. Momento de envío — Inmediato, +30s, +2m, +5m, +30m, +1h o un número de segundos personalizado. El Paso 1 normalmente va inmediato; los siguientes se escalonan.
3. Campos variables — cada plantilla tiene sus propios campos (nombre del huésped, línea del cuerpo, URL de la imagen, etc.). Escribe {{ en cualquier campo para insertar un token (ver abajo).
4. Interruptor de activación — desactiva un paso sin perder lo que escribiste.

Usa los botones ↑ / ↓ para reordenar. Duplicate copia un paso (útil cuando usas la misma plantilla dos veces con distinto tiempo). Send this step only envía solo ese paso a un teléfono para revisarlo.

Tokens — datos del huésped, del listado y de la reservación

Los tokens insertan valores reales en tu texto al momento del envío. Usan la sintaxis {{namespace.field}}. Escribe {{ en cualquier campo de texto y aparece un menú de autocompletado agrupado por namespace:

• guest.* — first_name, last_name, full_name, phone_last4
• listing.* — hotel_name, title, address, welcome_image_url, thumbnail_url, wifi_ssid, wifi_password
• reservation.* — check_in_date, check_out_date, nights
• system.* — arrival_token (el valor del botón de URL; Meta lo concatena con el prefijo de URL registrado), now_local

Los tokens distinguen mayúsculas y minúsculas y deben ser exactos: {{guest.first_name}}, no {{Guest.firstName}}. Los tokens desconocidos se muestran como texto vacío (y se registra una advertencia en el servidor).

Ejemplo de cuerpo: Hola {{guest.first_name}}, ¡bienvenido a {{listing.hotel_name}}! Tu habitación está lista. Al enviarse: Hola Andrea, ¡bienvenido a KAN Hotel Tulum! Tu habitación está lista.

Para incluir llaves literales, escápalas con una diagonal invertida: \{{guest.first_name}} se muestra como el texto literal {{guest.first_name}}.

Vista previa en vivo

El panel derecho apila cada paso activo como una burbuja de WhatsApp, en el orden en que llegarán. Cada burbuja tiene una franja de tiempo ("+0s", "+30s", "+5m") para que veas de un vistazo cómo se sentirá la conversación. Cualquier cambio actualiza la vista previa en unos 250 ms, útil para afinar los textos.

Enviar una prueba

Haz clic en Send test package en la barra inferior fija. Escribe un número de teléfono (con código de país), activa Compress delays si quieres que todos los pasos lleguen en unos segundos (en lugar de esperar los tiempos reales) y envía. Los resultados de cada paso van apareciendo: enviado / fallido, más el ID del mensaje de WhatsApp para rastrearlo.

La prueba hace llamadas reales a la API de Meta, pero usa un token de llegada sintético para que el botón de URL no lleve a ningún lugar dañino. Tiene un límite de 5 envíos por listado cada 5 minutos para evitar ciclos.

Cómo se envía de verdad a la llegada

Cuando una reservación real pasa a arrived (llegó):

1. La sincronización de Cloudbeds emite un evento de llegada
2. El manejador de llegadas identifica el listado y al huésped principal
3. El Paso 1 se envía de inmediato; los siguientes pasos se programan en el cron de WordPress según su retraso
4. Cada ejecución del cron vuelve a cargar el paquete, así que se respetan los cambios que hagas mientras tanto
5. La idempotencia por paso evita envíos duplicados si el evento de llegada se dispara dos veces

Si un campo obligatorio de un paso está vacío (por ejemplo, no hay imagen de bienvenida), ese paso se omite con una línea en el registro; el resto del paquete sí se envía.

Migración desde el mensaje de bienvenida único

La primera vez que guardas un paquete en un listado, los campos del mensaje de bienvenida anterior (cuerpo, línea final) se retiran y se convierten en el Paso 1 de tu nuevo paquete. Los listados que todavía no has tocado siguen usando el mensaje único anterior; no hay un día de corte, migras conforme vas creando.

Buenas prácticas

• El Paso 1 debe ser inmediato y llevar imagen: es la burbuja que el huésped nota, y Meta exige una imagen de encabezado en la plantilla principal guest_check_in.
• No apiles tres tarjetas informativas en +0s: llegan al mismo tiempo y forman un muro de texto. Escalónalas por 30 s o más para que cada una tenga su momento.
• Usa {{system.arrival_token}} para los botones de URL: cualquier otra cosa no pasa la validación de sufijo de URL de Meta. El editor lo hace cumplir con una lista de tokens permitidos.
• Prueba primero con los retrasos comprimidos: confirma en segundos que la cadena funciona. Luego envía una prueba sin comprimir para sentir el ritmo.
• Deja la línea de bienvenida en una sola línea: en WhatsApp la gente lee por encima. Usa la línea del botón para la acción.

Lo que no incluye la v1

• Pasos que se disparan por eventos (cuando el huésped responde, se conecta al WiFi, etc.); por ahora solo retrasos por tiempo
• Paquetes globales predeterminados que hereden los listados; solo por listado
• Mensajes posteriores a la estancia o promocionales; en la v1 es estrictamente la ventana de llegada
• Paquetes en varios idiomas; el idioma se define por huésped según su configuración regional

Si alguna de estas funciones te abriría un flujo de trabajo, coméntalo durante el onboarding y le daremos prioridad.