外呼机器人事件对接

外呼机器人使用过程中，七鱼系统通过该接口向第三方系统推送相关数据信息。包括通话记录回调：每次机器人通话结束后，推送相关通话记录信息；任务状态变更通知：外呼任务状态发生变更时自动推送通知；过滤客户回调：外呼每过滤一个客户会自动调用回调程序向用户配置的回调地址发送本次过滤客户的信息。通过参数dataType进行区分。

参数dataType类型说明：

参数值	参数说明
"ROBOT_CALL_RECORD"	通话记录回调
"ROBOT_CALL_JOB"	任务状态变更通知
"FILER_TASK"	外呼拦截过滤客户回调

调用说明

请您在对接接口前，务必配置好回调地址,否则回调将无法成功。对接URL配置在七鱼系统中：系统管理》扩展与集成》信息对接》外呼机器人对接接口URL;

七鱼服务器向第三方接口请求信息时，采用密钥安全认证机制，保证第三方系统的信息安全。接口鉴权参考通用说明-数据校验;

所有回调接口采用POST请求发起,请求Content-Type类型为：application/json;charset=utf-8,返回类型为JSON，同时进行UTF-8编码;

回调极少概率可能出现重复回调，接口中建议做幂等处理。

第三方接口需返回的数据体说明

接口返回数据体为JSON格式，最外层参数如下：

参数	是否必须	参数说明
code	是	返回码,200表示成功。
result	否	需返回的数据内容，code为200时，该返回值有效。
message	否	业务异常失败时，填错误提示信息。

curl请求样例及具体参数说明如下

1.当一次通话完成后，会自动调用回调程序向用户配置的回调地址发送本次通话详情

具体请求参数说明如下：

参数	类型	说明
dataType	String	回调类型（始终为 ROBOT_CALL_RECORD ）
callRecordId	Long	通话记录id
dialogFlowId	Long	话术id
robotCallJobId	Long	任务id
calledPhoneNumber	String	电话号码
resultStatus	String	通话结果 (ANSWERED, "已接听"),(NO_ANSWER, "未接"),(BUSY, "占线"),(POWER_OFF, "关机"),(OUT_OF_SERVICE, "被叫停机"),(REFUSED, "拒接"),(VACANT_NUMBER, "空号"),(CAN_NOT_CONNECT, "无法接通"), (FROM_PHONE_ERROR, "主叫号码不可用"),(SYSTEM_ERROR, "外呼失败")
intentLevel	String	意向等级, (A, "A级(较强)"),(B, "B级(一般)"),(C, "C级(无法判断)"),(D, "D级(很少)"),(E, "E级别(需要再次跟进)"),(F, "F级别(无需再次跟进)")
customerConcern	List	用户关注点
fullAudioUrl	String	用户和AI合成的录音
customerAudioUrl	String	用户的录音
analysisBasis	String	意向分析判断依据
startTime	String	拨打开始时间
endTime	String	拨打结束时间
chatDuration	Long	通话时长(单位秒)
chatRound	Long	通话轮次
attributes	Set	用户属性
properties	Map	自定义字段
intentLevelTagId	Long	自定义标签分组id
intentLevelCode	Integer	自定义标签组code
dynamicProperties	Map	通话过程中收集的动态变量
callDetailList	List	对话内容
text	String	对话说的具体文字内容
type	String	说话者 (PERSON, "人"), (ROBOT, "机器人")
callDetailId	Long	对话详情id

每当任务的状态有变更时，七鱼会自动调用回调程序向用户配置的回调地址发送本次任务状态变更的信息。

具体请求参数说明如下：

参数	类型	说明
dataType	String	回调类型（始终为ROBOT_CALL_JOB）
robotCallJobId	Long	任务id
status	String	任务状态 (COMPLETED 已完成 IN_PROCESS 进行中 NOT_STARTED 未开始 RUNNABLE 可运行 USER_PAUSE 用户暂停 SYSTEM_SUSPENDED 系统暂停 TERMINATE 已终止 IN_QUEUE 排队中 SYSTEM_HANG_UP 系统挂起 WAITING_FOR_REDIAL 等待重呼 EXPIRED 任务超时)

外呼每过滤一个客户会自动调用回调程序向用户配置的回调地址发送本次过滤客户的信息。

具体请求参数说明如下：

参数	类型	说明
dataType	String	回调类型（始终为FILER_TASK）
filteredRobotCallTaskId	Long	过滤记录id
robotCallJobId	Long	任务id
robotCallJobName	String	任务名称
dialogFlowId	Long	话术id
customerPersonId	Long	客户id
customerPersonName	String	客户姓名
calledPhoneNumber	String	联系电话
filterType	String	过滤类型 DEAD_ZONE 线路盲区 OPERATOR_RESTRICT 运营商限制 SHARE_WHITE_LIST 共享白名单拦截 JOB_WHITE_LIST 任务白名单拦截 INTERCEPT 外呼拦截 CALL_UPPER_LIMIT 拨打上限 LACK_PROPERTIES 自定义变量缺失 BLACK_LIST 大数据黑名单拦截
tenantPhoneNumberId	Long	线路id
location	String	号码归属地

调用说明#

第三方接口需返回的数据体说明#

curl请求样例及具体参数说明如下#

调用说明

第三方接口需返回的数据体说明

curl请求样例及具体参数说明如下