Cómo solucionar problemas de tokens de acceso caducados o ausentes en las integraciones de Cloudbeds Marketplace

Gabriela Garcia

Actualización 11 de noviembre de 2025 19:44

Información

Si estás utilizando una aplicación del Marketplace de Cloudbeds (como un proveedor de llegada automática, Channel Manager o sistema de contabilidad) y estás experimentando sincronizaciones de datos falladas, errores de autenticación o información faltante, la causa raíz puede ser un token de acceso/actualización expirado o faltante.

Estos tokens son esenciales para que la aplicación se comunique de forma segura con Cloudbeds; cuando expiran o se vuelven inválidos, la conexión se interrumpe.

Este artículo te guiará a través de la re-autorización de la aplicación, la prueba de la conexión y la recopilación de detalles para el Soporte si se necesita más ayuda.

Síntomas comunes

La funcionalidad de la aplicación integrada (por ejemplo, flujo de llegada, sincronización de reservas, informes) falla o no se activa.
La aplicación informa un fallo de autenticación, problema con el token o error de “no autorizado”.
No parece que se estén sincronizando nuevos datos desde Cloudbeds, a pesar de un uso exitoso en el pasado.
Mensajes de error específicos del sistema partner, tales como:
- HTTP 401: { "error": "server_error", "error_description": "El código de autorización es inválido o ha expirado." }
- HTTP 200: { "success": false, "message": "El usuario que aprobó esta conexión ya no está activo" }

Pasos de resolución

Paso 1: Re-autorización de la aplicación para generar un nuevo token

Los tokens de acceso y actualización se generan solo durante la conexión inicial o la re-autorización. Si un token se pierde o expira, la solución más rápida es desconectar y volver a conectar la aplicación en tu cuenta de Cloudbeds. Este proceso emite un nuevo token de acceso y actualización válido.

Ve a tu Menú de Cuenta → Aplicaciones & Marketplace → Aplicaciones Conectadas.
Localiza la aplicación problemática en la lista (por ejemplo, Trevo, Sweeply)
Haz clic en Desconectar, luego confirma la acción.
Haz clic en Conectar y sigue los pasos de autorización en pantalla específicos para esa aplicación. Esto generalmente implica iniciar sesión en la plataforma del partner o confirmar permisos.

Este proceso obliga a Cloudbeds a emitir un token de acceso y actualización completamente nuevo.

Paso 2: Probar la conexión

Abre un caso de prueba relevante en el PMS de Cloudbeds (por ejemplo, una reserva de prueba para una aplicación de llegada automática o activar una sincronización de datos para una aplicación de informes).
Ejecuta el flujo o acción que falló anteriormente (por ejemplo, iniciar la llegada, forzar una sincronización).
Verifica que se complete sin errores y que los datos se estén sincronizando como se esperaba.

Esto asegura que el nuevo token sea válido y funcione como se espera.

Paso 3: Si el problema persiste

Si la re-autorización no soluciona el problema, contacta al Servicio de soporte de Cloudbeds e incluye los siguientes detalles:

Tu ID de Propiedad de Cloudbeds
La fecha y hora aproximadas en que re-autorizaste la aplicación
Un número de reserva reciente (u otro ID relevante) donde ocurrió el problema después de la reconexión

Además, pide al equipo de soporte del partner (por ejemplo, Soporte de Trevo, Soporte de Sweeply) que proporcione:

Registros de solicitudes y respuestas de la API que muestren el uso del token fallido o mensajes de error. Estos registros ayudan al Equipo de Integraciones de Cloudbeds a identificar el problema.

Preguntas frecuentes

¿Por qué expiran o desaparecen los tokens del Marketplace de Cloudbeds?

Los tokens de acceso y de actualización pueden expirar tras un período de inactividad o restablecimientos de seguridad. También se invalidan si el usuario de Cloudbeds que originalmente autorizó la conexión se vuelve inactivo. En estos casos, se requiere reconectar con un usuario activo.

¿La expiración del token afecta a otras integraciones de Cloudbeds o aplicaciones conectadas?

Sí. El mismo proceso de solución de problemas de desconectar y reconectar se aplica a la mayoría de las otras aplicaciones del Marketplace de Cloudbeds que utilizan autenticación basada en tokens (OAuth 2.0). Si un partner informa errores como "El código de autorización es inválido o ha expirado" o "El usuario que aprobó esta conexión ya no está activo", generalmente se requiere una nueva autorización.

¿Existen integraciones que utilicen un método de autenticación diferente a los tokens del Marketplace de Cloudbeds?

Sí, algunas integraciones pueden tener métodos de autenticación diferentes. Por ejemplo, las integraciones de Omniboost se manejan de manera diferente. Siempre consulta las guías de integración específicas o contacta al Servicio de soporte de Cloudbeds si no estás seguro.

¿Qué significa el error “El ConnectionTokenProvider de tu aplicación no llamó al bloque de finalización proporcionado dentro de los 60 segundos” en la aplicación de Cloudbeds?

Este mensaje aparece cuando la aplicación móvil de Cloudbeds intenta conectarse a los servidores pero tarda más de 60 segundos en completar el proceso de conexión segura. Suele ocurrir al usar un lector de pagos (como Stripe o Cloudbeds Payments) y a menudo es causado por una señal de red débil, un retraso temporal en el servidor o un problema de conexión del lector.

A continuación se muestra un ejemplo de cómo se ve el error en la aplicación:

Causas posibles

Conexión Wi-Fi/celular inestable o débil.
La aplicación fue minimizada o interrumpida durante el proceso de conexión.
El lector de pagos perdió la conexión o no se emparejó correctamente.
Retraso temporal en la generación del token de conexión en el lado del servidor.

Pasos de solución

Cierra forzosamente y vuelve a abrir la aplicación móvil de Cloudbeds.
Asegúrate de que el dispositivo tenga una señal Wi-Fi o celular fuerte y vuelve a intentarlo.
Verifica que el lector de pagos esté encendido y emparejado correctamente.
Actualiza la aplicación de Cloudbeds a la última versión.

Si el problema persiste después de estos pasos, por favor contacta al Servicio de soporte de Cloudbeds e incluye la versión de la aplicación, el modelo del lector y cuándo apareció el error para que nuestro equipo pueda ayudarte más.

Si necesitas más ayuda o información, ¡nuestro Equipo de soporte está aquí para ayudarte!