目录
服务商可通过此接口获取授权给获客助手组件的链接。
请求方式: POST(HTTP)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/customer_acquisition/list_link?access_token=ACCESS_TOKEN
请求示例
{
"limit":100,
"cursor":"CURSOR"
}
参数说明:
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| limit | 否 | 返回的最大记录数,整型,最大值100 |
| cursor | 否 | 用于分页查询的游标,字符串类型,由上一次调用返回,首次调用可不填 |
权限说明:
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"link_id_list":
[
"LINK_ID_AAA",
"LINK_ID_BBB",
"LINK_ID_CCC"
],
"next_cursor":"CURSOR"
}
参数说明:
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| link_id_list | link_id列表 |
| next_cursor | 分页游标,在下次请求时填写以获取之后分页的记录 |
服务商可通过此接口根据获客链接id获取链接配置详情。
请求方式: POST(HTTP)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/customer_acquisition/get?access_token=ACCESS_TOKEN
请求示例
{
"link_id":"LINK_ID_AAA",
"extra":"customer_channel=CHANNEL_ID"
}
参数说明:
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| link_id | 是 | 获客链接id |
| extra | 否 | 需要附加到获客链接中的URL query参数,格式为key1=value1&key2=value2,最长2048字节。接口不解析参数内容,将其原样拼接到返回的获客链接末尾;参数值中包含中文等非ASCII字符时,需先进行URL编码 |
权限说明:
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"link":
{
"link_name":"LINK_NAME",
"url":"https://work.weixin.qq.com/ca/xxxxxx?comp_scene=xxxxxx&customer_channel=CHANNEL_ID"
}
}
参数说明:
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| link.link_name | 获客链接的名称 |
| link.url | 获客链接实际的url |
