群发消息给客户

具有客户联系权限的企业成员,可通过该接口将文本内容和附件传递到群发助手、发送给客户。当前暂仅支持在企业微信内调用。
为了防止滥用,同一个成员每日向一个客户最多可群发一条消息,每次群发最多可选200个客户。

wx.invoke("shareToExternalContact", {
      text: {
            content:"",    // 文本内容
      },
      attachments: [
            {
                  msgtype: "image",    // 消息类型,必填
                  image: {
                        mediaid: "",      // 图片的素材id
                        imgUrl: "",        // 图片的imgUrl,跟图片mediaid填其中一个即可
                  },
            },
            {
                  msgtype: "link",    // 消息类型,必填
                  link: {
                        title: "",        // H5消息标题
                        imgUrl: "",    // H5消息封面图片URL
                        desc: "",    // H5消息摘要
                        url: "",        // H5消息页面url 必填
                  },
            },
            {
                  msgtype: "miniprogram",    // 消息类型,必填
                  miniprogram: {
                        appid: "",    // 小程序的appid
                        title: "",        // 小程序消息的title
                        imgUrl : "",    //小程序消息的封面图。必须带http或者https协议头
                        page: "",        //小程序消息打开后的路径,注意要以.html作为后缀,否则在微信端打开会提示找不到页面
                  },
            },
            {
                  msgtype: "video",    // 消息类型,必填
                  video:{
                        mediaid:"",        // 视频的素材id
                 },
            },
      ]},function(res) {
        if (res.err_msg == "shareToExternalContact:ok") {
        }
    }
);
  • 企业微信3.1.6及以上版本支持text与attachments参数,旧版本不支持(mac端也暂不支持)(查看旧版本接口调用方式)。微信客户端不支持(微信开发者工具也不支持)。
  • 文本最多支持传入4000个字
  • 附件最多支持传入9个,类型支持图片(“image”),视频(“video”),图文(“link”)和小程序(“miniprogram”)
  • 支持传入文本和多附件的能力,仅在企业微信3.1.6及以后版本支持。微信客户端和微信开发者工具都不支持
  • 必须先成功调用agentConfig,否则调用时会报“no permission”错误
  • 当前成员必须配置了客户联系功能
  • agentConfig中所填agentid对应应用,需有配置客户联系功能权限
  • text和attachments不能同时为空(注:若text和attachments同时为空,接口使用老的方式shareToExternalContact传参也可以兼容。)
  • attachments中每个附件信息必须与msgtype一致,例如,msgtype指定为image,则需要填写image::imgUrl或者image::mediaid,否则会报错。mediaid和imgUrl只需填写一个,两者同时填写时使用media_id且imgUrl失效,二者不可同时为空
  • 图片或者视频的mediaid,可通过素材管理接口获得
© 1998 - 2021 Tencent Inc. All Rights Reserved