订单回传

客户在你的网站下单后，让你的服务器把订单发给 SealReply。下单前 30 天内和客服聊过天的订单，会关联到这位访客最近的一次会话：

• 客户卡的跟进卡片里列出这位客户的全部订单，下单前 30 天内没聊过天的标“未经聊天”。
• 报表 → 成果多一张卡片"聊过天后下单（网站回传）"，按币种显示单数和金额。

这些订单和客服手动标记的"成交"分开统计。它只说明"聊过天后下了单"，不代表订单是聊天带来的。

准备

1. 在工作台 开发者 页面创建 API Key，勾选 conversations:write 权限（见鉴权与限制）。Key 只放在你的服务器上。
2. 在 站点 → 你的站点 → 访客身份验证 卡片底部复制站点 ID。
3. 用什么认出访客，二选一：
   • external_id：你网站自己的会员 ID。前提是已开启访客身份验证，并把同一个 ID 传给了插件。推荐用这个。
   • visitor_id：SealReply 的访客 ID，可以从 Webhook 或会话接口里拿到。

没登录就下单的游客认不出来。这样的订单照样保存，但不算"聊过天后下单"。

发送订单

POST https://api.sealreply.com/v1/site-orders
Authorization: Bearer sr_live_…
Content-Type: application/json

{
  "site_id": "0192f000-0000-7000-8000-000000000201",
  "order_id": "A-1001",
  "amount": "59.90",
  "currency": "USD",
  "placed_at": "2026-11-04T09:30:00Z",
  "external_id": "42"
}

字段	说明
site_id	站点 ID
order_id	你网站的订单号，同一个站点内唯一，最多 100 个字符
amount	金额，字符串，最多两位小数，例如 "59.90"
currency	三个字母的币种代码，例如 USD、CNY
placed_at	下单时间（可选），不填就是现在；最多比现在晚一天
external_id 或 visitor_id	二选一，见上文

新订单返回 201，同一个订单号再发一次返回 200，算是修改（例如金额改了），不会重复计数。返回的 conversation_id 是关联到的会话，没有关联到时为 null，from_chat 为 false。

撤回订单

订单取消或全额退款后，撤回它，报表就不再计入：

DELETE https://api.sealreply.com/v1/site-orders/A-1001?site_id=0192f000-0000-7000-8000-000000000201
Authorization: Bearer sr_live_…

找不到这个订单号时返回 404。

说明

• 会话后来被删除（手动删除或超过保存期限），已关联的订单仍然计入报表。
• 测试会话不参与关联。
• 每个工作区每小时最多发送 5,000 次（发送和撤回合计）。
• 完整字段见 API 参考。