> 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.

# WooCommerce

接待员可以查询 WooCommerce 商店中来电者的订单并告知其状态。[Webhook 工具](/docs/zh/reception-ai/integrations/webhooks)会通过 WooCommerce REST API 搜索商店订单。

> **Warning**
>
> 订单包含客户姓名、地址、电话号码和购买记录。接待员在分享任何信息前，必须
> 确认来电者就是该客户。下面的工具说明会要求提供订单号和订单中的邮箱地址，且仅在
> 两者都匹配时讨论订单。

## 开始前

### 检查商店设置

商店必须使用 HTTPS，并启用固定链接：在 WordPress 中打开 **设置** → **固定链接**，选择 **朴素** 以外的任意选项。

### 创建只读 API 密钥

在 WordPress 中打开 **WooCommerce** → **设置** → **高级** → **REST API**，然后选择 **添加密钥**。输入说明，例如“Reception”，选择用户，将 **权限** 设为 **读取**，然后选择 **生成 API 密钥**。复制 **Consumer key** 和 **Consumer secret**；密钥仅显示一次。

### 构建请求头值

WooCommerce 使用 HTTP 基本认证验证密钥。在电脑上构建请求头值：

```bash
printf 'CONSUMER_KEY:CONSUMER_SECRET' | base64
```

## 创建 Webhook 工具

前往 **集成**，选择 **添加集成**，然后选择 **Webhook Tool**。

| 字段         | 值                                                                                        |
| ---------- | ---------------------------------------------------------------------------------------- |
| **名称**     | `find_woocommerce_order`                                                                 |
| **说明**     | “当来电者询问订单时查询订单。先询问订单号和订单中的邮箱地址，并让对方逐字拼读邮箱。仅分享订单号和账单邮箱都与来电者所述一致的订单详情。否则，说明未找到订单，并提供回电服务。” |
| **方法**     | GET                                                                                      |
| **URL**    | `https://YOUR-STORE.com/wp-json/wc/v3/orders`                                            |
| **请求头**    | 将 `Authorization` 设为 `Basic `，后接编码后的值                                                    |
| **查询参数**   | `search`（字符串，必填）：“来电者提供的邮箱地址。”  `per_page`（数字，必填）：“始终使用精确值 `5`。”                         |
| **分配给智能体** | **Receptionist**                                                                         |

选择 **启用**，然后使用测试订单[测试接待员](/docs/zh/reception-ai/receptionist/testing)：先使用正确的订单号和邮箱查询，再使用错误的邮箱查询，并确认第二次通话未获得任何详情。

> **Tip**
>
> 响应包含每笔订单的所有字段，包括地址。为接待员添加可在电话中分享内容的[规则或 流程](/docs/zh/reception-ai/receptionist/rules-and-procedures)，例如仅分享状态、订单日期和物流单号。

## 故障排除

| 问题                  | 检查内容                                                            |
| ------------------- | --------------------------------------------------------------- |
| WooCommerce 返回 401  | 重新编码请求头值。部分主机会在 WordPress 接收前移除 `Authorization` 请求头；请主机服务商将其传递。 |
| 404 `rest_no_route` | 检查 URL 中的商店地址，以及固定链接是否设为 **朴素**。                                |
| 未找到已知订单             | 搜索会匹配订单中存储的账单信息。检查来电者是否提供了结账时使用的邮箱。                             |
| 防火墙或安全插件将其拦截        | 在插件或主机防火墙中允许访问 `/wp-json/wc/`。                                  |