Clave API de Cloudbeds, paso a paso

Permite que Hotelmente lea su propiedad en Cloudbeds: reservas, huéspedes, habitaciones, tarifas, pagos y los datos de su hotel. Una sola clave sirve para Hotelmente AI, Hotelmente PAY y Hotelmente FACTURA.

Para Hotelmente AI solo lee. Nunca crea, cambia ni cancela nada en Cloudbeds.

• Un usuario de Cloudbeds que pueda abrir Account → Apps & Marketplace (normalmente el dueño de la cuenta o un administrador).
• Haber iniciado sesión en la propiedad que quiere conectar.
• Acceso a la API incluido en su paquete de Cloudbeds. Si Cloudbeds muestra un botón Submit API Access Form en lugar de las opciones para crear, envíelo primero y espere a que Cloudbeds active el acceso.

Guía oficial: myfrontdesk.cloudbeds.com/hc/en-us/articles/1260801405770-Apps-and-Integrations-Self-service-API

• Paso 1: Inicie sesión en Cloudbeds.
• Paso 2: Abra Account → Apps & Marketplace y luego la pestaña API Credentials.
• Paso 3: Haga clic en + New Credentials. Póngale el nombre Hotelmente, elija un Integration Type y, si le pide una Redirect URI, escriba localhost. Haga clic en Save.
• Paso 4: Una ventana muestra un Client ID y un Client Secret. No los necesita: ciérrela.
• Paso 5: En la fila nueva, haga clic en Create en la columna API Key.
• Paso 6: Marque solo permisos de lectura (Read; vea la siguiente pregunta), elija su propiedad, haga clic en Continue y luego en Allow Access.
• Paso 7: Copie la clave de inmediato. Cloudbeds la muestra una sola vez.

Los nombres de los menús pueden cambiar; vea la guía oficial: myfrontdesk.cloudbeds.com/hc/en-us/articles/1260801405770-Apps-and-Integrations-Self-service-API

Cloudbeds agrupa los permisos en Read (lectura), Write (escritura) y Delete (borrado) para cada área. Para Hotelmente, marque solo Read, en estas áreas: hotel, reservas, huéspedes, habitaciones, tarifas, artículos, pagos, impuestos y cargos, cuentas de la casa, bloqueos de cupos, ajustes, usuarios y tablero.

No marque Write ni Delete. Hotelmente AI nunca los necesita.

Cloudbeds no permite agregar permisos a una clave existente. Si olvidó uno, borre la clave y cree otra.

Cada hotel en Hotelmente tiene su propia cuenta y su propia clave. Cree una clave por propiedad y conecte cada una en su propia cuenta de Hotelmente.

Si la clave la crea un usuario de grupo (organización), puede llegar a varias propiedades. Hotelmente se conecta a la primera propiedad a la que llega la clave, así que para un grupo es más seguro crearla con la sesión iniciada en esa propiedad. Hotelmente muestra el nombre de la propiedad después de la prueba: verifique que sea la correcta.

Acceso de grupo: developers.cloudbeds.com/docs/property-and-group-account-api-access

En el inicio de Hotelmente, en el paso 3, Conectar Cloudbeds:
- Paso 1: Pegue la clave en el campo de la clave API de Cloudbeds.
- Paso 2: Haga clic en el botón para conectar. Hotelmente prueba la clave con Cloudbeds antes de guardar nada.
- Paso 3: Si funciona, verá que ya está conectado con el nombre de su propiedad, y empieza la primera sincronización.

La clave empieza con cbat_. Si la pantalla muestra un botón Conectar con Cloudbeds, puede iniciar sesión en Cloudbeds en su lugar; Usar una clave de API en su lugar mantiene este método.

Hotelmente conecta Cloudbeds cuando ya hay un producto activo en su cuenta. Termine el paso Plan en el inicio de Hotelmente y luego pegue la clave.

Abra Hotelmente AI → Configuración AI. En Su sistema de gestión, la fila de Cloudbeds muestra la clave como ••••últimos4, la fecha en que se guardó y la última prueba. Un propietario hace clic en Probar: Hotelmente pregunta a Cloudbeds a qué propiedad llega la clave, no cambia nada y guarda el resultado con la fecha.

• Cloudbeds no aceptó esta clave. Verifique que la copió completa.: falta una parte de la clave. Cópiela de nuevo.
• Esta clave está inactiva o venció. Cree una nueva en Cloudbeds.: la clave se borró o desactivó. Cree una nueva.
• Esta clave no tiene acceso de lectura a su propiedad. Otórguele permisos de lectura en Cloudbeds.: no se marcó Read. Cree una clave nueva con Read.
• La clave funciona, pero no tiene ninguna propiedad vinculada.: la clave es de otra cuenta o no tiene una propiedad elegida.
• Cloudbeds está ocupado / no responde / No se pudo contactar a Cloudbeds: espere unos minutos y pruebe de nuevo.
• Eso no parece una clave de API de Cloudbeds.: lo que pegó tiene espacios o es demasiado corto.

La guía Mensajes de error de conexión y soluciones tiene más detalle.

Cloudbeds mantiene una clave activa mientras se use al menos una vez cada 30 días. Hotelmente sincroniza cada noche, así que una clave conectada se mantiene activa.

Cloudbeds puede desactivar una clave que quedó expuesta públicamente. Si le pasó, cree una nueva y reemplácela.

Fuente: developers.cloudbeds.com/docs/quickstart-guide-api-authentication-for-property-level-users

• Paso 1: Cree una clave nueva en Cloudbeds (mismos pasos, permisos Read).
• Paso 2: En Hotelmente, abra Hotelmente AI → Configuración AI y haga clic en Reemplazar clave.
• Paso 3: Pegue la clave nueva y haga clic en Probar y guardar. Primero se prueba la nueva clave; la actual se mantiene hasta que la nueva funcione.
• Paso 4: Cuando Hotelmente muestre Conectado, borre la clave anterior en Cloudbeds (API Credentials, ícono de papelera).

Su historial y su configuración en Hotelmente se mantienen.

Un propietario hace clic en Desconectar en Hotelmente AI → Configuración AI y confirma. Hotelmente deja de sincronizar y borra la clave guardada. Su historial sincronizado se mantiene hasta que haga clic en Eliminar datos sincronizados, en Sus datos de la misma página.

En Cloudbeds no cambia nada. Para asegurarse de que la clave no se pueda volver a usar, bórrela también en Cloudbeds, en API Credentials.

La clave sigue funcionando, pero conviene reemplazarla: cree una clave nueva con su propio usuario de Cloudbeds, reemplácela en Hotelmente y borre la anterior en Cloudbeds. Revise también el rol de esa persona en Configuración → Usuarios y equipo.

Hotelmente AI solo necesita lectura. Cuando Hotelmente PAY o Hotelmente FACTURA se active para su hotel, registrar pagos o números de factura en las reservas requiere acceso de escritura; Hotelmente le indicará en la aplicación cómo otorgarlo. Mientras tanto, mantenga la clave de solo lectura.