企业微信消息通道 · 会话级 API

企业微信机器人 API,
让 AI Agent 读写企微群消息

机器人的私聊与群聊,都变成可编程的收发接口:Webhook 实时推送 9 种消息、REST 发送与双向归档查询、媒体按需转存。让 Dify / Coze / n8n 的 Agent 拥有企业微信的「手」和「眼」。

服务 1000+ 企业客户 私聊 + 群聊 全通道 9 种 · 发 5 种消息类型
terminal — 微桥快速开始
# 1. 后台开启 API 服务,拉取机器人的会话列表
$ curl 'https://api.webridge.cn/api/groups?secret=wb_sec_8f3k...'
← { "name": "华东客户群", "conversation_id": "R:16888573...",
    "send_secret": "wb_ss_9f2a...", "message_secret": "wb_ms_31c7..." }
 
# 2. 在群里发「开启接口」后,向该会话发送消息
$ curl -X POST 'https://api.webridge.cn/api/send?secret=wb_ss_9f2a...\&conversation_id=R:16888573...' \
  -d '{"msgtype":"text","text":{"content":"今日订单已同步,共 37 单"}}'
← HTTP 200 ✓ 已送达「华东客户群」
 
# 3. 群里来消息,实时推送到你的 Webhook:
← POST /your-callback { "msgtype": "text",
  "text": "帮我查下订单 12345 的物流" }
已接入生态:DifyCoze 扣子n8nworkbuddy及任意 HTTP 调用的 Agent 框架
为什么需要微桥

让 AI 机器人进企业微信群,
一直是个麻烦事 官方接口各有局限,自建协议成本又高。微桥用一个 Secret 把这件事变简单。

痛点 1

官方群机器人进不了外部群,也只能发、不能收

企业微信官方的群机器人 webHook 只支持内部群,且只能发消息、不能收消息。面对客户群(外部群)里的真实咨询,你的 AI 客服连「进群」都做不到,更别说听懂并回复,只能让销售手动盯群。

痛点 2

RPA / 协议外挂方案脆弱、难维护

用自动化脚本或协议方案做企微收发,隔三岔五要适配企微版本更新,登录态还容易掉线封号;消息格式、会话 ID、媒体文件都要自己处理,稳定性差、维护成本高,团队精力全耗在和协议对抗上。

痛点 3

自建方案开发成本高

自己对接协议、做会话管理、鉴权重试、消息格式适配,一套下来至少数周,还占运维精力,不如把精力花在 Agent 本身。

微桥的解法:机器人的每个会话——无论私聊还是群聊——都是一组独立密钥的 API。后台开启 API 服务后,用机器人级 secret 拉取会话列表,拿到每个会话的 conversation_id 与专属密钥;在会话里发送「开启接口」即完成启用。收消息走 Webhook、发消息走 REST、历史消息随时归档查询,媒体文件按需转存——你的 Agent 用什么框架、接什么模型都行。六个接口,收、发、查、媒体、会话管理全覆盖。

核心能力

为 AI Agent 而生的企微消息通道 像 Discord Bot 之于 Discord——简单、开放、可编程。AI 客服、订单播报、会话存档,一个通道全搞定。

🔄

双向收发 · 私聊 + 群聊

Webhook 实时推送收到的 9 种消息:文本、图片、语音、文件、小程序、链接、名片、位置、视频号;REST 发送文本、链接卡片、图片、小程序卡片、名片。听得到、答得上。

🗄️

会话存档 · 消息归档查询

会话内双向消息自动归档,GET /api/messages 分页查询任意历史记录,role 区分对方与机器人发送。对话记录直接变成可检索的数据资产。

🔑

三级密钥权限体系

机器人级 secret 管全局;会话级 send_secret 只能发、message_secret 只能查——权限最小化,单个会话可独立开关接口,泄露可单独吊销。

🖼️

媒体安全转存

图片、语音、文件按需转存为可下载 URL(media.ready 回调通知),全程不暴露微信 CDN、file_idaes_key,按配置自动过期删除。

纯 HTTP · 任意语言直调

