任务电话维度拨打结束状态通知

任务的电话拨打结束时(接通或者完成拨打次数)，不管接通还是未接通，主动通知对接方该任务的此电话拨打数据，接通的电话会在完成后立即通知；完成拨打次数但仍未接通的所有电话，会聚合通知。
如果此url 响应异常(http状态码非200)，我方会间隔1 分钟进行重试，最多5 次重试，失败后不再进行通知。请在收到数据后进行异步处理，尽快返回响应。
对接方需要提供一个回调URL 地址给我方配置。

请求参数

Header 参数

Content-Type

string

必需

默认值:

application/json

User-Agent

string

可选

默认值:

Airudder

Body 参数application/json

task_id

string

必需

task_name

string

必需

status

enum<string>

必需

枚举值:

createdpendingfinishedcallingcanceledpaused

created_at

string

必需

repeat_interval

integer

必需

repeat_number

integer

必需

robot_hash

string

必需

robot_method

string

必需

sip_line

string

必需

schedule_start_time

string

必需

任务调度开始时间。时区为客户所在地区时间。

schedule_end_time

string

必需

任务调度结束时间。时区为客户所在地区时间。

details

array [object {22}]

必需

1.这里是一个数组，之所以采用数组结构，是因为电话并发拨打，会存在电话拨打同时结束的情况，这里会聚合通知，具体看下面的示例 2.时区为客户所在地区时间。

integer

必需

callee

string

必需

result

enum<string>

必需

枚举值:

createdpendingfinishedcancelledfailed

result_label

string

必需

通话结果标签，根据机器人不同通话结果有不同的含义。

duration

integer

必需

该通电话的通话时长，单位是s

hangup_type

enum<string>

必需

枚举值:

ByCalleeByRobotCanceled

ring_type

enum<string>

必需

枚举值:

busycantuseholdlineswitchoffoutofareaunregisterwrongnum notmatchnormalnull

question_answer

array [object {10}]

必需

EventLabel

object

可选

呼叫结果多标签。（此字段因国家/地区而异。如果您需要更多信息，请联系我们。）

Slots

object

可选

该通电话命中的NER槽位和槽值（此字段将废弃，由NerSlots取代）

NerSlots

object

可选

该通电话命中的NER槽位和槽值（此字段因国家/地区而异。如果您需要更多信息，请联系我们。）

variables

object

可选

用户上传的变量信息。（此字段因国家/地区而异。如果您需要更多信息，请联系我们。）

robot_hash

string

可选

此字段因国家/地区而异。如果您需要更多信息，请联系我们。）

call_id

string

可选

此字段因国家/地区而异。如果您需要更多信息，请联系我们。

call_times

integer

可选

拨打次数，当前轮次内名单的拨打总次数。（此字段因国家/地区而异。如果您需要更多信息，请联系我们。）

call_start_time

string

可选

该通电话的用户接通时间，不包含响铃时长。时区为客户所在地区时间。

call_end_time

string

可选

该通电话的拨打结束时间。时区为客户所在地区时间。此字段因国家/地区而异。如果您需要更多信息，请联系我们。）

ring_time

integer

可选

呼叫的振铃持续时间。（此字段因国家/地区而异。如果您需要更多信息，请联系我们。）

talk_round

integer

可选

通话回合。（此字段因国家/地区而异。如果您需要更多信息，请联系我们。）

redail_call

array [object {8}]

可选

本轮通话重拨的详细信息。（此字段因国家/地区而异。如果您需要更多信息，请联系我们。）

intention_description

string

必需

意图描述，不同的机器人的不同意图描述均不一样。（此字段因国家/地区而异。如果您需要更多信息，请联系我们。）

caller_number

string

必需

此次呼叫的主叫号码（此字段因国家/地区而异。如果您需要更多信息，请联系我们。）

示例

