WORK WEIXIN EXECUTION API

企业微信API接口大全

把企业微信接入你的业务系统,像调用一个服务一样简单

查 看 API 文 档
API Key 已创建X-QIWEI-TOKEN
企业实例在线iPad / Windows 扫码登录
/msg/sendText消息已下发 · 响应 200
Webhook 已配置全量推送 / 按需订阅
PRODUCT CAPABILITIES

真 实 可 用 的 控 制 台 能 力

从 Token、实例、接口调试到回调、计费、发票与技术支持,形成完整企业微信接入闭环。

01

应用凭证与 Token

APP CREDENTIALS

按业务创建独立应用,区分生产/测试环境,支持 Token 查看、复制与绑定实例统计。

02

企业微信实例管理

INSTANCE MANAGEMENT

支持 iPad / Windows 设备,地区线路、自定义代理与 Aid,统一管理在线、离线、异常状态。

03

可视化接口调试

API DEBUGGER

选择应用与实例后自动填充 GUID,生成请求体及 cURL、JavaScript、Python 示例。

04

消息与业务 API

MESSAGING API

覆盖文本、图片、文件、视频、联系人、群、朋友圈、标签、会话等企业微信执行接口。

05

Webhook 回调配置

CALLBACK EVENTS

支持回调 URL、Authorization 鉴权、全量推送/按需订阅与一键连通性检测。

06

套餐与资源包

BILLING PACKAGE

按号数购买套餐包,支付成功自动生效,到期前短信提醒并同步收紧实例配额。

07

订单与发票闭环

INVOICE FLOW

已支付订单可申请发票,支持企业与个人抬头,自动计算可开票金额与历史累计。

08

文档与技术支持

SUPPORT & DOCS

提供 Apifox 文档、控制台内置技术支持客服问答,围绕接口、实例、回调场景答疑。

ONBOARDING WORKFLOW

四 步 完 成 接 入

首页看到的流程,登录控制台后都能直接操作。

STEP 01

创建应用凭证
获得业务 Token

每个业务线可以创建独立应用凭证,用于隔离生产/测试环境、实例绑定和回调配置。

  • Token 作为 X-QIWEI-TOKEN 请求头
  • 支持应用名称、备注和环境标记
  • 展示已绑定实例数量与回调状态
电商业务线生产通道PROD · Token 已生成2a6948fd-****-****-****
已绑实例马先红 · 在线 / Windows
STEP 02

扫码登录企业微信实例
让 API 有执行节点

选择应用后创建设备,扫码登录企业微信账号,系统自动记录 GUID、昵称、企业和在线状态。

  • 支持 iPad / Windows 设备类型
  • 支持地区线路、自定义代理与本机 Aid
  • 可停止、恢复或删除异常实例
总实例12
在线9
离线/异常3
STEP 03

选择接口并发送测试
请求体和示例自动生成

接口调试页按消息、联系人、群、朋友圈、标签等分类展示,选择实例后自动填充 GUID。

  • 统一网关 /work-weixin/api/doApi
  • 生成 cURL / JavaScript / Python 示例
  • 直接查看接口响应 JSON
POST /work-weixin/api/doApi{"method":"/msg/sendText"}
Response · 200{"code":0,"msg":"success"}
STEP 04

配置 Webhook 回调
让事件回到你的系统

配置业务回调地址,可选择全量推送或按需订阅指定事件,并支持 Authorization 密钥鉴权。

  • 私聊消息、群聊消息、登录状态、系统异常
  • 保存前先测试回调连通性
  • 回调地址由客户系统自定义接收
全量推送ON
按需订阅EVENTS
Authorization可选
DEVELOPER EXPERIENCE

10 分 钟 发 出 第 一 条 消 息

从控制台复制 Token 与 GUID,即可通过统一网关调用企业微信执行能力。

Terminal
# 发送文本消息
$ curl -X POST http://api.qiwx.online/work-weixin/api/doApi \
  -H "Content-Type: application/json" -H "X-QIWEI-TOKEN: your_token" \
  -d '{"method":"/msg/sendText","params":{"guid":"your_guid","toId":"user_id","content":"Hello QiWX"}}'
1
创建 Token
注册登录后创建应用凭证
2
实例上线
添加设备并扫码登录企微
3
调用 API
复制请求体和多语言示例
4
接收回调
配置 Webhook 推送事件
WEBHOOK EVENTS

消息与事件实时回流到业务系统

支持回调 URL、Authorization 鉴权、全量推送和按需订阅。保存配置前可一键测试连通性,确保客户系统能够正确接收 qiweapi 推送。

私聊消息群聊消息登录状态系统异常
PRICING PACKAGES

按 号 数 购 买 资 源 包

支持 1 / 3 / 10 / 20 / 50 个号套餐,3/6/12 个月灵活购买,12 个月约 8 折。

入 门 测 试

STARTER
¥300/ 月
1 个号,适合验证接入流程
  • 应用凭证与实例管理
  • 接口调试与示例代码
  • Webhook 回调配置
  • 订单与发票申请

企 业 部 署

ENTERPRISE
定制
私有化 / 独立资源 / 专属支持
  • 独立资源池与定制策略
  • SLA 与专属技术支持
  • 私有化部署方案
  • 企业级发票与交付流程
联 系 技 术 支 持
FREQUENTLY ASKED

常 见 问 题

什么是应用凭证 Token?+
应用凭证是每个业务通道的鉴权入口,接口调用时通过 X-QIWEI-TOKEN 传入,可独立绑定实例和配置回调。
一个应用可以绑定多个实例吗?+
可以。当前平台支持一个应用凭证绑定多个企业微信实例,便于同一业务线统一管理多个执行节点。
如何发送第一条企业微信消息?+
创建 Token 后添加实例并扫码上线,在接口调试页选择“发送文本消息”,系统会自动生成请求体和示例代码。
回调配置如何鉴权?+
回调可填写 Authorization 密钥。qiweapi 推送时会携带该值,客户服务端可据此校验请求来源。
套餐号数如何计算?+
套餐按可用号数计算,多个套餐包可叠加。套餐到期后系统会同步收紧配额,并在最后三天短信提醒。
是否支持发票和私有化部署?+
支持。已支付订单可在控制台申请企业或个人发票;企业客户可联系技术支持沟通私有化与独立资源方案。
START YOUR INTEGRATION

从 Token 到实例
从 API 到回调

立即完成企业微信接入闭环,在控制台中管理应用、实例、调试、回调、套餐与发票。

API 文 档