企微API发消息不是只有一种类型文本、图片、卡片各有各的适用场景。我之前踩过一个坑用文本发了一大段带格式的产品说明结果企微不支持 Markdown换行全成了空格客户看了一脸懵。先把三种消息类型的接口和适用场景理清楚。三种消息对比表类型接口路径优点限制文本/wx-api/api/message/sendText最简单、触达率最高不支持Markdown、不支持超链接可点击图片/wx-api/api/message/sendImage能展示产品截图、二维码必须先走CDN上传拿fileId卡片/wx-api/api/message/sendCard交互性强有按钮能跳转结构最复杂仅应用推送场景文本消息最稳妥的选择直接传 content 就行但有两个细节要注意requests.post( f{BASE}/wx-api/api/message/sendText, headersHEADERS, json{ toUser: [external_userid], # int64数组客户的externalUserId content: 您好\n我是产品顾问小王\n电话: 13800001111 } )第一toUser是数组哪怕只发给一个人也要用[external_userid]不能直接传单值。第二文本里的\n换行有效但没有可点击的超链接——客户看到的https://xxx.com是纯文本不能点。要可点击得换卡片类型。图片消息必须两步走企微API不允许直接传图片URL必须先走CDN上传拿fileId# 第一步上传图片到CDN upload requests.post( f{BASE}/wx-api/api/cdn/uploadImage, headersHEADERS, files{media: open(product.png, rb)} ) file_id upload[data][id] # 注意字段名Eyun返回的是id不是fileId # 第二步发图片消息 requests.post( f{BASE}/wx-api/api/message/sendImage, headersHEADERS, json{toUser: [external_userid], fileId: file_id} )超过8MB的图片要用/wx-api/api/cdn/uploadBigFile异步上传这个之前写过就不重复了。另外fileId有效期只有3天不能提前上传攒着。卡片消息结构最灵活卡片是三种里最复杂的适合发带按钮跳转的产品介绍、活动通知requests.post( f{BASE}/wx-api/api/message/sendCard, headersHEADERS, json{ toUser: [userid], templateId: tpl_xxxxx, # 先在企微后台配置卡片模板 data: { title: {value: 新品上线通知}, desc: {value: 点此查看详情}, url: {value: https://your-site.com/product/123} } } )注意卡片消息的toUser用的是内部员工的userid不是外部客户的external_userid——卡片只支持发给应用可见范围内的内部成员不能发外部客户。要给客户发带跳转的内容得用图文消息类型sendNews但那又是另一套接口了。我的选择原则给客户发纯文字通知 → sendText给客户发二维码/产品图 → sendImage先走CDN给内部员工发带按钮的活动通知 → sendCard选对类型比什么都重要别像我一开始那样用文本硬凑格式客户体验差不说还耽误事。
企微API发消息不是只有一种类型文本、图片、卡片各有各的适用场景。我之前踩过一个坑用文本发了一大段带格式的产品说明结果企微不支持 Markdown换行全成了空格客户看了一脸懵。先把三种消息类型的接口和适用场景理清楚。三种消息对比表类型接口路径优点限制文本/wx-api/api/message/sendText最简单、触达率最高不支持Markdown、不支持超链接可点击图片/wx-api/api/message/sendImage能展示产品截图、二维码必须先走CDN上传拿fileId卡片/wx-api/api/message/sendCard交互性强有按钮能跳转结构最复杂仅应用推送场景文本消息最稳妥的选择直接传 content 就行但有两个细节要注意requests.post( f{BASE}/wx-api/api/message/sendText, headersHEADERS, json{ toUser: [external_userid], # int64数组客户的externalUserId content: 您好\n我是产品顾问小王\n电话: 13800001111 } )第一toUser是数组哪怕只发给一个人也要用[external_userid]不能直接传单值。第二文本里的\n换行有效但没有可点击的超链接——客户看到的https://xxx.com是纯文本不能点。要可点击得换卡片类型。图片消息必须两步走企微API不允许直接传图片URL必须先走CDN上传拿fileId# 第一步上传图片到CDN upload requests.post( f{BASE}/wx-api/api/cdn/uploadImage, headersHEADERS, files{media: open(product.png, rb)} ) file_id upload[data][id] # 注意字段名Eyun返回的是id不是fileId # 第二步发图片消息 requests.post( f{BASE}/wx-api/api/message/sendImage, headersHEADERS, json{toUser: [external_userid], fileId: file_id} )超过8MB的图片要用/wx-api/api/cdn/uploadBigFile异步上传这个之前写过就不重复了。另外fileId有效期只有3天不能提前上传攒着。卡片消息结构最灵活卡片是三种里最复杂的适合发带按钮跳转的产品介绍、活动通知requests.post( f{BASE}/wx-api/api/message/sendCard, headersHEADERS, json{ toUser: [userid], templateId: tpl_xxxxx, # 先在企微后台配置卡片模板 data: { title: {value: 新品上线通知}, desc: {value: 点此查看详情}, url: {value: https://your-site.com/product/123} } } )注意卡片消息的toUser用的是内部员工的userid不是外部客户的external_userid——卡片只支持发给应用可见范围内的内部成员不能发外部客户。要给客户发带跳转的内容得用图文消息类型sendNews但那又是另一套接口了。我的选择原则给客户发纯文字通知 → sendText给客户发二维码/产品图 → sendImage先走CDN给内部员工发带按钮的活动通知 → sendCard选对类型比什么都重要别像我一开始那样用文本硬凑格式客户体验差不说还耽误事。