{
    "task_id": "ic1a7a8f2bxxx9f5e343a2ec25a9b2",
    "task_name": "xxxxxxxxxxc25a9b2_ic_task",
    "status": "finished",
    "created_at": "2022-12-19 15:14:52",
    "repeat_interval": 0,
    "repeat_number": 0,
    "robot_hash": "f3298554xxxxxxx88aa595674",
    "robot_method": "single",
    "sip_line": "TEST_LINE",
    "schedule_start_time": "2022-12-19 15:14:52",
    "schedule_end_time": "2022-12-19 15:24:52",
    "details": [
        {
            "id": 931888898,
            "callee": "+8612345678",
            "result": "finished",
            "result_label": "A",
            "intention_description": "xxxx",
            "duration": 0,
            "hangup_type": "ByCallee",
            "ring_type": "normal",
            "question_answer": [
                {
                    "question_name": "Q1",
                    "answer": "rba1",
                    "answer_text": "yes it is  rba1",
                    "status": "Completed",
                    "answer_text_slot": "rba1",
                    "var": "RBA1",
                    "verification_results": "Match",
                    "question_content": "ABCD Reverification",
                    "question_type": "open",
                    "whether_answer": "Answered"
                },
                {
                    "question_name": "Q2",
                    "answer": "Yes",
                    "answer_text": "yes i will",
                    "status": "Completed",
                    "answer_text_slot": "-",
                    "var": "-",
                    "verification_results": "-",
                    "question_content": " Willingness Check",
                    "question_type": "whether",
                    "whether_answer": "Answered"
                },
                {
                    "question_name": "Q3",
                    "answer": "06",
                    "answer_text": "",
                    "status": "Completed",
                    "answer_text_slot": "06",
                    "var": "SN06",
                    "verification_results": "Match",
                    "question_content": " ABCD Verification for 2 character",
                    "question_type": "open",
                    "whether_answer": "Answered"
                }
            ],
            "EventLabel": {
                "VerifyPass": "VerifyPass"
            },
            "NerSlots": {
                    "PaymentMethod": "ATM",
                    "PaymentTime": "Time_0"
                },
            "variables": {
                "birthday": "1224",
                "var2": "03",
                "creditnumber": "1234"
            },
            "robot_hash": "f3298554be9xxxxxxxxaa595674",
            "call_id": "ic9adfe00d474bxxxxxxxx5351bc0",
            "call_times": 1,
            "call_start_time": "2022-12-19 15:17:14",
            "call_end_time": "2022-12-19 15:17:14",
            "ring_time": 0,
            "talk_round": 0,
            "redail_call": [
                {
                    "CallID": "7c5a79bd5c5ac93cbe6fa6b5a0b0412c",
                    "CallStartTime": "2023-03-29 14:24:28",
                    "RingType": "",
                    "RingTime": 5,
                    "HangupType": "ByCallee",
                    "ResultLabel": "F",
                    "caller_number": "+62777888888" ,
                    "callee_number": "+6212345678"  
                }
            ],
            "caller_number": "+62777888888"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '对接方提供此url交给我方配置' \
--header 'User-Agent: Airudder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "task_id": "ic1a7a8f2bxxx9f5e343a2ec25a9b2",
    "task_name": "xxxxxxxxxxc25a9b2_ic_task",
    "status": "finished",
    "created_at": "2022-12-19 15:14:52",
    "repeat_interval": 0,
    "repeat_number": 0,
    "robot_hash": "f3298554xxxxxxx88aa595674",
    "robot_method": "single",
    "sip_line": "TEST_LINE",
    "schedule_start_time": "2022-12-19 15:14:52",
    "schedule_end_time": "2022-12-19 15:24:52",
    "details": [
        {
            "id": 931888898,
            "callee": "+8612345678",
            "result": "finished",
            "result_label": "A",
            "intention_description": "xxxx",
            "duration": 0,
            "hangup_type": "ByCallee",
            "ring_type": "normal",
            "question_answer": [
                {
                    "question_name": "Q1",
                    "answer": "rba1",
                    "answer_text": "yes it is  rba1",
                    "status": "Completed",
                    "answer_text_slot": "rba1",
                    "var": "RBA1",
                    "verification_results": "Match",
                    "question_content": "ABCD Reverification",
                    "question_type": "open",
                    "whether_answer": "Answered"
                },
                {
                    "question_name": "Q2",
                    "answer": "Yes",
                    "answer_text": "yes i will",
                    "status": "Completed",
                    "answer_text_slot": "-",
                    "var": "-",
                    "verification_results": "-",
                    "question_content": " Willingness Check",
                    "question_type": "whether",
                    "whether_answer": "Answered"
                },
                {
                    "question_name": "Q3",
                    "answer": "06",
                    "answer_text": "",
                    "status": "Completed",
                    "answer_text_slot": "06",
                    "var": "SN06",
                    "verification_results": "Match",
                    "question_content": " ABCD Verification for 2 character",
                    "question_type": "open",
                    "whether_answer": "Answered"
                }
            ],
            "EventLabel": {
                "VerifyPass": "VerifyPass"
            },
            "NerSlots": {
                    "PaymentMethod": "ATM",
                    "PaymentTime": "Time_0"
                },
            "variables": {
                "birthday": "1224",
                "var2": "03",
                "creditnumber": "1234"
            },
            "robot_hash": "f3298554be9xxxxxxxxaa595674",
            "call_id": "ic9adfe00d474bxxxxxxxx5351bc0",
            "call_times": 1,
            "call_start_time": "2022-12-19 15:17:14",
            "call_end_time": "2022-12-19 15:17:14",
            "ring_time": 0,
            "talk_round": 0,
            "redail_call": [
                {
                    "CallID": "7c5a79bd5c5ac93cbe6fa6b5a0b0412c",
                    "CallStartTime": "2023-03-29 14:24:28",
                    "RingType": "",
                    "RingTime": 5,
                    "HangupType": "ByCallee",
                    "ResultLabel": "F",
                    "caller_number": "+62777888888" ,
                    "callee_number": "+6212345678"  
                }
            ],
            "caller_number": "+62777888888"
        }
    ]
}'