企业跟第三方应用可通过此接口添加企业群发消息的任务并通知成员发送给相关客户或客户群。(注:企业微信终端需升级到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"
],
"sender": "zhangsan",
"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 | 否 | 客户的外部联系人id列表,仅在chat_type为single时有效,不可与sender同时为空,最多可传入1万个客户 |
sender | 否 | 发送企业群发消息的成员userid,当类型为发送给客户群时必填 |
text.content | 否 | 消息文本内容,最多4000个字节 |
attachments | 否 | 附件,最多支持添加9个附件 |
attachments.msgtype | 是 | 附件类型,可选image、link、miniprogram或者video |
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,可以通过素材管理接口获得 |
* text和attachments不能同时为空
权限说明:
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"fail_list":["wmqfasd1e1927831123109rBAAAA"],
"msgid":"msgGCAAAXtWyujaWJHDDGi0mAAAA"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
fail_list | 无效或无法发送的external_userid列表 |
msgid | 企业群发消息的id,可用于获取群发消息发送结果 |