Integración con Cloudbeds
HiLucy tiene una integración profunda y nativa con Cloudbeds — uno de los principales Sistemas de Gestión de Propiedades para hoteles y alquileres vacacionales.
HiLucy solo lee de Cloudbeds. Las reservas, los datos de los huéspedes y las asignaciones de habitación van en un solo sentido, de Cloudbeds a HiLucy. Nada de lo que hagas en HiLucy crea, cambia ni cancela algo en Cloudbeds, así que Cloudbeds sigue siendo tu fuente de verdad: haz los cambios de reservas ahí y llegan a HiLucy en la siguiente sincronización.
Qué se Sincroniza
| Datos | Dirección | Frecuencia |
|---|---|---|
| Reservas | Cloudbeds → HiLucy | Cada 15 minutos, incremental |
| Detalles del huésped | Cloudbeds → HiLucy | Con cada sincronización de reservas |
| Asignaciones de habitación/unidad | Cloudbeds → HiLucy | Con cada sincronización de reservas |
| Estado de check-in/check-out | Cloudbeds → HiLucy | En tiempo real vía webhook |
Pasos de Configuración
1. Abrir la página de Cloudbeds
En tu panel de administración de HiLucy, ve a Settings → Integrations (Configuración → Integraciones) y haz clic en Manage junto a Cloudbeds (o ve directamente a /admin/settings/cloudbeds). Selecciona la propiedad en la barra lateral para ver su configuración de Cloudbeds.
No hay un botón "Conectar Cloudbeds". Te conectas introduciendo credenciales.
2. Introducir tus Credenciales
En la tarjeta Webhook & credentials:
- API key — Haz clic en editar, pega tu API key de Cloudbeds y guarda
- Property ID — Haz clic en editar, introduce el ID de propiedad de Cloudbeds para esta propiedad de HiLucy y guarda
- Webhook URL — Copia la URL que se muestra y pégala en Cloudbeds para que pueda enviar actualizaciones en vivo a HiLucy
Cada propiedad de HiLucy se vincula a un ID de propiedad de Cloudbeds.
3. Probar y Sincronizar
Usa los botones de la tarjeta Connection:
- Test connection — Comprueba que HiLucy puede llegar a Cloudbeds con estas credenciales
- Force sync — Trae las reservas ahora en lugar de esperar a la siguiente sincronización programada
- Disconnect & re-auth — Desconecta esta propiedad y abre Cloudbeds para que vuelvas a autorizar. Úsalo cuando la conexión deje de funcionar.
4. Verificar
Abre Guests (Huéspedes, en la sección Operations de la barra lateral). Ahí aparecen las reservas de Cloudbeds en HiLucy, y las llegadas del día también salen en Arrivals (Llegadas). Deberías ver tus reservas de Cloudbeds con:
- Nombres e información de contacto de los huéspedes
- Fechas y asignaciones de habitación
- Estado de la reserva
Sistema de Escritura Dual
La "escritura dual" se refiere al almacenamiento interno de HiLucy, no a Cloudbeds. Cuando HiLucy lee una reserva de Cloudbeds, la guarda en dos lugares dentro de HiLucy:
- Las reservas se escriben tanto en la tabla de sincronización legacy de HiLucy como en sus nuevas tablas normalizadas
- Esto asegura compatibilidad hacia atrás mientras habilita nuevas funciones
- El sistema gestiona los conflictos automáticamente
- No se escribe nada de vuelta en Cloudbeds. Si editas en HiLucy la habitación o el precio de una reserva de Cloudbeds, la siguiente sincronización puede sobrescribirlo, así que haz los cambios definitivos en Cloudbeds
Monitoreo
La sincronización se ejecuta cada 15 minutos mediante cron de WordPress, y es incremental: cada ejecución solo obtiene las reservas que cambiaron desde la última ejecución, así que la mayoría de los ciclos son rápidos y tocan apenas un puñado de registros. Un barrido completo periódico se ejecuta como red de seguridad para captar cualquier cosa que la ventana incremental pudiera pasar por alto. La sincronización solo registra cuando hay cambios (synced > 0, updated > 0, o errors > 0), manteniendo limpio tu registro de depuración.
Solución de Problemas
¿Las reservas no se sincronizan?
- Abre la página de Cloudbeds y haz clic en Test connection
- Comprueba que la API key y el Property ID sean correctos
- Revisa la tarjeta Sync activity en busca de errores y luego prueba Force sync
- Si la conexión sigue fallando, usa Disconnect & re-auth
¿Falta información de contacto del huésped?
Algunas reservas de OTAs (por ejemplo, Booking.com) no comparten el correo electrónico/teléfono del huésped. Estos huéspedes se sincronizarán sin información de contacto hasta que la proporcionen directamente.