登录
基础
连接微信
办公目录
企业跟第三方应用可通过此接口添加企业群发消息的任务并通知成员发送给相关客户或客户群。（注：企业微信终端需升级到2.7.5版本及以上）
注意：调用该接口并不会直接发送消息给客户/客户群，需要成员确认后才会执行发送（客服人员的企业微信需要升级到2.7.5及以上版本）
旧接口创建企业群发已经废弃，接口升级后支持发送视频文件，并且支持最多同时发送9个附件。
仅会推送给最后跟客户进行聊天互动的企业成员。
群发消息可以是企业统一创建发送的，也可以是成员自己创建发送的；每位客户/每个客户群每月最多可接收条数为当月天数，超过接收上限的客户/客户群将无法再收到群发消息。
请求方式: POST(HTTP)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_msg_template?access_token=ACCESS_TOKEN
请求示例
{
"chat_type": "single",
"external_userid": [
"woAJ2GCAAAXtWyujaWJHDDGi0mACAAAA",
"wmqfasd1e1927831123109rBAAAA"
],
"chat_id_list":["wr2GCAAAXtWyujaWJHDDGasdadAAA"],
"tag_filter":
{
"group_list":
[
{
"tag_list":["ete19278asuMT123109rBAAAA","ete19MT12278109UYteaBAAAA"]
},
{
"tag_list":["eteIlKKHSDfuMT18Kg9rBAAAA"]
}
]
},
"sender": "zhangsan",
"allow_select":true,
"text": {
"content": "文本消息内容"
},
"attachments": [{
"msgtype": "image",
"image": {
"media_id": "MEDIA_ID",
"pic_url": "http://p.qpic.cn/pic_wework/3474110808/7a6344sdadfwehe42060/0"
}
}, {
"msgtype": "link",
"link": {
"title": "消息标题",
"picurl": "https://example.pic.com/path",
"desc": "消息描述",
"url": "https://example.link.com/path"
}
}, {
"msgtype": "miniprogram",
"miniprogram": {
"title": "消息标题",
"pic_media_id": "MEDIA_ID",
"appid": "wx8bd80126147dfAAA",
"page": "/path/index.html"
}
}, {
"msgtype": "video",
"video": {
"media_id": "MEDIA_ID"
}
}, {
"msgtype": "file",
"file": {
"media_id": "MEDIA_ID"
}
} ]
}参数说明:
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| chat_type | 否 | 群发任务的类型，默认为single，表示发送给客户，group表示发送给客户群 |
| external_userid | 否 | 客户的externaluserid列表，仅在chat_type为single时有效，最多可一次指定1万个客户 |
| chat_id_list | 否 | 客户群id列表，仅在chat_type为group时有效，最多可一次指定2000个客户群。指定群id之后，收到任务的群主无须再选择客户群，仅对4.1.10及以上版本的企业微信终端生效 |
| tag_filter.group_list.tag_list | 否 | 要进行群发的客户标签列表，同组标签之间按或关系进行筛选，不同组标签按且关系筛选，每组最多指定100个标签，支持规则组标签 |
| sender | 否 | 发送企业群发消息的成员userid，当类型为发送给客户群时必填 |
| allow_select | 否 | 是否允许成员在待发送客户列表中重新进行选择，默认为false，仅支持客户群发场景 |
| text.content | 否 | 消息文本内容，最多4000个字节 |
| attachments | 否 | 附件，最多支持添加9个附件 |
| attachments.msgtype | 是 | 附件类型，可选image、link、miniprogram、video或者file |
| image.media_id | 否 | 图片的media_id，可以通过素材管理接口获得 |
| image.pic_url | 否 | 图片的链接，仅可使用上传图片接口得到的链接 |
| link.title | 是 | 图文消息标题，最长128个字节 |
| link.picurl | 否 | 图文消息封面的url，最长2048个字节 |
| link.desc | 否 | 图文消息的描述，最多512个字节 |
| link.url | 是 | 图文消息的链接，最长2048个字节 |
| miniprogram.title | 是 | 小程序消息标题，最多64个字节 |
| miniprogram.pic_media_id | 是 | 小程序消息封面的mediaid，封面图建议尺寸为520*416 |
| miniprogram.appid | 是 | 小程序appid（可以在微信公众平台上查询），必须是关联到企业的小程序应用 |
| miniprogram.page | 是 | 小程序page路径 |
| video.media_id | 是 | 视频的media_id，可以通过素材管理接口获得 |
| file.media_id | 是 | 文件的media_id，可以通过素材管理接口获得 |
权限说明:
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"fail_list":["wmqfasd1e1927831123109rBAAAA"],
"msgid":"msgGCAAAXtWyujaWJHDDGi0mAAAA"
}参数说明:
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| fail_list | 无效或无法发送的external_userid或chatid列表 |
| msgid | 企业群发消息的id，可用于获取群发消息发送结果 |
基础连接微信办公基础连接微信办公基础连接微信办公