La integración con Cloudbeds: lo que Converstay lee y lo que nunca toca
Converstay funciona solo con Cloudbeds, y se conecta con una clave de API de solo lectura, tres webhooks de reservas y un fragmento de código en el motor de reservas. Esto es exactamente lo que hace cada parte, para el hotel y para quien administre tu cuenta de Cloudbeds.
Actualizado el 16 de noviembre de 2026
Las tres partes
- Una clave de API de solo lectura que creas en Cloudbeds, con acceso de lectura a Hotel, Rate, Reservation y Room.
- Tres webhooks a los que Converstay se suscribe con esa clave: reserva creada, cambio de estado de la reserva y cambio de fechas de la reserva.
- Un fragmento de código de una línea en el Custom JavaScript del motor de reservas, o en Google Tag Manager, que detecta cuando un huésped escribe su correo y se va.
Lo que Converstay lee de Cloudbeds
Todo lo que lee sirve para que el correo al huésped sea exacto y para contar las reservas con honestidad:
| Datos de Cloudbeds | Para qué |
|---|---|
| Hotel: nombre, dirección, moneda, zona horaria | El remitente, el pie del correo y los precios en tu moneda |
| Habitaciones: nombres y fotos | El huésped ve la habitación que eligió, con su foto |
| Tarifas y disponibilidad | La tarifa actual para sus fechas, las alertas de bajada de precio y la revisión de habitaciones agotadas |
| Reservas: correo del huésped, fechas, estado, total | Dejar de escribir a los huéspedes que reservaron y vincular cada reserva que vuelve |
La clave no puede crear, cambiar ni cancelar nada en Cloudbeds. Converstay nunca ve los datos de la tarjeta: el pago se hace en el propio motor de reservas de Cloudbeds, y el fragmento de código no lee el paso de pago.
Lo que hace el fragmento de código en el motor de reservas
El fragmento carga el rastreador de Converstay en tu motor de reservas de Cloudbeds. Sigue los pasos del huésped, guarda la habitación, las fechas, la tarifa y el idioma que eligió, y guarda su correo en cuanto lo escribe en el formulario de datos del huésped. No se envía nada a un huésped que nunca escribió su correo.
También puede mostrar las tarjetas opcionales que actives en el panel: tus beneficios por reservar directo cuando el huésped se va a otra pestaña, Send My Stay, un aviso de que otros huéspedes están viendo las mismas fechas y otros enlaces de reserva cuando una fecha está agotada. Cada una está apagada hasta que la actives.
Cómo se vinculan las reservas
Cuando Cloudbeds avisa a Converstay de una reserva nueva, busca a un huésped que haya salido del motor de reservas con el mismo correo en el mismo hotel. Si lo encuentra, detiene los correos pendientes, y si Converstay ya le había escrito a ese huésped, la reserva cuenta como recuperada.
Las reservas que llegan sin correo se vinculan por hotel, fechas y una ventana de dos horas alrededor del momento en que el huésped se fue. Las cancelaciones y los cambios de fecha llegan por los otros dos webhooks, así que una reserva cancelada deja de contar ese mismo día. Las reservas hechas por teléfono, WhatsApp o en la recepción también cuentan, marcadas por canal, cuando el correo del huésped coincide.
Configurarlo
El panel te guía y verifica cada paso. En resumen:
- En Cloudbeds, abre Account → Apps & Marketplace → API Credentials y crea una credencial llamada Converstay.
- Crea su clave de API marcando R (lectura) para Hotel, Rate, Reservation y Room, y pega la clave en Converstay. Los webhooks se suscriben solos.
- Pega el fragmento de código en Booking Engine → Customize → Custom JavaScript, o agrégalo en Google Tag Manager.
- Conecta tu dominio de envío y aprueba los correos cuando te convenzan.
La guía completa, con los problemas comunes, está en seguimiento en Cloudbeds.
Desactivarlo
Borra la clave de API en Cloudbeds y quita el fragmento de código del motor de reservas, y Converstay deja de leer todo al instante. Puedes pedirnos que borremos los datos de tu hotel en cualquier momento, como explica el aviso de privacidad.
Preguntas
¿Converstay está en el Marketplace de Cloudbeds?
Todavía no. Converstay se conecta con una clave de API que creas en tu propia cuenta de Cloudbeds, y funciona en cualquier plan de Cloudbeds con acceso a la API.
¿Converstay puede cambiar mis reservas o tarifas?
No. La clave es de solo lectura: Hotel, Rate, Reservation y Room. No puede crear, cambiar ni cancelar nada.
¿Qué webhooks de Cloudbeds usa Converstay?
Reserva creada, cambio de estado de la reserva y cambio de fechas de la reserva. Le permiten detener los correos en cuanto un huésped reserva y descontar las cancelaciones.
¿Funciona con Cloudbeds Booking Engine Plus?
Sí. El fragmento de código va en el Custom JavaScript del motor de reservas, o en Google Tag Manager si tu motor de reservas lo usa.