外呼任务

快速阅读

外呼任务对接，是把业务系统里的「一批人」送进呼叫中心的任务体系，再按产品逻辑跑完拨号、承接、回写。下面三个故事先讲产品怎么用；需要联调或脚本化时，再看每个故事后面的 CLI 怎么用。

• 预览：人看单再拨。
• 预测：系统先呼客户，接通再找座席。
• IVR / 自动外呼：系统按固定节奏拨，接通进导航或机器人。

对接方通常是：CRM 调 OpenAPI（或人在管理端操作）驱动任务；CLI 只是同一套接口的命令行形式，用来核实「创建成功了没有、名单进了没有、监控在不在动、话单能不能查到」。

这篇里 CLI 扮演什么角色

能力边界（务必先读）：

• zenava callcenter task（--type 1 预测 / --type 2 自动外呼）：建任务、导号码、启停、监控。
• 预览任务的建档与分配：不在 task 里；预览一通点呼可用 agent preview-outcall，记录用 cdr ob-query。
• 完整参数以 Zenava CLI 产品说明 为准；下文命令只演示联调习惯。

故事一：CRM 高意向跟进——预览外呼任务怎么用

业务要什么

销售筛出 200 个高意向客户。每通要先看报价和异议再开口，不能系统自动连拨。要的闭环是：名单进任务 → 分到座席 → 工作台预览 → 点呼 → 结果回到商机。

产品在这条链上干什么

建预览任务 → 上传/导入任务名单 → 把联系人分配给座席
→ 座席登录后看到待呼列表 → 预览客户资料 → 手动发起每一通
→ 通话进入外呼记录 → 用预览外呼报表做汇总

要点：系统管名单和分配，不管自动连拨。每一通仍是座席（或工作台点击外呼）触发。

按产品用法走完第一周

第 1 天： 跟进组座席有外呼权限、分机或软电话可用、外显是企业已有号码。CRM 定好商机 ID、手机号、负责人座席工号。密钥按最小权限开通。

第 2 天： 在预览外呼里创建任务并导入约 10 条名单，回查条数不是 0；把联系人分配到测试座席；座席登录应看到待呼列表并能预览上下文；预览后手动发起一通内部号。这一通应在外呼记录里找到，不要去预测外呼记录里翻。

若 CRM 还有「不经过任务名单、点按钮直接呼」，走 发起外呼通话 / 工作台集成，不要和「导入预览任务」做成同一个接口。

第 3 天： 开通推送或 Webhook（至少接通、挂机）；商机 ID 幂等更新。空号 / 未接对照外呼记录或外呼失败日志，CRM 标「未接通待重拨」。

第 4 天： 名单加到 200，不要改成预测或 IVR。灰度只看：名单到人、预览有上下文、点呼稳、CRM 回写。

本故事 CLI 怎么用（可选联调）

预览任务的「建任务 + 分配联系人」请用管理端或管理类 OpenAPI。CLI 用来证明座席能上线、外呼链路能通、记录能查到：

# 1. 座席是否存在、是否在线（产品前提）
zenava callcenter agent query --cnos 1001
zenava callcenter agent online-list

# 2. 不经过任务名单、先证明「一通预览外呼」链路（座席须已可外呼）
zenava callcenter agent preview-outcall \
  --cno 1001 \
  --tel 13800000000 \
  --request-unique-id opp-test-001 \
  --ob-clid 02112345678
# 打错：preview-outcall-cancel --cno 1001

# 3. 对账：外呼记录，不是预测话单
zenava callcenter cdr ob-query --cno 1001 --customer-number 13800000000

--request-unique-id 建议等于商机 / 测试单号，方便事件和话单对齐。

断点

细项见 预览外呼任务。

故事二：催收要人效——预测外呼任务怎么用

业务要什么

30 个催收座席要系统按名单批量拨，客户接通后马上有人说话；又怕接通无人理。指标看利用率，也看骚扰。

产品在这条链上干什么

（可选）任务模板 → 任务管理创建/配置
→ 配拨打时间、座席侧/客户侧、超呼等 → 导入号码（可多批次）
→ 启动 → 预热 → 算法调节每轮呼叫量
→ 先呼客户；接通后直连座席，或 AI 转人工
→ 任务监控；单通进预测外呼记录

并发与节奏以任务参数 + 全局配置 + 算法为准；对接方不要在 CRM 里再写一套并发器。接通后路径事先选好：直连座席 或 AI 转人工。骚扰相关状态升高时减超呼或补就绪。

按产品用法走完第一周

第 1 天： 确认班务、就绪、外呼组 / 工号、外显与拨打时段。新建预测任务时超呼先保守；需要复用则用任务模板。确认全局配置未把任务拦住。

