知识中心
所有文章
帮助中心
AI客户联络中心 升级日志
API文档
AI客户联络
API接口
【新】云节点列表
对话接口
白标接口及地址
任务初始化
最后更新于 2023/05/06   阅读数 780

创建任务初始化


获取新建任务所需要的初始信息

此接口【v1.2.31版本有变动】 查看变更日志

  • 接口:/agent-api/user/{user_id}/task/create

  • 请求方式: GET

  • 路由参数

参数

类型

示例

解释

必填

user_id

string

5832d184-dd53-42a0-8ace-0bf8d660f4cc

用户id

  • 请求参数

    参数

    类型

    示例

    解释

    必填

    sub_user_id

    string

    5b55bcca-d653-4a58-8f9a-437fb0601f8e 

    子账户id(传递此参数则是对子账户操作)

    • 返回结果:

      {
      	"code": 200,
      	"status": "success",
      	"message": "返回任务初始化信息成功",
      	"data": {
              //已废弃
      		"enum_disable_dial_timegroup": [ // 禁呼时间组列表
      			{
      				"uuid": "8c7f43ec-b690-48a6-a46d-1ae11b662cc4", // 禁呼时间组id
      				"name": "默认禁止呼叫时间:00:00:00-08:00:00,21:00:00-23:59:59", // 禁呼时间组名称
      				"is_default": 1, //1代表为默认,0代表非默认
      				"time_range": [ //具体的时间规则
      					{
      						"group_uuid": "8c7f43ec-b690-48a6-a46d-1ae11b662cc4", // 禁呼时间组id
      						"uuid": "1f8ae9c2-7343-4a3a-9173-03030185c91c",
      						"begin_datetime": "18:00:00",
      						"end_datetime": "09:00:00"
      					},
      					{
      						"group_uuid": "8c7f43ec-b690-48a6-a46d-1ae11b662cc4",
      						"uuid": "3629d087-5ac3-4878-b8ed-6a5b4a32b50d",
      						"begin_datetime": "12:00:00",
      						"end_datetime": "13:00:00"
      					}
      				]
      			}
      		],
              //新增呼叫组
              "enum_dial_time_group": [ //呼叫时间组
                  {
                      "id": 1, //呼叫组ID
                      "name": "测试呼叫组1", //呼叫组名称
                      "content": [ //呼叫组内容
                          {  //以下配置表示呼叫时间为:周一 9点~12点、3点到18点
                              "week": 0, //周一
                              "times": [ //呼叫时间段
                                  {   
                                      "end_time": "12:00", 
                                      "begin_time": "9:00"
                                  },
                                  {
                                      "end_time": "18:00",
                                      "begin_time": "13:00"
                                  }
                              ]
                          },
                          {  //以下配置表示呼叫时间为:周二 9点30分~12点30分、13点30分~17点30分
                              "week": 1,
                              "times": [
                                  {
                                      "end_time": "12:30",
                                      "begin_time": "9:30"
                                  },
                                  {
                                      "end_time": "17:30",
                                      "begin_time": "13:30"
                                  }
                              ]
                          }
                      ],
                      "skip_holiday": false, //是否跳法定节假日,为true表示任务的拨打时间自动跳过国家法定节假日(如春节、清明、端午、五一、国庆等)
                      "is_default": true //是否为默认呼叫组,一个用户只能有一个默认组,方便用户在外呼任务处快速绑定呼叫组。
                  },
                  { //以下表示:使用该呼叫组的任务,只能在周一的8点~12点、13点~15点、16点~22点拨打,其余时间为禁呼时间
                      "id": 2,
                      "content": [
                          {
                              "week": 0,
                              "times": [
                                  {
                                      "end_time": "12:00",
                                      "begin_time": "08:00"
                                  },
                                  {
                                      "end_time": "15:00",
                                      "begin_time": "13:00"
                                  },
                                  {
                                      "end_time": "22:00",
                                      "begin_time": "16:00"
                                  }
                              ]
                          }
                      ],
                      "skip_holiday": false,
                      "is_default": false
                  }
              ],
      		"caller_line_list": [ // 线路列表
      			{
      				"name": "成都平安小许-2020050701", // 线路名称
      				"value": "a62bdf07-df18-46c7-960b411df4b6e", // 线路id
      				"residue": 7, // 剩余并发
      				"call_line": 13, // 总共并发
      				"available_at": "2020-07-01 00:00:00", // 有效期至
      				"call_number": null // 主叫号码(一般为空)
      			}
      		],
      		"outbound_group": [ // 话术组
      			{
      				"id": 5, // 话术组id
      				"name": "话术分组11.22", // 话术组名称
      				"user_id": "f00c8abc-433f-4666-a9479605ced1", // 用户id
      				"debug": true, // 是否是调试模式
      				"deleted_at": null,
      				"created_at": "2019-11-22 17:22:54", // 创建时间
      				"updated_at": "2020-03-06 16:18:09", // 更新时间
      				"link_word_group_id": null, // 衔接词组
      				"tag_scene_id": null, // 业务场景id
      				"default": false,// 是否是默认话术组
      			"caller_lines": [   //话术关联的线路
                                        {
                                            "id": "0b13ac66-a2c0-4a0e-b9c3-ef21f087f80a",
                                            "name": "机器人测试54978536",
                                            "description": null,
                                            "deadline_at": "2022-05-31 00:00:00",
                                            "begin_at": "2021-05-31 11:43:36",
                                            "call_line": 1,
                                            "call_line_used": 0,
                                            "pivot": {
                                                "label_group_id": 1703,
                                                "caller_line_id": "0b13ac66-a2c0-4a0e-b9c3-ef21f087f80a"
                                            }
                                        }
                                    ]
      			}
      		],
      		"bridge_groups": [{    //转接组
      				"id": 3,
      				"name": "转接组2号",
      				"strategy": 2,        //转接组策略
      				"strategy_str": "顺序"
      			},
      			{
      				"id": 4,
      				"name": "转接组14号",
      				"strategy": 2,
      				"strategy_str": "顺序"
      			}
      		],
      		"auto_recycle_rules": [ // 自动重呼规则
      			{
      				"id": 4, // 自动重呼规则id
      				"user_id": "f00c8abc-433f-4666-a9d6-70479605ced1", // 用户id
      				"name": "测试自动重呼", // 自动重呼规则名称
      				"remark": "测试自动重呼", // 自动重呼规则描述
      				"status": true, // 是否启用
      				"created_at": "2020-01-14 14:00:09",
      				"updated_at": "2020-01-14 14:00:09",
      				"is_default": null, // 是否默认
      				"type": 1, // 类型:1自动重呼、2指定时间重呼
      				"configs": null, // 指定时间重呼规则的时间配置
      				"details": [{
      						"rule_id": 4,
      						"number_status": 2, //号码状态
      						"time": 0, //重呼次数
      						"number_status_str": "运营商拦截"
      					},
      					{
      						"rule_id": 4,
      						"number_status": 12,
      						"time": 0,
      						"number_status_str": "用户屏蔽"
      					}
      				]
      			}
      		],
             "end_actions":{
                "1": "暂停任务并释放并发"
              }
      	}
      }
      
      
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      52
      53
      54
      55
      56
      57
      58
      59
      60
      61
      62
      63
      64
      65
      66
      67
      68
      69
      70
      71
      72
      73
      74
      75
      76
      77
      78
      79
      80
      81
      82
      83
      84
      85
      86
      87
      88
      89
      90
      91
      92
      93
      94
      95
      96
      97
      98
      99
      100
      101
      102
      103
      104
      105
      106
      107
      108
      109
      110
      111
      112
      113
      114
      115
      116
      117
      118
      119
      120
      121
      122
      123
      124
      125
      126
      127
      128
      129
      130
      131
      132
      133
      134
      135
      136
      137
      138
      139
      140
      141
      142
      143
      144
      145
      146
      147
      148
      149
      150
      151
      152
      153
      154
      155
      156
      157
      158
      159
      160
      161
      162
      163
      164
      165
      166
      167
      168
      169
      170
      171
      172
      173
      plaintext
      • 字段解释:

      • enum_disable_dial_timegroup 禁呼时间组

      • caller_line_list线路列表

      • outbound_group 话术组

      • customer_service 客服组

      • auto_recycle_rules 自动重呼规则

      • bridge_groups 转接组 strategy的值 1代表平均,2代表顺序,3代表随机

      • enum_dial_time_group 呼叫时间组

      • end_actions 任务结束动作

未能解决您的问题?请联系
本篇目录

创建任务初始化