通讯话单

### 通话记录异步通知

### 1.回调触发时机

通话结束后、话单为异步推送

> 当企业的话单生成时，服务器会把相关话单发送给企业，企业需要接受处理，并返回应答。如果服务器请求推送地址的应答不是成功或者超时，服务器认为通知失败，服务器会通过一定策略(共发送3次,第一次失败后5分钟后执行第二次, 第二次失败后1小时后执行第三次)定期重新发起通知，尽可能尽可能提高通知的成功率，但服务器不保证通知最终能成功。注意：同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。

### 2. 其他说明
回调地址需要对接方提供，需要在系统后台配置对接方的的回调地址。接口请求为POST请求，接口返回SUCCESS字符串（全大写）为成功，其他为失败。

### 3. 回调结构体

| 参数名称 | 类型 | 描述 |
| --- | --- | --- |
| code | number | 状态编码 |
| msg | String | 描述 |
| data | object | 话单 |

> data结构体定义

| 参数名称 | 类型 | 描述 |
| --- | --- | --- |
| call_id | String | 呼叫ID |
| call_type | Int | 电话类型 0 呼出 1呼入|
| caller_number | String | 主叫号码 |
| callee_number | String | 被叫号码 |
| relay_number | String | 中继号码 |
| ivr_in_time | Int | IVR开始时间 |
| ivr_duration | Int | IVR持续时间 |
| queue_in_time | Int | 队列开始时间 |
| queue_duration | Int | 队列持续时间 |
| skill_id | Int | 技能组ID |
| skill_name | String | 技能组名称 |
| ring_in_time | Int | 振铃开始时间 |
| ring_duration | Int | 振铃持续时间 |
| start_time | Int | 开始时间 |
| answer_time | Int | 应答时间 |
| hangup_time | Int | 挂断时间 |
| talk_duration | Int | 通话时长 |
| duration | Int | 总时长 |
| transfer_type | String | 转接类型 consult-询问、treeway-三方、blind-转接|
| hangup_type | Int | 挂断类型 0-对方，1-自己 |
| hangup_reason | String | 挂断原因 |
| custom | String | 自定义 (32位字母和数字) |
| province | String | 省 |
| city | String | 市 |
| channel | String | 运营商 |
| code | String | 行政区域编码 |
| category | Int | 电话类别(0 普通 1自动外呼) |
| bot_id | Int | 机器人ID |
| detail | Array | 子话单 |
| ivrDetail | Array | ivr导航 |

> Detail子话单-数组结构体定义

| 参数名称 | 类型 | 描述 |
| --- | --- | --- |
| call_id | String | 呼叫ID |
| call_type | Int | 电话类型 0 呼出 1呼入|
| caller_number | String | 主叫号码 |
| callee_number | String | 被叫号码 |
| relay_number | String | 中继号码 |
| ivr_in_time | Int | IVR开始时间 |
| ivr_duration | Int | IVR持续时间 |
| queue_in_time | Int | 队列开始时间 |
| queue_duration | Int | 队列持续时间 |
| skill_id | Int | 技能组ID |
| skill_name | String | 技能组名称 |
| ring_in_time | Int | 振铃开始时间 |
| ring_duration | Int | 振铃持续时间 |
| start_time | Int | 开始时间 |
| answer_time | Int | 应答时间 |
| hangup_time | Int | 挂断时间 |
| talk_duration | Int | 通话时长（有效通话时长） |
| duration | Int | 总时长 |
| transfer_type | String | 转接类型 consult-询问、treeway-三方、blind-转接 |
| hangup_type | Int | 挂断类型 0-对方，1-自己|
| hangup_reason | String | 挂断原因 |
| record_status | Int | 是否有录音 0-无 1-有|
| record_url | String | 录音地址 |
| province | String | 省 |
| city | String | 市 |
| channel | String | 运营商 |
| code | String | 行政区域编码 |
| ev_id | Int | 满意度评价ID |
| category | Int | 电话类别(0 普通 1自动外呼) |

