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

发布时间:2026/7/28 1:28:36
【企业通信】基于ipad协议全类型消息发送接口设计:支持文本、多媒体、群聊及大文件传输的API 一、一段话总结本文档为企业微信消息发送与管理的接口技术文档系统介绍了23个基于HTTP POST的API接口统一采用application/json格式进行数据交互。所有接口均以uuid作为企业微信实例的唯一标识部署于http://172.0.0.1:8080/wxwork/服务地址下成功响应均为errcode0、errmsgok。文档涵盖消息发送如文本、图片、文件、语音、视频、小程序、视频号、引用、群等、大文件特殊传输机制、群发限制规则以及消息同步、已读标记、语音转文字等辅助功能形成完整的企业微信消息生态操作体系。;适合人群具备基本Web API调用经验的技术人员、企业微信开发者、后端开发工程师或自动化运维人员尤其适用于需要集成企业微信消息能力的中高级研发人员使用场景及目标① 实现自动化消息推送与撤回② 构建企业级消息同步与通知系统③ 开发支持多媒体内容如CDN资源、大文件、小程序卡片的消息机器人④ 实现精准群聊提醒与每日群发策略接口地址集中于https://wechatapi.apifox.cn/成功返回errcode0、errmsgok**。思维导图官网地址极客互动企业微信聚合聊天企业微信API接口API调用企业微信API接入文档四、详细总结1. 接口基础规范请求方式POST内容类型application/json唯一标识uuid必传定位企业微信实例服务地址http://172.0.0.1:8080/wxwork/成功响应{errcode:0,errmsg:ok}2. 核心消息发送接口按类型分类接口功能请求 URL必传核心参数消息类型撤回消息/RevokeMsguuid、msgid、roomid撤回发送文本/SendTextMsguuid、send_userid、isRoom、content文本发送文本 表情/SendTextAndExpMsguuid、send_userid、isRoom、content混合发送 CDN 图片/SendCDNImgMsguuid、send_userid、isRoom、cdnkey、aeskey、md5、fileSize图片发送 CDN 文件/SendCDNFileMsguuid、send_userid、isRoom、cdnkey、aeskey、md5、fileSize文件发送 CDN 语音/SendCDNVoiceMsguuid、send_userid、isRoom、cdnkey、aeskey、md5、fileSize、voice_time语音发送 CDN 视频/SendCDNVideoMsguuid、send_userid、isRoom、cdnkey、aeskey、md5、fileSize、video_duration视频发送大视频/SendCDNBigVideoMsg大文件上传非 CDN大视频发送大文件/SendCDNBigFileMsg大文件上传非 CDN大文件发送链接卡片/SendLinkMsguuid、send_userid、isRoom、url、title、content链接发送小程序/SendAppMsguuid、send_userid、isRoom、appid、pagepath、username小程序发送视频号/SendVideoNumberuuid、send_userid、isRoom、url、coverUrl视频号发送视频号直播/SendVideoNumberZhiBouuid、send_userid、isRoom、url、coverUrl直播发送 GIF 表情/SendEmotionMessageuuid、send_userid、isRoom、imgurlGIF发送名片/SendBusinessCardMsguuid、send_userid、isRoom、username、nickname名片发送位置/SendLocationMsguuid、send_userid、isRoom、longitude、latitude、address位置发送群 /SendTextAtMsguuid、send_userid、atids、content、isRoom群 格式化 /SendTextAtMsgTwouuid、send_userid、contentva、isRoom混合 群发消息/SendGroupsMsguuid、vids、isroom、msg_list群发发送引用/sendQuoteMsguuid、send_userid、isRoom、content、quoteMsg引用3. 消息辅助管理接口接口功能请求 URL必传参数作用同步消息/SyncAllDatauuid、limit、seq同步离线消息标记已读/MarkAsReaduuid、send_userid、isRoom去除小红点语音转文字/SpeechToTextEntityuuid、msgid语音解析文本4. 关键规则大视频 / 大文件必须走大文件上传禁止用 CDN 方式群发消息限制每天每人一次引用消息必须完整携带quoteMsg对象否则显示不全\\群 \\支持指定成员 / 全体vid0seq建议使用消息回调的server_id用于增量同步五、关键问题与答案问题发送大视频和大文件有什么强制要求答案必须走大文件上传通道禁止使用 CDN 上传对应接口为/SendCDNBigVideoMsg和/SendCDNBigFileMsg。问题如何实现企业微信离线消息同步答案调用/SyncAllData接口传入uuid、limit每次返回条数、seq建议传回调中最后一条消息的server_id返回is_select1表示未同步完需继续调用。问题发送群聊 所有人消息需要怎么配置答案使用/SendTextAtMsgTwo接口在contentva数组中添加msgtype5且vid0的对象即可实现 全体成员。