入群欢迎语素材管理-添加
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,二者不可同时为空。
原文档地址:
https://open.work.weixin.qq.com/api/doc/90000/90135/92366
https://open.work.weixin.qq.com/api/doc/90001/90143/93438
请求示例请求示例
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