云客服
云客服
- 最新动态
- 产品介绍
- 快速入门
-
用户指南
- 云控制台操作指南
-
租户管理员指南
- 认识您的租间
- 配置员工中心
- 启用人工服务
- 配置移动客服
- 配置多媒体渠道
-
机器人管理配置指南
- 快速入门
-
配置智能机器人
- 概述
- 配置一个预约挂号机器人（任务型对话机器人）
- 添加问答型对话机器人
- 其他操作
-
相关参考
- 图元
- 参数
-
TUC接口
- /chatbot/rest/tuc/v1/nlp/detectRegularEntity
- /chatbot/rest/tuc/v1/nlp/identify
- /chatbot/rest/tuc/v1/recommendFaq
- /chatbot/rest/tuc/v1/qualityInspection/qiOnline/recognize
- /chatbot/rest/tuc/v1/nlp/feedback
- /chatbot/rest/tuc/v1/nlp/textClassify
- /chatbot/rest/tuc/v1/nlp/detectEntity
- /chatbot/rest/tuc/v1/qualityInspection
- 内置函数
- 常见问题
- 操作员：配置普通IVR
- 配置预置流程
- IVR Journey分析
- 外呼风险监控
- 管理工单配置
- 质检管理
- 管理通知中心
- 管理客户中心
- 配置智能外呼
- 管理问卷
- 管理智能实训
- 配置知识库
- 配置公共资源
- 业务故障放通管理
- 护航浏览
- 社交媒体运营
- 绩效管理
- 客服座席指南
- 质检员指南
- 价格说明
-
开发指南
- 开发概述
- 用户接入——VOIP音视频接入
- 用户接入——网页版客户端集成 (RESTful)
- 用户接入——网页版轻量级客户端集成 (JS)
- 座席集成——座席轻量级接续块集成（JS）
- 座席集成——座席呼叫处理 (RESTful)
-
座席集成——Openeye H5 软电话接口集成
- 修订记录
- OpenEye H5软电话接口概述
- OpenEye软电话安装指导
- 座席侧集成H5软电话开发指导
- 音频呼叫接口
-
音视频呼叫接口扩展
- 音视频呼叫
-
设备管理
- getMediaDevices(获取设备列表)
- setMicIndex(设置麦克风)
- mediaGetMicIndex(查询当前使用的麦克风)
- setSpeakIndex (设置扬声器)
- mediaGetSpeakIndex (查询当前使用的扬声器)
- setMicVol(设置麦克风音量)
- getMicVol(查询麦克风当前音量)
- setSpkVol(设置扬声器音量)
- getSpkVol(查询扬声器当前音量)
- setVideoWindowParam(设置视频窗口位置和宽高)
- setVideoLayoutMode(设置视频窗口画面排列模式)
- setVideoDisplayMode(设置视频窗口画面裁剪模式)
- openCamera(打开摄像头)
- closeCamera(关闭摄像头)
- 屏幕共享
- 截屏
- 录屏
- 错误码列表
- 运营管理——座席工作台集成第三方Web页面
-
API参考
- 接口概述
- 相关术语
- 修改记录
- 接口鉴权方式
-
呼叫中心配置类
-
座席管理
- 单个创建座席业务账号（agentAccount/create）
- 单个删除指定座席业务账号（agentAccount/delete）
- 单个修改座席业务账号信息（agentAccount/update）
- 查询座席业务账号信息（agentAccount/query）
- 绑定座席和技能队列（addSkillsToAgent）
- 解绑座席某技能队列（releaseAgentBySkillId）
- 通过技能队列ID查询座席信息（queryAgentInfoBySkillId）
- 修改座席软电话号码登录密码（updateSipPhonePassword）
- 查询所有座席的软电话信息 (不包含业务账号) (querySysInfo)
- 查询所有座席的软电话信息 (包含业务账号) (queryAgentInfo)
- 查询账号登录结果 (queryAgentLoginParams)
- 根据登录账号查询座席信息 (queryAgentInfoByAccount)
- 按客户号码清理数据 (cleancustpersonaldata)
- 技能队列管理
- 号码管理
- IVR流程管理
-
座席管理
-
座席工作台
- 座席控制
-
座席双呼
- 创建双呼呼叫 (V1.0.0) (createCall)
- 创建双呼呼叫 (V3.0.0) (createCall)
- 查询呼叫历史记录 (queryCallDetailRecord)
- 查询呼叫状态 (queryCallState)
- 获取录音文件地址 (getRecordingAddress)
- 查询分配的软电话号码 (V1.0.0) (queryPhone)
- 查询分配的软电话号码 (V2.0.0) (queryPhone)
- 获取呼叫目的设备信息 (getCalledInfo)
- 创建语音外呼（V1.0.0）（createVoiceNotification）
- 创建语音外呼（V2.0.0）（createVoiceNotification）
- 查询当前会话客户的最近历史接触记录（queryUserContactLimit）
- 查询通话信息（queryCallInfoByCallId）
- ITA双呼结果通知（statusnotify）
- 回调接口
- 订阅语音识别结果接口
- App个人设置
- 附录
- 电销外呼
- 调查问卷
- 知识库管理
- 机器人管理
-
网页客户端接入
- 接口调用流程
- 第三方请求鉴权 (applyToken)
- 查询排队信息 (queryQueueInfo)
- 主动轮询座席侧发送的信息 (poll)
- 保存客户提交的满意度评价结果 (saveSatisfaction)
- 发送消息 (send)
- 客户发送文件 (uploadFileStream)
- 客户接收文件 (downloadFileStream)
- 根据客户输入联想常用语 (queryPhraseByKeyword)
- 检查当前租间是否支持点击通话 (checkClickToCallSupport)
- 创建点击通话 (createClickToCall)
- 获取点击通话事件 (getClickToCallEvents)
- 释放点击通话 (dropClickToCall)
- 创建匿名通话 (createcall)
- 客户提交留言 (doLeaveMessage)
- 提交客户对机器人满意度评价结果 (feedbacksatisfaction)
- 查询历史消息 (queryHistoryChatMessage)
- 丢弃邮件（chat_dropMail）
- 提供whatsapp发送下行消息（sendWhatsappMessage）
- 查询在线交谈工作台当前交谈的消息（getUserInfoBycallId）
- 查询满意度调查配置（getSatisfactionSurveyMode）
-
质检/监控/统计类
- 实时质检:qualitycontrol
-
智能质检
- 质检评分接口 (scoresetting)
- 句子管理接口 (sentencemanagement)
- 敏感词管理接口 (sensitiveWordManage)
- 话术接口 (conversationspecific)
- 句子、敏感词训练接口 (SemanticKeywordTraining)
- 对话逻辑接口 (conversationflow)
- 对话规则接口 (conversationrules)
- 抢插话规则接口 (interposalrules)
- 静默规则接口 (silencerule)
- 语速规则接口 (speedrule)
- 质检场景管理接口 (scenariomanage)
- 通话质检接口 (qualitycheckmanage)
- 人工抽检任务接口 (regularQualityTask)
- 质检任务接口 (qualitytask)
- 质检任务详情接口 (qualitytaskdetail)
- 质检申诉接口 (qualityitem)
- 第三方录音质检接口 (asrtrans)
-
监控/统计
-
实时数据查询类接口
-
VDN维度实时接口
- 查询指定VDN下的系统接入码信息
- 查询指定VDN下的座席休息情况
- 查询指定VDN下的座席电话号码
- 查询指定VDN下的所有座席信息
- 查询指定VDN下的所有座席的当前状态信息
- 查询指定VDN下的所有座席的静态配置信息
- 查询指定VDN下的IVR详细状态信息
- 查询指定VDN下的IVR流程接入码信息
- 查询指定VDN下的各技能队列相关信息
- 查询指定VDN所有休息原因码
- 查询指定接入码编号的呼叫信息
- 查询指定VDN下的呼叫信息
- 查询指定VDN下的呼叫信息（v2）
- 查询指定VDN下的通话轨迹数据
- 查询指定VDN下的所有座席的静态配置信息(CTI3.6版本不支持)
- 查询指定VDN下的所有座席信息(CTI3.6版本不支持)
- 获取VDN实时监控指标
- 技能队列维度实时接口
- 座席维度实时接口
- 呼叫明细维度实时接口
-
VDN维度实时接口
- 历史数据查询类接口
- 配置数据查询类接口
- 质检关系维护接口
- 外呼任务列表查询接口
- 系统指标查询接口
- 健康检查接口
- 附录
-
实时数据查询类接口
- 录音/话单类
- 语音通知
- OMA接口参考
- Case2.0接口参考
- DataProcess接口参考
- 其他类接口参考
- 常见问题
- 文档下载
- 通用参考
链接复制成功！
对话接口（V2）
场景描述
智能助手平台提供接口给第三方接入方调用，实现初始化、对话交互、对话转移以及拆线的实时对话操作，第三方通过调用该接口能够实现与终端用户的进行多轮对话交互以及办理和查询等业务。
此对话接口（V2）对比原对话接口，区别是对话接口（V2）支持依据vdnId进行灰度路由（在接口url中携带vdnId标识），接口参数与逻辑均与原对话接口相同。
接口方法
设置成“POST”。
URL
https://IP:PORT/oifde/rest/v2/crs/process/{vdnId}
请求说明
|
参数名称 |
数据类型 |
参数位置 |
必选/可选 |
描述 |
|---|---|---|---|---|
|
userid |
String |
body |
True |
ODFS根据在Userid内部建立呼叫实例，同一时间ODFS内部可能有多个呼叫实例，后继的交互根据Userid将同一通电话关联起来。 不超过64位 |
|
inaction |
int |
body |
True |
接入方本次执行的是什么类型的请求： 8: 对话初始化请求 (第一次调用时) 9: 对话交互后请求 11: 对话转移后请求 注：除了第一次调用时必须为8，后继传入值即为上次交互接收到的“outaction”即可。 |
|
seat |
String |
body |
False |
座席类型，不填默认为vir
|
|
inparams |
Object |
body |
True |
用于向ODFS传递参数，告知ODFS本次操作结果的详细信息，Inaction的值不同，Params的参数也不相同，根据下面细分的场景详细了解参数介绍。 |
|
extparams |
Object |
body |
False |
用于向ODFS传递参数，可选的扩展参数，当前只有初始化场景使用。 |
响应说明
|
参数名称 |
数据类型 |
参数位置 |
必选/可选 |
描述 |
|---|---|---|---|---|
|
ret |
int |
body |
True |
执行结果
|
|
userid |
String |
body |
True |
ODFS根据在userid内部建立呼叫实例，同一时间ODFS内部可能有多个呼叫实例，后继的交互根据userid将同一通电话关联起来。 |
|
outaction |
int |
body |
True |
接下来接入方需要执行什么类型的操作
|
|
outparams |
Object |
body |
True |
用于知会接入方完成操作需要的详细信息，请根据具体的场景查看参数介绍。 |
返回码
须知：
在响应消息体中没有返回码和描述信息，直接使用如下HTTPS协议原生的返回码。
|
返回码 |
返回描述 |
可能原因 |
解决方案 |
|---|---|---|---|
|
200 |
成功响应码 |
处理成功 |
- |
|
400 |
错误请求 |
请求URL错误 |
请核对您的请求URL是否正确。 |
|
500 |
业务失败 |
您请求中的某参数值在系统中不存在，例如，您发送的工单类别编码在系统中不存在。 |
请依次确认您请求中各参数的取值。 |
|
其他 |
参照标准的HTTPS协议状态码 |
- |
- |
- 对话初始化接口（inaction=8）
接入方首次向ODFS发起请求时，需要发送一条inaction为8的请求，表示通知ODFS初始化，由ODFS在outparams中返回接入方的下一步操作。本节介绍请求参数inparams的具体结构以及请求消息样例，几种不同场景的返回参数结构与消息样例。 - 对话交互后接口（inaction=9）
接入方执行完放音、文字交谈等操作后,将当前操作的结果作为入参,继续请求ODFS下一次的操作,以下是请求参数结构。 - 对话转接后请求（inaction=11）
接入方执行完对话转接操作后,将当前操作的结果作为入参,继续请求ODFS下一次的操作,以下是请求参数结构。 - 对话开启抓包录制请求（inaction=7）
接入方首次向ODFS发起请求时,首先请求ODFS开启宇高录制,但ODFS是否会向宇高请求开启,则还由发布流程时确定。只限对接了抓包系统（如宇高）组网下智能IVR业务 - 请求识别结果（inaction=13）
接入方请求ODFS返回用户语音识别结果,便于进行打断放音等处理。只限对接了抓包系统（如宇高）组网下智能IVR业务
父主题： 机器人管理
