平台简介 - WTAPI开发文档

WTAPI

WEIXIN AUTOMATION API

让微信能力通过 API 接入你的业务系统

面向开发者的微信机器人后端基础设施。基于 iPad / Mac 协议，无需逆向、无需自建设备阵列，通过标准 HTTP API 完成消息、好友、群聊、朋友圈等自动化，快速接入 CRM、AI 客服、私域运营与自动化系统。

快速开始查看 API 应用场景打开控制台

按角色快速开始

先选角色，按对应路径看，不用整站翻一遍。

我是开发者

把微信变成可调用的接口

1. 控制台拿 Token，扫码登录（见「登录流程说明」）
2. 按「快速入门」发出第一条消息
3. 要收消息再看「消息订阅收发」，其余接口在侧栏「API模块」

我是产品 / 运营

先确认能力是否覆盖你的业务

1. 看能做什么：消息、好友、群、朋友圈、视频号
2. 对照业务场景：AI 客服、私域、群运营、CRM
3. 范围清楚后再交给开发接入

能做什么

控制已登录的微信，事件推到你的系统。客服、CRM、AI 在你这边。

发消息

文字 / 图片 / 视频 / 文件 / 链接 / 名片 / 小程序

管好友

搜索、添加、备注、通讯录、标签

管群

建群、邀请、公告、成员、管理员

朋友圈

发布、点赞、评论、列表

标签 / 视频号

好友分层、视频号互动

收事件

消息、进群等推到你的回调

5 分钟完成第一次调用

按最短路径先发通一条消息，再接 Webhook 与业务系统。

获取 Token→登录微信→调用 API→返回结果

最简请求示例

使用 POST 发送文字消息。Header 携带 X-finder-TOKEN，并将 YOUR_TOKEN、YOUR_APPID 替换为实际值。部分环境还需 Authorization: Bearer <JWT>（见「接入开发规范」）。

快速测试：将 toWxid 设为 filehelper，向文件传输助手发送。

curl -X POST "https://wx.chuapi.com/finder/v2/api/message/postText" 
-H "Content-Type: application/json" 
-H "X-finder-TOKEN: YOUR_TOKEN" 
-d '{
"appId": "YOUR_APPID",
"toWxid": "filehelper",
"content": "Hello, WTAPI"
}'

完成第一次调用后，可继续配置 Webhook、接收消息以及接入业务系统。详见「快速入门」「消息订阅收发」。

API 能力地图

用于选对模块；详细参数以侧栏「API模块」正文为准。

模块	能做什么	入口
登录	二维码登录、回调、在线检测、退出、重连	API模块 / 登录接口
消息	发送文字、图片、文件、视频、链接，以及转发、撤回、下载	API模块 / 消息接口
联系人	搜索、添加、备注、检测关系、通讯录	API模块 / 联系人接口
群聊	创建群、邀请、公告、管理员、成员管理	API模块 / 群聊接口
朋友圈	发布、列表、点赞、评论	API模块 / 朋友圈接口
标签	创建标签、给好友打标、用户分层	API模块 / 标签接口
视频号	浏览、互动、私信、发布	API模块 / 视频号接口
Webhook	消息、进群等事件通知你的业务系统	消息订阅收发 / 回调信息速览

业务场景

WTAPI 负责微信一侧。话术、分层、CRM 字段在你自己的系统里。

AI 客服

用户发消息 → Webhook → AI → API 回复

私域运营

加好友 → 打标签 → 触达 → 回写系统

群运营

进群 → Webhook → 欢迎语 / 拉人 / 管群

CRM 对接

CRM → API → 微信执行 → 回写 CRM

群发与通知

定时 / 事件触发图文、卡片、文件（请遵守风控频次）

业务告警

订单 / 服务异常等推到指定微信

部署与企业服务

WTAPI 提供 SaaS 与私有化两种交付，接口能力相同，差别在部署位置与数据落点。私有化方案详询商务。

SaaS（推荐）

私有化

部署

无需部署，注册即可用

装在企业自己的环境

数据

平台以请求转发为主，不存用户敏感内容

数据留在企业侧

适合

大多数团队，先验证、再上线

对隔离与合规要求更高的企业

WTAPI 控制台

官网

产品介绍与报价咨询。
www.chuapi.com

技术架构要点

双通道 — HTTP 主动调用 + Webhook 实时回调
代理 IP — 平台共享 / 自购 SOCKS5 / AID 本地网络
风控可读 — 频次与红线见「运维与风控规范」

账号使用建议

建议注册时长 ≥ 3 个月、已完成实名认证的微信账号
使用官方微信客户端，避免多开、分身类软件
请遵守平台规范与相关法律法规，控制发送频率

开始构建你的微信机器人