ChatBedsDesenvolvedores

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 quemSoftware que você oferece a muitos hotéisUm hotel que trabalha diretamente com você
Como o hotel se conectaClica 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ê
CredencialToken de acesso cbat_... (1 hora) mais token de atualizaçãoChave de API cbk_... (não expira até ser revogada)
PermissõesSó os scopes que o hotel permitiuTudo 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

  1. Você cria uma conta de desenvolvedor grátis e recebe um Sandbox Hotel com dados de teste e uma chave de API.
  2. Você desenvolve no ambiente de testes com essa chave.
  3. Você registra um app na página Developers e recebe um client ID e um secret.
  4. Você conecta o app ao seu próprio ambiente de testes com OAuth para testar o fluxo completo.
  5. Você envia o app para revisão. Quando o ChatBeds aprova, ele fica listado no diretório de Apps de todos os hotéis.
  6. Um hotel conecta seu app, seu servidor troca o código por tokens e chama /partner/v1 para aquela propriedade.
  7. 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

Criando algo?

Nesta página