首页/常见问题
FAQ · 20 条

企业微信机器人 API 常见问题

接入、平台集成、场景、技术与商务的 20 个高频问题，答案首句给结论。没找到答案？加微信 duopei365 直接问。

接入类

企业微信有类似 Discord Bot 的开放 API 吗？
有，但官方接口受限：官方群机器人 Webhook 只能单向发消息且仅限内部群，智能机器人需企业认证且能力封闭。微桥是面向开发者的会话级 API，把每个私聊/群聊会话变成可编程收发接口，支持 Webhook 接收、REST 发送与归档查询，是企微生态里最接近 Discord Bot 的形态。
企业微信群机器人 Webhook 能接收消息吗？
官方 Webhook 不能接收消息，只能单向发送，且进不了外部客户群。微桥提供双向能力：Webhook 实时推送每个会话（私聊与群聊）收到的消息，发送走 REST API，这是做对话式 AI 机器人的前提。
企微智能机器人和群机器人 Webhook 有什么区别？
智能机器人是官方 AI 客服形态，需企业认证、能力仅限知识库问答；群机器人 Webhook 只能单向发送且进不了外部客户群。微桥的会话级 API 介于两者之间：进任意群、双向收发、可对接你自己的大模型与业务系统。
个人开发者能调用企业微信 API 吗？
可以。微桥面向个人开发者开放：后台开启 API 服务后，用机器人级 secret 拉取会话列表，在会话内发送「开启接口」即可获得该会话的收发密钥，全程无需企业认证。
微桥怎么收费？免费档能用多久？
免费档（1 机器人 / 2 会话 / 仅支持纯文本 / 每天收发共 100 条）永久免费，不是限时试用也不需要绑卡。专业版 ¥1,680/年，单机器人，支持文本以外的消息类型且收发不限；独立部署 ¥8,800 起一次性。详见定价页。
微桥支持哪些消息类型？
接收支持 9 种：文本、图片、语音、文件、小程序、链接、名片、地理位置、视频号；发送支持 5 种：文本、链接卡片、图片、小程序卡片、名片。媒体类消息默认只回调 media_id，调用媒体转存接口后返回可下载 URL。

平台集成类

如何让 Dify 的 Agent 收发企业微信消息？
三步：① 后台开启 API 服务并配置 Webhook，从会话列表接口拿到 conversation_id 与 send_secret；② 在 Dify 里把微桥 Webhook 配置为触发器（收到私聊/群聊消息即触发工作流）；③ 工作流结尾调用 /api/send 回复。
Coze（扣子）怎么接入企业微信？
用微桥做消息通道即可：Coze 工作流的触发节点接微桥 Webhook（群消息到达即触发），结尾接 HTTP 请求节点调用 /api/send 把机器人回复发回群里。微桥是纯 HTTP 接口，Coze 的 HTTP 节点可直接调用，无需自定义代码。
n8n 如何对接企业微信？
n8n 用 Webhook 节点接收微桥推送的群消息事件，用 HTTP Request 节点调用 /api/send 发送回复，两步即可跑通；定时推送类任务用 Cron 节点 + HTTP Request 节点即可。
微桥支持 MCP 协议吗？
微桥是纯 HTTP + JSON 接口，任意语言与 Agent 框架无需 SDK 即可调用；官方 MCP Server 与 Python / Node SDK 在产品路线图上，届时 Claude 等 MCP 客户端可直接把读写企微消息作为工具调用。
微桥有 Python / Node.js SDK 吗？
官方 SDK 在路线图上，但当前不需要等它：六个接口均为标准 HTTP + JSON，用 requests / fetch 即可调用，示例代码见各应用场景教程页。
FastGPT / 自建 Agent 能接吗？
能。任何支持 Webhook 触发与 HTTP 调用的 Agent 框架都能接微桥：收到消息走 Webhook，回复走 /api/send，历史消息走 /api/messages 归档查询。微桥不绑定任何模型，模型部署在你的 Agent 侧。

场景类

怎么给企业微信群做自动推送订单的机器人？
核心是三步：① 把微桥机器人拉进客户群并开启接口；② 用你的业务系统监听订单状态变更；③ 变更发生时调用 /api/send 播报到对应会话。完整可抄的 Python 示例见订单跟单机器人教程。
群机器人怎么每天定时发早报？
用定时任务（cron / GitHub Actions / 任何调度器）每天触发一次你的脚本：脚本汇总资讯或数据后调用 /api/send 发送到目标会话即可。示例见早报机器人教程。
企微 AI 客服怎么搭建？
三步：① 把微桥机器人拉进客服群/客户私聊并开启接口；② 接到 Webhook 消息后调用你的大模型（或 Dify/Coze 工作流）生成回复；③ 调用 /api/send 发回。知识库问答、转人工都发生在你的 Agent 侧，微桥只做消息通道。示例见AI 客服机器人教程。

技术类

Webhook 回调怎么验签？失败会重试吗？
微桥 Webhook 推送中携带 secret 字段，你的回调接口比对 secret 即可完成来源校验。推送失败会自动重试，具体重试次数与退避策略以 API 文档为准，建议你的回调接口保持幂等。
消息量超限了会怎样？
免费档每天收发共 100 条，超出后返回 429 限流提示，不会产生任何费用；专业版单机器人且消息收发不限。
可以接入自己的大模型 Key 吗？（BYOK）
可以，而且微桥默认就是 BYOK：微桥只做消息通道，不绑任何模型。模型部署在你的 Agent 侧，Key 与成本自己掌控，换模型不影响上层应用。
支持独立部署吗？数据存哪里？
支持。独立部署版（¥8,800 起）整套网关 Docker 一键私有化，媒体转存文件存你服务器本地持久目录、按配置自动过期删除，消息数据不出内网，附总管理后台管理机器人数量、额度和有效期。

商务类

可以开发票吗？有代理商政策吗？
可以开发票（佛山市极速互动科技有限公司）。代理商/OEM 政策面向 SCRM 同行、代运营与系统集成商，独立部署版支持自定义品牌对外销售，合作请加微信 duopei365 详聊。
还有疑问？加微信 duopei365 直接问