ChatBeds开发者

ChatBeds 开发者平台

开发能读写 ChatBeds 中酒店房间、价格、预订和账单的集成。ChatBeds 是通过 WhatsApp 和网页后台运营的酒店 PMS。

ChatBeds 通过 WhatsApp 和网页后台管理酒店的前台、预订、客房和账务。借助开发者平台,你的软件可以通过一个 REST API——Partner API(/partner/v1)——处理这些数据,并通过带签名的 webhook 获知变化。

你可以开发什么

  • 预订网站和渠道。 查询实时房态和价格,然后创建、修改和取消预订。
  • 渠道管理和 PMS 连接器。 读取房型、价格计划和房间,并让你保存的每笔预订保持同步,无论是谁创建的。
  • 客人消息工具。 按日期、客人姓名或你自己的编号查找住宿,在预订变化时及时响应。
  • 付款和会计工具。 读取客人账单、添加费用、记录付款,并在酒店自己的 Stripe 账户上创建银行卡付款链接。

两种接入方式

应用(推荐)私有密钥
适用对象你提供给许多酒店的软件直接与你合作的一家酒店
酒店如何连接在应用目录中点击 Connect,再点击 Allow(OAuth 2.0)业主在 Settings → Partner API 创建密钥并发给你
凭证访问令牌 cbat_...(1 小时)和刷新令牌API 密钥 cbk_...(撤销前不会过期)
权限仅限酒店允许的权限范围(scopes)该物业的全部内容

两种方式在同一个基础地址调用同样的 25 个操作,幂等性、速率限制和 webhook 都相同。每个凭证只代表一个物业。

整体流程

  1. 你注册免费开发者账户,获得带测试数据的 Sandbox Hotel 和一个 API 密钥。
  2. 你用这个密钥在沙盒上开发。
  3. 你在 Developers 页面注册一个应用,获得 client ID 和 secret。
  4. 你用 OAuth 把应用连接到自己的沙盒,测试完整流程。
  5. 你提交应用审核。ChatBeds 批准后,它会上架到每家酒店的应用目录。
  6. 酒店连接你的应用后,你的服务器用授权码换取令牌,并为该物业调用 /partner/v1。
  7. 每当该物业的预订被创建、修改或取消时,ChatBeds 都会向你的 webhook 地址发送一个带签名的事件。

免费开发

开发者账户和 Sandbox Hotel 免费,永不收费。在审核前的任何阶段,你都可以把自己的应用连接到自己的沙盒。

下一步

正在开发什么?

本页内容