当前位置：首页 > news >正文

【企业通信】基于ipad协议全类型消息发送接口设计：支持文本、多媒体、群聊及大文件传输的API

news 2026/7/28 1:42:43

一、一段话总结

本文档为企业微信消息发送与管理的接口技术文档，系统介绍了23个基于HTTP POST的API接口，统一采用application/json格式进行数据交互。所有接口均以uuid作为企业微信实例的唯一标识，部署于http://172.0.0.1:8080/wxwork/服务地址下，成功响应均为errcode=0、errmsg=ok。文档涵盖消息发送（如文本、图片、文件、语音、视频、小程序、视频号、引用、群@等）、大文件特殊传输机制、群发限制规则，以及消息同步、已读标记、语音转文字等辅助功能，形成完整的企业微信消息生态操作体系。;
适合人群：具备基本Web API调用经验的技术人员、企业微信开发者、后端开发工程师或自动化运维人员，尤其适用于需要集成企业微信消息能力的中高级研发人员；
使用场景及目标：① 实现自动化消息推送与撤回；② 构建企业级消息同步与通知系统；③ 开发支持多媒体内容（如CDN资源、大文件、小程序卡片）的消息机器人；④ 实现精准群聊@提醒与每日群发策略；接口地址集中于https://wechatapi.apifox.cn/，成功返回errcode=0、errmsg=ok**。

思维导图

官网地址：极客互动企业微信聚合聊天&企业微信API接口
API调用：企业微信API接入文档

四、详细总结

1. 接口基础规范

请求方式：POST

内容类型：application/json

唯一标识：uuid（必传，定位企业微信实例）

服务地址：http://172.0.0.1:8080/wxwork/

成功响应：{"errcode":0,"errmsg":"ok"}

2. 核心消息发送接口（按类型分类）

接口功能	请求 URL	必传核心参数	消息类型
撤回消息	/RevokeMsg	uuid、msgid、roomid	撤回
发送文本	/SendTextMsg	uuid、send_userid、isRoom、content	文本
发送文本 + 表情	/SendTextAndExpMsg	uuid、send_userid、isRoom、content	混合
发送 CDN 图片	/SendCDNImgMsg	uuid、send_userid、isRoom、cdnkey、aeskey、md5、fileSize	图片
发送 CDN 文件	/SendCDNFileMsg	uuid、send_userid、isRoom、cdnkey、aeskey、md5、fileSize	文件
发送 CDN 语音	/SendCDNVoiceMsg	uuid、send_userid、isRoom、cdnkey、aeskey、md5、fileSize、voice_time	语音
发送 CDN 视频	/SendCDNVideoMsg	uuid、send_userid、isRoom、cdnkey、aeskey、md5、fileSize、video_duration	视频
发送大视频	/SendCDNBigVideoMsg	大文件上传，非 CDN	大视频
发送大文件	/SendCDNBigFileMsg	大文件上传，非 CDN	大文件
发送链接卡片	/SendLinkMsg	uuid、send_userid、isRoom、url、title、content	链接
发送小程序	/SendAppMsg	uuid、send_userid、isRoom、appid、pagepath、username	小程序
发送视频号	/SendVideoNumber	uuid、send_userid、isRoom、url、coverUrl	视频号
发送视频号直播	/SendVideoNumberZhiBo	uuid、send_userid、isRoom、url、coverUrl	直播
发送 GIF 表情	/SendEmotionMessage	uuid、send_userid、isRoom、imgurl	GIF
发送名片	/SendBusinessCardMsg	uuid、send_userid、isRoom、username、nickname	名片
发送位置	/SendLocationMsg	uuid、send_userid、isRoom、longitude、latitude、address	位置
发送群 @	/SendTextAtMsg	uuid、send_userid、atids、content、isRoom	群 @
格式化 @	/SendTextAtMsgTwo	uuid、send_userid、contentva、isRoom	混合 @
群发消息	/SendGroupsMsg	uuid、vids、isroom、msg_list	群发
发送引用	/sendQuoteMsg	uuid、send_userid、isRoom、content、quoteMsg	引用

3. 消息辅助管理接口

接口功能	请求 URL	必传参数	作用
同步消息	/SyncAllData	uuid、limit、seq	同步离线消息
标记已读	/MarkAsRead	uuid、send_userid、isRoom	去除小红点
语音转文字	/SpeechToTextEntity	uuid、msgid	语音解析文本