La piattaforma per sviluppatori di ChatBeds
Crea integrazioni che leggono e scrivono camere, prezzi, prenotazioni e conti di un hotel su ChatBeds, il PMS alberghiero gestito da WhatsApp e da una dashboard web.
ChatBeds gestisce reception, prenotazioni, housekeeping e fatturazione di un hotel da WhatsApp e da una dashboard web. La piattaforma per sviluppatori permette al tuo software di lavorare con quei dati tramite un’unica API REST, la Partner API (/partner/v1), e di sapere dei cambiamenti tramite webhook firmati.
Cosa puoi creare
- Siti e canali di prenotazione. Cerca disponibilità e prezzi in tempo reale, poi crea, modifica e cancella prenotazioni.
- Channel manager e connettori PMS. Leggi tipologie di camera, piani tariffari e camere, e tieni sincronizzata la tua copia di ogni prenotazione, chiunque l’abbia fatta.
- Strumenti di messaggistica per gli ospiti. Trova i soggiorni per data, nome dell’ospite o tuo riferimento, e reagisci quando una prenotazione cambia.
- Strumenti di pagamento e contabilità. Leggi il conto di un ospite, aggiungi addebiti, registra pagamenti e crea link di pagamento con carta sull’account Stripe dell’hotel.
Due modi di accedere
| Un’app (consigliato) | Una chiave privata | |
|---|---|---|
| Per chi | Software che offri a molti hotel | Un hotel che lavora direttamente con te |
| Come si collega un hotel | Clicca Connect nella sua directory App, poi Allow (OAuth 2.0) | Un proprietario crea una chiave in Settings → Partner API e te la invia |
| Credenziale | Token di accesso cbat_... (1 ora) più token di aggiornamento | Chiave API cbk_... (non scade finché non viene revocata) |
| Permessi | Solo gli scope consentiti dall’hotel | Tutto in quella struttura |
Entrambe chiamano le stesse 25 operazioni allo stesso indirizzo di base, con la stessa idempotenza, gli stessi limiti di frequenza e gli stessi webhook. Ogni credenziale agisce per una struttura.
Come si combina il tutto
- Ti registri per un account sviluppatore gratuito e ricevi un Sandbox Hotel con dati di prova e una chiave API.
- Sviluppi sull’hotel di prova con quella chiave.
- Registri un’app nella pagina Developers e ottieni un client ID e un secret.
- Colleghi l’app al tuo hotel di prova con OAuth per testare tutto il flusso.
- Invii l’app in revisione. Quando ChatBeds la approva, viene pubblicata nella directory App di ogni hotel.
- Un hotel collega la tua app; il tuo server scambia il codice con i token e chiama
/partner/v1per quella struttura. - ChatBeds invia al tuo indirizzo webhook un evento firmato ogni volta che una prenotazione di quella struttura viene creata, modificata o cancellata.
Gratis per sviluppare
Gli account sviluppatore e il Sandbox Hotel sono gratuiti e non vengono mai fatturati. Puoi collegare le tue app al tuo hotel di prova in qualsiasi momento, prima della revisione.
Dove andare ora
Guida rapida
Fai la tua prima chiamata e la tua prima prenotazione in pochi minuti.
App e OAuth
Registra un’app e lascia che qualsiasi hotel la colleghi.
Riferimento API
Tutte le 25 operazioni, con richieste e risposte reali.
Webhook
Ricevi gli eventi delle prenotazioni e verifica le firme.
Guide
Percorsi completi per le integrazioni più comuni.
Risorse
Errori, idempotenza, limiti di frequenza, changelog e assistenza.
Stai creando qualcosa?