AI客服管理后台

机器人基础设置

机器人名称

欢迎语

System Prompt（AI 人设指令）

引导 AI 在对话中自然获取用户联系方式

🤖 机器人工作模式

回答模式

📚 仅知识库问答

只用知识库匹配回复，不调用AI，以引导留电为核心目的

🧠 知识库 + AI 增强

知识库注入 + 大模型智能回复，回复更自然

选择「仅知识库」时机器人以知识库为核心围绕引导客户留电，不会给出过于完整的答案

🧠 AI 模型配置已启用 0 个 · 轮询负载均衡

可添加任意数量的 AI 模型，开启的模型自动轮询分散压力。支持硅基流动、DeepSeek、通义千问、本地 Xinference 等所有 OpenAI 兼容接口。

🔗 Webhook 推送配置

配置 Webhook 后，系统会在用户对话、提取联系方式、转人工等事件发生时，主动向你的服务器发送 POST 请求。

启用 Webhook 开启后事件将自动推送到下方 URL

Webhook URL

接收推送的 HTTP(S) 地址，需能接受 POST application/json

Secret 密钥（可选）

填写后每个请求会带上 X-Webhook-Secret 请求头，用于验证身份

触发事件

用户发新消息 — 用户每发一条消息时触发 AI 回复 — 机器人/AI 回复消息时触发 提取到联系方式 — 检测到手机号/微信/邮箱时触发 转人工 — 用户请求转接人工客服时触发 新访客首次访问 — 新会话首次发消息时触发

📖 Webhook 数据格式说明

POST 你的 Webhook URL
Content-Type: application/json
X-Webhook-Secret: 你配置的密钥（如填写了）

{
  "event": "newMessage",          // 事件类型
  "timestamp": "2025-07-01T...",  // ISO 时间
  "data": {                        // 事件数据（各事件不同）
    "sessionId": "xxx",
    "message": "用户消息内容",
    ...
  }
}

事件类型：
  newMessage        — data: { sessionId, agentId, message, mode }
  aiReply           — data: { sessionId, agentId, userMessage, reply }
  contactExtracted  — data: { sessionId, agentId, contacts[], message }
  transferToHuman   — data: { sessionId, reason, agentId }
  newVisitor        — data: { sessionId, agentId, firstMessage }

📨 入站 Webhook（AI 作为服务方）

开启后，外部系统（如企业微信、钉钉、其他平台）可以把用户消息推送到我们的 AI 机器人，机器人处理后同步返回 AI 回复。

启用入站 Webhook 开启后外部系统即可调用下面的接口地址

鉴权 Token

外部系统调用时必须携带此 Token，用于验证身份

接口地址

将此地址配置到外部系统的 Webhook 回调中

📖 接口调用文档

请求方式：POST http://172.16.1.244:9988/api/webhook/incoming

鉴权（三选一）：
  方式1：Header  Authorization: Bearer <你的Token>
  方式2：Body    { "token": "你的Token", ... }
  方式3：Query   ?token=你的Token

请求头：
  Content-Type: application/json

请求体：
{
  "message": "你好，请问怎么收费？",   // 必填，用户消息
  "sessionId": "wx_user_12345",       // 选填，会话ID（用于上下文记忆）
  "agentId": "agt_default",           // 选填，指定客服机器人
  "userId": "user_abc",               // 选填，外部用户ID（替代sessionId）
  "token": "你的Token"                // 选填，放body里的鉴权
}

成功响应（200）：
{
  "success": true,
  "reply": "您好！我们的收费标准是...", // AI回复内容
  "sessionId": "sess_inbound_xxx",     // 会话ID
  "mode": "ai",                        // 模式：ai 或 human
  "contacts": [],                      // 自动提取的联系方式
}

错误响应：
  401 — Token 验证失败
  403 — 入站 Webhook 未启用
  400 — message 为空

curl 示例：
curl -X POST http://172.16.1.244:9988/api/webhook/incoming \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"message":"你好","sessionId":"user_001"}'

🔒 管理后台登录

💳 名片模板编辑