ChatBedsРазработчикам

Платформа для разработчиков ChatBeds

Создавайте интеграции, которые читают и записывают номера, цены, бронирования и счета отеля в ChatBeds — PMS для отелей, которой управляют через WhatsApp и веб-панель.

ChatBeds ведёт ресепшн, бронирования, хаускипинг и расчёты отеля через WhatsApp и веб-панель. Платформа для разработчиков позволяет вашему ПО работать с этими данными через один REST API — Partner API (/partner/v1) — и узнавать об изменениях через подписанные вебхуки.

Что можно создать

  • Сайты и каналы бронирования. Проверяйте актуальную доступность и цены, затем создавайте, изменяйте и отменяйте бронирования.
  • Менеджеры каналов и коннекторы PMS. Читайте типы номеров, тарифные планы и номера и держите свою копию каждого бронирования в актуальном состоянии, кто бы его ни создал.
  • Инструменты для переписки с гостями. Находите проживания по дате, имени гостя или собственному номеру и реагируйте, когда бронирование меняется.
  • Инструменты для платежей и учёта. Читайте счёт гостя, добавляйте начисления, записывайте платежи и создавайте ссылки на оплату картой в собственном аккаунте Stripe отеля.

Два способа подключения

Приложение (рекомендуется)Закрытый ключ
Для когоПО, которое вы предлагаете многим отелямОдин отель, работающий с вами напрямую
Как отель подключаетсяНажимает Connect в каталоге приложений, затем Allow (OAuth 2.0)Владелец создаёт ключ в Settings → Partner API и отправляет его вам
Учётные данныеТокен доступа cbat_... (1 час) и токен обновленияКлюч API cbk_... (действует, пока его не отзовут)
ПраваТолько scopes, разрешённые отелемВсё в этом объекте

Оба способа вызывают те же 25 операции по тому же базовому адресу, с той же идемпотентностью, лимитами и вебхуками. Каждые учётные данные действуют для одного объекта.

Как всё связано

  1. Вы регистрируете бесплатный аккаунт разработчика и получаете Sandbox Hotel с тестовыми данными и ключ API.
  2. Вы разрабатываете на тестовом отеле с этим ключом.
  3. Вы регистрируете приложение на странице Developers и получаете client ID и secret.
  4. Вы подключаете приложение к своему тестовому отелю через OAuth, чтобы проверить весь процесс.
  5. Вы отправляете приложение на проверку. Когда ChatBeds его одобряет, оно появляется в каталоге приложений каждого отеля.
  6. Отель подключает ваше приложение, ваш сервер обменивает код на токены и вызывает /partner/v1 для этого объекта.
  7. ChatBeds отправляет на адрес вашего вебхука подписанное событие каждый раз, когда бронирование в этом объекте создаётся, меняется или отменяется.

Разработка бесплатна

Аккаунты разработчика и Sandbox Hotel бесплатны, за них никогда не выставляют счёт. Вы можете подключать свои приложения к своему тестовому отелю на любом этапе, ещё до проверки.

Что дальше

Что-то создаёте?

На этой странице