外呼任务 API 接口说明

本文档说明外呼任务创建接口的两种任务类型：长期任务 与 一次性任务，帮助开发者根据实际场景选择合适的接口。

一、长期任务

适用场景

同一话术的机器人需要持续、分批对外呼出，不希望每次都重新创建任务。

核心机制

1. 先创建任务：调用「创建外呼任务」接口，创建任务时可设置较长的任务有效期；
2. 后追加号码：任务创建后，随时调用「外呼任务添加号码」接口，向该任务补充号码；
3. 无需重复创建：同一话术只需创建一次任务，后续仅需追加号码即可发起外呼。

使用流程

创建外呼任务（设置较长有效期）
        ↓
向任务添加号码（第一批）
        ↓
机器人外呼执行
        ↓
向任务添加号码（第二批）
        ↓
机器人外呼执行
        ↓
  ……持续追加，循环使用

注意事项

• 任务有效期需在创建时合理设置，确保在业务周期内任务不会过期；
• 追加号码接口支持批量添加，具体批次大小请参考接口参数说明；
• 同一任务可重复利用，适合长期运营类外呼场景（如会员回访、定期通知等）。

二、一次性任务

适用场景

外呼号码一次性确定，不需要后续追加号码的单次执行场景。

核心机制

1. 创建即提交：调用接口创建任务时需同时提交全部外呼号码，任务创建后即刻或按计划开始执行；
2. 不支持追加：任务创建后不支持通过任何接口向该任务追加号码；
3. 结果通知：任务执行结束后，系统会通过外部任务状态回调接口自动推送任务完成状态通知，无需手动查询。

使用流程

创建外呼任务（同时提交全部号码）
        ↓
机器人外呼执行（一次性完成）
        ↓
接收任务状态回调通知
        ↓
（任务结束，不可追加）

注意事项

• 请在创建任务前确认号码列表完整，创建后无法补发；
• 需提前配置好任务状态回调地址，确保能正常接收执行结果通知；
• 适合名单固定、单次执行的场景（如活动通知、一次性调研等）。

三、两种任务类型对比

四、如何选择

• 号码是分批到位、需要持续外呼 → 选择 长期任务
• 号码一次性备齐、只执行一次 → 选择 一次性任务