获取企微成员的客服专属 URL

请求方式

POST

请求地址

https://nbd-api.myscrm.cn/open-nbd-qw-kefu/v1/receptionist/get-links

请求参数

示例

{
  "parameters": [
    {
      "app_id": "39fdda6e-a341-5e67-e243-d4ec9da063b8",
      "qw_users": ["zhouyong", "wangming"]
    }
  ],
  "organ_project_id": "08da0623-1bc8-4070-8fc2-fb6387548de3",
   "channel_type": 1,
   "ext_param": "{\"union_id\":\"xxxxxx\"}"
}

说明

参数	类型	必须	说明
parameters.app_id	string	是	企微中台应用 id
parameters.qw_users	string[]	是	企微员工 id 列表
organ_project_id	string	否	组织项目id
channel_type	int32	否	渠道类型：1-小程序、2-公众号、3-视频号、4-抖音、5-快手、6-其他
ext_param	string	否	自定义参数 json字符串

返回参数

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "kf": [
    {
      "app_id": "39fdda6e-a341-5e67-e243-d4ec9da063b8",
      "qw_users": [
        {
          "qw_user_id": "zhouyong",
          "url": "xxxxx",
          "modified_at": 1632723009
        }
      ]
    }
  ]
}

说明

参数	类型	说明
kf.app_id	string	企微中台应用 id
kf.qw_users.qw_user_id	string	企微员工 id
kf.qw_users.url	string	接待人员的专属客服链接。 可将该链接嵌入到 H5 页面中，用户点击链接即可向对应的企微客服帐号发起咨询。 也可根据该 url 自行生成需要的二维码图片。
kf.qw_users.modified_at	string	最后一次更新时间，秒级时间戳