六个接口、标准 JSON,无需 SDK 依赖:后台开 API → 拉会话列表 → 会话说「开启接口」→ 收发跑通。Python、Node、Java 还是低代码平台,都只是发 HTTP 请求。

🖥️

可独立部署

对数据敏感?整套网关 Docker 一键私有化部署,媒体文件存本地持久目录,消息不经过第三方,机器人数量与额度自己管。

工作原理

四步,把一个群变成 API 无需企业认证、无需开放平台申请——后台配置到跑通第一条消息,最快几分钟。

1

后台开启 API

机器人后台配置 Webhook 地址、启用 API 服务,获得机器人级 secret。

secret = wb_sec_8f3k...
2

拉取会话列表

调 /api/users 与 /api/groups,拿到每个会话的 ID 与专属密钥。

R:群聊 / S:私聊
3

会话内开启接口

会话级接口默认关闭,运营者在对应私聊/群聊发送一句话启用。

开启接口
4

收发与查询

Webhook 收新消息,/api/send 发消息,/api/messages 查归档。

收 · 发 · 查 ✓
应用场景

开发者在用微桥做什么 每个场景都有一篇含完整可抄代码的教程。

客户案例

已经在生产环境跑起来的机器人 以下数据来自客户实际使用反馈(上线前替换为经客户确认的数据)。

教培 · 知识付费

AI 客服接管 12 个学员群

课程咨询、开课提醒、资料发放全部由知识库 + 大模型自动应答,复杂问题自动@班主任。

85%咨询自动应答率
<10s平均响应时间
"晚上 11 点的咨询也能秒回,第二天醒来直接看到转化线索。"
电商 · 代运营

订单同步机器人服务 20+ 品牌

ERP 状态变更实时播报到各品牌对接群,异常订单自动置顶提醒,运营人力省一半。

300+日均自动播报条数
20+同时管理的群
"以前专人盯群发消息,现在机器人干,人只处理异常。"
金融数据服务

行情早晚报定时推送

每交易日早晚定时推送行情摘要到付费客户群,支持群内回复代码实时查询个股数据。

1000+覆盖付费客户
2人天从接入到上线
"原来给客户做数据推送要开发一周,接入微桥两天上线了。"
开发者视角

六个接口,覆盖收、发、查、媒体 纯 HTTP + JSON,任意语言直调。会话列表、消息发送、归档查询、媒体转存、Webhook 推送,各司其职。

发送消息 · POST /api/send curl
# 向群聊(或私聊)发送一条文本消息
$ curl -X POST 'https://api.webridge.cn/api/send\
    ?secret=wb_ss_9f2a...&conversation_id=R:16888573...' \
  -H 'Content-Type: application/json' \
  -d '{
    "msgtype": "text",
    "text": { "content": "今日订单已同步,共 37 单 ✅" }
  }'

# 同一接口还支持:
# link     链接卡片(title / url / desc / image_url)
# image    图片(任意可访问的图片 URL)
# miniprogram  小程序卡片(可复用查询接口返回对象)
# contact  名片(share_user_id)
归档查询 · GET /api/messages json
{
  "list": [{
    "id": "66c01234567890abcdef1234",
    "conversation_id": "R:16888573...",
    "role": "user",          // user=对方 assistant=机器人
    "msgtype": "text",
    "text": { "content": "帮我查下订单 12345 的物流" },
    "message_at": "2026-08-23T08:30:00.000Z"
  }],
  "pagination": { "page": 1, "page_size": 50, "total": 128 }
}
# 图片/语音/文件默认仅返回 media_id,
# 调 /api/media/:id/resolve 按需转存后
# 收到 media.ready 回调即得可下载 url
定价

从免费开始,按需升级 免费档永久有效,不是限时试用。先用出效果,再谈付费。

永久免费

免费档

¥0
体验、个人项目、养自己的机器人
  • 1 个机器人
  • 2 个会话(群)
  • 仅支持纯文本消息
  • 每天收发共 100 条
  • REST + Webhook 接入
  • 社区支持
立即免费开始
最受欢迎

专业版

