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

# 文档介绍

> Shulex Intelli Custom Ticket Open API 对接文档概览

# 文档介绍

> Shulex Intelli Custom Ticket Open API 对接文档概览

Custom Ticket 用于将第三方工单系统接入 Shulex Intelli AI。第三方在有新消息时触发 Webhook，并提供工单详情查询、回复回调和可选的标签回调；Shulex 负责拉取完整上下文、执行 AI 处理，并将结果回传。

## 文档结构

<CardGroup cols={3}>
  <Card title="整体流程" icon="route" href="/api/ticket-ai/introduction/flow">
    了解第三方与 Shulex 之间的端到端调用顺序。
  </Card>

  <Card title="渠道配置" icon="sliders" href="/api/ticket-ai/introduction/channel-config">
    在 UI 中完成渠道、鉴权、回复格式和流程标签配置。
  </Card>

  <Card title="接口规范" icon="code" href="/api/ticket-ai/open-api/webhook">
    查看 Webhook、查询、回复、标签和 AI Summary 的详细字段定义。
  </Card>
</CardGroup>

## 核心概念

| 名词          | 含义                            |
| ----------- | ----------------------------- |
| Webhook     | 第三方在新消息到达时调用 Shulex 的触发接口     |
| `queryUrl`  | 第三方提供，供 Shulex 拉取完整工单详情       |
| `replyUrl`  | 第三方提供，供 Shulex 回传 AI 或人工回复    |
| `tagsUrl`   | 第三方提供，供 Shulex 回传已回复、转人工等流程标签 |
| `messageId` | 第三方本次触发消息的唯一 ID；存在时会随回调原样返回   |

<Note>
  版本变化和兼容性说明请查看 [变更记录](/api/ticket-ai/introduction/changelog)。
</Note>