La plateforme développeurs ChatBeds
Créez des intégrations qui lisent et écrivent les chambres, les prix, les réservations et les notes d’un hôtel sur ChatBeds, le PMS hôtelier piloté depuis WhatsApp et un tableau de bord web.
ChatBeds gère la réception, les réservations, le ménage et la facturation d’un hôtel depuis WhatsApp et un tableau de bord web. La plateforme développeurs permet à votre logiciel de travailler avec ces données grâce à une seule API REST, la Partner API (/partner/v1), et d’être prévenu des changements par des webhooks signés.
Ce que vous pouvez créer
- Sites et canaux de réservation. Cherchez les disponibilités et les prix en direct, puis créez, modifiez et annulez des réservations.
- Channel managers et connecteurs PMS. Lisez les types de chambre, les plans tarifaires et les chambres, et gardez votre copie de chaque réservation à jour, quel qu’en soit l’auteur.
- Outils de messagerie client. Retrouvez les séjours par date, par nom du client ou par votre propre référence, et réagissez quand une réservation change.
- Outils de paiement et de comptabilité. Lisez la note d’un client, ajoutez des frais, enregistrez des paiements et créez des liens de paiement par carte sur le compte Stripe de l’hôtel.
Deux façons d’accéder
| Une app (recommandé) | Une clé privée | |
|---|---|---|
| Pour qui | Un logiciel que vous proposez à de nombreux hôtels | Un hôtel qui travaille directement avec vous |
| Comment un hôtel se connecte | Il clique sur Connect dans son annuaire d’Apps, puis sur Allow (OAuth 2.0) | Un propriétaire crée une clé dans Settings → Partner API et vous l’envoie |
| Identifiant | Jeton d’accès cbat_... (1 heure) et jeton de rafraîchissement | Clé d’API cbk_... (sans expiration jusqu’à révocation) |
| Permissions | Uniquement les scopes autorisés par l’hôtel | Tout dans cet établissement |
Les deux appellent les mêmes 25 opérations à la même adresse de base, avec la même idempotence, les mêmes limites de débit et les mêmes webhooks. Chaque identifiant agit pour un établissement.
Comment tout s’articule
- Vous créez un compte développeur gratuit et recevez un Sandbox Hotel avec des données de test et une clé d’API.
- Vous développez sur l’hôtel de test avec cette clé.
- Vous enregistrez une app sur la page Developers et obtenez un client ID et un secret.
- Vous connectez l’app à votre propre hôtel de test avec OAuth pour tester tout le parcours.
- Vous soumettez l’app à validation. Une fois approuvée par ChatBeds, elle est publiée dans l’annuaire des Apps de chaque hôtel.
- Un hôtel connecte votre app ; votre serveur échange le code contre des jetons et appelle
/partner/v1pour cet établissement. - ChatBeds envoie à votre adresse de webhook un événement signé chaque fois qu’une réservation de cet établissement est créée, modifiée ou annulée.
Gratuit pour développer
Les comptes développeur et le Sandbox Hotel sont gratuits et jamais facturés. Vous pouvez connecter vos propres apps à votre propre hôtel de test à tout moment, avant la validation.
Et ensuite
Démarrage rapide
Faites votre premier appel et votre première réservation en quelques minutes.
Apps et OAuth
Enregistrez une app et laissez n’importe quel hôtel la connecter.
Référence de l’API
Les 25 opérations, avec de vraies requêtes et réponses.
Webhooks
Recevez les événements de réservation et vérifiez leurs signatures.
Guides
Des parcours complets pour les intégrations courantes.
Ressources
Erreurs, idempotence, limites de débit, journal des modifications et assistance.
Vous créez quelque chose ?