欢迎回来，继续使用企业微信执行能力
接入状态一览，点击左侧菜单进入各功能模块
⚡ 新功能
发送一条企业消息
在调试台选择通道一键发送：群机器人通知、应用消息、Markdown 图文，全部可视化完成，请求代码自动生成。
EXECUTION RESULT
Status: 200 OK
Delivered to WeChat
Message Sent
💡
建议：将能力接入业务系统 —— 工单、监控、审批等系统只需调用统一网关即可下发企业微信消息，与业务系统完全解耦。
当前状态
应用、通道、回调与套餐的实时概览
快捷操作
⌨
接口调试可视化发起调试请求
🔗
配置回调将事件推送至业务系统
🚀
创建通道添加群机器人发送通道
X-QIWEI-TOKEN
-选择接口后录入参数进行调试
POST/api/qw/doApi
参数请求（自动生成，可直接复制）复制
复制以下任一语言的代码直接使用
cURLJavaScriptPython
CONSOLE RESPONSE
⚡Waiting for request…
点击左侧「Send」发起调试
点击左侧「Send」发起调试
| 应用名称 | 已绑通道 | 环境 | 凭证 | 回调状态 | 创建时间 | 操作 |
|---|
ℹ️ 自托管版不限制通道数量，无需升级套餐。群机器人与应用通道均走官方接口，稳定可靠。
通道概览
什么是通道？
本页「实例」即发送通道：群机器人 Webhook 可发群消息；应用通道（corpid+secret）可发给成员/部门，均走官方接口。
套餐与服务
当前部署为自托管版本，无需购买套餐
当前套餐：自托管企业版
套餐有效期
永久 自托管
业务类型
接收 + 发送
可用号数
不限 自家服务器
月度成本
¥0 平台费
本月资源使用
实时统计（最近 24 小时窗口）
详细规则说明
- 自托管版本无需购买任何套餐包，号数与调用量仅受服务器性能限制。
- 成本构成为服务器与域名费用，无平台月费、无按号计费。
- 数据（应用、通道、消息日志）全部存储在本机 data/data.json，可自行备份迁移。
- 如需对外经营（给其他团队开号计费），联系管理员加装运营端。
发票申请
自托管系统无消费订单，无需开票
🧾
没有可开票订单
平台费用为 ¥0（自托管），服务器费用请向云服务商索取发票。
如后续加装运营端对外经营，此处将支持订单开票流程。
开发文档
统一网关 API · 与主流企微代发平台调用方式兼容
1. 基础信息
2. 接口方法（method）
| method | 说明 | 主要参数 |
|---|---|---|
/msg/sendBotText | 群机器人发文本 | botId, content, mentionedList? |
/msg/sendBotMarkdown | 群机器人发 Markdown | botId, content |
/msg/sendBotImage | 群机器人发图片 | botId, base64 或 url |
/msg/sendBotNews | 群机器人发图文 | botId, articles[] |
/msg/sendAppText | 应用消息发给成员 | toUser|toParty|toTag, content |
/msg/sendAppMarkdown | 应用 Markdown | toUser, content |
/msg/sendText | 兼容模式（自动选择通道） | botId 或 toId, content |
/bot/list | 查询通道列表 | — |
快速示例
3. 回调事件推送（收消息）
在企业微信后台配置回调后，所有消息/事件将以下列 JSON 格式 POST 到你配置的回调地址
{
"type": "wecom_event",
"appId": "app_xxx",
"msgType": "text",
"fromUser": "zhangsan",
"chatId": "wr_xxx",
"content": "消息内容",
"raw": { ... }
}
// 推送携带 Authorization 头（若已配置密钥）；失败自动重试 3 次
4. 微信客服（私聊微信用户 · 官方合规）
客户从客服链接/客服小程序进入会话，收发全走官方接口，无封号风险
- 企微管理后台 → 应用管理 → 微信客服 → 开通并创建客服账号，拿到 open_kfid（wk 开头）
- 「微信客服」应用页 → API 区域 → 复制专用 Secret，填到本平台应用凭证的「微信客服 Secret」
- 收消息两条路：① 回调推送（消息事件自动转发到业务系统，与现有回调同一套配置）② 业务系统定时调
/kf/syncMsg拉取 - 发消息：
/kf/sendText（openKfid + toId + content），调试台可直接试
POST /api/qw/doApi {"method":"/kf/accounts"} // 查客服账号
POST /api/qw/doApi {"method":"/kf/syncMsg","params":{"limit":1000}} // 拉消息（游标翻页）
POST /api/qw/doApi {"method":"/kf/sendText","params":{"openKfid":"wkxx","toId":"woxx","content":"您好"}} // 回复客户
5. 外部群实时监听 + 大模型自动回复（智能机器人）
官方合规路径：群里 @机器人 的消息实时推送到本网关，自动调用大模型同步回复（5 秒内），无需业务系统参与
- 实例管理 → 通道卡片 → 回调 → 复制 URL / Token / EncodingAESKey 三项
- 企微管理后台 → 协作 → 机器人 → 创建智能机器人（同名）→ 接收消息服务器 → 照抄三项
- 把该智能机器人拉进外部群（客户群）；客户 @机器人 提问即触发
- AI 直通：在服务器 config.json 配置
llm.apiKey（GLM 兼容接口）并systemctl restart qwx-gateway；不配置则仅转发到「转发 URL」由业务系统自行处理 - 日志：消息日志页可看每条 @消息 和 AI 回复记录
config.json 增加字段后重启服务：
{
"port": 8790,
"adminPassword": "…",
"llm": {
"apiBase": "https://open.bigmodel.cn/api/paas/v4/chat/completions",
"apiKey": "你的GLM API Key",
"model": "glm-4-flash",
"systemPrompt": "你是XX公司的客服助手，回答简洁专业，不确定的问题引导联系人工。"
}
}
全量监听（不需要 @）：官方仅「会话内容存档」可读取外部群全部聊天（付费许可、需成员同意），且只能读不能回；回复仍需机器人。绝大多数客服场景 @触发 已够用。
6. 上线检查清单
- 应用凭证 → 创建应用 → 复制 Token（即 X-QIWEI-TOKEN）
- 实例管理 → 创建通道 → 粘贴群机器人 Webhook（群右键 → 群机器人 → 添加）
- 接口调试 → 选应用选通道 → Send 发出第一条消息
- 需要收消息：回调配置 → 填业务 URL 保存 → 到企业微信后台配置回调三项参数