1.1 接口说明

云客服系统提供【在线咨询】模块自定义的窗口内容对接。当点击外链按钮时，云客服系统会请求第三方配置的url，并展示第三方系统页面。

1.2 对接步骤

管理员坐席登陆云客服,点击左下角进入设置页面

第一步：设置 —> 对接设置 —> 添加 —> 邮件

第二步：选择请求时需要携带的参数

1.3 请求参数

非必填参数，调用接口时请传递参数名，参数值可为空

序号 名称 类型 是否必填 说明
1 agent_name String 是 坐席名称
2 agnet_num String 是 坐席工号
3 tenant_id String 是 租户ID
4 客户管理 ：关联客户时传勾选的客户信息
4.1 customer_id String 是 客户ID
4.2 nickname String 否 昵称
4.3 truename String 否 客户名称
4.4 mail String 否 邮箱
4.5 website String 否 网站
4.6 tracker_id String 否 关联访客id
4.7 mobile String 否 手机
4.8 wechat String 否 微信
4.9 summary String 否 备注
4.10 address String 否 地址
4.11 province String 否 省
4.12 city String 否 市
4.13 district String 否 区
4.14 town String 否 镇/街道
4.15 village String 否 村/社区
4.16 source_name String 否 客户来源
4.17 level_name String 否 客户等级
4.18 customParam_i String 否 第i个自定义字段
5 在线咨询
5.1 imVisitor_id String 否 会话id
5.2 tracker_id String 否 访客id
5.3 tracker_name String 否 访客名称
5.4 platform_name String 否 接入名称
5.4 authorize_of String 否 平台来源

1.4 请求样例

请求：

假设配置的url地址为：http://127.0.0.1:1002/call/getCall
点击页签时给请求参数赋值，发送post请求，请求体：
{
“agent_name”:”员工甲”,
“agent_num”:”666”,
“tenant_id”:”acf528a2-d0e2-4a7b-8513-74cb3995cfab”,
“customer_id”:”00001920f9beabe279536f0999e7a66c”(有客户时),
“imVisitor_id”:”6da5d1d81634f934b0ba5d1d4ce2dde8”
…..
}

效果：

展示添加时保存url的页面效果

文档更新时间: 2026-04-08 10:25   作者：admin