Cómo funciona la generación de plantillas dinámicas en Buqipi

La generación de plantillas dinámicas en Buqipi te permite crear mensajes automáticos (como emails o SMS) totalmente personalizados para cada reserva.
Solo tienes que escribir tu texto con etiquetas entre corchetes [[...]], y Buqipi las reemplazará por la información real del cliente, la reserva o la habitación.

🧩 Cómo funciona paso a paso

Reemplazo de datos de la reserva y del cliente
- Buqipi busca las etiquetas como [[bookingId]], [[arrivalDate]] o [[crmName]] y las sustituye automáticamente por la información correspondiente.
- Si un dato no existe, la etiqueta se reemplaza por un texto vacío (no se mostrará nada).
Actualización automática del total
- Si el total de la reserva no coincide con la suma de las habitaciones, el sistema calcula el importe correcto y lo muestra en [[totalPrice]].
Inserción de políticas y términos
- Si tu plantilla incluye etiquetas como [[policySummary]] o [[termsHtml]], Buqipi añadirá automáticamente las condiciones de reserva y políticas de cancelación de cada categoría.
- Estas políticas se muestran en el idioma del cliente si está disponible.
Repetición por habitación (bloques dinámicos)
- Puedes incluir un bloque que se repite automáticamente por cada habitación activa de la reserva usando:
```
[[activeRoomsLoop]] ... aquí el contenido repetido ... [[/activeRoomsLoop]]
```
- Dentro de ese bloque puedes usar etiquetas como [[roomName]], [[guestFirstName]] o [[roomPrice]], y se reemplazarán con la información de cada habitación.
Combina información general y específica
- Puedes usar tanto datos generales ([[totalPrice]], [[arrivalDate]]) como datos por habitación ([[roomName]], [[roomPrice]]) en una misma plantilla.

💡 Buenas prácticas al crear tus plantillas

Usa los bloques [[activeRoomsLoop]] y [[/activeRoomsLoop]] siempre en pareja.
Si quieres mostrar políticas o términos por habitación, colócalos dentro del bloque de habitaciones ([[roomPolicySummary]], [[roomTermsHtml]]).
Si quieres mostrar políticas o términos generales, colócalos fuera del bloque ([[policySummary]], [[termsHtml]]).
Las etiquetas que no tengan información disponible se reemplazan por un espacio vacío, por lo que no estropearán el diseño del mensaje.
Puedes usar HTML en el texto (por ejemplo, para dar formato o agregar enlaces).

✨ Ejemplo práctico

Plantilla de ejemplo

Hola [[crmName]],  
Gracias por tu reserva [[bookingId]] del [[arrivalDate]] al [[departureDate]].  

[[activeRoomsLoop]] -> aquí empieza el bloque de repetición

- Habitación: [[roomName]] (Categoría [[categoryName]])   
Huésped: [[guestFirstName]] [[guestLastName]]   
Importe: [[roomPrice]]
 
[[/activeRoomsLoop]]  -> Fin del bloque de repetición

Importe total: [[totalPrice]]  
Política de cancelación: [[policySummary]]  
Términos y condiciones: [[termsHtml]]  

Gracias por elegirnos, El equipo de Buqipi

Qué hace Buqipi:

Sustituye las etiquetas por los datos reales del cliente y la reserva.
Repite el bloque por cada habitación activa.
Inserta las políticas y términos correspondientes.
Calcula automáticamente el total si es necesario.

🔖 Listado de etiquetas disponibles

🏨 Datos de la reserva

Etiqueta	Significado	Ejemplo de uso
[[bookingId]]	Número o identificador único de la reserva.	“Tu reserva #12345 ha sido confirmada.”
[[arrivalDate]]	Fecha de llegada del huésped.	“Llegada: 2025-11-15”
[[departureDate]]	Fecha de salida del huésped.	“Salida: 2025-11-25”
[[bookedAt]]	Fecha en la que se realizó la reserva.	“Reservado el 2025-11-02”
[[bookingStatus]]	Estado actual de la reserva (confirmada, cancelada, modificada…).	“Estado: Confirmada”
[[totalPrice]]	Precio total de la reserva (automáticamente calculado si hay varias habitaciones).	“Total: 250,00 €”

👤 Datos del cliente

Etiqueta	Significado	Ejemplo de uso
[[crmName]]	Nombre del cliente.	“Hola Juan,”
[[crmSurname]]	Apellido del cliente.	“Sr. Pérez”
[[crmEmail]]	Dirección de correo electrónico.	“Te enviaremos la confirmación a [email protected]”
[[crmPhone]]	Teléfono de contacto.	“Teléfono: +34 600 123 456”
[[crmAddress]]	Dirección del cliente.	“Calle Mayor 25”
[[crmCity]]	Ciudad del cliente.	“Ciudad: Madrid”
[[crmState]]	Provincia o estado.	“Provincia: Madrid”
[[crmCountry]]	País del cliente.	“País: España”
[[crmLanguage]]	Idioma preferido del cliente.	“Idioma: español”
[[crmCompanyName]]	Nombre de la empresa (si la reserva es corporativa).	“Empresa: Tech Solutions S.L.”
[[crmCompanyVat]]	Número de IVA o CIF de la empresa.	“CIF: B12345678”

🛏️ Datos por habitación (dentro del bloque `[[activeRoomsLoop]]`)

Etiqueta	Significado	Ejemplo de uso
[[roomName]]	Nombre o número de la habitación.	“Habitación 1234”
[[categoryName]]	Categoría o tipo de habitación.	“Categoría: Suite Junior”
[[rateName]]	Nombre de la tarifa aplicada.	“Tarifa: No reembolsable”
[[mealPlan]]	Régimen alimenticio (solo alojamiento, media pensión, todo incluido...).	“Régimen: Desayuno incluido”
[[arrivalDate]]	Fecha de llegada para esa habitación.	“Entrada: 2025-11-15”
[[departureDate]]	Fecha de salida para esa habitación.	“Salida: 2025-11-25”
[[roomPrice]]	Importe total de esa habitación.	“Precio: 120,00”
[[guestFirstName]]	Nombre del huésped principal asignado a la habitación.	“Huésped: María”
[[guestLastName]]	Apellido del huésped principal.	“Huésped: María López”
[[roomPolicySummary]]	Resumen de la política de cancelación o condiciones específicas de esa categoría.	“Cancelación gratuita hasta 48 h antes.”
[[roomTermsHtml]]	Texto completo de los términos y condiciones para esa categoría (puede incluir formato HTML).	“El cliente acepta las condiciones del alojamiento...”