创建企业群发
POST
/cgi-bin/externalcontact/add_msg_template
服务端API第三方应用开发企业内部开发
注意:调用该接口并不会直接发送消息给客户/客户群,需要成员确认后才会执行发送(客服人员的企业微信需要升级到2.7.5及以上版本)
旧接口创建企业群发已经废弃,接口升级后支持发送视频文件,并且支持最多同时发送9个附件。
同一个企业每个自然月内仅可针对一个客户/客户群发送4条消息,超过接收上限的客户将无法再收到群发消息。
attachments中每个附件信息必须与msgtype一致,例如,msgtype指定为image,则需要填写image.pic_url或者image.media_id,否则会报错。
media_id和pic_url只需填写一个,两者同时填写时使用media_id,二者不可同时为空
权限说明:
自建应用只能给应用可见范围内的成员进行推送。
第三方应用需具有“企业客户权限->客户联系->群发消息给客户和客户群”权限。
当只提供sender参数时,相当于选取了这个成员所有的客户。
注意:2019-8-1之后,取消了 “无法向未回复消息的客户发送企业群发消息” 的限制。
原文档地址:
https://open.work.weixin.qq.com/api/doc/90001/90143/92698
https://open.work.weixin.qq.com/api/doc/90000/90135/92135
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_msg_template?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"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"}}]}'
响应示例响应示例
{
"errcode": 0,
"errmsg": "ok",
"fail_list": [
"wmqfasd1e1927831123109rBAAAA"
],
"msgid": "msgGCAAAXtWyujaWJHDDGi0mAAAA"
}
请求参数
Query 参数
access_token
调用接口凭证
示例值:
{{accesstoken}}
Body 参数application/json
返回响应
修改于 2022-01-14 04:25:42