企业微信scrm源码开发-基于企微联系我接口

联系：vx:  llike620

先看企微联系我接口文档

企业可以在管理后台-客户联系-加客户中配置成员的「联系我」的二维码或者小程序按钮，客户通过扫描二维码或点击小程序上的按钮，即可获取成员联系方式，主动联系到成员。
企业可通过此接口为具有客户联系功能的成员生成专属的「联系我」二维码或者「联系我」按钮。
如果配置的是「联系我」按钮，需要开发者的小程序接入小程序插件。

注意:
通过API添加的「联系我」不会在管理端进行展示，每个企业可通过API最多配置50万个「联系我」。
用户需要妥善存储返回的config_id，config_id丢失可能导致用户无法编辑或删除「联系我」。
临时会话模式不占用「联系我」数量，但每日最多添加10万个，并且仅支持单人。
临时会话模式的二维码，添加好友完成后该二维码即刻失效。

 

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_contact_way?access_token=ACCESS_TOKEN

请求示例：

{
   "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"
    	}
   }
}

 

参数说明：

参数	必须	说明
access_token	是	调用接口凭证
type	是	联系方式类型,1-单人, 2-多人
scene	是	场景，1-在小程序中联系，2-通过二维码联系
style	否	在小程序中联系时使用的控件样式，详见附表
remark	否	联系方式的备注信息，用于助记，不超过30个字符
skip_verify	否	外部客户添加时是否无需验证，默认为true
state	否	企业自定义的state参数，用于区分不同的添加渠道，在调用“获取客户详情”时会返回该参数值，不超过30个字符
user	否	使用该联系方式的用户userID列表，在type为1时为必填，且只能有一个
party	否	使用该联系方式的部门id列表，只在type为2时有效
is_temp	否	是否临时会话模式，true表示使用临时会话模式，默认为false
expires_in	否	临时会话二维码有效期，以秒为单位。该参数仅在is_temp为true时有效，默认7天，最多为14天
chat_expires_in	否	临时会话有效期，以秒为单位。该参数仅在is_temp为true时有效，默认为添加好友后24小时，最多为14天
unionid	否	可进行临时会话的客户unionid，该参数仅在is_temp为true时有效，如不指定则不进行限制
is_exclusive	否	是否开启同一外部企业客户只能添加同一个员工，默认为否，开启后，同一个企业的客户会优先添加到同一个跟进人
conclusions	否	结束语，会话结束时自动发送给客户，可参考“结束语定义”，仅在is_temp为true时有效

注意，每个联系方式最多配置100个使用成员（包含部门展开后的成员）
当设置为临时会话模式时（即is_temp为true），联系人仅支持配置为单人，暂不支持多人
使用unionid需要调用方（企业或服务商）的企业微信“客户联系”中已绑定微信开发者账户

 

返回结果：

{
   "errcode": 0,
   "errmsg": "ok",
   "config_id":"42b34949e138eb6e027c123cba77fAAA",
   "qr_code":"https://p.qpic.cn/wwhead/duc2TvpEgSdicZ9RrdUtBkv2UiaA/0"
}

 

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
config_id	新增联系方式的配置id
qr_code	联系我二维码链接，仅在scene为2时返回