Cloudbeds

Cloudbeds es una plataforma hotelera en la nube que reúne PMS, channel manager y motor de reservas. Conectada a Bookline, el asistente consulta la disponibilidad y las tarifas de tu propiedad directamente en Cloudbeds cada vez que un huésped pregunta, y le envía un enlace a tu motor de reservas con las fechas y la ocupación ya rellenadas para que termine la reserva.

Funcionalidades

Función	Compatibilidad
Disponibilidad en tiempo real	✅
Precio por noche de las habitaciones disponibles	✅
Enlace al motor de reservas con fechas y huéspedes	✅
Crear la reserva desde el asistente	❌
Modificar o cancelar una reserva	❌
Datos de la reserva del huésped	❌
Solicitud de reserva de grupo	✅

La reserva se completa siempre en tu motor de reservas de Cloudbeds, así que el pago, las políticas y la confirmación siguen siendo los que ya tienes configurados allí.

Qué necesitas

• Una cuenta de Cloudbeds con acceso a la API.
• El ID de propiedad: el número que identifica tu alojamiento en Cloudbeds. Lo verás en la barra de direcciones al entrar en tu propiedad (hotels.cloudbeds.com/connect/<ID>).
• Una clave API con el permiso read:room. Se crea desde la propia cuenta de Cloudbeds; te lo explicamos a continuación.
• La URL de tu motor de reservas de Cloudbeds, la página donde tus clientes reservan online.

Crear la clave API en Cloudbeds

Estos pasos resumen la guía oficial de Cloudbeds. Necesitas un usuario con permisos de administrador en la propiedad.

1. Entra en Cloudbeds y abre Account → Apps & Marketplace.
2. En el menú superior, ve a API Credentials y pulsa + New Credentials.
3. Rellena el formulario:
   • Name: Bookline.
   • Category: la que mejor encaje (por ejemplo, Guest communication).
   • Redirect URI: https://localhost. No se usa con claves API, pero el campo es obligatorio.
   • Si gestionas varias propiedades y quieres una sola clave para todas, marca Enable for entire organization.
4. Guarda. Cloudbeds te mostrará un Client ID y un Shared Secret: ciérralos sin más, no los necesitamos.
5. En la tabla de credenciales, desplázate a la derecha hasta la columna API Key y pulsa Create en la fila que acabas de crear.
6. En la lista de permisos marca read:room y pulsa Create. Es el único permiso que necesita Bookline: solo leemos disponibilidad y tarifas, nunca escribimos en tu PMS.
7. Si marcaste Enable for entire organization, elige ahora las propiedades a las que aplica la clave.
8. Cloudbeds te pedirá tu contraseña para aprobar los permisos y te mostrará la clave (empieza por cbat_).

Precaución

La clave solo se muestra una vez. Cópiala antes de cerrar la ventana; si la pierdes tendrás que borrarla y crear otra.

Conectar Cloudbeds en el portal de Bookline

1. En el portal, entra en Mercado y busca Cloudbeds PMS. Pulsa Instalar.
2. Rellena el formulario:
   • Nombre: cómo quieres ver esta conexión en el portal (por ejemplo, el nombre del hotel).
   • ID de propiedad: el número de tu propiedad en Cloudbeds.
   • Clave API: la clave que acabas de crear.
3. Guarda. Bookline comprueba la conexión con una consulta de disponibilidad; si la clave o el ID no son correctos, lo verás en ese momento.
4. Abre tu asistente de alojamiento y, en la funcionalidad de reservas, selecciona la integración de Cloudbeds e indica la URL base del motor de reservas (la página de reservas online de tu Cloudbeds). Sin esa URL el asistente no puede enviar el enlace de reserva.

Si gestionas varias propiedades, crea una conexión por propiedad, cada una con su ID. Puedes reutilizar la misma clave si la creaste para toda la organización.

Cómo funciona en una conversación

Cuando un huésped pregunta por una estancia, el asistente recoge las fechas, el número de habitaciones y los huéspedes (adultos y niños), consulta Cloudbeds y responde con la disponibilidad y el precio por noche. Si hay disponibilidad, le envía el enlace a tu motor de reservas con esos datos ya puestos para que complete la reserva.

• El precio es el que Cloudbeds devuelve para esas fechas y esa ocupación, dividido por el número de noches. Incluye los suplementos por huésped adicional que tengas configurados.
• Si el asistente puede dar un rango, usa la habitación más barata y la más cara disponibles.
• Para grupos o peticiones que no encajan en una reserva estándar, el asistente registra una solicitud y la recibes como el resto de solicitudes de grupo.

Preguntas frecuentes

¿Caduca la clave API?

No, mientras se use al menos una vez cada 30 días. El asistente la usa en cada consulta de disponibilidad, así que en un alojamiento con actividad no caduca. Si la propiedad está cerrada por temporada más de un mes, puede que tengas que crear una clave nueva al reabrir.

He regenerado o borrado la clave en Cloudbeds.

La anterior deja de funcionar al instante. Edita la conexión en el portal de Bookline y pega la clave nueva.

¿Puede Bookline modificar algo en mi Cloudbeds?

No. El permiso read:room solo permite leer habitaciones, disponibilidad y tarifas. Las reservas las crea el huésped en tu motor de reservas, como siempre.

El asistente dice que no hay disponibilidad y sí la hay.

Comprueba que el ID de propiedad es el correcto y que las habitaciones están abiertas a la venta en Cloudbeds para esas fechas. El asistente solo ve lo que Cloudbeds devuelve como disponible para reservar.

Documentación de referencia de Cloudbeds: developers.cloudbeds.com.