> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Shopmonkey

借助 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks)，当来电者想将车辆送至店内时，接待员可在 Shopmonkey 日历中添加预约。

> **Warning**
>
> Shopmonkey 不会检查通过这种方式创建的预约是否冲突，因此接待员
> 可能会重复预约同一时段。请告知来电者，该时间只是请求，店铺会
> 另行确认；或在接待员说明中提供营业时间和工位数量限制。

## 设置

### 创建 API 密钥

在 Shopmonkey 中，管理员依次打开 **Settings** → **Integration** → **API Keys**，然后选择 **Get Started** 或 **Add New Key**。选择 **Create API Key** 并立即复制密钥：Shopmonkey 仅显示一次。该密钥拥有创建它的用户所具备的相同权限。

### 创建 webhook 工具

在 Reception.ai 中，前往 **Integrations**，选择 **Add integration**，然后选择 **Webhook Tool**。

| 字段         | 值                                                                                                                                                                                                                                                                                       |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **名称**     | `create_shopmonkey_appointment`                                                                                                                                                                                                                                                         |
| **说明**     | "来电者选定日期和时间后，将预约添加到店铺日历。先与其确认时间。"                                                                                                                                                                                                                                                       |
| **方法**     | POST                                                                                                                                                                                                                                                                                    |
| **URL**    | `https://api.shopmonkey.cloud/v3/appointment`                                                                                                                                                                                                                                           |
| **请求标头**   | `Authorization`: `Bearer ` 后接 API 密钥                                                                                                                                                                                                                                                    |
| **正文参数**   | `name`（字符串，必填）：“服务项目和来电者姓名，例如：Oil change - Jane Doe。”  `startDate`（字符串，必填）：“UTC 格式的开始时间，采用 ISO 8601 格式，例如 2026-11-04T15:00:00.000Z。”  `endDate`（字符串，必填）：“采用相同格式的结束时间。除非来电者所需服务耗时更长，否则使用开始时间后 1 小时。”  `color`（字符串，必填）：“始终使用精确值 `blue`。”  `note`（字符串，必填）：“来电者的姓名、电话号码、车辆年份、品牌和型号，以及所需服务。” |
| **分配给智能体** | **Receptionist**                                                                                                                                                                                                                                                                        |

选择 **Enable**。

### 测试

通过预约一次换机油来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。检查预约是否以正确的本地时间显示在 Shopmonkey 日历中。

`color` 必须是 `aqua`、`black`、`blue`、`brown`、`gray`、`green`、`orange`、`purple`、`red` 或 `yellow` 之一。请使用团队未用于其他预约的颜色，以便电话预约更醒目。

## 限制

* Shopmonkey 的客户搜索需要电话号码列表，而 webhook 工具无法发送。因此，接待员无法查找来电者，也无法将预约关联到客户或车辆记录。来电者信息会记录在备注中。
* 该工具无法重新安排或取消预约。这些操作需要在 URL 中提供预约 ID。

## 故障排除

| 问题                  | 检查项                                        |
| ------------------- | ------------------------------------------ |
| Shopmonkey 返回 401   | 标头必须为 `Bearer ` 后接有效密钥，且 `Bearer` 后须有一个空格。 |
| 预约时间不正确             | 时间必须使用 UTC。将店铺时区添加到接待员说明中，确保其能正确转换。        |
| 关于 `color` 的 400 错误 | 使用 Shopmonkey 的颜色名称之一，并采用小写。               |
| 预约没有客户信息            | 在说明中要求接待员先收集来电者的姓名、号码和车辆信息。                |