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

# BigCommerce

接待员可以查询来电者在 BigCommerce 商店中的订单，并告知订单状态。[webhook 工具](/docs/zh/reception-ai/integrations/webhooks)会通过 BigCommerce Orders API，按客户邮箱地址查找订单。

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

## 开始前

### 创建只读 API 账户

在 BigCommerce 控制面板中，打开 **Settings** → **Store-level API accounts** 并创建 API 账户。为其命名，例如 "Reception"，将 **Orders** 权限范围设为 **read-only**，其他所有权限范围设为 **None**。之后无法更改权限范围。

### 复制凭据

保存账户并复制 **Access token** 和 **API path**。API 路径类似于 `https://api.bigcommerce.com/stores/STORE_HASH/v3/`；`/stores/` 后面的部分是商店哈希值。请将访问令牌视为机密信息。

## 创建 webhook 工具

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

| 字段                   | 值                                                                                                           |
| -------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Name**             | `find_bigcommerce_order`                                                                                    |
| **Description**      | "当来电者咨询订单时查询订单。首先索取订单号和订单中的邮箱地址，并请对方逐个拼读邮箱。仅分享订单 ID 和账单邮箱均与来电者所述内容匹配的订单详情。否则，告知无法找到订单，并提供回电服务。"             |
| **Method**           | GET                                                                                                         |
| **URL**              | `https://api.bigcommerce.com/stores/STORE_HASH/v2/orders`                                                   |
| **Request Headers**  | `X-Auth-Token`：访问令牌  `Accept`：`application/json`                                                            |
| **Query Parameters** | `email`（字符串，必填）：“来电者提供的邮箱地址。”  `sort`（字符串，必填）：“始终使用精确值 `date_created:desc`。”  `limit`（数字，必填）：“始终使用精确值 `5`。” |
| **Assign to agents** | **Receptionist**                                                                                            |

`sort` 和 `limit` 值会优先返回客户最新的订单，而不是最早的订单。

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

> **Tip**
>
> 响应中包含每笔订单的账单地址和付款详情。请添加一条[规则或 流程](/docs/zh/reception-ai/receptionist/rules-and-procedures)，规定接待员可通过电话
> 分享哪些信息，例如仅分享订单状态和下单日期。

## 故障排除

| 问题                 | 检查内容                                             |
| ------------------ | ------------------------------------------------ |
| BigCommerce 返回 401 | 标头必须命名为 `X-Auth-Token`，并填写访问令牌，而不是客户端 ID 或客户端密钥。 |
| BigCommerce 返回 403 | API 账户缺少 **Orders** 只读权限范围。请创建具有该权限的新账户。         |
| BigCommerce 返回 404 | 检查 URL 中的商店哈希值，并确认 URL 使用 `/v2/orders`。          |
| 响应为空               | 没有使用该邮箱的订单。请确认来电者提供的是结账时使用的邮箱。                   |