Skip to main content

Documentation Index

Fetch the complete documentation index at: https://beaver.voc.ai/llms.txt

Use this file to discover all available pages before exploring further.

若在 UI 中配置了 tagsUrl,Shulex 会在以下场景回调标签结果。

触发场景

场景回调标签来源默认值
AI 成功回复后repliedTagsshulex_ai_replied
AI 判断需要转人工,或前置过滤命中转人工动作handoffTagstransfer_to_agent

请求格式

POST {tagsUrl}
Content-Type: application/json
{replyAuthHeader}

回调体

例:AI 已回复
{
  "ticketId": "order-2024-88001",
  "tags": ["shulex_ai_replied"]
}
例:转人工
{
  "ticketId": "order-2024-88001",
  "tags": ["transfer_to_agent"]
}

字段说明

字段类型说明
ticketIdstring对应原始工单 ID
tagsarray需要第三方系统写入工单的标签列表
当前 Custom Ticket 链路的 tagsUrl 不是任意 AI 分类标签回调;它主要用于写入“已由 Shulex AI 回复”和“转人工”这类流程标签

期望响应

{
  "code": 0,
  "message": "success"
}
tagsUrl 失败会记录告警日志,不会中断主流程。但仍建议你的接口快速返回,并对同一 ticketId + tag 做幂等处理。