第三方应用开发 服务端API 客户联系 消息推送 入群欢迎语素材管理
入群欢迎语素材管理
最后更新:2023/12/01
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
入群欢迎语素材管理
最后更新:2023/12/01

目录

  • 添加入群欢迎语素材
  • 编辑入群欢迎语素材
  • 获取入群欢迎语素材
  • 删除入群欢迎语素材
  • 添加入群欢迎语素材

    企业可通过此API向企业的入群欢迎语素材库中添加素材。每个企业的入群欢迎语素材库中,最多容纳100个素材。

    请求方式: POST(HTTP)

    请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/group_welcome_template/add?access_token=ACCESS_TOKEN

    请求示例

    {
    	"text": {
    		"content": "亲爱的%NICKNAME%用户,你好"
    	},
    	"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"
    	},
    	"file": {
    		"media_id": "1Yv-zXfHjSjU-7LH-GwtYqDGS-zz6w22KmWAT5COgP7o"
    	},
    	"video": {
    		"media_id": "MEDIA_ID"
    	},
    	"agentid": 1000014,
    	"notify": 1
    }

    参数说明:

    参数必须说明
    access_token调用接口凭证
    text.content消息文本内容,最长为3000字节
    image.media_id图片的media_id,可以通过素材管理接口获得
    image.pic_url图片的链接,仅可使用上传图片接口得到的链接
    link.title图文消息标题,最长为128字节
    link.picurl图文消息封面的url
    link.desc图文消息的描述,最长为512字节
    link.url图文消息的链接
    miniprogram.title小程序消息标题,最长为64字节
    miniprogram.pic_media_id小程序消息封面的mediaid,封面图建议尺寸为520*416
    miniprogram.appid小程序appid,必须是关联到企业的小程序应用
    miniprogram.page小程序page路径
    file.media_id文件id,可以通过素材管理异步上传临时素材接口获得
    video.media_id视频媒体文件id,可以通过素材管理异步上传临时素材接口获得
    agentid授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数
    notify是否通知成员将这条入群欢迎语应用到客户群中,0-不通知,1-通知, 不填则通知
    text中支持配置多个%NICKNAME%(大小写敏感)形式的欢迎语,当配置了欢迎语占位符后,发送给客户时会自动替换为客户的昵称;
    text、image、link、miniprogram、file、video不能全部为空;
    text与其它消息类型可以同时发送,此时将会以两条消息的形式触达客户
    text以外的消息类型,只能有一个,如果三者同时填,则按image、link、miniprogram、file、video的优先顺序取参。例如:image与link同时传值,则只有image生效。
    图片消息中,media_id和pic_url只需填写一个,两者同时填写时使用media_id,二者不可同时为空。

     

    权限说明:

    • 企业需要使用配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?)。
    • 第三方应用需具有“企业客户权限->客户联系->配置入群欢迎语素材”权限

     

    返回结果:

    {
        "errcode": 0,
        "errmsg": "ok",
    	"template_id": "msgXXXXXX"
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    template_id欢迎语素材id

     

    编辑入群欢迎语素材

    企业可通过此API编辑入群欢迎语素材库中的素材,且仅能够编辑调用方自己创建的入群欢迎语素材。

    请求方式: POST(HTTP)

    请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/group_welcome_template/edit?access_token=ACCESS_TOKEN

    请求示例

    {
    	"template_id": "msgXXXXXXX",
    	"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": "wx8bd80126147df384",
    		"page": "/path/index"
    	},
    	"file": {
    		"media_id": "1Yv-zXfHjSjU-7LH-GwtYqDGS-zz6w22KmWAT5COgP7o"
    	},
    	"video": {
    		"media_id": "MEDIA_ID"
    	},
    	"agentid": 1000014
    }

    参数说明:

    参数必须说明
    access_token调用接口凭证
    template_id欢迎语素材id
    text.content消息文本内容,最长为3000字节
    image.media_id图片的media_id,可以通过素材管理接口获得
    image.pic_url图片的链接,仅可使用上传图片接口得到的链接
    link.title图文消息标题,最长为128字节
    link.picurl图文消息封面的url
    link.desc图文消息的描述,最长为512字节
    link.url图文消息的链接
    miniprogram.title小程序消息标题,最长为64字节
    miniprogram.pic_media_id小程序消息封面的mediaid,封面图建议尺寸为520*416
    miniprogram.appid小程序appid,必须是关联到企业的小程序应用
    miniprogram.page小程序page路径
    file.media_id文件id,可以通过素材管理异步上传临时素材接口获得
    video.media_id视频媒体文件id,可以通过素材管理异步上传临时素材接口获得
    agentid授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数

     

    权限说明:

    • 企业需要使用配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?)。
    • 第三方应用需具有“企业客户权限->客户联系->配置入群欢迎语素材”权限
    • 仅可编辑本应用创建的入群欢迎语素材

     

    返回结果:

    {
        "errcode": 0,
        "errmsg": "ok"
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容

     

    获取入群欢迎语素材

    企业可通过此API获取入群欢迎语素材。

    请求方式: POST(HTTP)

    请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/group_welcome_template/get?access_token=ACCESS_TOKEN

    请求示例

    {
    	"template_id":"msgXXXXXXX"
    }

    参数说明:

    参数必须说明
    access_token调用接口凭证
    template_id群欢迎语的素材id

     

    权限说明:

    • 企业需要使用配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?)。
    • 第三方应用需具有“企业客户权限->客户联系->配置入群欢迎语素材”权限

     

    返回结果:

    {
    	"errcode": 0,
    	"errmsg": "ok",
    	"text": {
    		"content": "文本消息内容"
    	},
    	"image": {
    		"pic_url": "http://p.qpic.cn/pic_wework/XXXXX"
    	},
    	"link": {
    		"title": "消息标题",
    		"picurl": "https://example.pic.com/path",
    		"desc": "消息描述",
    		"url": "https://example.link.com/path"
    	},
    	"miniprogram": {
    		"title": "消息标题",
    		"pic_media_id": "MEDIA_ID",
    		"appid": "wx8bd80126147df384",
    		"page": "/path/index"
    	},
    	"file": {
    		"media_id": "1Yv-zXfHjSjU-7LH-GwtYqDGS-zz6w22KmWAT5COgP7o"
    	},
    	"video": {
    		"media_id": "MEDIA_ID"
    	}
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    text.content消息文本内容
    image.pic_url图片的url
    link.title图文消息标题
    link.picurl图文消息封面的url
    link.desc图文消息的描述
    link.url图文消息的链接
    miniprogram.title小程序消息标题
    miniprogram.pic_media_id小程序消息封面的mediaid
    miniprogram.appid小程序appid
    miniprogram.page小程序page路径
    file.media_id文件id,可以通过素材管理接口获得。
    注意:设置接口若使用异步上传临时素材拿到的media_id,此时就会返回同类型的media_id
    video.media_id视频媒体文件id,可以通过素材管理接口获得。
    注意:设置接口若使用异步上传临时素材拿到的media_id,此时就会返回同类型的media_id

     

    删除入群欢迎语素材

    企业可通过此API删除入群欢迎语素材,且仅能删除调用方自己创建的入群欢迎语素材。

    请求方式: POST(HTTP)

    请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/group_welcome_template/del?access_token=ACCESS_TOKEN

    请求示例

    {
    	"template_id":"msgXXXXXXX",
    	"agentid" : 1000014
    }

    参数说明:

    参数必须说明
    access_token调用接口凭证
    template_id群欢迎语的素材id
    agentid授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数

     

    权限说明:

    • 企业需要使用配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?)。
    • 第三方应用需具有“企业客户权限->客户联系->配置入群欢迎语素材”权限
    • 仅可删除本应用创建的入群欢迎语素材

     

    返回结果:

    {
        "errcode": 0,
        "errmsg": "ok"
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    上一篇
    发送新客户欢迎语
    下一篇
    获取「联系客户统计」数据