Plataforma para desarrolladores de ChatBeds
Crea integraciones que leen y escriben las habitaciones, los precios, las reservas y las cuentas de un hotel en ChatBeds, el PMS hotelero que se maneja desde WhatsApp y un panel web.
ChatBeds gestiona la recepción, las reservas, la limpieza y la facturación de un hotel desde WhatsApp y un panel web. La plataforma para desarrolladores permite que tu software trabaje con esos datos a través de una única API REST, la Partner API (/partner/v1), y se entere de los cambios mediante webhooks firmados.
Qué puedes crear
- Webs y canales de reserva. Busca disponibilidad y precios en tiempo real y luego crea, cambia y cancela reservas.
- Channel managers y conectores de PMS. Lee tipos de habitación, planes de tarifas y habitaciones, y mantén sincronizada tu copia de cada reserva, la haya hecho quien la haya hecho.
- Herramientas de mensajería con huéspedes. Busca estancias por fecha, nombre del huésped o tu propia referencia, y reacciona cuando una reserva cambia.
- Herramientas de pagos y contabilidad. Lee la cuenta de un huésped, añade cargos, registra pagos y crea enlaces de pago con tarjeta en la cuenta de Stripe del propio hotel.
Dos formas de entrar
| Una app (recomendado) | Una clave privada | |
|---|---|---|
| Para quién | Software que ofreces a muchos hoteles | Un hotel que trabaja contigo directamente |
| Cómo se conecta un hotel | Pulsa Connect en su directorio de Apps y luego Allow (OAuth 2.0) | Un propietario crea una clave en Settings → Partner API y te la envía |
| Credencial | Token de acceso cbat_... (1 hora) más token de actualización | Clave de API cbk_... (no caduca hasta que se revoca) |
| Permisos | Solo los scopes que el hotel ha permitido | Todo en ese establecimiento |
Ambas llaman a las mismas 25 operaciones en la misma dirección base, con la misma idempotencia, los mismos límites de uso y los mismos webhooks. Cada credencial actúa para un establecimiento.
Cómo encaja todo
- Te registras para obtener una cuenta de desarrollador gratuita y recibes un Sandbox Hotel con datos de prueba y una clave de API.
- Desarrollas contra el entorno de pruebas con esa clave.
- Registras una app en la página Developers y obtienes un client ID y un secreto.
- Conectas la app a tu propio entorno de pruebas con OAuth para probar todo el flujo.
- Envías la app a revisión. Cuando ChatBeds la aprueba, aparece publicada en el directorio de Apps de todos los hoteles.
- Un hotel conecta tu app, tu servidor cambia el código por tokens y llama a
/partner/v1para ese establecimiento. - ChatBeds envía a tu dirección de webhook un evento firmado cada vez que se crea, cambia o cancela una reserva en ese establecimiento.
Gratis para crear
Las cuentas de desarrollador y el Sandbox Hotel son gratuitos y nunca se facturan. Puedes conectar tus propias apps a tu propio entorno de pruebas en cualquier momento, antes de la revisión.
Siguientes pasos
Guía rápida
Haz tu primera llamada y tu primera reserva en unos minutos.
Apps y OAuth
Registra una app y deja que cualquier hotel la conecte.
Referencia de la API
Las 25 operaciones, con peticiones y respuestas reales.
Webhooks
Recibe eventos de reservas y verifica sus firmas.
Guías
Recorridos completos para las integraciones más habituales.
Recursos
Errores, idempotencia, límites de uso, registro de cambios y soporte.
¿Estás creando algo?