Comment résoudre les problèmes de jetons d'accès expirés ou manquants pour les intégrations Cloudbeds Marketplace

Aperçu

Si vous utilisez une application Cloudbeds Marketplace (comme un fournisseur d'auto check-in, un gestionnaire de canaux ou un système comptable) et que vous rencontrez des échecs de synchronisation des données, des erreurs d'authentification ou des informations manquantes, la cause principale peut être un jeton d'accès/rafraîchissement expiré ou manquant.

Ces jetons sont essentiels pour que l'application communique en toute sécurité avec Cloudbeds ; lorsqu'ils expirent ou deviennent invalides, la connexion est rompue.

Cet article vous guide pour réautoriser l'application, tester la connexion et rassembler les informations pour le support si une aide supplémentaire est nécessaire.

Symptômes courants

• La fonctionnalité de l'application intégrée (p. ex., le flux de check-in, la synchronisation des réservations, les rapports) échoue ou ne se déclenche pas.
• L'application signale un échec d'authentification, un problème de jeton ou une erreur « non autorisé ».
• Aucune nouvelle donnée ne semble se synchroniser depuis Cloudbeds, malgré une utilisation réussie antérieure.
• Messages d'erreur spécifiques du système partenaire, tels que :
  • HTTP 401 : { "error": "server_error", "error_description": "Le code d'autorisation est invalide ou a expiré." }
  • HTTP 200 : { "success": false, "message": "L'utilisateur qui a approuvé cette connexion n'est plus actif" }

Étapes de résolution

Étape 1 : Réautoriser l'application pour générer un nouveau jeton

Les jetons d'accès et de rafraîchissement sont générés uniquement lors de la connexion initiale ou de la réautorisation. Si un jeton est perdu ou expiré, la solution la plus rapide est de déconnecter puis reconnecter l'application dans votre compte Cloudbeds. Ce processus émet un nouveau jeton d'accès et de rafraîchissement valide.

1. Accédez à votre Menu Compte → Apps & Marketplace → Applications connectées.
2. Localisez l'application problématique dans la liste (p. ex., Trevo, Sweeply)
3. Cliquez sur Déconnecter, puis confirmez l'action.
4. Cliquez sur Connecter et suivez les étapes d'autorisation affichées à l'écran, spécifiques à cette application. Cela implique généralement de se connecter à la plateforme partenaire ou de confirmer les autorisations.

Étape 2 : Tester la connexion

1. Ouvre un cas de test pertinent dans Cloudbeds PMS (p. ex., une réservation test pour une application d’auto check-in ou déclenche une synchronisation des données pour une application de rapport).
2. Lance le flux ou l’action qui avait échoué précédemment (p. ex., initie un check-in, force une synchronisation).
3. Vérifie que cela se termine sans erreur et que les données se synchronisent comme prévu.

Cela garantit que le nouveau jeton est valide et fonctionne comme attendu.

Étape 3 : si le problème persiste

Si la réautorisation ne résout pas le problème, contacte l’Assistance Cloudbeds en fournissant les informations suivantes :

• L’identifiant de ton établissement Cloudbeds
• La date et l’heure approximatives de la réautorisation de l’application
• Un numéro de réservation récent (ou un autre identifiant pertinent) où le problème est survenu après la reconnexion

Demande également à l’équipe d’assistance du partenaire (p. ex., Assistance Trevo, Assistance Sweeply) de fournir :

• Les journaux des requêtes et réponses API montrant l’utilisation du jeton échoué ou les messages d’erreur. Ces journaux aident l’équipe d’intégrations Cloudbeds à identifier précisément le problème.

Questions fréquentes

Si vous avez besoin d’aide supplémentaire ou de plus d’informations, notre équipe d’assistance est là pour vous aider !