Plataforma para desenvolvedores do ChatBeds
Crie integrações que leem e gravam os quartos, preços, reservas e contas de um hotel no ChatBeds, o PMS hoteleiro usado pelo WhatsApp e por um painel web.
O ChatBeds cuida da recepção, das reservas, da governança e do faturamento de um hotel pelo WhatsApp e por um painel web. A plataforma para desenvolvedores permite que seu software trabalhe com esses dados por meio de uma única API REST, a Partner API (/partner/v1), e saiba das mudanças por webhooks assinados.
O que você pode criar
- Sites e canais de reserva. Pesquise disponibilidade e preços em tempo real e, depois, crie, altere e cancele reservas.
- Channel managers e conectores de PMS. Leia tipos de quarto, planos tarifários e quartos, e mantenha sua cópia de cada reserva sincronizada, não importa quem a fez.
- Ferramentas de mensagens para hóspedes. Encontre estadias por data, nome do hóspede ou sua própria referência, e reaja quando uma reserva mudar.
- Ferramentas de pagamento e contabilidade. Leia a conta de um hóspede, adicione cobranças, registre pagamentos e crie links de pagamento com cartão na conta Stripe do próprio hotel.
Duas formas de acesso
| Um app (recomendado) | Uma chave privada | |
|---|---|---|
| Para quem | Software que você oferece a muitos hotéis | Um hotel que trabalha diretamente com você |
| Como o hotel se conecta | Clica em Connect no diretório de Apps e depois em Allow (OAuth 2.0) | Um proprietário cria uma chave em Settings → Partner API e envia para você |
| Credencial | Token de acesso cbat_... (1 hora) mais token de atualização | Chave de API cbk_... (não expira até ser revogada) |
| Permissões | Só os scopes que o hotel permitiu | Tudo naquela propriedade |
As duas chamam as mesmas 25 operações no mesmo endereço base, com a mesma idempotência, os mesmos limites de taxa e os mesmos webhooks. Cada credencial age por uma propriedade.
Como tudo se encaixa
- Você cria uma conta de desenvolvedor grátis e recebe um Sandbox Hotel com dados de teste e uma chave de API.
- Você desenvolve no ambiente de testes com essa chave.
- Você registra um app na página Developers e recebe um client ID e um secret.
- Você conecta o app ao seu próprio ambiente de testes com OAuth para testar o fluxo completo.
- Você envia o app para revisão. Quando o ChatBeds aprova, ele fica listado no diretório de Apps de todos os hotéis.
- Um hotel conecta seu app, seu servidor troca o código por tokens e chama
/partner/v1para aquela propriedade. - O ChatBeds envia ao seu endereço de webhook um evento assinado sempre que uma reserva daquela propriedade é criada, alterada ou cancelada.
Grátis para desenvolver
As contas de desenvolvedor e o Sandbox Hotel são grátis e nunca cobrados. Você pode conectar seus apps ao seu ambiente de testes a qualquer momento, antes da revisão.
Próximos passos
Guia rápido
Faça sua primeira chamada e sua primeira reserva em poucos minutos.
Apps e OAuth
Registre um app e deixe qualquer hotel conectá-lo.
Referência da API
As 25 operações, com requisições e respostas reais.
Webhooks
Receba eventos de reservas e verifique as assinaturas.
Guias
Passo a passo completo para as integrações mais comuns.
Recursos
Erros, idempotência, limites de taxa, changelog e suporte.
Criando algo?