> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Hostaway

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

> **Note**
>
> 接待员无法创建预订或查询现有预订。它会查看日历并记录预订请求，
> 团队再根据[通话后 摘要](/docs/zh/reception-ai/features/notifications)确认入住。

## 开始前

### 创建 API 密钥

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

### 获取访问令牌

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

```bash
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 个月。

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

### 查找房源 ID

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

```bash
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`。

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

### 测试

通过询问已知被预订日期的小屋，再询问已知空闲日期的小屋来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。将回答与 Hostaway 日历进行对比。

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

## 限制

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

## 故障排除

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