第 2 天： 导入几十条测试号并启动。先等预热，再盯任务监控：有拨打、客户接通后座席很快进入通话。抽一通在预测外呼记录里找到并回写催记。

第 3 天： 主路径事件进 CRM；未知事件按 系统兼容性 处理。有效通话、骚扰率跟预测任务 / 报表，不和话单「通话时长」混用。

第 4 天： 先扩名单，超呼不动；观察一天再调超呼。暂停 / 结束在任务管理做。

本故事 CLI 怎么用（可选联调）

预测外呼的完整生命周期都在 task（--type 1）里，适合「管理端点一遍」之外，用同一套步骤脚本化核实：

# 建任务（参数按企业补全；超呼 --predict-adjust；1=直连座席）
zenava callcenter task create \
  --type 1 \
  --name "催收预测-联调" \
  --call-route-strategy 1 \
  --predict-adjust 100 \
  --cnos 1001,1002,1003

# 写后必回查
zenava callcenter task query --type 1 --name 催收预测
zenava callcenter task get --task-id <任务Id>

# 导名单（CSV 必有 tel；业务主键可放 property）→ 启动 → 监控
zenava callcenter task import-tel \
  --task-id <任务Id> --name "batch-test-01" --file ./tels-test.csv --is-repeat 1
zenava callcenter task list-tel --task-id <任务Id> --return-count 1
zenava callcenter task start --task-id <任务Id>
zenava callcenter task monitor --task-id <任务Id> --type 1
zenava callcenter task monitor-tasks --type 1 --status 1

# 话单对账
zenava callcenter cdr predictive-call-query --task-id <任务Id>

# 暂停 / 结束
zenava callcenter task pause --task-id <任务Id>
zenava callcenter task stop --task-id <任务Id>

说明：task monitor 的 --type 是「当日统计 / 任务汇总」，和任务种类的 --type 1|2 不是同一个字段。

断点

细项见 预测外呼任务；失败见 外呼失败日志。

故事三：账单到期提醒——IVR / 自动外呼任务怎么用

业务要什么

数万用户到期提醒：能自助的在语音里解决，要人工再转。要「导入 → 自动拨 → 回写用户状态」。

产品在这条链上干什么

（可选）任务模板 → 创建任务并绑定语音导航
→ 配拨打时间、外呼速率/并发、外显、时间条件
→ 导入号码（可多批次）→ 启动
→ 按固定速率呼客户（不预先算座席空闲）
→ 接通进 IVR / 机器人，流程里可转人工
→ 任务监控；单通进自动外呼记录

旋钮是固定外呼速率 / 并发和导航绑定，不是超呼。必须先把 IVR 或外呼语音机器人配通并绑到任务，再灌名单。快速上手见 发起自动外呼任务。

按产品用法走完第一周

第 1 天： 导航 / 机器人定稿；新建 IVR / 自动外呼任务并绑对导航；速率偏保守。

第 2 天： 小名单启动。听感：听到预期导航 / 机器人；按键或意图后业务状态可变；转人工进对队列。对账走自动外呼记录。

第 3 天： 按应还日分批导入；CRM 以用户 ID 回写已触达 / 未接通 / 已转人工。

第 4 天： 先加名单量，再调速率；转人工队列被打满时降速率。停任务用暂停 / 结束，不要只停 CRM 推送。

本故事 CLI 怎么用（可选联调）

自动外呼 = task --type 2。CLI 适合在导航已通的前提下，把「建任务 → 导号 → 启动 → 查自动外呼话单」跑成可重复脚本：

zenava callcenter task create \
  --type 2 \
  --name "账单提醒-联调" \
  --ivr-name "<已通导航名称>"
# 或 --ivr-id <导航Id>

zenava callcenter task import-tel \
  --task-id <任务Id> --name "remind-test" --file ./remind-test.csv --is-repeat 1
zenava callcenter task start --task-id <任务Id>
zenava callcenter task monitor-tasks --type 2 --status 1
zenava callcenter cdr list-auto-task --task-id <任务Id>

CSV 的 property 带用户 ID。不要用 ob-query 找自动外呼主结果。

断点

任务形态见 IVR 外呼任务；机器人见 外呼语音机器人。

三个故事里同一套习惯

1. 先认准任务类型，再对接 CRM。
2. 产品顺序： 模板（可选）→ 任务 → 名单 → 启动 → 监控 → 记录；CRM 插在名单与回写上。
3. 要用 CLI 时： 先能 get / query / list-tel 再 start；写后必回查。
4. 记录别串页： 预览 ob-query；预测 predictive-call-query；自动 list-auto-task。
5. 放量拧产品旋钮： 预览加名单；预测先就绪再超呼；自动先速率与流程容量。

体系总览见 外呼任务管理。鉴权与管理集成见 鉴权认证、呼叫中心管理集成。事件见 Webhooks：事件回调、推送产品。

你像哪一个