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

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

taobao.smart.call.task.edit (智能外呼任务编辑)

智能外呼任务编辑

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
recall_type Number 可选 1
  • 默认值:1
  • 重呼配置,可选值:1,2,3,默认为1; 1:不重呼;2:间隔重呼;3:定时重呼;注:不传参视为不修改;
    template_id String 可选 1 AI话术ID,注:只返回自建已发布及授权已发布的话术模板
    max_concurrency Number 可选 1
  • 默认值:1
  • 修改并发数。默认为1,不可超过企业设置最高并发数; 注:不传参视为不修改;
    voice_id Number 可选 123 音色id,注:不传参视为不修改;
    recall_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, 8,9,10,11, 12] 重呼条件是指上一通外呼状态,如“占线”“空号” 注,重呼条件编码与描述对应: 2 "关机", 3 "空号", 4 "改号", 5 "停机", 6 "占线", 7 "拒接", 8 "无法接通", 9 "未接", 10 "用户欠费", 11 "线路故障", 12 "呼叫失败" 30 "已拦截" 40 "单日呼叫次数受限"
    task_id Number 必须 123 任务id
    call_time String 可选 "{{8.5,12},{13.5,19}}" 外呼时间,格式举例:“8:30-12:00 13:30-19:00”则传[[8.5,12][13.5,19]];,只支持半小时维度,如9:30则传9.5。 注:不传参视为不修改;
    gateway_id Number 可选 1 gatewayId不传值时,默认按系统的线路配置外呼
    status Number 可选 2 修改任务状态,2:开启;4:停止; 注:不传参视为不修改;
    repeat_count Number 可选 2 重呼次数, 当重呼选项为2时,必填;支持≥1正整数,不传参视为不修改

    响应参数

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

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    SmartCallTaskEditRequest req = new SmartCallTaskEditRequest();
    req.setRecallType(1L);
    req.setTemplateId("1");
    req.setMaxConcurrency(1L);
    req.setVoiceId(123L);
    req.setRecallInterval(1L);
    req.setRepeatTimes("{\"8:00\",\"9:00\"}");
    req.setName("测试");
    req.setRepeatReason({2,3}L);
    req.setTaskId(123L);
    req.setCallTime("\"{{8.5,12},{13.5,19}}\"");
    req.setGatewayId(1L);
    req.setStatus(2L);
    req.setRepeatCount(2L);
    SmartCallTaskEditResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <smart_call_task_edit_response>
        <task_id>123</task_id>
        <error>10</error>
        <message>非法参数</message>
    </smart_call_task_edit_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

    返回
    顶部