Intégration Cloudbeds
HiLucy dispose d'une intégration approfondie et native avec Cloudbeds — l'un des principaux systèmes de gestion hôtelière (PMS) pour hôtels et locations saisonnières.
Ce qui est synchronisé
| Donnée | Sens | Fréquence | |------|-----------|-----------| | Réservations | Cloudbeds → HiLucy | Toutes les 15 minutes, incrémental | | Détails des clients | Cloudbeds → HiLucy | À chaque synchronisation de réservation | | Attributions de chambres/unités | Cloudbeds → HiLucy | À chaque synchronisation de réservation | | Statut de check-in/checkout | Cloudbeds → HiLucy | En temps réel via webhook |
Étapes de configuration
1. Connexion via OAuth
Dans votre tableau de bord admin HiLucy :
- Allez dans Paramètres → Intégrations → Cloudbeds
- Cliquez sur Connecter Cloudbeds
- Connectez-vous à votre compte Cloudbeds et autorisez HiLucy
La connexion OAuth rafraîchit automatiquement les jetons, vous n'avez donc jamais besoin de vous reconnecter.
2. Mappez vos établissements
Après la connexion, mappez vos établissements Cloudbeds aux annonces HiLucy. Chaque ID d'établissement Cloudbeds est lié à une annonce HiLucy.
3. Synchronisation initiale
HiLucy exécute une synchronisation complète initiale de toutes les réservations. Cela prend généralement 2 à 5 minutes selon votre volume de réservations.
4. Vérification
Consultez la page Réservations de votre tableau de bord admin. Vous devriez voir toutes vos réservations Cloudbeds avec :
- Les noms des clients et leurs coordonnées
- Les dates et les attributions de chambres
- Le statut de la réservation
Système de double écriture
HiLucy utilise une architecture de double écriture pour une fiabilité maximale :
- Les réservations sont écrites à la fois dans l'ancienne table de synchronisation et dans les nouvelles tables normalisées
- Cela garantit la rétrocompatibilité tout en permettant de nouvelles fonctionnalités
- Le système gère les conflits automatiquement
Surveillance
La synchronisation s'exécute toutes les 15 minutes via le cron WordPress, et elle est incrémentale : chaque exécution ne récupère que les réservations qui ont changé depuis la dernière, si bien que la plupart des passages sont rapides et ne touchent qu'une poignée d'enregistrements. Un balayage complet périodique s'exécute en filet de sécurité pour rattraper ce que la fenêtre incrémentale pourrait manquer. La synchronisation ne journalise que lorsqu'il y a des changements (synced > 0, updated > 0 ou errors > 0), gardant votre journal de débogage propre.
Dépannage
Les réservations ne se synchronisent pas ?
- Vérifiez que la connexion OAuth est toujours active dans les Paramètres
- Vérifiez que le mappage des établissements est correct
- Consultez le journal de débogage WordPress pour les erreurs de synchronisation
Coordonnées de client manquantes ?
Certaines réservations OTA (par exemple Booking.com) ne partagent pas l'e-mail/téléphone du client. Ces clients se synchronisent sans coordonnées jusqu'à ce qu'ils les fournissent directement.