TQ云呼叫中心与第三方系统对接方案(HTX).doc

TQ云呼叫中心·第三方系统对接方案 版本信息：201504  目录 1 概述 4 1.1 对接目的 4 1.2 对接前提 4 2 CRM对接 4 2.1 统一平台 4 2.1.1 流程 4 2.1.2 配置 4 2.1.3 效果演示 5 2.2 统一登录 5 2.2.1 流程 6 2.2.2 参数说明 6 3 弹屏对接 7 3.1 流程 7 3.2 参数说明 7 3.3 配置 8 3.4 效果演示 8 4 点击外呼 8 4.1 方案：JS调用 8 4.2 参数 8 4.3 示例 8 概述 对接目的 为了保持客户对现有业务系统的使用习惯，为了实现客户数据保存到自己原有系统，TQ专门做了相应接口，来协助企业兼容TQ呼叫中心和业务系统两个重要的模块 对接前提 第三方系统必须基于B/S架构 CRM对接 统一平台 登陆TQ客户端时，用户可以直接在TQ客户端操作配置好的第三方CRM系统 流程 在TQ系统配置好第三方CRM地址，登陆TQ客户端时，TQ调用第三方CRM地址，实现在TQ客户端打开第三方 CRM系统功能 配置 登陆TQ系统的“系统管理”，然后进入“第三方接口-CRM接口”，把第三方CRM的url填写到接口设置处，选择“启用”，然后“保存” 效果演示 登陆客户端，点击“客户管理”，即可访问第三方系统。以百度为第三方crm为例： 统一登录 登陆TQ客户端以后，直接登录第三方CRM系统，不需要再次输入账号密码人工登陆系统 流程 统一认证机制说明 登陆TQ客户端时，TQ会调用第三方系统网址，同时会向该地址推送安全认证号token参数 第三方系统可根据token值到TQ认证地址去认证 验证TQ认证地址返回值，如果认证成功则说明调用有效 扩展第三方系统登陆方式，将TQ号码和第三方系统账号做对应，允许当前帐号直接进入系统，并显示相应权限内的数据，否则予以提示 认证地址： 认证地址：/check.do?uin=**token=** 返回值：1或-1，1：成功，-1失败 注：所有参数格式都为小写，具体如以上参数表所示。 参数说明 参数名 说明 备注 token TQ帐号登录时在TQ认证服务器生成的唯一标识 登录30分钟内无任何操作则自动失效 退出TQ客户端时将被注销 uin 当前用户的TQ帐号 admin_uin 当前用户的TQ管理员帐号 弹屏对接 客户来电或坐席去电时，TQ客户自动弹出保存在第三方系统中与呼叫电话号码相关的客户信息（以及其它个性化操作入口）页面 流程 客户来电/座席去电，弹屏事件推送至TQ客户端 TQ客户端调用已配置的第三方弹屏地址同时传入相应参数 第三方系统接收到参数后进行处理，并返回相应信息 TQ客户端实现调用第三方弹屏信息功能 参数说明 注：关键参数为admin_uin（企业唯一标识）、uin（坐席TQ号）、callerid（电话号码） 参数名 说明 备注 phoneid 电话记录编号 　 admin_uin TQ管理员账户 7位纯数字 uin 弹屏座席TQ号 8位纯数字 userName 座席用户名 seatid 座席工号 　 called_id 座席电话 　 called_id_key 自定义安全参数 格式：座席电话-自定义安全码 callerid 客户电话号码 callerid_key 自定义安全参数 格式：客户电话号码-自定义安全码 phone_place 电话归属地 gbk编码 phone_place_encode 电话归属地编码 UTF-8编码 dnis 呼入中继号码 token 安全认证参数 每次退出账户自动注销 isencry 客户号码是否屏蔽后四位 　 mykey 自定义安全参数 　格式：yyyy-MM-dd?HH:mm-安全码 manual_clicked=0 是否点击外呼 0：是 1：否 roleid 角色id 0：管理员；-1：自定义角色； 1：系统默认普通座席； 2：系统默认经理角色； 其他：TQ系统角色id media_id 媒体id 呼入媒体来源id queuename 呼入队列 url编码 rand 访客id 如果有值，则一定要存第三方库，以便对应记录 call_style 电话类型 1：免费电话 2：400电话 3：外呼电话 4：直线呼入 client_uin 可自定义参数值1 现阶段只针对免费电话 client_id 可自定义参数值2 现阶段只针对免费电话 visitor_entry 初始来源 只针对免费电话 visitor_comes 来访次数 只针对免费电话 visitor_keyword 关键词 只针对免费电话 visitor_last_page 上一个页面 只针对免费电话 visitor_page