第三方应用开发 服务端API 客户联系 消息推送 创建企业群发
创建企业群发

企业跟第三方应用可通过此接口添加企业群发消息的任务并通知成员发送给相关客户或客户群。(注:企业微信终端需升级到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不能同时为空
  • attachments中每个附件信息必须与msgtype一致,例如,msgtype指定为image,则需要填写image.pic_url或者image.media_id,否则会报错。
  • media_id和pic_url只需填写一个,两者同时填写时使用media_id,二者不可同时为空

 

权限说明:

  • 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?)。
  • 自建应用只能给应用可见范围内的成员进行推送。
  • 第三方应用需具有“企业客户权限->客户联系->群发消息给客户和客户群”权限。
  • 当只提供sender参数时,相当于选取了这个成员所有的客户。
  • 注意:2019-8-1之后,取消了 “无法向未回复消息的客户发送企业群发消息” 的限制。

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
	"fail_list":["wmqfasd1e1927831123109rBAAAA"],
	"msgid":"msgGCAAAXtWyujaWJHDDGi0mAAAA"
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
fail_list无效或无法发送的external_userid列表
msgid企业群发消息的id,可用于获取群发消息发送结果
上一篇
获取客户朋友圈全部的发表记录
下一篇
获取企业的全部群发记录