¥1,680/年
单机器人生产环境
  • 1 个机器人
  • 支持文本以外的消息类型
  • 消息收发不限
  • 全部接入方式
  • 调用日志与告警
  • 专属支持群
开始使用

独立部署

¥8,800起 / 一次性
服务商、数据敏感型客户
  • 无任何数量限制
  • Docker 一键私有化部署
  • 总管理后台(额度/有效期)
  • 消息数据不出内网
  • 可自定义品牌对外销售
  • 部署与培训支持
联系我们
微桥只做消息通道,不绑任何模型:你的 Agent 用 DeepSeek、通义千问、Kimi 还是自建模型,由你决定——模型部署在你的 Agent 侧,Key 和成本自己掌控,随时更换。
常见问题

你可能想问 完整 20 条 FAQ 见 常见问题页

企业微信群机器人 Webhook 能接收消息吗?
官方群机器人 Webhook 只能单向发送,无法接收群消息。微桥提供双向能力:Webhook 实时推送每个会话(私聊与群聊)收到的消息,发送走 REST API,这是做对话式 AI 机器人的前提。
如何让 Dify / Coze / n8n 的 Agent 接入企业微信?
三步:① 后台开启 API 服务并配置 Webhook,从会话列表接口拿到 conversation_id 与 send_secret;② 在 Dify/Coze/n8n 里把微桥 Webhook 配置为触发器(收到私聊/群聊消息即触发工作流);③ 工作流结尾调用 /api/send 回复。我们为每个平台提供了 一键导入模板
微桥有 MCP Server 或 SDK 吗?
微桥是纯 HTTP + JSON 接口,任意语言无需 SDK 即可调用,与 Dify、Coze、n8n、FastGPT 等所有支持 Webhook / HTTP 的 Agent 框架天然兼容;官方 MCP Server 与 Python / Node SDK 在产品路线图上。
免费档真的永久免费吗?
是。免费档(1 机器人 / 2 会话 / 仅支持纯文本 / 每天收发共 100 条)永久有效,不是限时试用,也不需要绑卡。超限时返回 429 限流提示,不会产生任何费用。
微桥支持哪些消息类型?图片、语音、文件怎么获取?
接收支持 9 种:文本、图片、语音、文件、小程序、链接、名片、地理位置、视频号;发送支持 5 种:文本、链接卡片、图片、小程序卡片、名片。媒体类消息默认只回调 media_id,调用 媒体按需转存接口(POST /api/media/:id/resolve)后等待 media.ready 回调即可拿到可下载 URL,全程不暴露微信 CDN 与解密密钥。
密钥安全吗?泄露了怎么办?
微桥采用三级密钥体系:机器人级 secret 管全局,会话级 send_secret 仅能发送、message_secret 仅能查询,权限天然最小化。单个会话密钥泄露只影响该会话,后台可立即关闭该会话接口;Webhook 回调携带的 secret 字段可用于校验通知来源。
支持独立部署吗?
支持。独立部署版(¥8,800 起)整套网关 Docker 一键私有化,媒体转存文件存服务器本地持久目录、按配置自动过期删除,消息数据不出内网,附总管理后台管理机器人数量、额度和有效期。

5 分钟,让你的机器人
出现在企业微信群里

免费档永久有效 · 无需企业认证 · 纯 HTTP 接入 · 支持 Dify / Coze / n8n

商务合作 / 免费体验咨询:加微信 duopei365(备注 微桥,送 7天免费试用)
「微桥开发者群」前 100 位成员享专业版年费全免(1个)

联系我们

聊一聊你的场景 不确定微桥适不适合你?加微信描述一下你想做的机器人,我们直接给你方案。

💬

微信咨询(最快)

duopei365(大师兄)
备注 微桥,送 7天免费试用
工作时段平均 10 分钟内回复

👨‍💻

微桥开发者群

技术交流、模板分享、Bug 反馈
前 100 位成员专业版年费全免(1个)

🤝

代理 / OEM 合作

SCRM 同行、代运营、系统集成商
独立部署版支持自定义品牌对外销售
渠道政策请微信详聊