注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 三方AI项目

taobao.smart.call.task.create (智能外呼任务创建)

智能外呼任务创建

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
recall_type Number 可选 1
  • 默认值:1
  • 未接重呼配置, 可选值:1,2,3,默认为1; 1:不重呼;2:间隔重呼;3:定时重呼
    template_id Number 必须 1 话术模版ID
    max_concurrency Number 可选 1 外呼并发数
    voice_id Number 可选 1 音色id, 若不传则使用默认音色
    repeat_interval Number 可选 1 重呼间隔, 当重呼选项为2时,必填;单位为分钟,支持≥1的正整数
    repeat_times String 可选 {"8:00","9:00"} 当重呼选项为3时,必填;格式为["8:00","9:00"],多个时间点用,隔开 可以选值穷举: "7:00", "7:30", "8:00", "8:30", "9:00", "9:30", "10:00", "10:30", "11:00", "11:30", "12:00", "12:30", "13:00", "13:30", "14:00", "14:30", "15:00", "15:30", "16:00", "16:30", "17:00", "17:30", "18:00", "18:30", "19:00", "19:30", "20:00", "20:30", "21:00", "21:30", "22:00"
    name String 必须 外呼任务测试 任务名称, 不能超过100个字符
    repeat_reason Number 可选 {2,3} 重呼条件, 可多选,不传时默认条件全部 重呼条件是指上一通外呼状态,如“占线”“空号” 注,重呼条件编码与描述对应: 2 "关机", 3 "空号", 4 "改号", 5 "停机", 6 "占线", 7 "拒接", 8 "无法接通", 9 "未接", 10 "用户欠费", 11 "线路故障", 12 "呼叫失败" 30 "已拦截" 40 "单日呼叫次数受限"
    start_time String 可选 2022-09-16 指定日期启动外呼任务;不传则任务创建成功立即外呼,直至数据外呼完成; 格式举例:2022年09月16日执行外呼任务,传:[2022-09-16];
    gateway_id Number 可选 1 线路id,不传值时,默认按系统的线路配置外呼
    repeat_count Number 可选 1 重呼次数, 当重呼选项为2时,必填;支持≥1正整数
    call_time String 可选 "{{8.5,12},{13.5,19}}" 外呼时间,格式举例:“8:30-12:00 13:30-19:00”则传[[8.5,12][13.5,19]];默认为[[8,20]],只支持半小时维度,如9:30则传9.5。

    响应参数

    名称 类型 示例值 描述
    task_id Number 123 外呼任务ID
    error Number 13 错误码
    message String 非法参数 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    SmartCallTaskCreateRequest req = new SmartCallTaskCreateRequest();
    req.setRecallType(1L);
    req.setTemplateId(1L);
    req.setMaxConcurrency(1L);
    req.setVoiceId(1L);
    req.setRepeatInterval(1L);
    req.setRepeatTimes("{\"8:00\",\"9:00\"}");
    req.setName("外呼任务测试");
    req.setRepeatReason({2,3}L);
    req.setStartTime("2022-09-16");
    req.setGatewayId(1L);
    req.setRepeatCount(1L);
    req.setCallTime("\"{{8.5,12},{13.5,19}}\"");
    SmartCallTaskCreateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <smart_call_task_create_response>
        <task_id>123</task_id>
        <error>13</error>
        <message>非法参数</message>
    </smart_call_task_create_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部