企业微信外部群如何通过 API 自动化投递结构化小程序卡片

能力介绍相比于传统的文字链接结构化的小程序卡片拥有更高的点击率和更规范的视觉展现。该能力允许开发者通过主动调用 API直接向指定的企业微信外部群投递原生小程序卡片。接口支持自定义动态配置小程序的appid、首屏页面路径pagepath可携带动态业务参数以及卡片封面图title实现系统数据与微信生态的深度无缝打通。10 分钟接入 Demo绑定小程序确保目标小程序已经在企业微信管理后台完成了关联授权。素材准备获取作为卡片封面的图片media_id通过临时素材上传接口获取。参数装配准备小程序的原始 IDgh_开头或 AppID以及跳转的具体 Page 路径。异步发送调用外部群消息接口投递miniprogram类型的数据包。API 示例代码Javaimport com.fasterxml.jackson.databind.ObjectMapper; import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.util.HashMap; import java.util.Map; public class MiniProgramSender { public static void main(String[] args) throws Exception { String apiUrl https://api.qiweapi.com/cgi-bin/externalchat/send; String developerKey your_developer_key; MapString, Object payload new HashMap(); payload.put(chat_id, chat_id_abcde123); payload.put(msgtype, miniprogram); MapString, String miniParams new HashMap(); miniParams.put(title, 您的专属数据分析报告已生成); miniParams.put(appid, wxe1234567890abcde); // 小程序的AppID miniParams.put(pagepath, pages/report/index.html?reportId998877); // 动态业务路径 miniParams.put(pic_media_id, MEDIA_ID_FROM_UPLOAD); // 封面图MediaID payload.put(miniprogram, miniParams); ObjectMapper mapper new ObjectMapper(); String jsonBody mapper.writeValueAsString(payload); HttpClient client HttpClient.newHttpClient(); HttpRequest request HttpRequest.newBuilder() .uri(URI.create(apiUrl)) .header(Content-Type, application/json) .header(Authorization, Bearer developerKey) .POST(HttpRequest.BodyPublishers.ofString(jsonBody)) .build(); HttpResponseString response client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(返回结果: response.body()); } }使用场景说明业务流转动态卡片在 B2B 采购群中当订单状态变更为“待确认”时系统自动发送带有订单 ID 参数的小程序卡片外部客户点击直达小程序订单页完成签章。预约协同提醒医疗、教育或售后预约场景下系统提前 1 小时向服务群投递预约签到小程序方便微信端用户一键点击确认。FAQQ: 为什么群成员点击卡片时提示“小程序未关联”或“无法打开”A:请确认两点1. 该小程序是否已在企微后台进行配置绑定2. 外部微信用户所属的微信版本是否支持该小程序的运行环境。Q:pic_media_id图片失效时间是多久A:企微官方临时素材的有效周期通常为 3 天。过期后需重新调用素材上传接口获取新的media_id否则卡片封面将无法正常渲染。引导入口查看完整技术文档前往技术官网