登录
基础
连接微信
办公
目录
创建企业群发
企业跟第三方应用可通过此接口添加企业群发消息的任务并通知成员发送给相关客户或客户群。（注：企业微信终端需升级到2.7.5版本及以上）
注意：调用该接口并不会直接发送消息给客户/客户群，需要成员确认后才会执行发送（客服人员的企业微信需要升级到2.7.5及以上版本）
旧接口创建企业群发已经废弃，接口升级后支持发送视频文件，并且支持最多同时发送9个附件。
仅会推送给最后跟客户进行聊天互动的企业成员。
每位客户/每个客户群每天可接收1条群发消息，可以是企业统一创建发送的，也可以是成员自己创建发送的；超过接收上限的客户/客户群将无法再收到群发消息。
请求方式: 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，可以通过素材管理接口获得 |
- 对于客户群发，sender，external_userid，tag_filter不可同时为空，如果指定了external_userid,则tag_filter不生效
- text和attachments不能同时为空
- attachments中每个附件信息必须与msgtype一致，例如，msgtype指定为image，则需要填写image.pic_url或者image.media_id，否则会报错。
- media_id和pic_url只需填写一个，两者同时填写时使用media_id，二者不可同时为空
权限说明:
- 企业需要使用配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。
- 自建应用只能给应用可见范围内的成员进行推送。
- 第三方应用需具有“企业客户权限->客户联系->群发消息给客户和客户群”权限。
- 当只提供sender参数时，相当于选取了这个成员所有的客户。
- 注意：2019-8-1之后，取消了 “无法向未回复消息的客户发送企业群发消息” 的限制。
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"fail_list":["wmqfasd1e1927831123109rBAAAA"],
"msgid":"msgGCAAAXtWyujaWJHDDGi0mAAAA"
}参数说明:
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| fail_list | 无效或无法发送的external_userid或chatid列表 |
| msgid | 企业群发消息的id，可用于获取群发消息发送结果 |
- 创建企业群发
本节内容
