跳到导航

Shopmonkey

通过 webhook 工具将预约请求添加到 Shopmonkey 日历。

借助 webhook 工具,当来电者想将车辆送至店内时,接待员可在 Shopmonkey 日历中添加预约。

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

设置

1

创建 API 密钥

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

2

创建 webhook 工具

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

字段值
名称create_shopmonkey_appointment
说明”来电者选定日期和时间后,将预约添加到店铺日历。先与其确认时间。“
方法POST
URLhttps://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。

3

测试

通过预约一次换机油来测试接待员。检查预约是否以正确的本地时间显示在 Shopmonkey 日历中。

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

限制

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

故障排除

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