配置客户联系「联系我」方式
POST
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_contact_way
企业可通过此接口为具有客户联系功能的成员生成专属的「联系我」二维码或者「联系我」按钮。
如果配置的是「联系我」按钮，需要开发者的小程序接入小程序插件。
通过API添加的「联系我」不会在管理端进行展示，每个企业可通过API最多配置50万个「联系我」。
用户需要妥善存储返回的config_id，config_id丢失可能导致用户无法编辑或删除「联系我」。
临时会话模式不占用「联系我」数量，但每日最多添加10万个，并且仅支持单人。
临时会话模式的二维码，添加好友完成后该二维码即刻失效。
当设置为临时会话模式时（即is_temp为true），联系人仅支持配置为单人，暂不支持多人
使用unionid需要调用方（企业或服务商）的企业微信“客户联系”中已绑定微信开发者账户
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_contact_way' \
--header 'Content-Type: application/json' \
--data-raw '{
"type" :1,
"scene":1,
"style":1,
"remark":"渠道客户",
"skip_verify":true,
"state":"teststate",
"user" : ["zhangsan", "lisi", "wangwu"],
"party" : [2, 3],
"is_temp":true,
"expires_in":86400,
"chat_expires_in":86400,
"unionid":"oxTWIuGaIt6gTKsQRLau2M0AAAA",
"is_exclusive":true,
"conclusions":
{
"text":
{
"content":"文本消息内容"
},
"image":
{
"media_id": "MEDIA_ID"
},
"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"
}
}
}'响应示例响应示例
{
"errcode": 0,
"errmsg": "ok",
"config_id": "42b34949e138eb6e027c123cba77fAAA",
"qr_code": "http://p.qpic.cn/wwhead/duc2TvpEgSdicZ9RrdUtBkv2UiaA/0"
}请求参数
Query 参数
access_token
string
调用接口凭证
示例值:
ACCESS_TOKEN
Body 参数application/json
返回响应
扫码加入交流群修改于 2022-12-06 08:34:13