Hostaway | ElevenLabs Documentation

使用以下 webhook 工具，接待员可查询 Hostaway 房源日历中来电者咨询的日期，并告知小屋或房源是否空闲、每晚价格以及最短入住天数。Hostaway 的公共 API 会签发有效期为 24 个月的访问令牌，因此该工具会直接调用 Hostaway。

接待员无法创建预订或查询现有预订。它会查看日历并记录预订请求，团队再根据通话后摘要确认入住。

开始前

创建 API 密钥

在 Hostaway 控制面板中，打开 Settings → Hostaway API，然后创建新的 API 密钥。将其命名为 Reception.ai，并选择 Hostaway Public API 作为合作伙伴。复制密钥：Hostaway 仅显示一次。同时记下 Account ID，它也显示在 Settings 中。

获取访问令牌

在终端中将密钥交换为访问令牌，替换 ACCOUNT_ID 和 API_KEY：

curl -X POST 'https://api.hostaway.com/v1/accessTokens' \
  -H 'Content-type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials&client_id=ACCOUNT_ID&client_secret=API_KEY&scope=general'

从响应中复制 access_token 值。它的有效期为 24 个月。

该访问令牌可以读取和更改 Hostaway 账户中的所有内容，包括住客详细信息和门锁密码。不要将其粘贴到共享文档或在线工具中。如发生泄露，请撤销令牌并在 Hostaway 中删除 API 密钥。

查找房源 ID

使用令牌列出房源，替换 YOUR_TOKEN：

curl 'https://api.hostaway.com/v1/listings?limit=100' \
  -H 'Authorization: Bearer YOUR_TOKEN'

响应中的每个房源都有 id 和 name。记下接待员需要查询的每个房源 ID。

创建工具

前往 Integrations，选择 Add integration，然后选择 Webhook Tool。

字段	值
名称	`check_hostaway_calendar`
描述	”查询某个房源在来电者所选日期是否空闲，以及每晚价格和最短入住天数。在告知来电者房源可订前使用此工具。“
方法	GET
URL	`https://api.hostaway.com/v1/listings/{listing_id}/calendar`
请求标头	`Authorization`：`Bearer` 后接访问令牌，并将 Type 设为 Secret
路径参数	`listing_id`（字符串，必填）：“Cedar Cabin 使用 `11111`，Lakeside Cabin 使用 `22222`。”
查询参数	`startDate`（字符串，必填）：“到达日期，格式为 YYYY-MM-DD。” `endDate`（字符串，必填）：“入住的最后一晚，格式为 YYYY-MM-DD。” `includeResources`（字符串，固定值）：`0`
分配给智能体	Receptionist

将小屋名称和 ID 替换为自己的值，并为每个房源添加一行。选择 Enable。

Hostaway 会为每晚返回一个条目。当 status 为 available 时，该晚为空闲。每晚还会显示其 price 和 minimumStay。

将 includeResources 固定为 0。如果设为 1，Hostaway 会将每晚的预订信息，包括住客姓名、电话号码和电子邮箱，添加到接待员可见的内容中。

测试

通过询问已知被预订日期的小屋，再询问已知空闲日期的小屋来测试接待员。将回答与 Hostaway 日历进行对比。

为入住请求添加一个流程：询问房源、到达和离开日期以及住客人数，查询日历，然后收集来电者的姓名、电话号码和电子邮箱供团队跟进。添加一条规则，要求接待员绝不承诺入住已预订成功。

限制

接待员无法创建、更改或取消预订。每次入住均由团队确认。
它一次只能查询一个房源。若要推荐其他小屋，需要依次查询每一个。
每晚价格不包含清洁费、税费或折扣，因此接待员只能将其作为参考报价。
该工具不会查询现有预订。Hostaway 的预订和房源记录包含门锁密码和 Wi-Fi 密码，因此本指南不会将这些信息提供给接待员。Zapier 的 Hostaway 应用会返回相同记录，且不提供预订或可用性操作。
访问令牌会在 24 个月后失效。请在此之前创建新令牌并更新标头。

故障排除

问题	检查项
Hostaway 返回 401 或 403	标头值必须是 `Bearer`、一个空格和访问令牌，而不是 API 密钥。检查令牌是否已过期。
查询了错误的小屋	检查 `listing_id` 描述中的房源 ID 是否与实际房源一致。
已预订的夜晚显示为空闲	检查 Hostaway 中的日历。已屏蔽和已预订的夜晚，其 `status` 不会是 `available`。
接待员提供了入住时间过短的选项	在工具描述中要求它检查到达当晚的 `minimumStay`。