添加企业群发消息任务

企业可通过此接口添加企业群发消息的任务并通知客服人员发送给相关客户或客户群。(注:企业微信终端需升级到2.7.5版本及以上)
注意:调用该接口并不会直接发送消息给客户/客户群,需要相关的客服人员操作以后才会实际发送(客服人员的企业微信需要升级到2.7.5及以上版本)
同一个企业每个自然月内仅可针对一个客户/客户群发送4条消息,超过限制的用户将会被忽略。

请求方式: 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":"文本消息内容"
    },
    "image": {
        "media_id": "MEDIA_ID",
        "pic_url":"http://p.qpic.cn/pic_wework/3474110808/7a6344sdadfwehe42060/0"
    },
    "link": {
        "title": "消息标题",
        "picurl": "https://example.pic.com/path",
        "desc": "消息描述",
        "url": "https://example.link.com/path"
    },
    "miniprogram": {
        "title": "消息标题",
        "pic_media_id": "MEDIA_ID",
        "appid": "wx8bd80126147dfAAA",
        "page": "/path/index.html"
    }
}

参数说明:

参数 必须 说明
access_token 调用接口凭证
chat_type 群发任务的类型,默认为single,表示发送给客户,group表示发送给客户群
external_userid 客户的外部联系人id列表,仅在chat_type为single时有效,不可与sender同时为空,最多可传入1万个客户
sender 发送企业群发消息的成员userid,当类型为发送给客户群时必填
text.content 消息文本内容,最多4000个字节
image.media_id 图片的media_id,可以通过素材管理接口获得
image.pic_url 图片的链接,仅可使用上传图片接口得到的链接
link.title 图文消息标题
link.picurl 图文消息封面的url
link.desc 图文消息的描述,最多512个字节
link.url 图文消息的链接
miniprogram.title 小程序消息标题,最多64个字节
miniprogram.pic_media_id 小程序消息封面的mediaid,封面图建议尺寸为520*416
miniprogram.appid 小程序appid,必须是关联到企业的小程序应用
miniprogram.page 小程序page路径

text、image、link和miniprogram四者不能同时为空;
text与另外三者可以同时发送,此时将会以两条消息的形式触达客户
image、link和miniprogram只能有一个,如果三者同时填,则按image、link、miniprogram的优先顺序取参,也就是说,如果image与link同时传值,则只有image生效。
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,可用于获取群发消息发送结果
© 1998 - 2020 Tencent Inc. All Rights Reserved