企业微信 API 基础设施
消息、客户、外部群、好友与事件回调，统一成一套 REST 接口。 不用自己搭接入环境，不用为每种能力对接不同形态 —— 拿到凭证就能开始调。
REQUEST
curl -X POST https://manager.wecomapi.com/message/sendText \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"guid": "7db8...",
"toId": "78813...",
"content": "Hello WeCom"
}'RESPONSE200 OK
{ "code": 0, "msg": "success" }x-request-id: req_7d4ec1a9
x-ratelimit-remaining: 98
WEBHOOK EVENTS
CORE CAPABILITIES
消息、事件、客户、群聊与外部群、账号实例与系统集成，统一在一套 REST 接口与 Webhook 之下。企业微信 API 开发所需的能力都在这里，不必为每类能力单独维护一套接入方式。
Messaging
12 种消息类型，从文本图片到小程序、名片与视频号，都走同一个发送接口。
{
"method": "/message/sendImage",
"params": {
"guid": "7db8...",
"toId": "R_1042",
"imageUrl": "https://cdn.example.com/a.png"
}
}Webhook
账号侧发生的变化以事件形式推送到你的回调地址，不需要轮询拉取。
message.received消息事件friend.applied好友事件customer.add客户事件room.member.join群事件instance.offline账号状态事件事件按类型分发，可按需订阅。每条推送的结构一致：
{
"event": "message.received",
"guid": "7db8...",
"data": { ... }
}Customer
外部联系人、好友申请、客户标签与朋友圈，客户侧数据可读可写、可同步进自有系统。
Group
从建群到日常运营，内部群与企业微信外部群的生命周期都可以由程序驱动，是企业微信外部群开发中最常用的一组接口。
Instance
每个账号运行在独立实例中，登录状态与运行状态都可通过接口查询。
7db8c1a2···在线3f19be40···在线Platform
以标准 HTTP 接口对接，已有业务系统不需要为此改造架构。
同一套凭证与接口，可同时服务多个内部系统。
快速开始
从创建应用到发出消息只有三步，不需要自建接入环境，也不需要额外的服务器。
注册 wecomapi，创建应用并获得调用凭证。
凭证在控制台可随时轮换，测试与生产环境相互隔离。
创建实例并通过企业微信扫码登录。
实例托管在服务端，登录态与心跳由平台维持。
调用消息接口发送第一条消息。
同一套请求结构覆盖消息、客户、群聊与 Webhook 接口。
# API_BASE 与 Token 在控制台创建应用后获取 curl -X POST "$API_BASE/message/sendText" \ -H "Authorization: Bearer $WECOM_TOKEN" \ -H "Content-Type: application/json" \ -d '{"guid":"7db8...","toId":"78813...","content":"Hello WeCom"}' # { "code": 0, "msg": "success" }
架构
业务系统只需要对接一套接口和一个回调地址。鉴权、路由、实例托管与事件分发都在网关内完成，账号数量发生变化时，接入方式保持不变。
消息、客户、群聊、好友与账号能力收敛到同一套 REST 接口，不必为每个账号单独适配调用方式。
企业微信侧产生的消息与客户事件由网关统一整理，推送到你配置的回调地址，业务系统无需轮询。
既可以直接使用托管实例快速接入，也可以按需私有化部署到你自己的服务器上。
应用场景
同一套 REST API 与 Webhook，覆盖智能客服、客户运营、社群自动化与内部系统集成的常见落地方式。
消息事件推送到你的服务，由你自己的模型决定怎么回答，再通过接口原路发回企业微信。
客户、好友、标签、会话、群聊统一管理，同一套接口即可与自有 CRM 的数据模型对齐。
通过事件监听感知群成员变动与群消息，把群公告、群运营中重复的动作交给程序执行 —— 企业微信外部群开发的典型落地形态。
把企业微信接入内部业务系统：系统既能接收事件回调，也能主动发起消息与操作。
Production Ready
接入之后真正要面对的是长期运行：实例怎么隔离、状态怎么看、出问题怎么查。这些能力从第一天起就在。
不同企业微信实例独立运行。
单个实例的运行状态不影响同账号下的其他实例。
实时掌握账号在线和运行状态。
控制台可查看每个实例的当前状态，状态变化也会通过事件推送。
实例异常提供恢复机制。
检测到实例异常后可发起恢复流程，无需重建接入配置。
事件投递失败自动处理。
回调地址不可达或返回非成功状态时，事件会重新投递。
Trace ID 帮助快速定位问题。
每次调用返回唯一 Trace ID，可凭它检索该请求的完整链路。
满足大型企业与高安全要求场景。
支持部署在客户自有服务器，数据不出企业内网。
具体的状态字段、重试策略与部署方式，以接口文档为准。
查看开发文档Developer First
标准 REST API、JSON 数据结构与 Webhook 事件模型，让 Java、Node.js、Python、Go 等技术栈都可以快速接入。
REQUEST
curl -X POST "$BASE_URL/message/sendText" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"guid":"7db8...","toId":"78813...","content":"Hello WeCom"}'
RESPONSE
{ "code": 0, "msg": "success" }WEBHOOK EVENT
{
"event": "message.received",
"guid": "7db8...",
"data": {
"fromId": "78813...",
"msgType": "text",
"content": "在吗"
}
}价格
按账号按月计费，规模与用量变化时不必重新谈方案；需要独立环境与更高安全要求时，可选择私有化部署。
适合开发者、中小企业与 SaaS 产品。
单账号封顶价。时长与账号数折扣可叠加，最低 ¥25 / 账号 / 月。
包含
部署在你自己的服务器与网络环境中，数据与实例由你掌控。
依据账号规模与部署环境评估
适合
说明账号规模与部署环境，我们据此出具方案。也可直接加微信 cc_wecomapi
不确定选哪种方案？查看完整价格说明
Guides
从接口参数到事件回调，接入过程中会用到的文档与示例都在这里。
把企业微信里的日常操作变成你系统可以调用的 HTTP 接口：发送与接收消息、管理外部联系人、处理群聊与外部群成员、添加好友，以及查询和维护账号实例的在线状态。常见的企业微信外部群 API 开发需求，例如批量建群、成员进退群监听与群发，都在这一层完成。
调用方向是双向的 —— 你的系统通过 REST API 主动发起动作，企业微信侧产生的事件则通过 Webhook 推送回你的服务。
企业微信开放平台面向的是「在企业微信里安装一个应用」，能力范围由应用的可见范围与授权决定，接入前需要企业管理员完成一系列配置。
wecomapi 面向的是「让已有系统直接对接一个企业微信账号」。我们把账号实例托管起来，对外只暴露统一的 REST API 与 Webhook，你不需要维护接入环境，也不需要为每种能力对接不同的接口形态。
换个说法：如果你要做的是企业微信二次开发 —— 把消息、客户、外部群这些能力接进自己的 CRM、SCRM 或 AI 工作流，那么企业微信 API 二次开发的工程量主要花在接入环境与状态维护上，而这部分正是网关替你收敛掉的。两者解决的是不同层面的问题，也可以并存；具体能力边界以线上接口文档为准。
支持。每个企业微信账号对应一个独立的实例，拥有各自的 guid。调用接口时用 guid 指定要操作的账号，Webhook 推送的事件同样会带上来源实例，因此同一套服务可以同时管理多个账号，无需为每个账号单独部署。
支持。配置回调地址后，收到消息、新增外部联系人、群成员变动等事件会以 JSON 的形式 POST 到你的服务，事件中包含来源实例、事件类型与业务字段。
建议回调接口尽快返回，把耗时逻辑放进队列异步处理，并按事件做幂等，避免重复投递造成重复动作。
可以。wecomapi 负责通道，不绑定任何模型厂商：你的服务在 Webhook 里拿到用户消息，自行调用需要的大模型或业务逻辑，再用发送消息接口把结果回复回去。常见的做法是在中间加一层会话上下文与人工接管开关。
支持。可以把服务部署在你自己的服务器或内网环境中，接口形态与云端一致，业务数据不出你的环境。具体的资源要求与交付方式，可以联系我们按场景确认。
支持。接口是标准的 HTTP + JSON，不依赖特定语言的 SDK，Java、Python、Node.js、Go、PHP、C# 等任何能发起 HTTP 请求、能提供一个回调地址的技术栈都可以接入。