> ivrDetail-数组结构体定义

| 参数名称 | 类型 | 描述 |
| --- | --- | --- |
| ivr_name | String | IVR名称 |
| title | String | 节点名称|
| created_time | String | 创建时间 |

### 3.示例

>i  输出示例

```
{
    "code": 0,
    "msg": "",
    "data": {
        "call_id": "ee1fc5a9-fc88-4439-94c6-8f0142dba150",
        "call_type": 1,
        "caller_number": "189xxxx",
        "callee_number": "8989",
        "relay_number": "021xxxxx",
        "ivr_in_time": 1691049030,
        "ivr_duration": 4,
        "queue_in_time": 1691049034,
        "queue_duration": 2,
        "skill_id": 98,
        "skill_name": "进线测试",
        "ring_in_time": 1691049029,
        "ring_duration": 0,
        "start_time": 1691049029,
        "answer_time": 1691049029,
        "hangup_time": 1691049090,
        "talk_duration": 61,
        "duration": 61,
        "transfer_type": "",
        "hangup_type": 0,
        "hangup_reason": "NORMAL_CLEARING",
        "custom": "",
        "province": "安徽",
        "city": "蚌埠",
        "channel": "中国电信",
        "code": "340300",
        "category": 0,
		"bot_id": 33,
        "detail": [
            {
                "call_id": "ee1fc5a9-fc88-4439-94c6-8f0142dba150",
                "call_type": 1,
                "caller_number": "8989",
                "callee_number": "1011",
                "relay_number": "021xxxx",
                "ivr_in_time": 1691049030,
                "ivr_duration": 4,
                "queue_in_time": 0,
                "queue_duration": 0,
                "skill_id": 0,
                "skill_name": "",
                "ring_in_time": 1691049045,
                "ring_duration": 1,
                "start_time": 1691049045,
                "answer_time": 1691049046,
                "hangup_time": 1691049050,
                "talk_duration": 4,
                "duration": 5,
                "transfer_type": "consult",
                "hangup_reason": "NORMAL_CLEARING",
                "hangup_type": 0,
                "record_url": "record\/3021\/2023\/08\/03\/C30xxx_C30xxx1_xxxx_5f6ce45b-40c4-427f-b2e0-af3322c690f5.mp3",
                "record_status": 1,
                "callee_uuid": "5f6ce45b-40c4-427f-b2e0-af3322c690f5",
                "province": "",
                "city": "",
                "channel": "",
                "code": "",
                "ev_id": 0,
                "category": 0
            },
            {
                "call_id": "ee1fc5a9-fc88-4439-94c6-8f0142dba150",
                "call_type": 1,
                "caller_number": "8989",
                "callee_number": "1011",
                "relay_number": "021xxxxx",
                "ivr_in_time": 1691049030,
                "ivr_duration": 4,
                "queue_in_time": 0,
                "queue_duration": 0,
                "skill_id": 0,
                "skill_name": "",
                "ring_in_time": 1691049055,
                "ring_duration": 2,
                "start_time": 1691049055,
                "answer_time": 1691049057,
                "hangup_time": 1691049061,
                "talk_duration": 4,
                "duration": 6,
                "transfer_type": "treeway",
                "hangup_reason": "NORMAL_CLEARING",
                "hangup_type": 0,
                "record_url": false,
                "record_status": 0,
                "callee_uuid": "429a05dc-750b-4132-9edf-20cfcc5be7ad",
                "province": "",
                "city": "",
                "channel": "",
                "code": "",
                "ev_id": 0,
                "category": 0
            }
        ],
        "ivrDetail": [
            {
                "created_time": "2023-08-03 15:50:30",
                "title": "播放语音:按键导航1-5",
                "ivr_name": "进线测试"
            },
            {
                "created_time": "2023-08-03 15:50:32",
                "title": "按键导航",
                "ivr_name": "进线测试"
            }
        ]
    }
}

```