入群欢迎语素材管理-添加
POST
/cgi-bin/externalcontact/group_welcome_template/add
服务端API企业内部开发第三方应用开发
text中支持配置多个**%NICKNAME%**(大小写敏感)形式的欢迎语，当配置了欢迎语占位符后，发送给客户时会自动替换为客户的昵称;
text、image、link、miniprogram、file、video不能全部为空；
text与其它消息类型可以同时发送，此时将会以两条消息的形式触达客户
text以外的消息类型，只能有一个，如果三者同时填，则按image、link、miniprogram、file、video的优先顺序取参。例如：image与link同时传值，则只有image生效。
图片消息中，media_id 和pic_url只需填写一个，两者同时填写时使用media_id，二者不可同时为空。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/group_welcome_template/add?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
"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
}'响应示例响应示例
{
"errcode": 0,
"errmsg": "ok",
"template_id": "msgXXXXXX"
}请求参数
Query 参数
access_token
调用接口凭证
示例值:
{{accesstoken}}
Body 参数application/json
返回响应
扫码加入交流群修改于 2023-01-31 09:17:50