BigCommerce | ElevenLabs Documentation

接待员可以查询来电者在 BigCommerce 商店中的订单，并告知订单状态。webhook 工具会通过 BigCommerce Orders API，按客户邮箱地址查找订单。

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

开始前

创建只读 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，然后用测试订单测试接待员：使用正确的订单号和邮箱查询，再使用错误邮箱查询，并确认第二通电话未获得任何详情。

响应中包含每笔订单的账单地址和付款详情。请添加一条规则或流程，规定接待员可通过电话分享哪些信息，例如仅分享订单状态和下单日期。

故障排除

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