Webhook 推送 - Shulex Intelli Custom Ticket Open API

当第三方平台有新消息时，向 Shulex 在 UI 中展示的 Webhook 地址发起 POST 请求。

Webhook 地址

请在 Shulex 前端 UI 创建渠道后，直接复制页面展示的 Webhook 地址。不要手动拼接 Webhook URL。 UI 展示的 Webhook 地址格式：

POST https://<host>/api_v2/intelli/v2/webhook/CUSTOM_TICKET/{xToken}/{channelId}

POST {webhookUrl}
Content-Type: application/json

{
  "ticketId": "order-2024-88001",
  "event": "new_message"
}

字段	类型	是否必填	说明
`ticketId`	string	必填	工单唯一 ID，Shulex 用它调用 `queryUrl` 拉取详情
`event`	string	选填	触发事件类型，例如 `new_message`、`ticket_updated`；当前链路不依赖该字段做分支处理

Webhook 只作为触发器使用。请求体至少包含 ticketId，完整工单内容不会从 Webhook body 读取。

{
  "code": 200,
  "message": "ok"
}

code=200 只表示 Shulex 已接收并进入处理链路，不表示 AI 回复已经完成。

{
  "code": 401,
  "message": "invalid token"
}

{
  "code": 400,
  "message": "unsupported platform: CUSTOM_TICKET"
}

{
  "code": 422,
  "message": "platform not configured"
}