协议概述
企业微信 iPad 协议是一套基于企业微信 iPad 客户端的智能接口服务解决方案。通过逆向工程技术,将 iPad 客户端原生的私有二进制通信接口封装为标准化、可编程的 API,模拟 iPad 客户端行为与企业微信服务器交互,实现与原生客户端完全对齐的功能能力。
技术对接:官网 jikehudong.com · API 文档 wechatapi.apifox.cn
方案优势(与官方 API 对比)
官方企业微信 API 在实际业务中存在诸多能力限制;iPad 协议基于原生客户端长连接,可有效突破这些瓶颈:
- 事件推送时效:毫秒级实时推送,与客户端对齐的事件流,消息一条不落
- 事件粒度:支持「成员撤回」「消息删除」「进群」「踢人」等细粒度监听
- 消息回执:双向通信,可获取完整发送回执与状态确认
- 功能覆盖度:可实现企微 PC / iPad 端全部原生功能,无能力阉割
- 官方局限:事件延迟常 ≥15s,多为单向推送,细粒度动作难感知,拿不到发送回执
消息发送接口说明
- 请求方法:POST · Content-Type:application/json
- 关键参数:uuid(设备唯一标识)、kf_id(非客服填 0)、send_userid、isRoom、content
{
"uuid": "81eddc1771c293e933cf6ef9b17e5f87",
"kf_id": 0,
"send_userid": 1688856937681797,
"isRoom": false,
"content": "消息测试"
}
成功时 errcode=0,data 中含 receiver、sender、msg_id、server_id、msgtype、content、sendtime 等字段。
客户端功能矩阵
基于 iPad 协议可全覆盖原生客户端能力,包括但不限于:文本、名片、CDN 图片/文件/语音、大视频/大文件、链接卡片、小程序、GIF、位置、群 @;以及撤回、同步记录、语音转文字、已读清零、引用、群友互动、客户群/联系人列表、登录登出、二次验证、自动登录等,完整复刻 PC / iPad 端原生操作,无功能缺失。