Het ChatBeds-ontwikkelaarsplatform
Bouw koppelingen die de kamers, prijzen, boekingen en rekeningen van een hotel lezen en schrijven in ChatBeds, het hotel-PMS dat via WhatsApp en een webdashboard werkt.
ChatBeds regelt de receptie, boekingen, housekeeping en facturering van een hotel via WhatsApp en een webdashboard. Met het ontwikkelaarsplatform werkt je software met die gegevens via één REST-API, de Partner API (/partner/v1), en hoort ze van wijzigingen via ondertekende webhooks.
Wat je kunt bouwen
- Boekingssites en -kanalen. Zoek live beschikbaarheid en prijzen en maak, wijzig en annuleer daarna boekingen.
- Channel managers en PMS-koppelingen. Lees kamertypes, tariefplannen en kamers, en houd je kopie van elke boeking gelijk, wie hem ook maakte.
- Tools voor gastberichten. Zoek verblijven op datum, gastnaam of je eigen referentie, en reageer als een boeking verandert.
- Betaal- en boekhoudtools. Lees de rekening van een gast, voeg kosten toe, registreer betalingen en maak betaallinks voor kaarten op het eigen Stripe-account van het hotel.
Twee manieren om binnen te komen
| Een app (aanbevolen) | Een privésleutel | |
|---|---|---|
| Voor wie | Software die je aan veel hotels aanbiedt | Eén hotel dat direct met je werkt |
| Hoe een hotel koppelt | Klikt op Connect in de Apps-directory en daarna op Allow (OAuth 2.0) | Een eigenaar maakt een sleutel bij Settings → Partner API en stuurt hem naar je |
| Inloggegevens | Toegangstoken cbat_... (1 uur) plus vernieuwingstoken | API-sleutel cbk_... (verloopt niet tot hij wordt ingetrokken) |
| Rechten | Alleen de scopes die het hotel toestond | Alles bij die accommodatie |
Beide roepen dezelfde 25 bewerkingen aan op hetzelfde basisadres, met dezelfde idempotentie, limieten en webhooks. Elke sleutel werkt voor één accommodatie.
Hoe het in elkaar past
- Je meldt je aan voor een gratis ontwikkelaarsaccount en krijgt een Sandbox Hotel met testgegevens en een API-sleutel.
- Je bouwt met die sleutel tegen het testhotel.
- Je registreert een app op de pagina Developers en krijgt een client-ID en een secret.
- Je koppelt de app met OAuth aan je eigen testhotel om de hele flow te testen.
- Je dient de app in ter beoordeling. Zodra ChatBeds hem goedkeurt, staat hij in de Apps-directory van elk hotel.
- Een hotel koppelt je app; je server wisselt de code in voor tokens en roept
/partner/v1aan voor die accommodatie. - ChatBeds stuurt je webhookadres een ondertekend event zodra een boeking bij die accommodatie wordt gemaakt, gewijzigd of geannuleerd.
Gratis bouwen
Ontwikkelaarsaccounts en het Sandbox Hotel zijn gratis en worden nooit gefactureerd. Je kunt je eigen apps op elk moment aan je eigen testhotel koppelen, ook vóór de beoordeling.
Verder
Snelstart
Je eerste aanroep en je eerste boeking binnen een paar minuten.
Apps en OAuth
Registreer een app en laat elk hotel hem koppelen.
API-referentie
Alle 25 bewerkingen, met echte verzoeken en antwoorden.
Webhooks
Ontvang boekingsevents en controleer hun handtekeningen.
Handleidingen
Complete stappenplannen voor veelvoorkomende koppelingen.
Bronnen
Fouten, idempotentie, limieten, changelog en support.
Bouw je iets?