## 快速阅读 Zenava CLI（以下简称“CLI”）是面向企业开放能力的命令行工具，覆盖范围不限于呼叫中心。它将开放接口封装为统一、可执行、可组合的命令，使实施人员、开发人员、运维人员和智能体能够更便捷地完成业务查询、资源管理、运行监控和自动化协同。 CLI 主要提供以下价值： - 统一接入企业开放能力。 - 简化鉴权、签名和接口请求处理。 - 支持单企业、多企业和多环境配置。 - 覆盖座席、话单、录音、监控、报表、外呼任务等呼叫中心核心对象。 - 在已开通对应能力的企业中，还可覆盖客户管理、工单和在线客服。 - 通过一级命令 `agent` / `aikb` 完成智能体编排与智能知识库管理（对外只安装 / 使用 Zenava CLI）。 - 提供结构化输出，便于脚本和智能体继续处理。 - 为写操作提供本地预检能力，降低操作风险。 - 提供版本更新检测，便于核对本机安装是否落后于制品库。具体命令、完整参数、必填项和默认值统一收录在本文附录 E“全部命令与参数”。 ## 阅读地图 | 阅读目标 | 建议章节 | | ----------- | --------------- | | 了解产品定位与价值 | 二、产品总览 | | 了解产品运行链路 | 四、对象关系与运行链路 | | 了解产品覆盖哪些能力 | 五、能力地图；六、产品功能说明 | | 完成安装与企业接入 | 六、6.8～6.10 | | 了解典型使用方式 | 七、典型业务场景 | | 了解上线准备与运营建议 | 八、上线准备与运营建议 | | 查找全部命令和参数 | 本文附录 E“全部命令与参数” | ## 一、文档说明 ### 1.1 文档目的本文从产品视角说明 CLI 是什么、解决什么问题、覆盖哪些能力、适合哪些场景，以及如何与呼叫中心管理端、OpenAPI、脚本和智能体协同。 ### 1.2 产品范围本文主要说明： - CLI 的安装、企业接入配置、多 Profile 管理和结构化输出。 - 呼叫中心能力入口 `callcenter` 下的企业、座席、话单、录音、导航、外呼任务、监控和报表等命令能力。 - 客户管理（`crm`）、工单（`ticket`）与在线客服（`livechat`）命令能力（以企业开通情况为准）。 - 智能体编排（`agent`）与智能知识库（`aikb`）一级命令：发现分类与模型、管理应用草稿与版本、查询运行数据与知识库对象。 - 人工联调、脚本自动化和智能体协同方式。 - 写操作的预检、确认、执行和结果回查要求。 - 上线准备、实施验收和常见问题处理。本文供售前、项目经理、实施顾问、开发人员、运维与支持人员以及智能体使用者协同使用。具体业务字段和统计口径应结合对应产品文档确认。实际可用范围由目标平台、企业开通能力和接口权限共同决定。 ### 1.3 版本依据本文以本机已验证的 `zenava 0.5.5` 命令契约为基准。附录 E 收录当前版本的全部命令、参数、必填项和默认值；实际执行时仍以当前安装版本的逐级帮助为准。 ## 二、产品总览 ### 2.1 产品定位 CLI 位于使用者与呼叫中心 OpenAPI 之间，将接口调用过程转化为统一的命令操作。 ```text 人工使用者 / 脚本 / 智能体 ↓ Zenava CLI ↓ 企业 OpenAPI ↓ 座席、话单、录音、任务、监控、报表客户、工单、在线客服（按企业开通能力）智能体编排 / 智能知识库（`agent` / `aikb`） ``` CLI 负责处理本地配置、请求签名、参数提交、结果输出和必要的安全处理，让使用者把重点放在业务对象和使用目标上。呼叫中心类命令统一挂在 `callcenter` 下；客户、工单和在线客服分别通过 `crm`、`ticket`、`livechat` 使用。智能体与知识库通过同一入口的 `agent`、`aikb` 使用。 ### 2.2 产品价值 | 价值方向 | 产品价值 | | ----- | ---------------------- | | 接入效率 | 将接口签名和请求封装为标准命令，减少重复开发 | | 实施联调 | 快速验证企业、座席、号码、任务和话单能力 | | 运行核实 | 查询实时状态、监控指标、通话记录和录音信息 | | 自动化 | 通过结构化输出衔接脚本、巡检和智能体分析 | | 多环境协同 | 通过具名配置管理不同企业和环境 | | 操作治理 | 通过预检、脱敏和日志支持受控操作与问题复盘 | ### 2.3 适用方式 - **人工查询**：在终端中查看业务对象和运行结果。 - **实施联调**：验证鉴权、参数和目标接口能力是否可用。 - **脚本自动化**：消费结构化结果并完成批量处理。 - **智能体调用**：由 Cursor 等智能体根据授权执行查询和分析。 - **问题核实**：结合话单、录音、状态和监控信息还原系统事实。 ## 三、核心概念 ### 3.1 接入环境 CLI 通过企业接入信息确定 OpenAPI 访问地址。使用时选择与企业实际环境一致的 Endpoint 和鉴权配置即可。 ### 3.2 鉴权配置鉴权配置用于标识企业、环境和访问凭证。CLI 自动完成请求签名，使用者无需在每次调用时重复实现签名逻辑。接入时按项目提供的凭证填写即可，常见为 **Token** 或 **AccessKey（AccessKeyId + AccessKeySecret）**。Profile 中 Token 非空时优先使用 Token；Token 为空且 AccessKey 完整时使用 AccessKey。具体字段组合见「六、6.9 企业接入配置」。 ### 3.3 Profile Profile 是具名配置，用于管理多个企业或多个环境。使用者可以在不改动业务命令的情况下切换目标配置。`--profile` 只影响当前这一次命令；`profile use` 才会改写本机默认的 currentProfile。 ### 3.4 业务对象 CLI 围绕呼叫中心及相关业务对象组织能力，包括： - 企业与号码资源。 - 座席、分机、技能和队列。 - 语音导航、呼入路由和 IVR 脚本。 - 通话、话单、录音和语音识别结果。 - 外呼任务、号码批次、任务模板和任务呼叫记录导出。 - 实时监控、统计与报表。 - 智能体会话、话后分析配置与配置模板，以及智能体应用、草稿、版本、运行数据与知识库对象。 - 推送目标接口与推送设置。 - 客户资料、企业客户与业务记录。 - 工单、表单、流转、审批与工单统计。 - 在线客服会话记录、座席工作日志和队列状态。 ### 3.5 全局选项 | 选项 | 作用 | 使用建议 | | ------------- | ------------------ | -------------------- | | `--profile` | 指定本次命令使用的具名配置 | 多企业或多环境场景使用 | | `--json` | 输出机器可读 JSON | 脚本和智能体调用时使用 | | `--verbose` | 输出请求链路相关日志 | 联调和排障时使用，不记录鉴权密钥和请求体 | | `--no-redact` | JSON 输出不再脱敏手机号 | 仅在受控环境、确有完整号码处理需求时使用 | | `--dry-run` | 对支持的写操作进行本地校验和请求预览 | 正式写入前优先使用 | | `--version` | 显示当前版本 | 联调和排障前先确认 | 全局选项应放在一级命令之前。自动化任务应优先使用 `--json`，并根据退出码和标准错误处理失败分支，不依赖人工展示文本。 ### 3.6 输出、脱敏与预检 CLI 支持面向人工阅读的摘要和面向程序处理的结构化结果。默认对敏感号码进行脱敏；只有在数据处理环境、人员权限和输出去向均受控时，才使用 `--no-redact`。对于支持预检的写操作，CLI 可以先完成本地参数校验和请求预览。预检不代表服务端已生效，正式执行后仍需查询目标对象确认结果。 ### 3.7 配置生效层次实施和验收时应区分： 1. **本地已安装**：CLI 能显示版本和帮助信息。 2. **接入信息已配置**：Endpoint 与企业实际环境一致。 3. **鉴权已通过**：企业身份、凭证和接口权限可完成基础查询。 4. **业务命令可用**：目标对象的数据范围与企业权限一致。 5. **写操作已生效**：正式执行后通过回查确认服务端状态已生效。命令正常结束不等于业务配置一定生效。涉及资源、任务、座席状态或呼叫动作时，应以服务端回查结果为准。 ## 四、对象关系与运行链路 ### 4.1 统一调用链路 ```text 确认当前 Profile、企业与接入环境 ↓ 读取访问地址和鉴权配置 ↓ CLI 生成签名并提交 OpenAPI 请求 ↓ 目标平台 OpenAPI 返回业务结果 ↓ CLI 完成摘要展示或 JSON 输出 ↓ 人工核验 / 脚本处理 / 智能体分析 ``` ### 4.2 写操作确认链路 ```text 确认企业、Profile、接入环境和操作对象 ↓ 检查业务授权与参数 ↓ 支持时先执行 --dry-run ↓ 展示操作对象和预计影响 ↓ 取得使用方明确确认后正式执行 ↓ 查询目标对象，确认服务端实际结果 ``` 自动化或智能体不得仅凭命令名称判断风险。凡涉及配置修改、资源变更、任务生命周期、座席状态或呼叫发起，均应先确认目标和影响。 ### 4.3 通话问题核实链路 ```text 按时间、号码、方向或业务标识查询话单 ↓ 确认通话标识、状态和关键时间点 ↓ 关联录音、ASR、机器人事件或任务信息 ↓ 必要时补充座席、队列和监控数据 ↓ 形成可回溯的问题结论 ``` ## 五、能力地图 ### 5.1 配置与环境管理 CLI 通过具名 Profile 管理企业接入信息、访问地址、鉴权信息和日志开关，适合单企业使用及多企业、多环境切换。具名配置保存在 `~/.zenava/profile.json`。创建或修改使用 `profile set`，切换使用 `profile use`，单次调用可用 `--profile`。 ### 5.2 座席与组织资源 CLI 支持： - 查询和管理座席资料。 - 查询座席实时状态和绑定电话。 - 执行座席上线、下线、置忙和置闲。 - 完成咨询、转移、三方和挂机等座席操作。 - 查询座席技能和在线座席。 - 管理分机。 - 查询技能与座席、队列之间的关系。 - 查询座席时长报表。 ### 5.3 企业与号码资源 CLI 支持： - 查询企业基础信息。 - 查询企业号码列表。 - 查询和维护企业配置。 - 上传企业语音文件。 - 查询当前企业可用的 TTS 音色列表。 - 查询号码池。 - 查询单个或批量号码归属地。 ### 5.4 通话、话单与录音 CLI 提供覆盖多种呼叫类型的记录查询能力，包括： - 呼入话单。 - 外呼话单。 - 内部外呼话单。 - WebCall 话单。 - SIP 话单。 - 预测外呼和自动外呼任务话单。 - 智能体相关话单。 - 满意度调查记录。在话单基础上，还可以继续获取录音信息、录音访问地址、ASR 结果（`asr get`，挂机后按录音）、RASR 事件（`rasr query`，通话中的机器人对话事件）和智能体对话文本（`intelligent-agent-rasr query`，按主话单 ID 查询）。智能体对话文本可以只看通话中已缓存的转写，也可以在缓存没有时再查归档。识别侧还可以维护热词（`asr-vocab`，保存后要再发布才进入识别）、纠错词（`asr-replacement`，保存后自动生效）和 ASR 上下文（`asr-context`）。话单自定义字段的定义用 `cdr-user-field` 维护；查询话单时仍用 `--user-field` 和 `--user-value` 按这些字段过滤。对于外呼任务话单，CLI 还支持异步导出任务呼叫记录、查询导出状态并获取下载地址，便于大批量结果取用。 ### 5.5 语音导航与路由 CLI 支持语音导航的查询、详情获取、导入、导出和管理，并可查询企业呼入路由设置，方便实施人员核实呼入流程和导航资源。脚本通过 `ivr-script` 维护。新建脚本不会自动产生已发布版本；暂存版本同时只保留一个，版本上限为 5。语音导航里实际运行的是已发布的生效版本。 ### 5.6 外呼任务 CLI 覆盖外呼任务的主要生命周期： - 创建和修改任务。 - 查询任务列表和任务详情。 - 启动、暂停和结束任务。 - 删除符合条件的任务。 - 导入、查询和删除任务号码。 - 查询号码批次和文件信息。 - 查询单任务监控和任务运行总览。 - 管理外呼任务模板。该能力适用于预测外呼、自动外呼及相关任务联调和运行核实。 ### 5.7 呼叫发起与业务缓存 CLI 可以发起 WebCall 和座席预览外呼，并支持管理呼叫前业务缓存，为 IVR、呼叫流程和业务系统协同提供数据入口。 ### 5.8 监控与报表 CLI 提供以下实时查询和统计能力： - 座席监控。 - 队列监控。 - 分机监控。 - 中继监控。 - 企业最新呼叫情况。 - 座席实时统计。 - 队列实时统计。 - 满意度实时统计。 - 外呼和号码相关报表。这些能力可用于日常巡检、运行核实和自动化监测。 ### 5.9 智能体与知识库在呼叫中心侧，CLI 支持查询机器人对话事件和智能体话单，并可管理智能体话后分析配置，包括信息捕获、意向标签、流程挂断点和话后助手等能力。话后分析配置模板（`agent-analysis-config-template`）可按信息捕获、意向标签或流程挂断点单独维护，再发布到已经有话后分析配置的智能体。同时，`zenava agent` 覆盖应用（含草稿、版本与密钥）、工具凭据、模型、分类、知识库数据集、运行数据（会话、消息、追踪）和 Schema；`zenava aikb` 覆盖知识库、目录、问答、文档、回收站、检索与附件。智能体与知识库写操作须显式确认（如 `--yes`）。命令与参数见本文附录 E。 ### 5.10 反馈与协同使用者可以通过 CLI 提交意见反馈，并根据需要附带本地运行日志（`~/.zenava/logs/zenava.log`），帮助维护人员结合命令、版本和链路信息定位问题。 ### 5.11 客户、工单与在线客服在已开通对应能力且接口已授权的企业中，CLI 还提供： - 客户资料的查询、创建、修改与删除。 - 企业客户和业务记录管理。 - 企微群客户相关查询。 - 客户自定义 Tab、字段同步、HTTP 数据推送和自定义字段。 - 工单的创建、修改、分配、流转、审批、催单和关闭。 - 工单字段、表单、子表单、模板和统计查询。 - 工单自定义字段和主表单模板的新增、修改与删除。 - 在线客服会话记录、消息、满意度、座席工作日志和队列状态。 - 在线客服统计报表（`livechat stat`）与网页渠道等渠道配置（`livechat setting`）。实际可用范围由企业开通能力和接口权限共同决定；未开通时，继续以 `callcenter` 下的呼叫中心能力为主。 ### 5.12 命令组织方式一级命令按能力域划分： | 一级命令 | 作用 | | ------------ | ------------------------- | | `callcenter` | 呼叫中心开放能力总入口 | | `profile` | 多企业 / 多环境具名配置 | | `crm` | 客户管理（按企业开通与接口权限） | | `ticket` | 工单（按企业开通与接口权限） | | `livechat` | 在线客服记录、报表、渠道配置与监控（按企业开通与接口权限） | | `agent` | 智能体应用（草稿、版本、密钥、工具、模型、数据集、运行数据） | | `aikb` | 智能知识库（目录、问答、文档、检索、附件） | | `feedback` | 意见反馈 | | `update` | 版本更新检测 | 呼叫中心相关的座席、话单、录音、导航、任务、监控等子命令，统一位于 `zenava callcenter ...` 之下。 ### 5.13 事件推送 CLI 可以维护推送目标接口（`push-target`）和推送设置（`push-action`）。目标接口是事件要发往的地址；推送设置决定哪一类事件、在什么条件下、以什么方式送出。推送设置可以引用已有目标接口，也可以直接填写地址，并可以挂上数据加工脚本。事件类型和参数取值见本文附录 E 中 `push-action` 的说明。 ## 六、产品功能说明 ### 6.1 统一的 OpenAPI 调用方式 CLI 将接入和鉴权过程封装在配置层。使用者选择目标 Profile 后，可以用一致的交互方式访问企业开放能力，降低接口接入和维护成本。 ### 6.2 多企业与多环境切换通过 Profile，可以为生产、测试或不同企业建立独立配置。调用时明确指定目标 Profile，避免频繁修改默认配置。 ### 6.3 从资源配置到运行查询 CLI 既能查询企业、号码、座席、分机和导航等基础资源，也能查询座席状态、队列监控、任务运行和通话记录，形成“资源—配置—运行—记录—统计”的完整使用链路。 ### 6.4 从通话事实到问题复盘对于通话类问题，可以从话单入手，通过通话标识继续关联录音、ASR、机器人事件、任务或满意度记录，为问题核实和客户答复提供证据。 ### 6.5 外呼任务全流程协同外呼任务能力覆盖任务创建、号码导入、运行控制、监控和话单查询。实施和运营人员可以在同一工具中完成任务配置核实与运行结果追踪。 ### 6.6 结构化数据与自动化 CLI 的结构化输出可以被 Shell、Python、流水线或智能体继续处理，适合构建： - 企业资源巡检。 - 座席和队列状态检查。 - 话单批量核实。 - 外呼任务运行监测。 - 录音和转写结果整理。 - 问题证据采集。 ### 6.7 受控写入涉及配置修改、资源变更、任务生命周期或呼叫发起时，可以先使用预检能力核对目标对象和请求摘要，再执行正式操作并回查结果。 ### 6.8 运行环境与安装 Windows、macOS、Linux 均可使用，不按操作系统分套环境要求。只要本机 Python ≥ 3.12，且能够访问企业提供的 Endpoint 即可。配置目录位于当前用户主目录下的 `.zenava`（Windows 一般为 `%USERPROFILE%\.zenava`）。使用前确认本机满足： - Python **≥ 3.12**。 - 能够访问项目提供的 OpenAPI 地址（Endpoint）。 - 已安装 `pip`；受限环境也可使用 `pipx`。推荐安装方式： ```bash pip install zenava zenava --version ``` 需要固定版本时： ```bash pip install 'zenava==0.5.5' ``` 使用 pipx 时： ```bash pipx install zenava ``` 对外只安装 Zenava CLI。智能体与知识库通过 `zenava agent` / `zenava aikb` 使用，不要再单独安装或调用原 Tinet Agent CLI（`taco`）。确认版本后，用逐级帮助核对命令契约。可用 `zenava update check` 检测本机是否落后于制品库。检查结果中若出现依赖包版本提示，仅表示依赖检查，不代表需要单独安装原 Tinet Agent CLI。生产环境应固定版本，变更前先在测试企业验证。 ### 6.9 企业接入配置配置保存在 `~/.zenava/profile.json`。创建或修改使用 `profile set`，切换默认使用 `profile use`，单次调用可用 `--profile`。配置时至少确认： | 配置项 | 作用 | 配置条件与注意事项 | | --- | --- | --- | | Endpoint | 指定 OpenAPI 访问地址 | 填写项目提供的地址，必须与企业实际环境一致 | | 企业接入类型 | 按项目提供的接入配置填写 | 决定可用参数组合；按项目交付信息填写，不必自行对照内部产品线 | | 企业或部门标识 | 确定鉴权主体 | Token 鉴权时按项目要求填写；AccessKey 鉴权时是否填写以项目要求为准 | | Token | Token 鉴权凭证 | Token 非空时优先使用 | | AccessKey | AccessKeyId + AccessKeySecret | Token 为空且二者均非空时使用；`--expires` 缺省 60 秒，范围 1～86400 | | Profile 名称 | 本机唯一标识一组配置 | 须满足 `^[a-z][a-z0-9-]{0,63}$` | | Profile | 保存一组完整配置 | 多企业和多环境分别建立 | 凭证选用顺序： 1. Profile 中 Token 非空 → 使用 Token 鉴权，并按项目要求配置 `validate-type`（1 部门编号 / 2 企业编号）以及对应的企业编号或部门编号。 2. Token 为空，且 AccessKeyId 与 AccessKeySecret 均非空 → 使用 AccessKey 鉴权；企业/部门编号是否填写以项目要求为准。 Token 示例（字段按项目交付填写）： ```bash zenava profile set --name prod \ --platform-type <按项目填写> \ --endpoint <项目提供的开放接口地址> \ --validate-type 2 \ --enterprise-id <企业编号> \ --token zenava profile use prod ``` AccessKey 示例： ```bash zenava profile set --name prod-ak \ --platform-type <按项目填写> \ --endpoint <项目提供的开放接口地址> \ --access-key-id \ --access-key-secret \ --expires 60 zenava profile use prod-ak ``` 凭证按敏感信息管理，不要写入文档、脚本仓库或聊天记录。 ### 6.10 多 Profile 切换执行任务前先 `profile list` 确认目标配置。 - `profile use `：改写本机默认的 currentProfile，影响后续未显式指定 `--profile` 的命令。 - `--profile `：只作用于当前这一次命令，不改写 currentProfile。 - 不可删除当前正在使用的 currentProfile；先切换到其他 Profile，再删除不再使用的配置。 - 不同企业的自动化任务应固定传入 `--profile`，避免误用默认配置。 ### 6.11 从只读查询开始首次接入建议从企业信息、座席列表等低风险查询开始，确认接入地址、鉴权、网络和接口权限正常后，再验证话单、任务、监控和写操作。 ### 6.12 结构化输出与脱敏脚本或智能体使用 `--json` 获取结构化结果。默认保留手机号脱敏；需要完整号码时，应先确认数据使用权限、处理环境和输出去向，再使用 `--no-redact`。 ### 6.13 写操作确认口径正式执行前至少展示： | 信息 | 确认内容 | | ----------- | ------------------------ | | 企业与 Profile | 当前命令实际作用的企业配置 | | 接入环境 | Endpoint 与企业环境 | | 操作类型 | 配置修改、资源变更、任务控制、座席操作或呼叫发起 | | 操作对象 | 对象名称、编号、任务 ID、座席号等 | | 影响说明 | 将新增、覆盖、删除、变更状态或发起真实呼叫 | 支持预检时先执行 `--dry-run`。取得使用方明确确认后再正式执行，并通过查询命令回查服务端结果。 ## 七、典型业务场景 ### 7.1 开放接口快速联调实施或开发人员完成企业配置后，先查询企业基础信息，再逐步验证座席、号码、话单和任务能力，快速确认鉴权、网络和接口权限。 ### 7.2 多企业日常巡检为不同企业建立独立 Profile，通过统一查询流程获取企业、座席、队列和任务状态，再将结构化结果汇总为巡检结论。 ### 7.3 话单与录音核实根据时间、呼叫方向或业务标识查询话单，确认通话标识后继续获取录音、ASR 或机器人事件，实现通信事实与业务记录的关联核实。 ### 7.4 外呼任务联调围绕任务配置、号码批次、任务状态、运行监控和任务话单逐步验证外呼链路，确认任务从创建到结果沉淀的完整过程。 ### 7.5 座席状态与操作验证先查询座席资料、技能、电话和实时状态，再根据授权完成上线、置忙、置闲或下线，并回查状态确认操作结果。 ### 7.6 智能体辅助分析 Cursor 等智能体可以在明确授权下调用 CLI 获取结构化数据，并结合话单、录音、任务和监控信息形成分析结论。 ### 7.7 客户、工单与在线客服联调在已开通对应能力的企业完成鉴权后，可先查询客户、工单或在线客服会话列表验证权限，再按业务需要验证创建、流转、审批、统计或会话核实能力。呼叫中心与上述能力可按同一 Profile 切换使用。 ### 7.8 智能体编排与知识库在同一 CLI 入口完成智能体或知识库操作： ```bash zenava agent category list zenava agent app list zenava --json agent schema list zenava aikb repository list-private ``` 写操作（创建、发布、写凭据、知识库写入等）须显式确认；支持时先 `--dry-run`。企业配置优先使用 `zenava profile`（AccessKey）；`--profile` 仅作用于本次命令。 ## 八、上线准备与运营建议 ### 8.1 上线准备 - 确认本机 Python ≥ 3.12，且 CLI 版本满足约定（可用 `zenava --version` / `zenava update check`）。 - 确认 Endpoint、鉴权配置和企业环境与项目交付一致。 - 准备已授权的 OpenAPI 凭证（Token 或 AccessKey）。 - 确认本机能够访问目标 Endpoint。 - 建立符合命名规则的 Profile，并确认 currentProfile。 - 明确只读查询、配置管理和呼叫操作的执行权限。 ### 8.2 验收建议建议依次验证： 1. CLI 可以正常启动并显示版本。 2. 企业配置可以被正确识别。 3. 企业基础查询能够正常返回。 4. 核心业务对象查询符合企业数据范围。 5. 结构化结果可以被脚本正确处理。 6. 写操作可以完成预检、正式执行和结果回查。 7. 多 Profile 切换符合预期。 ### 8.3 运营建议 - 生产环境固定 CLI 版本，版本变更前先在测试环境验证。 - 不同企业和环境使用独立 Profile。 - 自动化任务记录版本、目标 Profile 和执行时间。 - 重要写操作保留人工确认和结果回查。 - 定期检查本地配置、日志和不再使用的 Profile。 - 具体命令行为以当前版本帮助和本文参数附录为准。 ## 九、与周边能力的关系 | 周边能力 | 与 CLI 的关系 | | --------------- | --------------------------------------------------------------------------- | | 呼叫中心管理端 | 管理端适合可视化配置和日常运营，CLI 适合联调、批量查询和自动化 | | OpenAPI | OpenAPI 定义开放能力，CLI 提供统一调用入口 | | 话单与报表 | CLI 提供查询方式，具体字段和统计口径以对应产品文档为准 | | 自动化脚本 | 可消费结构化结果并形成巡检、核实或任务编排 | | 智能体控制台 | 控制台适合可视化配置；`zenava agent` / `aikb` 适合应用草稿与版本管理、联调与自动化 | | Cursor 等智能体 | 按当前命令契约调用本机 `zenava`，写操作须二次确认 | | 本文参数附录 | 统一承载全部命令、参数、必填项和默认值 | ## 十、FAQ ### 10.1 CLI 适合哪些使用者？适合需要进行开放接口联调、批量查询、运行核实、脚本自动化或智能体调用的实施、开发、运维和支持人员。 ### 10.2 CLI 是否只能查询数据？不是。CLI 同时提供查询、配置管理、资源维护、任务生命周期和呼叫操作等能力。实际使用应结合企业权限和业务授权。 ### 10.3 如何管理多个企业或环境？可以为每个企业或环境创建独立 Profile。日常切换用 `profile use`；脚本和自动化优先用 `--profile`，只影响当前这一次命令。不可删除当前正在使用的 Profile，需先切换再删除。 ### 10.4 CLI 能否用于自动化？可以。CLI 提供结构化结果，适合接入脚本、流水线、巡检任务和智能体。自动化接入应固定版本并针对目标命令验证返回结构。 ### 10.5 如何降低写操作风险？先确认目标企业和业务对象；支持预检时先进行预检；正式执行后再查询目标对象，确认服务端实际结果。 ### 10.6 CLI 是否替代管理端？ CLI 与管理端是互补关系。管理端适合可视化运营和复杂配置，CLI 适合开放接口联调、自动化、批量查询和问题核实。 ### 10.7 在哪里查看全部命令？全部命令、参数、必填项、默认值和帮助信息见本文附录 E“全部命令与参数”。 ### 10.8 为什么很多命令前面要加 `callcenter`？ Zenava CLI 将呼叫中心能力统一归入 `callcenter` 一级命令。例如查询企业信息使用 `zenava callcenter enterprise get`，而不是把企业命令直接挂在根命令下。 ### 10.9 `crm`、`ticket` 和 `livechat` 什么时候可用？这些能力的实际可用范围由企业开通情况和接口权限决定。已开通时，可按业务需要查询客户、工单或在线客服会话，并使用在线客服统计报表与渠道配置等命令；未开通时，请优先使用 `callcenter` 下的呼叫中心能力。 ### 10.10 智能体和知识库命令怎么用？统一使用 `zenava agent` / `zenava aikb`。呼叫中心话单、座席、任务等 OpenAPI 能力继续走 `callcenter` 等命令。原独立的 Tinet Agent CLI（`taco`）不再对外单独安装或单独成文。 ### 10.11 安装时如何使用国内 PyPI 镜像做版本检测？ `zenava update check` 默认请求官方制品索引。若需国内镜像，可手改 `~/.zenava/profile.json` 根级字段 `pypiJsonUrl`（CLI 不提供 set/show/clear）。该字段仅影响版本检测，不改变业务命令行为。 ## 十一、总结 Zenava CLI 将企业开放接口转化为统一、可执行和可自动化的工具能力，覆盖企业资源、座席、话单、录音、导航、脚本、事件推送、外呼任务、监控、报表、智能体话后分析，以及客户、工单、在线客服等核心业务对象，并提供智能体编排与知识库入口。通过统一配置、多 Profile、结构化输出和操作预检，CLI 可以同时服务于实施联调、开发接入、运行巡检、问题核实和智能体分析。 ## 附录 A：能力对象速查 | 能力领域 | 主要对象 | | ---- | ---------------------------- | | 配置管理 | Profile、日志开关、版本检测 | | 企业资源 | 企业、号码、号码池、企业配置、语音文件、TTS 音色 | | 座席资源 | 座席、分机、技能、队列、绑定电话 | | 通话记录 | 呼入、外呼、WebCall、SIP、预测外呼、智能体话单 | | 通话附件 | 录音、ASR、机器人事件、满意度 | | 路由导航 | 语音导航、呼入路由、IVR 脚本 | | 外呼任务 | 任务、模板、号码、批次、任务监控 | | 实时监控 | 座席、队列、分机、中继、企业呼叫 | | 智能体 | 智能体话单、话后分析配置、配置模板、应用草稿 / 版本 / 运行数据 | | 事件推送 | 推送目标接口、推送设置 | | 知识库 | 知识库、目录、问答、文档、检索问答 | | 客户管理 | 客户资料、企业客户、业务记录、企微群客户、自定义 Tab、字段同步、数据推送、自定义字段 | | 工单 | 工单、表单、自定义字段、主表单模板、流转、审批、统计 | | 在线客服 | 会话记录、消息、满意度、座席工作日志、队列状态 | ## 附录 B：实施检查清单 - [ ] 已确认本机 Python ≥ 3.12，且 CLI 版本符合约定。 - [ ] 已确认 Endpoint、鉴权配置和企业环境。 - [ ] 已准备有效的 OpenAPI 凭证（Token 或 AccessKey）。 - [ ] 已完成 Profile，并确认当前选用配置。 - [ ] 已验证企业基础查询。 - [ ] 已验证核心业务对象的数据范围。 - [ ] 已验证结构化结果处理方式。 - [ ] 写操作已完成授权确认、预检和结果回查。 - [ ] 自动化任务已固定版本和目标 Profile。 ## 附录 C：术语表 | 术语 | 说明 | | ---------- | ---------------------------- | | CLI | Command Line Interface，命令行工具 | | OpenAPI | 面向外部系统提供的标准开放接口 | | Endpoint | 企业 OpenAPI 访问地址 | | Profile | 保存企业、环境和鉴权信息的具名配置 | | Token | Token 鉴权凭证；Profile 中非空时优先使用 | | AccessKey | AccessKeyId + AccessKeySecret 鉴权凭证 | | Dry Run | 对支持的写操作进行本地校验和请求预览 | | CDR | 通话详单或通话记录 | | ASR | 自动语音识别结果 | | RASR | 机器人对话事件记录 | | WebCall | 由开放接口发起的呼叫方式 | | Zenava | 面向企业 OpenAPI 的命令行工具 | | callcenter | Zenava 中呼叫中心能力的一级命令入口 | | livechat | Zenava 中在线客服能力的一级命令入口 | | agent / aikb | 智能体编排与智能知识库一级命令入口 | | draft / version / secret | 智能体应用的草稿、版本与密钥；命令字面保留 | | dataset | 智能体侧知识库数据集 | | Schema | 智能体资源结构说明，不译 | ## 附录 D：文档导航 - 产品定位、能力、场景和使用流程：本文。 - 全部命令、参数、必填项和默认值（含 `agent` / `aikb`）：本文附录 E“全部命令与参数”。 - 当前版本帮助：通过 CLI 的逐级帮助查看。 ## 附录 E：全部命令与参数 > 以下内容基于 `zenava 0.5.5` 的实际命令树生成，
共 465 个命令节点、360 个可执行命令和 2602 个参数定义。
`zenava agent` / `zenava aikb` 为平台 CLI 一级能力。
参数是否必填、默认值和可选值以当前安装版本的帮助信息为准。 ### E.1 全局命令 #### E.1 `zenava` Zenava CLI **子命令：** `agent`、`aikb`、`callcenter`、`crm`、`feedback`、`livechat`、`profile`、`ticket`、`update` | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | --version | boolean | 否 | false | 显示版本号并退出 | | --json | boolean | 否 | false | JSON 输出 | | --verbose | boolean | 否 | false | 详细日志（URL + traceparent + baggage + trace_id，不含 token/sign/body） | | --no-redact | boolean | 否 | false | JSON 模式下不脱敏手机号 | | --dry-run | boolean | 否 | false | 仅本地校验与预览，不发送写请求、不写本地配置 | | --profile | text | 否 | — | 可选；指定本次调用使用的 profile（不改写 currentProfile；不传则用 currentProfile） | ##### E.1.1 `zenava agent` 智能体平台领域根命令。资源边界：管理应用、工具、模型、分类、知识库、运行数据和 Draft Schema **子命令：** `app`、`tool`、`model`、`category`、`dataset`、`data`、`schema` 本级命令无专属参数。 ###### E.1.1.1 `zenava agent app` 统一管理 Agent、Chat、Chatflow、Workflow 应用。资源边界：负责元数据、创建、标签和模板；Draft、版本和 Secret 是其子资源 **子命令：** `list`、`get`、`create`、`draft`、`secret`、`version`、`template`、`tag` 本级命令无专属参数。 ###### E.1.1.1.1 `zenava agent app list` 分页列出应用并按名称、分类或标签过滤。适用应用类型：agent、chat、chatflow、workflow。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：items、page、limit、total。常见稳定错误：APP_LIST_FAILED。建议前后命令：zenava agent app get ；zenava agent category list | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | --page | integer | 否 | 1 | 页码 | | --limit | integer | 否 | 20 | 每页数量，范围 1 到 100 | | --name | text | 否 | — | 按应用名称过滤 | | --category | text | 否 | — | 按业务分类 code 过滤，可重复 | | --tag-id | text | 否 | — | 按标签 ID 过滤，可重复；多个标签按任一匹配 | ###### E.1.1.1.2 `zenava agent app get` 按应用 ID 获取详情。适用应用类型：agent、chat、chatflow、workflow。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：id、name、type、mode、status 等稳定身份字段。常见稳定错误：APP_NOT_FOUND。建议前后命令：zenava agent app draft get | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | 应用 ID | ###### E.1.1.1.3 `zenava agent app create` 创建 Agent、Chat、Chatflow 或 Workflow 应用。create 本身表达远端创建，无需确认开关。适用应用类型：agent、chat、chatflow、workflow。互斥关系：workflow 禁止 --category；其他类型必须提供 --category。标准输入示例：不适用。远端副作用：在远端创建空应用，不写入 Draft 配置。关键输出字段：id、name、type。常见稳定错误：APP_TYPE_INVALID、APP_CATEGORY_REQUIRED、APP_CATEGORY_UNSUPPORTED。建议前后命令：zenava agent schema get ；zenava agent app draft get | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | --type | text | 是 | — | 应用类型：agent、chat、chatflow 或 workflow | | --name | text | 是 | — | 应用名称 | | --category | text | 否 | — | 业务分类叶子 code；非 workflow 必填，workflow 禁止 | | --description | text | 否 | "" | 应用描述 | ###### E.1.1.1.4 `zenava agent app draft` 读取或修改远端 Draft。资源边界：远端 Draft 是唯一编辑态 **子命令：** `get`、`update`、`patch`、`run`、`stop`、`publish` 本级命令无专属参数。 ###### E.1.1.1.4.1 `zenava agent app draft get` 读取远端 Draft；Agent/Chat 在草稿缺失时可能由服务端初始化。适用应用类型：agent、chat、chatflow、workflow。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读查询；Agent/Chat 可能由服务端初始化缺失草稿。关键输出字段：exists、hash、type、config 或所选字段。常见稳定错误：APP_NOT_FOUND。建议前后命令：zenava agent app draft update/patch；或 zenava agent schema get | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | 应用 ID | | --field-path | text | 否 | — | JSON Pointer（JSON 指针）配置路径，可重复提供 | ###### E.1.1.1.4.2 `zenava agent app draft update` 从标准输入读取完整 JSON 配置并修改远端 Draft。已有草稿使用 --expected-hash，首次创建使用 --create；--yes 仅确认风险，不启动交互。写入前执行结构和上下文校验。适用应用类型：agent、chat、chatflow、workflow。互斥关系：--expected-hash 与 --create 互斥，必须且只能提供一个。标准输入示例：echo '{}' | zenava agent app draft update --from-stdin --expected-hash --yes 远端副作用：修改远端 Draft，要求 --yes。Workflow/Chatflow 的 hash 校验不是严格原子，并发写入可能互相覆盖。关键输出字段：exists、hash、type、config、warnings。常见稳定错误：APP_DRAFT_CONFLICT、APP_DRAFT_VALIDATION_FAILED、APP_DRAFT_UPDATE_CONFIRM_REQUIRED。建议前后命令：先 zenava agent app draft get；成功后 zenava agent app draft run 或 publish | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | 应用 ID | | --from-stdin | boolean | 否 | false | 从标准输入（stdin）读取完整 Draft JSON 对象，必须提供 | | --expected-hash | text | 否 | — | 已有 Draft 的预期版本标识（hash），与 --create 互斥 | | --create | boolean | 否 | false | 确认首次创建不存在的 Draft，与 --expected-hash 互斥 | | --yes | boolean | 否 | false | 确认修改远端 Draft；不会启动交互式确认 | ###### E.1.1.1.4.3 `zenava agent app draft patch` 从标准输入读取 JSON Patch 数组并修改远端 Draft。必须提供预期版本 hash；--yes 仅确认风险，不启动交互。适用应用类型：agent、chat、chatflow、workflow。互斥关系：必须同时提供 --from-stdin 与 --expected-hash。标准输入示例：echo '[{op,path,value}]' | zenava agent app draft patch --from-stdin --expected-hash --yes 远端副作用：修改远端 Draft，要求 --yes。关键输出字段：exists、hash、type、config、warnings。常见稳定错误：APP_DRAFT_CONFLICT、APP_DRAFT_PATCH_CONFIRM_REQUIRED。建议前后命令：先 zenava agent app draft get；成功后 zenava agent app draft run | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | 应用 ID | | --from-stdin | boolean | 否 | false | 从标准输入读取 JSON Patch 数组，必须提供 | | --expected-hash | text | 否 | — | 已有 Draft 的预期版本标识（hash），必须提供 | | --yes | boolean | 否 | false | 确认修改远端 Draft；不会启动交互式确认 | ###### E.1.1.1.4.4 `zenava agent app draft run` 从标准输入读取完整 JSON 调试请求并运行远端 Draft。--yes 仅确认风险，不启动交互。输出为以 result 或 error 结束的 NDJSON。运行的是服务端当前 Draft，不绑定此前读取的版本。适用应用类型：agent、chat、chatflow、workflow。互斥关系：不适用。标准输入示例：echo '{"query":"..."}' | zenava agent app draft run --from-stdin --yes 远端副作用：可能调用模型、工具或外部系统，要求 --yes；影响线上取决于调试环境。关键输出字段：NDJSON 事件，最后一行为 result 或 error。常见稳定错误：APP_DRAFT_RUN_CONFIRM_REQUIRED、APP_DRAFT_RUN_FAILED。建议前后命令：zenava agent app draft stop

；随后 publish | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | 应用 ID | | --from-stdin | boolean | 否 | false | 从标准输入（stdin）读取完整调试请求 JSON 对象，必须提供 | | --yes | boolean | 否 | false | 确认调试可能产生真实外部副作用；不会启动交互式确认 | ###### E.1.1.1.4.5 `zenava agent app draft stop` 停止指定的远端 Draft 调试任务。适用应用类型：agent、chat、chatflow、workflow。互斥关系：不适用。标准输入示例：不适用。远端副作用：仅停止任务，不修改或发布 Draft，无需确认开关。关键输出字段：app_id、task_id、stopped。常见稳定错误：APP_DRAFT_STOP_FAILED。建议前后命令：zenava agent app draft run | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | 应用 ID | | task_id | text | 是 | — | 流式调试事件返回的任务 ID | ###### E.1.1.1.4.6 `zenava agent app draft publish` 校验并发布服务端处理请求时的最新 Draft，无法锁定此前读取的特定版本。适用应用类型：agent、chat、chatflow、workflow。互斥关系：Agent/Chat 不支持 --title 和 --notes。标准输入示例：不适用。远端副作用：改变正式版本并影响线上调用，要求 --yes。关键输出字段：发布结果稳定字段。常见稳定错误：APP_DRAFT_PUBLISH_CONFIRM_REQUIRED、APP_DRAFT_VALIDATION_FAILED。建议前后命令：zenava agent app version list | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | 应用 ID | | --title | text | 否 | — | Workflow/Chatflow 版本标题；Agent/Chat 不支持 | | --notes | text | 否 | — | Workflow/Chatflow 版本备注；Agent/Chat 不支持 | | --yes | boolean | 否 | false | 确认发布会改变正式版本并影响线上调用；不会交互确认 | ###### E.1.1.1.5 `zenava agent app secret` 安全列出或设置 Workflow/Chatflow Draft 环境变量 Secret。资源边界：仅 Workflow/Chatflow；不输出 Secret 值；不提供删除 **子命令：** `list`、`set` 本级命令无专属参数。 ###### E.1.1.1.5.1 `zenava agent app secret list` 列出 Workflow/Chatflow Draft Secret 的名称、类型和配置状态；不输出值或内部 ID。适用应用类型：chatflow、workflow。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：items（name、type、configured）。常见稳定错误：APP_SECRET_UNSUPPORTED。建议前后命令：zenava agent app secret set --from-env --yes | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | Workflow 或 Chatflow 应用 ID | ###### E.1.1.1.5.2 `zenava agent app secret set` 创建或更新一个 Workflow/Chatflow Draft Secret。推荐使用 --from-env；--value 可能进入 Shell 历史和进程列表。只更新 Draft，不调试或发布。适用应用类型：chatflow、workflow。互斥关系：--from-env 与 --value 互斥，必须提供其一。标准输入示例：不适用。远端副作用：修改远端 Draft Secret，要求 --yes；不输出 Secret 值。关键输出字段：name、configured。常见稳定错误：APP_SECRET_SET_CONFIRM_REQUIRED、APP_SECRET_UNSUPPORTED。建议前后命令：zenava agent app secret list | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | Workflow 或 Chatflow 应用 ID | | name | text | 是 | — | Secret 名称，最长 30 位 | | --from-env | text | 否 | — | 推荐：从指定环境变量读取 Secret，避免出现在命令参数中 | | --value | text | 否 | — | 直接传入 Secret；警告：可能进入 Shell 历史和进程列表 | | --yes | boolean | 否 | false | 确认修改远端 Draft；不会启动交互式确认 | ###### E.1.1.1.6 `zenava agent app version` 查询不可变历史版本或将其恢复为远端 Draft。资源边界：历史版本只读；restore 会整体替换当前 Draft，不发布 **子命令：** `list`、`get`、`restore` 本级命令无专属参数。 ###### E.1.1.1.6.1 `zenava agent app version list` 分页列出应用历史版本的稳定元数据。适用应用类型：agent、chat、chatflow、workflow。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：items、page、limit、has_more。常见稳定错误：APP_NOT_FOUND。建议前后命令：zenava agent app version get

| 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | 应用 ID | | --page | integer | 否 | 1 | 页码 | | --limit | integer | 否 | 20 | 每页数量，范围 1 到 100 | ###### E.1.1.1.6.2 `zenava agent app version get` 分页遍历历史列表并读取指定版本的完整不可变配置快照。适用应用类型：agent、chat、chatflow、workflow。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：version_id 与完整配置快照。常见稳定错误：APP_VERSION_NOT_FOUND。建议前后命令：zenava agent app version restore

--yes | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | 应用 ID | | version_id | text | 是 | — | 历史版本 ID | ###### E.1.1.1.6.3 `zenava agent app version restore` 将历史版本整体恢复为远端 Draft。恢复不调试、不发布。适用应用类型：agent、chat、chatflow、workflow。互斥关系：不适用。标准输入示例：不适用。远端副作用：修改远端 Draft（整体替换），要求 --yes。关键输出字段：恢复后的 Draft hash 与类型。常见稳定错误：APP_VERSION_RESTORE_CONFIRM_REQUIRED、APP_VERSION_NOT_FOUND。建议前后命令：zenava agent app draft get | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | 应用 ID | | version_id | text | 是 | — | 要恢复的历史版本 ID | | --yes | boolean | 否 | false | 确认整体替换当前远端 Draft；不会启动交互式确认 | ###### E.1.1.1.7 `zenava agent app template` 发现应用模板并从模板创建远端应用。资源边界：创建结果是远端应用 **子命令：** `list`、`get`、`create` 本级命令无专属参数。 ###### E.1.1.1.7.1 `zenava agent app template list` 列出当前企业可用的应用模板。适用应用类型：由模板自身类型决定。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：items（模板 ID、名称、类型）。常见稳定错误：APP_TEMPLATE_LIST_FAILED。建议前后命令：zenava agent app template get | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | --language | text | 否 | — | 模板语言；不传时使用账号或平台默认语言 | ###### E.1.1.1.7.2 `zenava agent app template get` 获取应用模板的稳定元数据。适用应用类型：由模板自身类型决定。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：id、name、description、type。常见稳定错误：APP_TEMPLATE_NOT_FOUND。建议前后命令：zenava agent app template create | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | template_id | text | 是 | — | 模板 ID，取自 template list 的 id | ###### E.1.1.1.7.3 `zenava agent app template create` 从应用模板创建远端应用。create 本身表达远端创建，无需确认开关。适用应用类型：由模板类型决定。互斥关系：不适用。标准输入示例：不适用。远端副作用：在远端创建应用，可能复制模板配置。关键输出字段：id、name、type。常见稳定错误：APP_TEMPLATE_NOT_FOUND。建议前后命令：zenava agent app draft get | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | template_app_id | text | 是 | — | 模板 ID，取自 template list 的 id，与 template get 使用同一个值 | | --name | text | 否 | — | 覆盖模板名称；不传时沿用模板原名称 | ###### E.1.1.1.8 `zenava agent app tag` 发现应用标签。资源边界：只读标签列表，不创建或删除标签 **子命令：** `list` 本级命令无专属参数。 ###### E.1.1.1.8.1 `zenava agent app tag list` 列出应用标签并可按名称关键词过滤。适用应用类型：全部应用类型。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：items（标签 ID 与名称）。常见稳定错误：APP_TAG_LIST_FAILED。建议前后命令：zenava agent app list --tag-id | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | --keyword | text | 否 | — | 按标签名称关键词过滤 | ###### E.1.1.2 `zenava agent tool` 统一发现内置／插件工具与 Workflow Tool。资源边界：平台级工具资源；凭据和 Workflow Tool 是其子资源 **子命令：** `list`、`get`、`credential`、`workflow` 本级命令无专属参数。 ###### E.1.1.2.1 `zenava agent tool list` 统一列出内置／插件工具与 Workflow Tool。可按完整 Provider ID 精确过滤，或按关键词过滤。适用应用类型：平台资源，不绑定单一应用类型。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：items（provider_id、tool_name、source）。常见稳定错误：TOOL_LIST_FAILED。建议前后命令：zenava agent tool get | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | --provider | text | 否 | — | 完整 Provider ID；精确匹配，不指定时查询全部来源 | | --keyword | text | 否 | — | 在工具名称、展示名和描述中进行不区分大小写匹配 | ###### E.1.1.2.2 `zenava agent tool get` 按公开标识 (Provider ID, 工具名称) 获取参数 Schema 和凭据要求。适用应用类型：平台资源，不绑定单一应用类型。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：parameters schema、credentials 要求。常见稳定错误：TOOL_NOT_FOUND。建议前后命令：zenava agent tool credential schema | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | provider_id | text | 是 | — | 完整 Provider ID，来自 tool list 的 provider_id | | tool_name | text | 是 | — | 工具名称，来自 tool list 的 tool_name | ###### E.1.1.2.3 `zenava agent tool credential` 按 Provider Schema 管理共享凭据。资源边界：永不输出凭据值；不提供删除；OAuth 等请在 Web UI 配置 **子命令：** `schema`、`status`、`set` 本级命令无专属参数。 ###### E.1.1.2.3.1 `zenava agent tool credential schema` 读取 Provider 凭据字段 Schema；不读取或输出任何凭据值。适用应用类型：平台资源，不绑定单一应用类型。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：fields schema，不含凭据值。常见稳定错误：TOOL_NOT_FOUND。建议前后命令：zenava agent tool credential set --from-stdin --yes | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | provider | text | 是 | — | 完整 Provider ID | ###### E.1.1.2.3.2 `zenava agent tool credential status` 读取 Provider 凭据配置状态与字段名；永不输出凭据值。适用应用类型：平台资源，不绑定单一应用类型。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：status、字段名，不含凭据值。常见稳定错误：TOOL_NOT_FOUND。建议前后命令：zenava agent tool credential schema | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | provider | text | 是 | — | 完整 Provider ID | ###### E.1.1.2.3.3 `zenava agent tool credential set` 按动态 Schema Upsert（创建或整体更新）Provider 共享凭据。成功仅输出 provider、action、status。OAuth、动态回调、验证码和多阶段认证不受支持，请在 Web UI 配置。适用应用类型：平台资源，不绑定单一应用类型。互斥关系：--from-stdin、--from-env、--env-prefix 互斥，必须提供其一。标准输入示例：echo '{...}' | zenava agent tool credential set --from-stdin --yes 远端副作用：修改远端共享凭据，要求 --yes；不输出凭据。关键输出字段：provider、action、status。常见稳定错误：CREDENTIAL_SET_CONFIRM_REQUIRED、CREDENTIAL_INPUT_INVALID。建议前后命令：zenava agent tool credential status | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | provider | text | 是 | — | 完整 Provider ID | | --from-stdin | boolean | 否 | false | 从标准输入（stdin）读取完整凭据 JSON 对象 | | --from-env | text | 否 | — | 从指定环境变量读取完整凭据 JSON 对象；与其他输入方式互斥 | | --env-prefix | text | 否 | — | 按 Schema 字段名和此前缀读取环境变量；与其他输入方式互斥 | | --yes | boolean | 否 | false | 确认整体写入远端共享凭据；不会启动交互式确认 | ###### E.1.1.2.4 `zenava agent tool workflow` 从已发布 Workflow 注册或更新平台 Workflow Tool。资源边界：名称、描述、图标和开始节点参数从远端推导，不读取本地文件 **子命令：** `get`、`publish`、`update` 本级命令无专属参数。 ###### E.1.1.2.4.1 `zenava agent tool workflow get` 按应用 ID 或 Workflow Tool ID 查询现有关联；两个参数必须且只能提供一个。适用应用类型：workflow。互斥关系：--app-id 与 --tool-id 互斥，必须且只能提供一个。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：workflow_tool_id、app_id、name、label。常见稳定错误：WORKFLOW_TOOL_QUERY_INVALID、WORKFLOW_TOOL_NOT_FOUND。建议前后命令：zenava agent tool workflow publish 或 update | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | --app-id | text | 否 | — | 已发布 Workflow 应用 ID；与 --tool-id 互斥 | | --tool-id | text | 否 | — | Workflow Tool ID；与 --app-id 互斥 | ###### E.1.1.2.4.2 `zenava agent tool workflow publish` 将已发布 Workflow 注册为平台工具。名称、描述、图标和开始节点参数从远端推导，可显式覆盖展示名和描述；不读取本地文件。适用应用类型：workflow。互斥关系：不适用。标准输入示例：不适用。远端副作用：修改远端平台工具注册，要求 --yes。关键输出字段：workflow_tool_id、name。常见稳定错误：WORKFLOW_TOOL_PUBLISH_CONFIRM_REQUIRED。建议前后命令：zenava agent tool workflow get --tool-id | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | app_id | text | 是 | — | 已发布 Workflow 应用 ID | | --name | text | 是 | — | 必填的 Tool 机器名，只能包含 ASCII 字母、数字或下划线 | | --label | text | 否 | — | 可选展示名；省略时使用远端 Workflow 应用名称 | | --description | text | 否 | — | 可选描述；省略时使用远端 Workflow 应用描述 | | --yes | boolean | 否 | false | 确认注册远端 Workflow Tool；不会启动交互式确认 | ###### E.1.1.2.4.3 `zenava agent tool workflow update` 从关联应用当前已发布 Workflow 刷新工具参数和图标。省略名称、展示名或描述时保留现有远端值；不读取本地文件。适用应用类型：workflow。互斥关系：不适用。标准输入示例：不适用。远端副作用：修改远端平台工具，要求 --yes。关键输出字段：workflow_tool_id、name。常见稳定错误：WORKFLOW_TOOL_UPDATE_CONFIRM_REQUIRED。建议前后命令：zenava agent tool workflow get --tool-id | 参数 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | tool_id | text | 是 | — | Workflow Tool ID | | --name | text | 否 | — | 可选的新 Tool 机器名；省略时保留现有值 | | --label | text | 否 | — | 可选的新展示名；省略时保留现有值 | | --description | text | 否 | — | 可选的新描述；省略时保留现有值 | | --yes | boolean | 否 | false | 确认更新远端 Workflow Tool；不会启动交互式确认 | ###### E.1.1.3 `zenava agent model` 发现当前上下文可用的 LLM。资源边界：必须指定业务分类；Workflow 使用分类 code workflow **子命令：** `list`、`get` 本级命令无专属参数。 ###### E.1.1.3.1 `zenava agent model list` 按业务分类列出当前上下文可用的 LLM。适用应用类型：agent、chat、chatflow；workflow 使用分类 code workflow。互斥关系：不适用。标准输入示例：不适用。远端副作用：只读，不修改远端，无需确认开关。关键输出字段：items（provider、model）。常见稳定错误：MODEL_LIST_FAILED。建议前后命令：zenava agent model get --provider --model --category


| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --category | text | 是 | — | 必填；业务分类 code，Workflow 使用 workflow |

###### E.1.1.3.2 `zenava agent model get`
获取指定模型的详情及调用参数规则。 适用应用类型：agent、chat、chatflow；workflow 使用分类 code workflow。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：provider、model、parameter_rules。 常见稳定错误：MODEL_NOT_FOUND。 建议前后命令：zenava agent app draft update
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --provider | text | 是 | — | Provider ID |
| --model | text | 是 | — | 模型 ID |
| --category | text | 是 | — | 必填；业务分类 code，Workflow 使用 workflow |

###### E.1.1.4 `zenava agent category`
发现智能体分类。 资源边界：只提供 list；默认返回叶子分类，--tree 返回完整树
**子命令：** `list`
本级命令无专属参数。

###### E.1.1.4.1 `zenava agent category list`
列出当前企业可用于应用的叶子分类；可保留完整分类树。 适用应用类型：非 workflow 应用创建需要叶子分类。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：items 或 tree。 常见稳定错误：CATEGORY_LIST_FAILED。 建议前后命令：zenava agent app create --category 
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --tree | boolean | 否 | false | 返回完整业务分类树，而不是默认的叶子分类列表 |

###### E.1.1.5 `zenava agent dataset`
发现可挂到智能体 Draft 的知识库。 资源边界：填写 Draft 所用的知识库；文档和问答内容用 zenava aikb 管理
**子命令：** `list`、`get`、`scope`
本级命令无专属参数。

###### E.1.1.5.1 `zenava agent dataset list`
分页列出当前租户可见的知识库，供 Draft 填写 dataset_id。 适用应用类型：agent、chat、chatflow、workflow。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：items（id、name、is_tinet_aikb）、page、limit、total、has_more。 常见稳定错误：DATASET_LIST_FAILED、DATASET_RESPONSE_INVALID。 建议前后命令：zenava agent dataset get ；zenava agent dataset scope list
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --keyword | text | 否 | — | 按名称关键词过滤 |
| --page | integer | 否 | 1 | 页码，从 1 开始 |
| --limit | integer | 否 | 20 | 每页数量 |
| --id | text | 否 | — | 按知识库 UUID 精确查询，可重复 |

###### E.1.1.5.2 `zenava agent dataset get`
读取知识库详情，确认 UUID 仍可用于 Draft。 适用应用类型：agent、chat、chatflow、workflow。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：id、name、provider、is_tinet_aikb、external_knowledge_id。 常见稳定错误：DATASET_NOT_FOUND、DATASET_GET_FAILED。 建议前后命令：zenava agent dataset scope list；zenava agent app draft update
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| dataset_id | text | 是 | — | 知识库 UUID |

###### E.1.1.5.3 `zenava agent dataset scope`
发现可写入 Draft 召回范围（select_list）的知识库或目录。 资源边界：供 Draft 选择召回范围，不管理文档或问答内容
**子命令：** `list`、`search`、`get`
本级命令无专属参数。

###### E.1.1.5.3.1 `zenava agent dataset scope list`
按父节点展开可写入 select_list 的知识库或目录。 适用应用类型：agent、chat、chatflow、workflow。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：items（id、name、type）。 常见稳定错误：DATASET_SCOPE_FAILED、DATASET_SCOPE_RESPONSE_INVALID。 建议前后命令：zenava agent dataset scope search；zenava agent app draft update
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --parent-id | integer | 否 | — | 父节点 ID |
| --parent-type | text | 否 | — | 父节点类型：repository 或 directory |
| --knowledge-type | text | 否 | — | 知识类型：customer 或 industry |

###### E.1.1.5.3.2 `zenava agent dataset scope search`
按关键词搜索可写入 select_list 的知识库或目录。 适用应用类型：agent、chat、chatflow、workflow。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：items（id、name、type）。 常见稳定错误：DATASET_SCOPE_FAILED、DATASET_SCOPE_RESPONSE_INVALID。 建议前后命令：zenava agent dataset scope get；zenava agent app draft update
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --query | text | 是 | — | 搜索关键词 |
| --knowledge-type | text | 是 | — | 知识类型：customer 或 industry |
| --limit | integer | 否 | 10 | 返回数量，默认 10 |
| --offset | integer | 否 | 0 | 偏移量，默认 0 |

###### E.1.1.5.3.3 `zenava agent dataset scope get`
读取选中项的库或目录详情，便于写入 select_list。 适用应用类型：agent、chat、chatflow、workflow。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：id、name、type。 常见稳定错误：DATASET_SCOPE_FAILED、DATASET_SCOPE_RESPONSE_INVALID。 建议前后命令：zenava agent app draft update
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 知识库或目录 ID |
| --type | text | 是 | — | 节点类型：repository 或 directory |
| --knowledge-type | text | 是 | — | 知识类型：customer 或 industry |

###### E.1.1.6 `zenava agent data`
查询应用运行后产生的会话、消息和追踪数据。 资源边界：分页状态由调用方自行保持
**子命令：** `conversation`、`message`、`trace`
本级命令无专属参数。

###### E.1.1.6.1 `zenava agent data conversation`
查询会话记录。 资源边界：列出指定应用的会话
**子命令：** `list`
本级命令无专属参数。

###### E.1.1.6.1.1 `zenava agent data conversation list`
查询智能体会话记录。分页游标（cursor）需由调用方保持；CLI 不保存分页查询状态。 适用应用类型：由 --app-id 对应应用决定。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：request_id、data、limit、has_more、next_cursor。 常见稳定错误：AGENT_OPENAPI_PARAMETER_INVALID。 建议前后命令：zenava agent data message list
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --app-id | text | 是 | — | 智能体应用 ID |
| --created-at-start | integer | 是 | — | 创建开始时间，Unix 秒级时间戳 |
| --created-at-end | integer | 是 | — | 创建结束时间，Unix 秒级时间戳，跨度不超过 90 天 |
| --conversation-id | text | 否 | — | 按指定会话 ID 查询 |
| --request-unique-id | text | 否 | — | 按接入方链路 ID 查询；与 --conversation-id 相互独立，可同时传入 |
| --invoke-from | text | 否 | — | 会话来源：PROD 或 DEBUG |
| --is-transfer-human | boolean | 否 | false | 筛选是否发生过转人工 |
| --limit | integer | 否 | 10 | 查询数量 |
| --cursor | text | 否 | — | 分页游标（cursor）。CLI 不保存分页查询状态 |

###### E.1.1.6.2 `zenava agent data message`
查询会话消息。 资源边界：列出指定会话的消息
**子命令：** `list`
本级命令无专属参数。

###### E.1.1.6.2.1 `zenava agent data message list`
查询指定会话的消息记录。分页游标（cursor）需由调用方保持；CLI 不保存分页查询状态。 适用应用类型：由 --app-id 对应应用决定。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：request_id、data、limit、has_more、next_cursor。 常见稳定错误：AGENT_OPENAPI_PARAMETER_INVALID。 建议前后命令：zenava agent data trace list
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --app-id | text | 是 | — | 智能体应用 ID |
| --conversation-id | text | 是 | — | 会话 ID |
| --conversation-created-at | integer | 是 | — | 会话创建时间，Unix 秒级时间戳 |
| --limit | integer | 否 | 10 | 查询数量 |
| --cursor | text | 否 | — | 分页游标（cursor）。CLI 不保存分页查询状态 |

###### E.1.1.6.3 `zenava agent data trace`
查询消息追踪。 资源边界：列出指定消息的节点追踪
**子命令：** `list`
本级命令无专属参数。

###### E.1.1.6.3.1 `zenava agent data trace list`
查询指定消息的详细日志追踪。分页游标（cursor）需由调用方保持；CLI 不保存分页查询状态。 适用应用类型：由 --app-id 对应应用决定。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：request_id、data、limit、has_more、next_cursor。 常见稳定错误：AGENT_OPENAPI_PARAMETER_INVALID。 建议前后命令：zenava agent app draft get
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --app-id | text | 是 | — | 智能体应用 ID |
| --conversation-id | text | 是 | — | 会话 ID |
| --conversation-created-at | integer | 是 | — | 会话创建时间，Unix 秒级时间戳 |
| --message-id | text | 是 | — | 消息 ID |
| --limit | integer | 否 | 10 | 查询数量 |
| --cursor | text | 否 | — | 分页游标（cursor）。CLI 不保存分页查询状态 |

###### E.1.1.7 `zenava agent schema`
读取当前 CLI 内置的远端 Draft Schema。 资源边界：与 draft update 使用同一份 Schema；未知节点与未知字段默认放行
**子命令：** `list`、`get`
本级命令无专属参数。

###### E.1.1.7.1 `zenava agent schema list`
列出四种应用类型的 Draft Schema 元数据。 适用应用类型：agent、chat、chatflow、workflow。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：items（id、app_type、schema_version、cli_version）。 常见稳定错误：ASSET_NOT_FOUND。 建议前后命令：zenava agent schema get 

###### E.1.1.7.2 `zenava agent schema get`
读取指定应用类型的完整 Draft Schema。 适用应用类型：agent、chat、chatflow、workflow。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：完整 JSON Schema。 常见稳定错误：APP_TYPE_INVALID、ASSET_NOT_FOUND。 建议前后命令：zenava agent app draft update  --from-stdin --expected-hash  --yes
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| app_type | text | 是 | — | 应用类型：agent、chat、chatflow 或 workflow |

##### E.1.2 `zenava aikb`
智能知识库管理。 资源边界：管理知识库、目录、文档、问答与检索
**子命令：** `repository`、`directory`、`faq`、`file`、`recycle-bin`、`knowledge`、`media`、`attachment`
本级命令无专属参数。

###### E.1.2.1 `zenava aikb repository`
知识库管理。 资源边界：列出公共/个人库并读取机器人知识库
**子命令：** `list-public`、`list-private`、`get-bot`
本级命令无专属参数。

###### E.1.2.1.1 `zenava aikb repository list-public`
获取公共知识库列表。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help

###### E.1.2.1.2 `zenava aikb repository list-private`
获取个人知识库列表。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help

###### E.1.2.1.3 `zenava aikb repository get-bot`
获取机器人知识库信息。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help

###### E.1.2.2 `zenava aikb directory`
目录管理。 资源边界：知识库目录的增删改查
**子命令：** `list`、`create`、`update`、`delete`
本级命令无专属参数。

###### E.1.2.2.1 `zenava aikb directory list`
获取知识库目录列表。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --repository-id | integer | 是 | — | 知识库 ID |
| --type | text | 是 | — | 知识类型 |
| --bot-id | integer | 否 | — | 机器人 ID |

###### E.1.2.2.2 `zenava aikb directory create`
创建知识库目录。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：修改远端知识库数据，要求 --yes，可能影响线上知识内容。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_CONFIRM_REQUIRED、AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --repository-id | integer | 是 | — | 知识库 ID |
| --name | text | 是 | — | 目录名称 |
| --type | text | 是 | — | 知识类型 |
| --parent-id | integer | 否 | — | 上级目录 ID |
| --yes | boolean | 否 | false | 确认创建目录 |

###### E.1.2.2.3 `zenava aikb directory update`
修改或移动知识库目录。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：修改远端知识库数据，要求 --yes，可能影响线上知识内容。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_CONFIRM_REQUIRED、AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --directory-id | integer | 是 | — | 目录 ID |
| --target-repository-id | integer | 否 | — | 目标知识库 ID |
| --name | text | 否 | — | 修改后的目录名称 |
| --target-directory-id | integer | 否 | — | 目标父目录 ID |
| --yes | boolean | 否 | false | 确认修改目录 |

###### E.1.2.2.4 `zenava aikb directory delete`
删除知识库目录。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：修改远端知识库数据，要求 --yes，可能影响线上知识内容。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_CONFIRM_REQUIRED、AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --directory-id | integer | 是 | — | 目录 ID |
| --yes | boolean | 否 | false | 确认删除目录 |

###### E.1.2.3 `zenava aikb faq`
问答知识管理。 资源边界：FAQ 的增删改查
**子命令：** `list`、`create`、`update`、`describe`、`delete`
本级命令无专属参数。

###### E.1.2.3.1 `zenava aikb faq list`
获取问答列表。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --repository-id | integer | 是 | — | 知识库 ID |
| --bot-id | integer | 否 | — | 机器人 ID |
| --update-time-start | text | 否 | — | 更新开始时间 |
| --update-time-end | text | 否 | — | 更新结束时间 |
| --offset | integer | 否 | 0 | 分页偏移量 |
| --limit | integer | 否 | 10 | 查询数量 |

###### E.1.2.3.2 `zenava aikb faq create`
创建问答知识。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：修改远端知识库数据，要求 --yes，可能影响线上知识内容。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_CONFIRM_REQUIRED、AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --repository-id | integer | 是 | — | 知识库 ID |
| --directory-id | integer | 是 | — | 目录 ID |
| --question | text | 是 | — | 问答问题标题 |
| --answers | text | 是 | — | 答案列表 JSON |
| --introduction-type | integer | 否 | — | 简介格式，1 为文本，2 为富文本 |
| --introduction | text | 否 | — | 问答简介 |
| --similar | text | 否 | — | 相似问，可重复 |
| --related-id | integer | 否 | — | 关联问答 ID，可重复 |
| --online-date-from | text | 否 | — | 有效开始时间 |
| --online-date-to | text | 否 | — | 有效结束时间 |
| --auto-online | boolean | 否 | false | 创建后自动上线 |
| --yes | boolean | 否 | false | 确认创建问答 |

###### E.1.2.3.3 `zenava aikb faq update`
编辑问答知识。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：修改远端知识库数据，要求 --yes，可能影响线上知识内容。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_CONFIRM_REQUIRED、AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --faq-id | integer | 是 | — | 问答 ID |
| --repository-id | integer | 是 | — | 知识库 ID |
| --directory-id | integer | 是 | — | 目录 ID |
| --question | text | 是 | — | 问答问题标题 |
| --answers | text | 是 | — | 答案列表 JSON |
| --introduction-type | integer | 否 | — | 简介格式，1 为文本，2 为富文本 |
| --introduction | text | 否 | — | 问答简介 |
| --similar | text | 否 | — | 相似问，可重复 |
| --related-id | integer | 否 | — | 关联问答 ID，可重复 |
| --online-date-from | text | 否 | — | 有效开始时间 |
| --online-date-to | text | 否 | — | 有效结束时间 |
| --yes | boolean | 否 | false | 确认编辑问答 |

###### E.1.2.3.4 `zenava aikb faq describe`
获取问答详情。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --faq-id | integer | 是 | — | 问答 ID |

###### E.1.2.3.5 `zenava aikb faq delete`
删除问答知识。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：修改远端知识库数据，要求 --yes，可能影响线上知识内容。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_CONFIRM_REQUIRED、AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --faq-id | integer | 是 | — | 问答 ID |
| --yes | boolean | 否 | false | 确认删除问答 |

###### E.1.2.4 `zenava aikb file`
文档知识管理。 资源边界：文档上传、创建与删除
**子命令：** `list`、`describe`、`upload`、`create`、`delete`
本级命令无专属参数。

###### E.1.2.4.1 `zenava aikb file list`
获取文档列表。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --repository-id | integer | 是 | — | 知识库 ID |
| --directory-id | integer | 否 | — | 目录 ID |
| --create-time-start | text | 否 | — | 创建开始时间 |
| --create-time-end | text | 否 | — | 创建结束时间 |
| --update-time-start | text | 否 | — | 更新开始时间 |
| --update-time-end | text | 否 | — | 更新结束时间 |
| --offset | integer | 否 | 0 | 分页偏移量 |
| --limit | integer | 否 | 10 | 查询数量 |

###### E.1.2.4.2 `zenava aikb file describe`
获取文档详情。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file-id | integer | 是 | — | 文档 ID |

###### E.1.2.4.3 `zenava aikb file upload`
获取临时上传地址并上传本地文档。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：修改远端知识库数据，要求 --yes，可能影响线上知识内容。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_CONFIRM_REQUIRED、AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 是 | — | 需要上传的本地文件 |
| --upload-timeout | number | 否 | — | PUT 上传超时秒数 |
| --yes | boolean | 否 | false | 确认上传文档 |

###### E.1.2.4.4 `zenava aikb file create`
使用已上传的 fileKey 创建文档知识。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：修改远端知识库数据，要求 --yes，可能影响线上知识内容。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_CONFIRM_REQUIRED、AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --repository-id | integer | 是 | — | 知识库 ID |
| --directory-id | integer | 是 | — | 目录 ID |
| --file-name | text | 是 | — | 包含后缀的文件名 |
| --file-key | text | 是 | — | 上传返回的 fileKey |
| --introduction | text | 否 | — | 文档说明 |
| --tag-id | integer | 否 | — | 文档标签 ID，可重复 |
| --effective-from | text | 否 | — | 有效开始时间 |
| --effective-to | text | 否 | — | 有效结束时间 |
| --auto-online | boolean | 否 | false | 解析后自动上线 |
| --yes | boolean | 否 | false | 确认创建文档 |

###### E.1.2.4.5 `zenava aikb file delete`
批量删除文档知识。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：修改远端知识库数据，要求 --yes，可能影响线上知识内容。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_CONFIRM_REQUIRED、AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --repository-id | integer | 是 | — | 知识库 ID |
| --file-id | integer | 是 | — | 文档 ID，可重复 |
| --yes | boolean | 否 | false | 确认删除文档 |

###### E.1.2.5 `zenava aikb recycle-bin`
回收站管理。 资源边界：只读列出回收站项目
**子命令：** `list`
本级命令无专属参数。

###### E.1.2.5.1 `zenava aikb recycle-bin list`
获取回收站列表。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --repository-id | integer | 是 | — | 知识库 ID |
| --delete-user | text | 否 | — | 删除人用户名 |
| --keyword | text | 否 | — | 名称关键词 |
| --type | text | 否 | — | 回收站项目类型 |
| --offset | integer | 否 | 0 | 分页偏移量 |
| --limit | integer | 否 | 10 | 查询数量 |

###### E.1.2.6 `zenava aikb knowledge`
知识问答与搜索。 资源边界：会话问答与检索
**子命令：** `assistant`、`search`
本级命令无专属参数。

###### E.1.2.6.1 `zenava aikb knowledge assistant`
发起或继续知识库会话问答。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：修改远端知识库数据，要求 --yes，可能影响线上知识内容。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_CONFIRM_REQUIRED、AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --username | text | 是 | — | 用户登录名 |
| --content | text | 是 | — | 本轮提问内容 |
| --conversation-id | text | 否 | — | 继续会话时使用的会话 ID |
| --yes | boolean | 否 | false | 确认发起会话 |

###### E.1.2.6.2 `zenava aikb knowledge search`
搜索知识库内容。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --username | text | 否 | — | 用户登录名 |
| --keyword | text | 否 | — | 搜索关键词 |
| --order-field | text | 否 | — | 排序字段 |
| --knowledge-type | text | 否 | — | 知识类型 |
| --repository-id | integer | 否 | — | 限定知识库 ID，可重复 |
| --directory-id | integer | 否 | — | 限定目录 ID，可重复 |
| --offset | integer | 否 | 0 | 分页偏移量 |
| --limit | integer | 否 | 10 | 查询数量 |

###### E.1.2.7 `zenava aikb media`
知识媒体管理。 资源边界：预览或下载文档与问答附件
**子命令：** `describe-file`、`describe-faq`
本级命令无专属参数。

###### E.1.2.7.1 `zenava aikb media describe-file`
获取文档预览或下载地址。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file-id | integer | 是 | — | 文档 ID |
| --inline | boolean | 否 | false | 在线预览或下载 |

###### E.1.2.7.2 `zenava aikb media describe-faq`
获取问答附件预览或下载地址。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：只读，不修改远端，无需确认开关。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb --help
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --faq-id | integer | 是 | — | 问答 ID |
| --file-key | text | 是 | — | 问答附件 fileKey |
| --inline | boolean | 否 | false | 在线预览或下载 |

###### E.1.2.8 `zenava aikb attachment`
知识附件管理。 资源边界：获取附件上传地址
**子命令：** `get-upload-url`
本级命令无专属参数。

###### E.1.2.8.1 `zenava aikb attachment get-upload-url`
获取附件上传地址及签名，随后由调用方自行上传。 适用应用类型：不适用（知识库领域）。 互斥关系：不适用。 标准输入示例：不适用。 远端副作用：仅签发上传凭证，不写入知识内容；仍要求 --yes。 关键输出字段：接口返回的业务字段。 常见稳定错误：AIKB_CONFIRM_REQUIRED、AIKB_PARAMETER_INVALID。 建议前后命令：zenava aikb file create
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file-name | text | 是 | — | 需要上传的文件名 |
| --yes | boolean | 否 | false | 确认获取上传签名 |

##### E.1.3 `zenava callcenter`
呼叫中心
**子命令：** `agent`、`agent-analysis-config`、`agent-analysis-config-template`、`agent-login`、`agent-report`、`agent-status`、`agent-tel`、`area-code`、`asr`、`asr-context`、`asr-replacement`、`asr-vocab`、`cdr`、`cdr-user-field`、`crn`、`data-manager`、`enterprise`、`enterprise-hotline`、`enterprise-setting`、`enterprise-time`、`enterprise-voice`、`export-record`、`exten`、`hybrid-group`、`intelligent-agent-rasr`、`investigation`、`ivr-profile`、`ivr-router`、`ivr-script`、`monitor`、`push-action`、`push-target`、`rasr`、`record`、`report`、`skill`、`stat`、`task`、`task-template`、`tts`、`webcall`
本级命令无专属参数。

###### E.1.3.1 `zenava callcenter agent`
座席操作与数据管理（含 create/update；非 agent-login 服务端鉴权）
**子命令：** `change-bind-tel`、`consult`、`consult-transfer`、`create`、`delete`、`get`、`involve-threeway`、`login`、`logout`、`online-list`、`pause`、`preview-outcall`、`preview-outcall-cancel`、`query`、`query-skill`、`refuse`、`unbind-tel`、`unlink`、`unpause`、`update`
本级命令无专属参数。

###### E.1.3.1.1 `zenava callcenter agent change-bind-tel`
修改绑定电话
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |
| --bind-tel | text | 是 | — | 绑定电话 |
| --bind-type | integer | 是 | — | 1 电话 2 分机 |
| --is-verify | integer | 否 | 1 | 0 不验证 1 验证 |

###### E.1.3.1.2 `zenava callcenter agent consult`
座席咨询
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |
| --object-type | integer | 是 | — | 0 电话 1 座席 2 分机 |
| --consult-object | text | 是 | — | 咨询对象 |
| --consult-variables | text | 否 | — | JSON 数组字符串 |
| --hold-music-class | text | 否 | — | 自定义保持音 |

###### E.1.3.1.3 `zenava callcenter agent consult-transfer`
座席咨询转移
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |
| --limit-time-second | integer | 否 | — | 通话限时秒 |
| --limit-time-alert-second | integer | 否 | — | 限时前提醒秒 |
| --limit-time-file | text | 否 | — | 提醒语音文件名 |
| --is-investigation | integer | 否 | — | 0 不调查 1 进行满意度调查 |

###### E.1.3.1.4 `zenava callcenter agent create`
创建座席
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --permit-ob-preview-time | text | 否 | — | 可外呼时间段 |
| --comment | text | 否 | — | 备注 |
| --is-ob-remember | text | 否 | 1 | 0 关闭 1 开启外呼主叫记忆 |
| --webrtc-url-type | integer | 否 | 0 | 0 企业默认 1 公网域名 2 专线域名 3 公网IP 4 专线IP |
| --is-quality-check | integer | 否 | 1 | 0 不开启 1 开启座席质检 |
| --is-asr | integer | 否 | 0 | 0 不开启 1 开启 ASR 转写 |
| --skill-levels | text | 否 | — | 技能等级逗号分隔 |
| --skill-ids | text | 否 | — | 技能 id 逗号分隔 |
| --ob-record | integer | 否 | 1 | 0 不录音 1 录音 |
| --ib-record | integer | 否 | 1 | 0 不录音 1 录音 |
| --ob-clid-property | text | 否 | — | 外显属性 JSON，如 {"isMatchCapital":0,"areaCodeRule":1,"isRandom":1} |
| --ob-clid | text | 否 | — | 透传号码（obClidType 为 2 或 3 时必选） |
| --ob-clid-type | integer | 否 | 1 | 1 默认 2 随机 3 按区号 4 动态外显 |
| --is-ob | integer | 否 | 1 | 0 不允许外呼 1 可以 |
| --wrapup | integer | 否 | 10 | 整理时间（秒） |
| --call-power | integer | 否 | 0 | 0 无限制 1 国内长途 2 国内本市 3 内部呼叫 |
| --power | integer | 否 | 0 | 0 普通座席 1 班长席 |
| --active | integer | 否 | 1 | 0 不激活 1 激活 |
| --area-code | text | 是 | — | 区号 |
| --name | text | 是 | — | 座席姓名 |
| --cno | text | 是 | — | 座席工号 |

###### E.1.3.1.5 `zenava callcenter agent delete`
座席删除
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |

###### E.1.3.1.6 `zenava callcenter agent get`
座席详细信息获取
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |

###### E.1.3.1.7 `zenava callcenter agent involve-threeway`
邀请三方
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --unique-id | text | 是 | — | 通话唯一标识 |
| --object-type | integer | 是 | — | 1 座席工号 2 外呼组 4 预测外呼任务 |
| --involve-object | text | 否 | — | 被邀请对象值 |
| --dial-timeout | integer | 否 | — | 2 < x ≤ 60 秒 |
| --dial-strategy | integer | 否 | — | 1 随机 2 空闲最长 |
| --conference-mode | integer | 否 | 0 | 0 静音 1 取消静音 |
| --barge-on-answer | integer | 否 | 0 | 0 三方通话 1 挂断主叫 |
| --involve-variables | text | 否 | — | JSON 数组字符串 |

###### E.1.3.1.8 `zenava callcenter agent login`
座席上线
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |
| --bind-tel | text | 是 | — | 绑定电话 |
| --bind-type | integer | 是 | — | 1 电话 2 分机 3 webrtc |
| --login-status | integer | 否 | 1 | 1 置闲 2 置忙 |
| --pause-description | text | 否 | — | 置忙描述 |

###### E.1.3.1.9 `zenava callcenter agent logout`
座席下线
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |
| --remove-binding | integer | 否 | 0 | 0 不解除绑定电话 1 解除绑定电话 |
| --is-kickout | integer | 否 | 1 | 0 不发送 1 发送 kickout |
| --ignore-offline | integer | 否 | 0 | 0 不忽略 1 忽略重复下线报错 |

###### E.1.3.1.10 `zenava callcenter agent online-list`
获取在线座席信息
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --qnos | text | 否 | — | 队列号，逗号分隔 |
| --cnos | text | 否 | — | 座席工号，逗号分隔 |
| --state-code | text | 否 | — | s1 空闲 s2 置忙 s3 整理 s4 呼叫中 s5 响铃 s6 通话（逗号分隔） |
| --pause-type | text | 否 | — | 1 普通 2 休息 3 IM 4 强制（逗号分隔） |
| --pause-description | text | 否 | — | 置忙原因，逗号分隔 |

###### E.1.3.1.11 `zenava callcenter agent pause`
座席置忙
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |
| --type | integer | 是 | — | 1 普通 2 休息 3 IM |
| --description | text | 是 | — | 置忙描述 |

###### E.1.3.1.12 `zenava callcenter agent preview-outcall`
座席外呼（预览外呼）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |
| --tel | text | 是 | — | 被叫号码（可 URLEncode 加密号码） |
| --timeout | integer | 否 | 30 | 呼叫超时秒数 |
| --dial-tel-timeout | integer | 否 | 45 | 拨号超时秒数 |
| --call-variables-json | text | 否 | — | 自定义变量 JSON 数组字符串 |
| --request-unique-id | text | 否 | — | 请求唯一标识 |
| --backup-tels | text | 否 | — | 备用号码，逗号分隔，最多 5 个 |
| --is-investigation | integer | 否 | — | 0 不调查 1 满意度调查（未传则取企业配置） |
| --cdr-is-asr | integer | 否 | 1 | 0 不转写 1 转写 |
| --crn-id | text | 否 | — | 客户号码池 ID |
| --ob-clid | text | 否 | — | 外显号码 |
| --ob-clid-area-code | text | 否 | — | 外显区号 |
| --clid-list-json | text | 否 | — | 外显号码列表 JSON 数组字符串 |
| --clid-pool-list-json | text | 否 | — | 外显号码池列表 JSON 数组字符串 |

###### E.1.3.1.13 `zenava callcenter agent preview-outcall-cancel`
座席外呼取消（预览外呼取消）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |

###### E.1.3.1.14 `zenava callcenter agent query`
座席详细信息列表获取
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --qno | text | 否 | — | 队列号 |
| --cnos | text | 否 | — | 座席工号，逗号分隔，最多 500 |
| --start | integer | 否 | 0 | 从第几条开始 |
| --limit | integer | 否 | 10 | 查询条数，最大 1000 |
| --active | integer | 否 | — | 0 停用 1 启用 |
| --status | integer | 否 | — | 0 离线 1 在线 |
| --order | integer | 否 | — | 0 正序 1 倒序 |
| --webrtc-url-type | integer | 否 | — | 0 企业默认 1 公网域名 2 专线域名 3 公网IP 4 专线IP |
| --start-time | text | 否 | — | 创建时间起，如 "2019-10-11 00:00:00" |
| --end-time | text | 否 | — | 创建时间止 |
| --return-queue | integer | 否 | 1 | 0 不返回队列 1 返回 |
| --name | text | 否 | — | 座席名称模糊 |
| --comment | text | 否 | — | 座席备注前缀模糊 |

###### E.1.3.1.15 `zenava callcenter agent query-skill`
获取座席技能
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cnos | text | 是 | — | 座席工号，逗号分隔 |

###### E.1.3.1.16 `zenava callcenter agent refuse`
座席拒接
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |
| --description | text | 否 | — | 拒接原因，< 20 字符 |

###### E.1.3.1.17 `zenava callcenter agent unbind-tel`
解除绑定电话
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |

###### E.1.3.1.18 `zenava callcenter agent unlink`
座席挂机
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 否 | — | 座席工号（三选一） |
| --unique-id | text | 否 | — | 通话唯一标识（三选一） |
| --request-unique-id | text | 否 | — | webcall 请求 ID（三选一） |
| --side | integer | 否 | 1 | 1 座席侧 2 非座席侧 |

###### E.1.3.1.19 `zenava callcenter agent unpause`
座席置闲
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |

###### E.1.3.1.20 `zenava callcenter agent update`
更新座席（仅 cno 必选，其余字段增量发送）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --permit-ob-preview-time | text | 否 | — | 可外呼时间段 |
| --comment | text | 否 | — | 备注 |
| --is-ob-remember | text | 否 | — | 0 关闭 1 开启外呼主叫记忆 [default: 1] |
| --webrtc-url-type | integer | 否 | — | 0 企业默认 1 公网域名 2 专线域名 3 公网IP 4 专线IP [default: 0] |
| --is-quality-check | integer | 否 | — | 0 不开启 1 开启座席质检 [default: 1] |
| --is-asr | integer | 否 | — | 0 不开启 1 开启 ASR 转写 [default: 0] |
| --skill-levels | text | 否 | — | 技能等级 |
| --skill-ids | text | 否 | — | 技能 id；"0" 清空 |
| --ob-record | integer | 否 | — | 0 不录音 1 录音 [default: 1] |
| --ib-record | integer | 否 | — | 0 不录音 1 录音 [default: 1] |
| --ob-clid-property | text | 否 | — | 外显属性 JSON，如 {"isMatchCapital":0,"areaCodeRule":1,"isRandom":1} |
| --is-random | text | 否 | — | 0 否 1 是（obClidType=4 时） [default: 0] |
| --ob-clid | text | 否 | — | 透传号码（obClidType 为 2 或 3 时必选） |
| --ob-clid-type | integer | 否 | — | 1 默认 2 随机 3 按区号 4 动态外显 [default: 1] |
| --is-ob | integer | 否 | — | 0 不允许外呼 1 可以 [default: 1] |
| --wrapup | integer | 否 | — | 整理时间（秒） [default: 10] |
| --call-power | integer | 否 | — | 0 无限制 1 国内长途 2 国内本市 3 内部呼叫 [default: 0] |
| --power | integer | 否 | — | 0 普通座席 1 班长席 [default: 0] |
| --agent-type | integer | 否 | — | 1 电话座席 2 电脑座席 [default: 1] |
| --active | integer | 否 | — | 0 不激活 1 激活 [default: 1] |
| --area-code | text | 否 | — | 区号 |
| --name | text | 否 | — | 座席姓名 |
| --cno | text | 是 | — | 座席工号 |

###### E.1.3.2 `zenava callcenter agent-analysis-config`
智能体话后分析配置管理
**子命令：** `create`、`delete`、`get`、`update`
本级命令无专属参数。

###### E.1.3.2.1 `zenava callcenter agent-analysis-config create`
创建智能体话后分析配置（整包写入） 服务端语义：未提供的列表会被清空、未提供的开关会被置 0； 仅用于首次创建或整体替换；只改部分字段请用 update
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --call-assistant-analysis-result-active | integer | 否 | — | 是否将话后分析结果传入话后助手：0 关，1 开 |
| --call-assistant-bot | text | 否 | — | 话后助手执行智能体 ID；callAssistantActive=1 时必填 |
| --call-assistant-active | integer | 否 | — | 话后助手开关：0 关，1 开；为 1 时 callAssistantBot 必填 |
| --custom-transfer-stat | text | 否 | — | 自定义转人工率项列表 JSON，最多 30 项；元素字段：name（String，必填，统计项名称）、values（String 数组，必填，统计维度取值列表）；示例：[{"name":"转人工率","values":["A"]}] |
| --call-intention | text | 否 | — | 进线意图项列表 JSON，最多 30 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"咨询","value":"进线咨询","disEditable":0}] |
| --question-active | integer | 否 | — | 异常提取开关：0 关，1 开 |
| --evaluation-active | integer | 否 | — | 分析评估开关：0 关，1 开 |
| --transfer-reason | text | 否 | — | 转人工原因项列表 JSON，最多 30 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"进线要求转人工","value":"客户明确要求转人工","disEditable":1}] |
| --solve | text | 否 | — | 是否解决问题项列表 JSON，最多 2 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"已解决","value":"客户问题已解决","disEditable":0}] |
| --process | text | 否 | — | 流程挂断点项列表 JSON，最多 30 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"节点A","value":"描述"}] |
| --process-active | integer | 否 | — | 流程挂断点开关：0 关，1 开 |
| --intention-tag | text | 否 | — | 意向标签项列表 JSON，最多 30 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"高意向","value":"描述"}] |
| --intention-tag-active | integer | 否 | — | 意向标签开关：0 关，1 开 |
| --info | text | 否 | — | 信息捕获项列表 JSON，最多 30 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"k1","value":"v1"}] |
| --info-active | integer | 否 | — | 信息捕获开关：0 关，1 开 |
| --agent-id | text | 是 | — | 智能体 ID |
| --category | text | 否 | — | 呼入/外呼分类：仅新建记录时写入（update 不生效） |
| --bot-type | text | 否 | — | 智能体类型：仅新建记录时写入 type/provider/config（update 不生效） |

###### E.1.3.2.2 `zenava callcenter agent-analysis-config delete`
清空智能体话后分析配置（不删除智能体本身）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --agent-id | text | 是 | — | 智能体 ID |

###### E.1.3.2.3 `zenava callcenter agent-analysis-config get`
查询智能体话后分析配置
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --agent-id | text | 是 | — | 智能体 ID |

###### E.1.3.2.4 `zenava callcenter agent-analysis-config update`
更新智能体话后分析配置（局部更新） 仅修改提供的字段，未提供的字段保持原值；记录必须已存在
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --call-assistant-analysis-result-active | integer | 否 | — | 是否将话后分析结果传入话后助手：0 关，1 开 |
| --call-assistant-bot | text | 否 | — | 话后助手执行智能体 ID；callAssistantActive=1 时必填 |
| --call-assistant-active | integer | 否 | — | 话后助手开关：0 关，1 开；为 1 时 callAssistantBot 必填 |
| --custom-transfer-stat | text | 否 | — | 自定义转人工率项列表 JSON，最多 30 项；元素字段：name（String，必填，统计项名称）、values（String 数组，必填，统计维度取值列表）；示例：[{"name":"转人工率","values":["A"]}] |
| --call-intention | text | 否 | — | 进线意图项列表 JSON，最多 30 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"咨询","value":"进线咨询","disEditable":0}] |
| --question-active | integer | 否 | — | 异常提取开关：0 关，1 开 |
| --evaluation-active | integer | 否 | — | 分析评估开关：0 关，1 开 |
| --transfer-reason | text | 否 | — | 转人工原因项列表 JSON，最多 30 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"进线要求转人工","value":"客户明确要求转人工","disEditable":1}] |
| --solve | text | 否 | — | 是否解决问题项列表 JSON，最多 2 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"已解决","value":"客户问题已解决","disEditable":0}] |
| --process | text | 否 | — | 流程挂断点项列表 JSON，最多 30 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"节点A","value":"描述"}] |
| --process-active | integer | 否 | — | 流程挂断点开关：0 关，1 开 |
| --intention-tag | text | 否 | — | 意向标签项列表 JSON，最多 30 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"高意向","value":"描述"}] |
| --intention-tag-active | integer | 否 | — | 意向标签开关：0 关，1 开 |
| --info | text | 否 | — | 信息捕获项列表 JSON，最多 30 项；元素字段：key（String，必填，不可为空）、value（String，可选）、disEditable（Int，可选，0 可编辑可删除 / 1 不可编辑不可删除 / 2 可编辑不可删除，默认 0）；示例：[{"key":"k1","value":"v1"}] |
| --info-active | integer | 否 | — | 信息捕获开关：0 关，1 开 |
| --agent-id | text | 是 | — | 智能体 ID |

###### E.1.3.3 `zenava callcenter agent-analysis-config-template`
智能体话后分析配置模板管理
**子命令：** `create`、`delete`、`get`、`list`、`publish`、`update`
本级命令无专属参数。

###### E.1.3.3.1 `zenava callcenter agent-analysis-config-template create`
创建话后分析配置模板 同企业同 type 下 name 不可重复；未提供 --items 时服务端视为空列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --items | text | 否 | — | SettingItem 列表 JSON，最多 30 项（条数由服务端裁决）；元素字段：key（String，必填，不可为空）、value（String，可选，可空）；示例：[{"key":"整体满意度","value":"根据客户反馈输出满意/一般/不满意"}] |
| --type | integer | 是 | — | 模板类型：1=信息捕获(info)，2=意向标签(intentionTag)，3=流程挂断点(process) |
| --name | text | 是 | — | 模板名称（trim 后非空） |

###### E.1.3.3.2 `zenava callcenter agent-analysis-config-template delete`
删除话后分析配置模板
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 模板 ID |

###### E.1.3.3.3 `zenava callcenter agent-analysis-config-template get`
查询话后分析配置模板详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 模板 ID |

###### E.1.3.3.4 `zenava callcenter agent-analysis-config-template list`
查询话后分析配置模板列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --type | integer | 否 | — | 模板类型：1=信息捕获(info)，2=意向标签(intentionTag)，3=流程挂断点(process)；不传返回全部 |

###### E.1.3.3.5 `zenava callcenter agent-analysis-config-template publish`
发布话后分析配置模板到智能体
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 模板 ID |
| --agent-id | text | 是 | — | 目标智能体 ID（须已有话后分析配置记录） |

###### E.1.3.3.6 `zenava callcenter agent-analysis-config-template update`
更新话后分析配置模板 未提供 --items 时服务端视为空列表；不做局部合并
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --items | text | 否 | — | SettingItem 列表 JSON，最多 30 项（条数由服务端裁决）；元素字段：key（String，必填，不可为空）、value（String，可选，可空）；示例：[{"key":"整体满意度","value":"根据客户反馈输出满意/一般/不满意"}] |
| --type | integer | 是 | — | 模板类型：1=信息捕获(info)，2=意向标签(intentionTag)，3=流程挂断点(process) |
| --name | text | 是 | — | 模板名称（trim 后非空；整单覆盖） |
| --id | integer | 是 | — | 模板 ID |

###### E.1.3.4 `zenava callcenter agent-login`
座席服务端登录鉴权（非 agent login 上线命令）
**子命令：** `authenticate`
本级命令无专属参数。

###### E.1.3.4.1 `zenava callcenter agent-login authenticate`
座席服务端登录鉴权
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --crm-id | text | 否 | — | validateType=1 时 CRM 工号 |
| --cno | text | 否 | — | validateType=2 时座席工号 |
| --pwd | text | 否 | — | 座席密码（发送 MD5） |

###### E.1.3.5 `zenava callcenter agent-report`
座席报表查询
**子命令：** `agent-duration`
本级命令无专属参数。

###### E.1.3.5.1 `zenava callcenter agent-report agent-duration`
座席工作时长报表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --time-range-type | integer | 是 | — | 1 日报表 2 周报表 3 月报表 4 自定义时间 |
| --start-time | text | 是 | — | yyyy-MM-dd |
| --end-time | text | 是 | — | yyyy-MM-dd |
| --cnos | text | 否 | — | 座席工号，逗号分隔 |
| --start-hour | integer | 否 | 0 | 统计时段开始小时，0–23 |
| --end-hour | integer | 否 | 23 | 统计时段结束小时，0–23 |
| --start | integer | 否 | 0 | 分页偏移 |
| --limit | integer | 否 | 10 | 查询条数，1–1000 |

###### E.1.3.6 `zenava callcenter agent-status`
座席实时状态（非 agent get 资料查询）
**子命令：** `batch-get`、`get`
本级命令无专属参数。

###### E.1.3.6.1 `zenava callcenter agent-status batch-get`
批量获取座席实时状态
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cnos | text | 是 | — | 座席工号，逗号分隔，最多 100 |

###### E.1.3.6.2 `zenava callcenter agent-status get`
获取单个座席实时状态
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |

###### E.1.3.7 `zenava callcenter agent-tel`
座席电话管理
**子命令：** `tel-list`
本级命令无专属参数。

###### E.1.3.7.1 `zenava callcenter agent-tel tel-list`
获取座席电话列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |
| --tel | text | 否 | — | 按号码筛选 |

###### E.1.3.8 `zenava callcenter area-code`
号码归属地查询
**子命令：** `batch-get`、`get`
本级命令无专属参数。

###### E.1.3.8.1 `zenava callcenter area-code batch-get`
批量查询号码归属地
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --tels | text | 是 | — | 手机号，逗号分隔，最多 500 |

###### E.1.3.8.2 `zenava callcenter area-code get`
查询号码归属地
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --tel | text | 是 | — | 11 位手机号 |
| --area-code | text | 否 | — | 区号（可选；与 tel 同时存在时平台按手机号查询） |

###### E.1.3.9 `zenava callcenter asr`
ASR 语音转写结果查询
**子命令：** `get`
本级命令无专属参数。

###### E.1.3.9.1 `zenava callcenter asr get`
查询 ASR 任务结果（result=-2 表示转写中）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --call-type | integer | 是 | — | 1 呼入 2 webcall 4 预览外呼 5 预测外呼 6 主叫外呼 9 内部呼叫 |
| --main-unique-id | text | 是 | — | 主通道唯一标识 |
| --all | boolean | 否 | false | 按 beginTime 返回两侧文本 |

###### E.1.3.10 `zenava callcenter asr-context`
ASR 上下文
**子命令：** `create`、`delete`、`list`、`update`
本级命令无专属参数。

###### E.1.3.10.1 `zenava callcenter asr-context create`
新增 ASR 上下文。同名新建失败，且不覆盖已有记录
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --content | text | 否 | — | 内容，最长 2000；未传则 JSON 不含该键。 |
| --name | text | 是 | — | 名称，1–64。同名新建失败且不覆盖 |

###### E.1.3.10.2 `zenava callcenter asr-context delete`
删除 ASR 上下文
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ids | text | 是 | — | 上下文 ID 列表，英文逗号分隔整数。 |

###### E.1.3.10.3 `zenava callcenter asr-context list`
获取 ASR 上下文列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --limit | integer | 否 | — | 每页条数。默认 10，小于等于 0 时按 10，最大 1000 |
| --offset | integer | 否 | — | 偏移量。默认 0，小于 0 时按 0 处理 |
| --name | text | 否 | — | 按名称过滤；最长 1–64 |

###### E.1.3.10.4 `zenava callcenter asr-context update`
更新 ASR 上下文。未传的名称或内容保持不变
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --content | text | 否 | — | 新内容，最长 2000；未传则不改。 |
| --name | text | 否 | — | 新名称，1–64；未传则不改。 |
| --id | integer | 是 | — | 上下文 ID |

###### E.1.3.11 `zenava callcenter asr-replacement`
纠错词。一条记录是一个正确词，以及应改写成该词的错误词。保存后自动生效，没有单独的发布命令
**子命令：** `copy`、`create`、`delete`、`list`、`paste`、`update`
本级命令无专属参数。

###### E.1.3.11.1 `zenava callcenter asr-replacement copy`
导出纠错词文本。不传 ID 时导出当前企业最多 1000 条
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ids | text | 否 | — | 纠错词 ID，英文逗号分隔；不传则导出当前企业最多 1000 条 |

###### E.1.3.11.2 `zenava callcenter asr-replacement create`
新增纠错词。保存后自动生效
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --targets | text | 是 | — | 错误词列表，英文逗号分隔，个数 1–100。加权长度须为 1–30（汉字=3，字母/数字=1，其它=0）；由远端校验 |
| --replacement | text | 是 | — | 正确词。加权长度须为 1–30（汉字=3，字母/数字=1，其它=0）；由远端校验 |

###### E.1.3.11.3 `zenava callcenter asr-replacement delete`
删除纠错词
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ids | text | 是 | — | 待删除纠错词 ID，英文逗号分隔 |

###### E.1.3.11.4 `zenava callcenter asr-replacement list`
获取纠错词列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --limit | integer | 否 | — | 每页条数。默认 10，小于等于 0 时按 10，最大 1000 |
| --offset | integer | 否 | — | 偏移量。默认 0，小于 0 时按 0 处理 |
| --target | text | 否 | — | 按错误词过滤 |
| --replacement | text | 否 | — | 按正确词过滤 |

###### E.1.3.11.5 `zenava callcenter asr-replacement paste`
按行粘贴纠错词。每行写作「正确词:错误词1,错误词2」，冒号和逗号可用中文或英文。整段不按逗号拆开。保存后自动生效
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --text | text | 是 | — | RequestBody 示例：{"text":"天润：天润融通，天润云\n润通:润通，runtong\n"}。每行 正确词：错误1，错误2（兼容英文冒号/逗号）；--text 整段不按逗号拆数组。 |

###### E.1.3.11.6 `zenava callcenter asr-replacement update`
更新一条纠错词的错误词。不能用本命令修改正确词
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --targets | text | 是 | — | 新的错误词列表，英文逗号分隔。不能通过本命令改正确词 replacement。加权长度须为 1–30（汉字=3，字母/数字=1，其它=0）；由远端校验 |
| --id | integer | 是 | — | 纠错词 ID |

###### E.1.3.12 `zenava callcenter asr-vocab`
热词。新增、修改、删除和粘贴只保存，不自动进入识别；发布使用 `publish`
**子命令：** `copy`、`create`、`delete`、`list`、`paste`、`publish`、`update`
本级命令无专属参数。

###### E.1.3.12.1 `zenava callcenter asr-vocab copy`
导出热词文本，每条为「热词,权重」。不传 ID 时导出当前企业最多 1000 条
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ids | text | 否 | — | 热词 ID，英文逗号分隔；不传则导出当前企业最多 1000 条 |

###### E.1.3.12.2 `zenava callcenter asr-vocab create`
新增热词。只保存，不自动发布
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --weight | integer | 否 | — | 全量同一权重；与 --weights 至少传其一。权重，整数，要求 1–10 |
| --weights | text | 否 | — | 与 vocabs 对应的权重，英文逗号分隔整数；与 --weight 至少传其一。权重，整数，要求 1–10 |
| --vocabs | text | 是 | — | 热词文本，英文逗号分隔 |

###### E.1.3.12.3 `zenava callcenter asr-vocab delete`
删除热词。只保存，不自动发布
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ids | text | 是 | — | 待删除热词 ID，英文逗号分隔 |

###### E.1.3.12.4 `zenava callcenter asr-vocab list`
获取热词列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --limit | integer | 否 | — | 每页条数 |
| --offset | integer | 否 | — | 偏移量 |
| --weight | integer | 否 | — | 权重，整数，要求 1–10 |
| --vocab | text | 否 | — | 按热词文本过滤 |

###### E.1.3.12.5 `zenava callcenter asr-vocab paste`
按行粘贴热词。每行写作「热词,权重」或「热词，权重」。整段不按逗号拆开。只保存，不自动发布
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --text | text | 是 | — | RequestBody 示例：{"text":"奥迪A六,10\n置换补贴，4\n"}。每行 词,权重 或 词，权重；--text 整段不按逗号拆数组。 |

###### E.1.3.12.6 `zenava callcenter asr-vocab publish`
将已保存的热词发布到语音识别。本命令无业务参数

###### E.1.3.12.7 `zenava callcenter asr-vocab update`
更新热词。只保存，不自动发布
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --weights | text | 否 | — | 新权重，英文逗号分隔；整列可省略。权重，整数，要求 1–10 |
| --vocabs | text | 否 | — | 新热词文本，英文逗号分隔；整列可省略 |
| --ids | text | 是 | — | 热词 ID，英文逗号分隔 |

###### E.1.3.13 `zenava callcenter cdr`
通话记录：任务话单与来电/外呼/webcall/sip/预测外呼等话单查询
**子命令：** `ib-agent-list`、`ib-copy`、`ib-detail`、`ib-detail-copy`、`ib-get`、`ib-intelligent-agent-list`、`ib-ivr`、`ib-list`、`ib-query`、`intelligent-agent-detail`、`intelligent-agent-list`、`list-auto-task`、`ob-copy`、`ob-detail`、`ob-get`、`ob-internal-detail`、`ob-internal-list`、`ob-list`、`ob-query`、`predictive-call-query`、`sip-query`、`webcall-list`、`webcall-query`
本级命令无专属参数。

###### E.1.3.13.1 `zenava callcenter cdr ib-agent-list`
查询座席接听记录
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --offset | integer | 否 | — | 偏移量，范围 0-99990，默认 0；limit+offset 不超过 100000 |
| --limit | integer | 否 | — | 查询条数，范围 10-100，默认 10；limit+offset 不超过 100000 |
| --scroll-search | boolean | 否 | false | 是否滚动查询，默认 false；传此 flag 表示 true |
| --scroll-id | text | 否 | — | 滚动查询 ID；配合 --scroll-search，首次可不传；空表示滚动结束 |
| --start-time | integer | 否 | — | 开始时间，Unix 秒；默认当月第一天；与 --start-time-end 跨度不超过一个月 |
| --start-time-end | integer | 否 | — | 开始时间截止，Unix 秒；默认当前时间 |
| --answer-time | integer | 否 | — | 系统应答时间，Unix 秒 |
| --answer-time-end | integer | 否 | — | 系统应答时间截止，Unix 秒 |
| --up-time | integer | 否 | — | 客户接听时间，Unix 秒 |
| --up-time-end | integer | 否 | — | 客户接听时间截止，Unix 秒 |
| --bridge-time | integer | 否 | — | 接听时间，Unix 秒 |
| --bridge-time-end | integer | 否 | — | 接听时间截止，Unix 秒 |
| --end-time | integer | 否 | — | 结束时间，Unix 秒 |
| --end-time-end | integer | 否 | — | 结束时间截止，Unix 秒 |
| --hidden-type | integer | 否 | — | 号码隐藏：0 不隐藏，1 中间四位，2 最后八位，3 全部，4 最后四位；默认 0 |
| --bridge-duration | integer | 否 | — | 通话时长范围最小值（秒），与 --bridge-duration-end 配合 |
| --bridge-duration-end | integer | 否 | — | 通话时长范围最大值（秒） |
| --total-duration | integer | 否 | — | 总时长范围最小值（秒），与 --total-duration-end 配合 |
| --total-duration-end | integer | 否 | — | 总时长范围最大值（秒） |
| --cnos | text | 否 | — | 座席号，逗号分隔 |
| --qnos | text | 否 | — | 队列号，逗号分隔 |
| --cno | text | 否 | — | 座席号，逗号分隔 |
| --qno | text | 否 | — | 队列号，逗号分隔 |
| --first-call-cno | text | 否 | — | 首呼座席，逗号分隔 |
| --first-call-qno | text | 否 | — | 首呼队列，逗号分隔 |
| --first-call-number | text | 否 | — | 首呼座席电话 |
| --client-number | text | 否 | — | 座席电话 |
| --customer-number | text | 否 | — | 客户号码 |
| --customer-number-match-type | integer | 否 | — | 号码匹配：0 精确，1 前缀，2 后缀，3 包含；需与 --customer-number 配合 |
| --hotlines | text | 否 | — | 热线号码，逗号分隔 |
| --hotline-name | text | 否 | — | 热线别名 |
| --ivr-ids | text | 否 | — | IVR Id，逗号分隔 |
| --xnumber | text | 否 | — | 虚拟号码，逗号分隔 |
| --statuses | text | 否 | — | 接听状态（来电）：1 人工接听，2 人工未接听，3 系统应答，4 系统未应答；默认全部；逗号分隔（WebCall 枚举不同，见文档） |
| --status | text | 否 | — | 接听状态（外呼）：1 客户未接听，2 座席未接听，3 客户接听，4 座席接听；默认全部；逗号分隔（机器人列表为机器人接听状态） |
| --status-result | text | 否 | — | 呼叫结果，配合人工未接听/系统应答级联：1 已进入留言，2 客户速挂，3 座席拒接，4 振铃未接，8 IVR中放弃，9 已进IVR，10 未进IVR，11 队列中放弃，12 队列中溢出；默认全部 |
| --on-hook-source | text | 否 | — | 挂断方，默认全部（见文档通用字段） |
| --call-remember | text | 否 | — | 主叫记忆：1 外呼主叫记忆，2 来电主叫记忆；默认全部 |
| --status-robot | text | 否 | — | 机器人接听状态：1 未应答，2 应答 |
| --investigation-keys | integer | 否 | — | 满意度评价 |
| --province | text | 否 | — | 客户归属地省份 |
| --city | text | 否 | — | 客户归属地城市 |
| --agent-answer-in-time | integer | 否 | — | 首次及时应答：0 否，1 是；默认全部 |
| --evaluation | integer | 否 | — | 是否邀评：0 否，1 是；默认全部 |
| --evaluation-solve-result | text | 否 | — | 会话评估是否解决：0 未解决，1 已解决；默认全部 |
| --user-field | text | 否 | — | 自定义字段 |
| --user-value | text | 否 | — | 自定义字段值，与 --user-field 配合 |
| --customer-mos | text | 否 | — | 客户侧通话质量 1-4（较差到优秀），逗号分隔 |
| --agent-mos | text | 否 | — | 座席侧通话质量 1-4（较差到优秀），逗号分隔 |
| --main-unique-id | text | 否 | — | 通话记录唯一标识 |
| --exist-ticket | integer | 否 | — | 工单：0 无，1 有；默认全部 |
| --exist-business | integer | 否 | — | 业务记录：0 无，1 有；默认全部 |
| --is-rtc-call | integer | 否 | — | 是否 RTC 通话：1 是，0 否；默认全部 |
| --bind-types | text | 否 | — | 接听设备：1 手机，2 IP话机，3 软电话；默认全部 |
| --detail-call-type | text | 否 | — | 呼叫类型，默认全部（见文档通用字段） |
| --bridge-status | text | 否 | — | 接听状态：0 人工未接听，1 人工接听；默认全部 |
| --bridge-status-detail | text | 否 | — | 人工未接听原因：2 座席拒接，3 振铃未接；默认全部 |
| --display-numbers | text | 否 | — | 呼转外显号码，逗号分隔 |
| --sip-cause-code | integer | 否 | — | SIP 状态码 |
| --call-type | text | 否 | — | 通话类型：4 预览外呼，6 主叫外呼；默认全部 |
| --left-clid | text | 否 | — | 外显号码，逗号分隔 |
| --sip-cause-type | text | 否 | — | 呼叫结果：0 呼叫成功，1 呼叫失败，2 线路故障，3 线路风控；默认全部 |
| --sip-cause | text | 否 | — | 呼叫失败原因（与 --sip-cause-type 级联）：-700 客户无人接听，710 客户占线，712 客户拒接，713 号码空号，714 号码关机，715 号码暂无法接听，716 号码停机；默认全部 |
| --sip-cause-raw | text | 否 | — | 被叫状态：710 客户占线，711 呼叫超时，712 客户拒接，713 号码空号，714 关机，715 号码暂无法接听，716 号码停机，717 呼叫受限，718 无人接听，719 正在通话中，720 暂停服务，721 来电提醒，722 不再使用，723 来电助手，724 号码格式不正确；默认全部 |
| --request-unique-id | text | 否 | — | 请求唯一 ID |
| --task-name | text | 否 | — | 外呼任务名称 |
| --clid | text | 否 | — | 外显号码，逗号分隔 |
| --callee-display-numbers | text | 否 | — | 转接外显号码，逗号分隔 |
| --degrade | integer | 否 | — | 是否呼叫降级：1 是，0 否；默认全部 |
| --trunk-group-key | text | 否 | — | 中继组号 |
| --field-to-sort | text | 否 | — | 排序字段，默认 cdrStartTime |
| --sort-desc | boolean | 否 | — | 排序：true 倒序，false 正序；默认 true |
| --call-intention | text | 否 | — | 进线意图 |
| --frequent-intention | text | 否 | — | 高频意图 |
| --intention-tag | text | 否 | — | 意向标签 |
| --solve | integer | 否 | — | 是否解决 |
| --first-ib-status | integer | 否 | — | 首次来电 |
| --first-ib-solve-status | integer | 否 | — | 首次来电解决 |
| --transfer-reason | text | 否 | — | 转人工原因 |
| --review-status | integer | 否 | — | 审阅状态：0 未读，1 已读 |
| --bot-ids | text | 否 | — | 机器人 ID，逗号分隔 |
| --round | integer | 否 | — | 对话轮次范围最小值，与 --round-end 配合 |
| --round-end | integer | 否 | — | 对话轮次范围最大值 |
| --interrupt-count | integer | 否 | — | 打断次数范围最小值，与 --interrupt-count-end 配合 |
| --interrupt-count-end | integer | 否 | — | 打断次数范围最大值 |
| --transfer | integer | 否 | — | 是否转人工：1 是，0 否；默认全部 |
| --transfer-bridge | text | 否 | — | 转人工接听状态，逗号分隔 |
| --task-id | text | 否 | — | 任务 ID，逗号分隔 |
| --greeting | integer | 否 | — | 开场白挂断点范围最小值，与 --greeting-end 配合 |
| --greeting-end | integer | 否 | — | 开场白挂断点范围最大值 |
| --end-flow | text | 否 | — | 流程挂断点 |
| --info | text | 否 | — | 信息捕获 |
| --ab-task-group-name | text | 否 | — | AB 测试组名 |
| --business-tag-names | text | 否 | — | 业务标签名称，逗号分隔 |

###### E.1.3.13.2 `zenava callcenter cdr ib-copy`
来电通话记录同步
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 数据表主键游标 |
| --month | text | 是 | — | yyyyMM |
| --limit | integer | 否 | 10 | 分页大小 |
| --user-field-key | text | 否 | — | 自定义字段名 |
| --user-field-value | text | 否 | — | 自定义字段值 |
| --return-count | integer | 否 | — | 0 不返回总条数 1 返回 [default: 1] |

###### E.1.3.13.3 `zenava callcenter cdr ib-detail`
查询客户来电记录详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --hidden-type | integer | 否 | — | 号码隐藏：0 不隐藏，1 中间四位，2 最后八位，3 全部，4 最后四位；默认 0 |
| --main-unique-id | text | 是 | — | 通话记录唯一标识 |

###### E.1.3.13.4 `zenava callcenter cdr ib-detail-copy`
来电通话记录详情同步
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 数据表主键游标 |
| --month | text | 是 | — | yyyyMM |
| --limit | integer | 否 | 10 | 分页大小 |
| --status | integer | 否 | — | 0 座席未接听/接听未桥接 1 呼叫失败 2 接听 |
| --user-field-key | text | 否 | — | 自定义字段名 |
| --user-field-value | text | 否 | — | 自定义字段值 |
| --return-count | integer | 否 | — | 0 不返回总条数 1 返回 [default: 1] |

###### E.1.3.13.5 `zenava callcenter cdr ib-get`
来电通话记录详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --unique-id | text | 是 | — | 通话唯一标识 |

###### E.1.3.13.6 `zenava callcenter cdr ib-intelligent-agent-list`
查询呼入机器人记录
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --offset | integer | 否 | — | 偏移量，范围 0-99990，默认 0；limit+offset 不超过 100000 |
| --limit | integer | 否 | — | 查询条数，范围 10-100，默认 10；limit+offset 不超过 100000 |
| --scroll-search | boolean | 否 | false | 是否滚动查询，默认 false；传此 flag 表示 true |
| --scroll-id | text | 否 | — | 滚动查询 ID；配合 --scroll-search，首次可不传；空表示滚动结束 |
| --start-time | integer | 否 | — | 开始时间，Unix 秒；默认当月第一天；与 --start-time-end 跨度不超过一个月 |
| --start-time-end | integer | 否 | — | 开始时间截止，Unix 秒；默认当前时间 |
| --answer-time | integer | 否 | — | 系统应答时间，Unix 秒 |
| --answer-time-end | integer | 否 | — | 系统应答时间截止，Unix 秒 |
| --up-time | integer | 否 | — | 客户接听时间，Unix 秒 |
| --up-time-end | integer | 否 | — | 客户接听时间截止，Unix 秒 |
| --bridge-time | integer | 否 | — | 接听时间，Unix 秒 |
| --bridge-time-end | integer | 否 | — | 接听时间截止，Unix 秒 |
| --end-time | integer | 否 | — | 结束时间，Unix 秒 |
| --end-time-end | integer | 否 | — | 结束时间截止，Unix 秒 |
| --hidden-type | integer | 否 | — | 号码隐藏：0 不隐藏，1 中间四位，2 最后八位，3 全部，4 最后四位；默认 0 |
| --bridge-duration | integer | 否 | — | 通话时长范围最小值（秒），与 --bridge-duration-end 配合 |
| --bridge-duration-end | integer | 否 | — | 通话时长范围最大值（秒） |
| --total-duration | integer | 否 | — | 总时长范围最小值（秒），与 --total-duration-end 配合 |
| --total-duration-end | integer | 否 | — | 总时长范围最大值（秒） |
| --cnos | text | 否 | — | 座席号，逗号分隔 |
| --qnos | text | 否 | — | 队列号，逗号分隔 |
| --cno | text | 否 | — | 座席号，逗号分隔 |
| --qno | text | 否 | — | 队列号，逗号分隔 |
| --first-call-cno | text | 否 | — | 首呼座席，逗号分隔 |
| --first-call-qno | text | 否 | — | 首呼队列，逗号分隔 |
| --first-call-number | text | 否 | — | 首呼座席电话 |
| --client-number | text | 否 | — | 座席电话 |
| --customer-number | text | 否 | — | 客户号码 |
| --customer-number-match-type | integer | 否 | — | 号码匹配：0 精确，1 前缀，2 后缀，3 包含；需与 --customer-number 配合 |
| --hotlines | text | 否 | — | 热线号码，逗号分隔 |
| --hotline-name | text | 否 | — | 热线别名 |
| --ivr-ids | text | 否 | — | IVR Id，逗号分隔 |
| --xnumber | text | 否 | — | 虚拟号码，逗号分隔 |
| --statuses | text | 否 | — | 接听状态（来电）：1 人工接听，2 人工未接听，3 系统应答，4 系统未应答；默认全部；逗号分隔（WebCall 枚举不同，见文档） |
| --status | text | 否 | — | 接听状态（外呼）：1 客户未接听，2 座席未接听，3 客户接听，4 座席接听；默认全部；逗号分隔（机器人列表为机器人接听状态） |
| --status-result | text | 否 | — | 呼叫结果，配合人工未接听/系统应答级联：1 已进入留言，2 客户速挂，3 座席拒接，4 振铃未接，8 IVR中放弃，9 已进IVR，10 未进IVR，11 队列中放弃，12 队列中溢出；默认全部 |
| --on-hook-source | text | 否 | — | 挂断方，默认全部（见文档通用字段） |
| --call-remember | text | 否 | — | 主叫记忆：1 外呼主叫记忆，2 来电主叫记忆；默认全部 |
| --status-robot | text | 否 | — | 机器人接听状态：1 未应答，2 应答 |
| --investigation-keys | integer | 否 | — | 满意度评价 |
| --province | text | 否 | — | 客户归属地省份 |
| --city | text | 否 | — | 客户归属地城市 |
| --agent-answer-in-time | integer | 否 | — | 首次及时应答：0 否，1 是；默认全部 |
| --evaluation | integer | 否 | — | 是否邀评：0 否，1 是；默认全部 |
| --evaluation-solve-result | text | 否 | — | 会话评估是否解决：0 未解决，1 已解决；默认全部 |
| --user-field | text | 否 | — | 自定义字段 |
| --user-value | text | 否 | — | 自定义字段值，与 --user-field 配合 |
| --customer-mos | text | 否 | — | 客户侧通话质量 1-4（较差到优秀），逗号分隔 |
| --agent-mos | text | 否 | — | 座席侧通话质量 1-4（较差到优秀），逗号分隔 |
| --main-unique-id | text | 否 | — | 通话记录唯一标识 |
| --exist-ticket | integer | 否 | — | 工单：0 无，1 有；默认全部 |
| --exist-business | integer | 否 | — | 业务记录：0 无，1 有；默认全部 |
| --is-rtc-call | integer | 否 | — | 是否 RTC 通话：1 是，0 否；默认全部 |
| --bind-types | text | 否 | — | 接听设备：1 手机，2 IP话机，3 软电话；默认全部 |
| --detail-call-type | text | 否 | — | 呼叫类型，默认全部（见文档通用字段） |
| --bridge-status | text | 否 | — | 接听状态：0 人工未接听，1 人工接听；默认全部 |
| --bridge-status-detail | text | 否 | — | 人工未接听原因：2 座席拒接，3 振铃未接；默认全部 |
| --display-numbers | text | 否 | — | 呼转外显号码，逗号分隔 |
| --sip-cause-code | integer | 否 | — | SIP 状态码 |
| --call-type | text | 否 | — | 通话类型：4 预览外呼，6 主叫外呼；默认全部 |
| --left-clid | text | 否 | — | 外显号码，逗号分隔 |
| --sip-cause-type | text | 否 | — | 呼叫结果：0 呼叫成功，1 呼叫失败，2 线路故障，3 线路风控；默认全部 |
| --sip-cause | text | 否 | — | 呼叫失败原因（与 --sip-cause-type 级联）：-700 客户无人接听，710 客户占线，712 客户拒接，713 号码空号，714 号码关机，715 号码暂无法接听，716 号码停机；默认全部 |
| --sip-cause-raw | text | 否 | — | 被叫状态：710 客户占线，711 呼叫超时，712 客户拒接，713 号码空号，714 关机，715 号码暂无法接听，716 号码停机，717 呼叫受限，718 无人接听，719 正在通话中，720 暂停服务，721 来电提醒，722 不再使用，723 来电助手，724 号码格式不正确；默认全部 |
| --request-unique-id | text | 否 | — | 请求唯一 ID |
| --task-name | text | 否 | — | 外呼任务名称 |
| --clid | text | 否 | — | 外显号码，逗号分隔 |
| --callee-display-numbers | text | 否 | — | 转接外显号码，逗号分隔 |
| --degrade | integer | 否 | — | 是否呼叫降级：1 是，0 否；默认全部 |
| --trunk-group-key | text | 否 | — | 中继组号 |
| --field-to-sort | text | 否 | — | 排序字段，默认 cdrStartTime |
| --sort-desc | boolean | 否 | — | 排序：true 倒序，false 正序；默认 true |
| --call-intention | text | 否 | — | 进线意图 |
| --frequent-intention | text | 否 | — | 高频意图 |
| --intention-tag | text | 否 | — | 意向标签 |
| --solve | integer | 否 | — | 是否解决 |
| --first-ib-status | integer | 否 | — | 首次来电 |
| --first-ib-solve-status | integer | 否 | — | 首次来电解决 |
| --transfer-reason | text | 否 | — | 转人工原因 |
| --review-status | integer | 否 | — | 审阅状态：0 未读，1 已读 |
| --bot-ids | text | 否 | — | 机器人 ID，逗号分隔 |
| --round | integer | 否 | — | 对话轮次范围最小值，与 --round-end 配合 |
| --round-end | integer | 否 | — | 对话轮次范围最大值 |
| --interrupt-count | integer | 否 | — | 打断次数范围最小值，与 --interrupt-count-end 配合 |
| --interrupt-count-end | integer | 否 | — | 打断次数范围最大值 |
| --transfer | integer | 否 | — | 是否转人工：1 是，0 否；默认全部 |
| --transfer-bridge | text | 否 | — | 转人工接听状态，逗号分隔 |
| --task-id | text | 否 | — | 任务 ID，逗号分隔 |
| --greeting | integer | 否 | — | 开场白挂断点范围最小值，与 --greeting-end 配合 |
| --greeting-end | integer | 否 | — | 开场白挂断点范围最大值 |
| --end-flow | text | 否 | — | 流程挂断点 |
| --info | text | 否 | — | 信息捕获 |
| --ab-task-group-name | text | 否 | — | AB 测试组名 |
| --business-tag-names | text | 否 | — | 业务标签名称，逗号分隔 |

###### E.1.3.13.7 `zenava callcenter cdr ib-ivr`
来电通话记录 IVR 详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --unique-id | text | 是 | — | 通话唯一标识 |

###### E.1.3.13.8 `zenava callcenter cdr ib-list`
查询客户来电记录
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --offset | integer | 否 | — | 偏移量，范围 0-99990，默认 0；limit+offset 不超过 100000 |
| --limit | integer | 否 | — | 查询条数，范围 10-100，默认 10；limit+offset 不超过 100000 |
| --scroll-search | boolean | 否 | false | 是否滚动查询，默认 false；传此 flag 表示 true |
| --scroll-id | text | 否 | — | 滚动查询 ID；配合 --scroll-search，首次可不传；空表示滚动结束 |
| --start-time | integer | 否 | — | 开始时间，Unix 秒；默认当月第一天；与 --start-time-end 跨度不超过一个月 |
| --start-time-end | integer | 否 | — | 开始时间截止，Unix 秒；默认当前时间 |
| --answer-time | integer | 否 | — | 系统应答时间，Unix 秒 |
| --answer-time-end | integer | 否 | — | 系统应答时间截止，Unix 秒 |
| --up-time | integer | 否 | — | 客户接听时间，Unix 秒 |
| --up-time-end | integer | 否 | — | 客户接听时间截止，Unix 秒 |
| --bridge-time | integer | 否 | — | 接听时间，Unix 秒 |
| --bridge-time-end | integer | 否 | — | 接听时间截止，Unix 秒 |
| --end-time | integer | 否 | — | 结束时间，Unix 秒 |
| --end-time-end | integer | 否 | — | 结束时间截止，Unix 秒 |
| --hidden-type | integer | 否 | — | 号码隐藏：0 不隐藏，1 中间四位，2 最后八位，3 全部，4 最后四位；默认 0 |
| --bridge-duration | integer | 否 | — | 通话时长范围最小值（秒），与 --bridge-duration-end 配合 |
| --bridge-duration-end | integer | 否 | — | 通话时长范围最大值（秒） |
| --total-duration | integer | 否 | — | 总时长范围最小值（秒），与 --total-duration-end 配合 |
| --total-duration-end | integer | 否 | — | 总时长范围最大值（秒） |
| --cnos | text | 否 | — | 座席号，逗号分隔 |
| --qnos | text | 否 | — | 队列号，逗号分隔 |
| --cno | text | 否 | — | 座席号，逗号分隔 |
| --qno | text | 否 | — | 队列号，逗号分隔 |
| --first-call-cno | text | 否 | — | 首呼座席，逗号分隔 |
| --first-call-qno | text | 否 | — | 首呼队列，逗号分隔 |
| --first-call-number | text | 否 | — | 首呼座席电话 |
| --client-number | text | 否 | — | 座席电话 |
| --customer-number | text | 否 | — | 客户号码 |
| --customer-number-match-type | integer | 否 | — | 号码匹配：0 精确，1 前缀，2 后缀，3 包含；需与 --customer-number 配合 |
| --hotlines | text | 否 | — | 热线号码，逗号分隔 |
| --hotline-name | text | 否 | — | 热线别名 |
| --ivr-ids | text | 否 | — | IVR Id，逗号分隔 |
| --xnumber | text | 否 | — | 虚拟号码，逗号分隔 |
| --statuses | text | 否 | — | 接听状态（来电）：1 人工接听，2 人工未接听，3 系统应答，4 系统未应答；默认全部；逗号分隔（WebCall 枚举不同，见文档） |
| --status | text | 否 | — | 接听状态（外呼）：1 客户未接听，2 座席未接听，3 客户接听，4 座席接听；默认全部；逗号分隔（机器人列表为机器人接听状态） |
| --status-result | text | 否 | — | 呼叫结果，配合人工未接听/系统应答级联：1 已进入留言，2 客户速挂，3 座席拒接，4 振铃未接，8 IVR中放弃，9 已进IVR，10 未进IVR，11 队列中放弃，12 队列中溢出；默认全部 |
| --on-hook-source | text | 否 | — | 挂断方，默认全部（见文档通用字段） |
| --call-remember | text | 否 | — | 主叫记忆：1 外呼主叫记忆，2 来电主叫记忆；默认全部 |
| --status-robot | text | 否 | — | 机器人接听状态：1 未应答，2 应答 |
| --investigation-keys | integer | 否 | — | 满意度评价 |
| --province | text | 否 | — | 客户归属地省份 |
| --city | text | 否 | — | 客户归属地城市 |
| --agent-answer-in-time | integer | 否 | — | 首次及时应答：0 否，1 是；默认全部 |
| --evaluation | integer | 否 | — | 是否邀评：0 否，1 是；默认全部 |
| --evaluation-solve-result | text | 否 | — | 会话评估是否解决：0 未解决，1 已解决；默认全部 |
| --user-field | text | 否 | — | 自定义字段 |
| --user-value | text | 否 | — | 自定义字段值，与 --user-field 配合 |
| --customer-mos | text | 否 | — | 客户侧通话质量 1-4（较差到优秀），逗号分隔 |
| --agent-mos | text | 否 | — | 座席侧通话质量 1-4（较差到优秀），逗号分隔 |
| --main-unique-id | text | 否 | — | 通话记录唯一标识 |
| --exist-ticket | integer | 否 | — | 工单：0 无，1 有；默认全部 |
| --exist-business | integer | 否 | — | 业务记录：0 无，1 有；默认全部 |
| --is-rtc-call | integer | 否 | — | 是否 RTC 通话：1 是，0 否；默认全部 |
| --bind-types | text | 否 | — | 接听设备：1 手机，2 IP话机，3 软电话；默认全部 |
| --detail-call-type | text | 否 | — | 呼叫类型，默认全部（见文档通用字段） |
| --bridge-status | text | 否 | — | 接听状态：0 人工未接听，1 人工接听；默认全部 |
| --bridge-status-detail | text | 否 | — | 人工未接听原因：2 座席拒接，3 振铃未接；默认全部 |
| --display-numbers | text | 否 | — | 呼转外显号码，逗号分隔 |
| --sip-cause-code | integer | 否 | — | SIP 状态码 |
| --call-type | text | 否 | — | 通话类型：4 预览外呼，6 主叫外呼；默认全部 |
| --left-clid | text | 否 | — | 外显号码，逗号分隔 |
| --sip-cause-type | text | 否 | — | 呼叫结果：0 呼叫成功，1 呼叫失败，2 线路故障，3 线路风控；默认全部 |
| --sip-cause | text | 否 | — | 呼叫失败原因（与 --sip-cause-type 级联）：-700 客户无人接听，710 客户占线，712 客户拒接，713 号码空号，714 号码关机，715 号码暂无法接听，716 号码停机；默认全部 |
| --sip-cause-raw | text | 否 | — | 被叫状态：710 客户占线，711 呼叫超时，712 客户拒接，713 号码空号，714 关机，715 号码暂无法接听，716 号码停机，717 呼叫受限，718 无人接听，719 正在通话中，720 暂停服务，721 来电提醒，722 不再使用，723 来电助手，724 号码格式不正确；默认全部 |
| --request-unique-id | text | 否 | — | 请求唯一 ID |
| --task-name | text | 否 | — | 外呼任务名称 |
| --clid | text | 否 | — | 外显号码，逗号分隔 |
| --callee-display-numbers | text | 否 | — | 转接外显号码，逗号分隔 |
| --degrade | integer | 否 | — | 是否呼叫降级：1 是，0 否；默认全部 |
| --trunk-group-key | text | 否 | — | 中继组号 |
| --field-to-sort | text | 否 | — | 排序字段，默认 cdrStartTime |
| --sort-desc | boolean | 否 | — | 排序：true 倒序，false 正序；默认 true |
| --call-intention | text | 否 | — | 进线意图 |
| --frequent-intention | text | 否 | — | 高频意图 |
| --intention-tag | text | 否 | — | 意向标签 |
| --solve | integer | 否 | — | 是否解决 |
| --first-ib-status | integer | 否 | — | 首次来电 |
| --first-ib-solve-status | integer | 否 | — | 首次来电解决 |
| --transfer-reason | text | 否 | — | 转人工原因 |
| --review-status | integer | 否 | — | 审阅状态：0 未读，1 已读 |
| --bot-ids | text | 否 | — | 机器人 ID，逗号分隔 |
| --round | integer | 否 | — | 对话轮次范围最小值，与 --round-end 配合 |
| --round-end | integer | 否 | — | 对话轮次范围最大值 |
| --interrupt-count | integer | 否 | — | 打断次数范围最小值，与 --interrupt-count-end 配合 |
| --interrupt-count-end | integer | 否 | — | 打断次数范围最大值 |
| --transfer | integer | 否 | — | 是否转人工：1 是，0 否；默认全部 |
| --transfer-bridge | text | 否 | — | 转人工接听状态，逗号分隔 |
| --task-id | text | 否 | — | 任务 ID，逗号分隔 |
| --greeting | integer | 否 | — | 开场白挂断点范围最小值，与 --greeting-end 配合 |
| --greeting-end | integer | 否 | — | 开场白挂断点范围最大值 |
| --end-flow | text | 否 | — | 流程挂断点 |
| --info | text | 否 | — | 信息捕获 |
| --ab-task-group-name | text | 否 | — | AB 测试组名 |
| --business-tag-names | text | 否 | — | 业务标签名称，逗号分隔 |

###### E.1.3.13.9 `zenava callcenter cdr ib-query`
来电通话记录查询
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --unique-id | text | 否 | — | 通话唯一标识 |
| --province | text | 否 | — | 省份 |
| --city | text | 否 | — | 城市 |
| --time-range-type | integer | 否 | 1 | 1 呼叫开始时间 2 呼叫结束时间 |
| --start-time | integer | 否 | — | 开始时间 Unix 秒 |
| --end-time | integer | 否 | — | 结束时间 Unix 秒 |
| --start | integer | 否 | 0 | 分页起始 |
| --limit | integer | 否 | 10 | 分页大小 |
| --user-field-key | text | 否 | — | 自定义字段名 |
| --user-field-value | text | 否 | — | 自定义字段值 |
| --customer-number | text | 否 | — | 客户号码 |
| --cno | text | 否 | — | 座席工号 |
| --status | integer | 否 | — | 1 座席接听 2 已呼叫座席未接 3 系统接听 4 IVR配置错误 5 停机 6 欠费 7 黑名单 8 未注册 9 彩铃 11 超最大限制 12 系统应答前挂机 13 其他错误 14 未进队列 15 队列放弃 16 超时溢出 17 无座席溢出 18 无座席未进队列 19 队列满 |
| --qno | text | 否 | — | 队列号 |
| --leave-queue-code | integer | 否 | — | 2 队列中放弃 3 超时溢出 4 无座席溢出 |
| --join-queue-code | integer | 否 | — | 3 队列满未进入 4 无座席未进入 |
| --agent-number | text | 否 | — | 座席号码 |
| --hotline | text | 否 | — | 热线号码 |

###### E.1.3.13.10 `zenava callcenter cdr intelligent-agent-detail`
查询机器人对话详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --request-id | text | 否 | — | 机器人记录唯一标识，可选 |
| --hidden-type | integer | 否 | — | 号码隐藏：0 不隐藏，1 中间四位，2 最后八位，3 全部，4 最后四位；默认 0 |
| --main-unique-id | text | 是 | — | 通话记录唯一标识 |

###### E.1.3.13.11 `zenava callcenter cdr intelligent-agent-list`
查询机器人对话记录
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --offset | integer | 否 | — | 偏移量，范围 0-99990，默认 0；limit+offset 不超过 100000 |
| --limit | integer | 否 | — | 查询条数，范围 10-100，默认 10；limit+offset 不超过 100000 |
| --scroll-search | boolean | 否 | false | 是否滚动查询，默认 false；传此 flag 表示 true |
| --scroll-id | text | 否 | — | 滚动查询 ID；配合 --scroll-search，首次可不传；空表示滚动结束 |
| --start-time | integer | 否 | — | 开始时间，Unix 秒；默认当月第一天；与 --start-time-end 跨度不超过一个月 |
| --start-time-end | integer | 否 | — | 开始时间截止，Unix 秒；默认当前时间 |
| --answer-time | integer | 否 | — | 系统应答时间，Unix 秒 |
| --answer-time-end | integer | 否 | — | 系统应答时间截止，Unix 秒 |
| --up-time | integer | 否 | — | 客户接听时间，Unix 秒 |
| --up-time-end | integer | 否 | — | 客户接听时间截止，Unix 秒 |
| --bridge-time | integer | 否 | — | 接听时间，Unix 秒 |
| --bridge-time-end | integer | 否 | — | 接听时间截止，Unix 秒 |
| --end-time | integer | 否 | — | 结束时间，Unix 秒 |
| --end-time-end | integer | 否 | — | 结束时间截止，Unix 秒 |
| --hidden-type | integer | 否 | — | 号码隐藏：0 不隐藏，1 中间四位，2 最后八位，3 全部，4 最后四位；默认 0 |
| --bridge-duration | integer | 否 | — | 通话时长范围最小值（秒），与 --bridge-duration-end 配合 |
| --bridge-duration-end | integer | 否 | — | 通话时长范围最大值（秒） |
| --total-duration | integer | 否 | — | 总时长范围最小值（秒），与 --total-duration-end 配合 |
| --total-duration-end | integer | 否 | — | 总时长范围最大值（秒） |
| --cnos | text | 否 | — | 座席号，逗号分隔 |
| --qnos | text | 否 | — | 队列号，逗号分隔 |
| --cno | text | 否 | — | 座席号，逗号分隔 |
| --qno | text | 否 | — | 队列号，逗号分隔 |
| --first-call-cno | text | 否 | — | 首呼座席，逗号分隔 |
| --first-call-qno | text | 否 | — | 首呼队列，逗号分隔 |
| --first-call-number | text | 否 | — | 首呼座席电话 |
| --client-number | text | 否 | — | 座席电话 |
| --customer-number | text | 否 | — | 客户号码 |
| --customer-number-match-type | integer | 否 | — | 号码匹配：0 精确，1 前缀，2 后缀，3 包含；需与 --customer-number 配合 |
| --hotlines | text | 否 | — | 热线号码，逗号分隔 |
| --hotline-name | text | 否 | — | 热线别名 |
| --ivr-ids | text | 否 | — | IVR Id，逗号分隔 |
| --xnumber | text | 否 | — | 虚拟号码，逗号分隔 |
| --statuses | text | 否 | — | 接听状态（来电）：1 人工接听，2 人工未接听，3 系统应答，4 系统未应答；默认全部；逗号分隔（WebCall 枚举不同，见文档） |
| --status | text | 否 | — | 接听状态（外呼）：1 客户未接听，2 座席未接听，3 客户接听，4 座席接听；默认全部；逗号分隔（机器人列表为机器人接听状态） |
| --status-result | text | 否 | — | 呼叫结果，配合人工未接听/系统应答级联：1 已进入留言，2 客户速挂，3 座席拒接，4 振铃未接，8 IVR中放弃，9 已进IVR，10 未进IVR，11 队列中放弃，12 队列中溢出；默认全部 |
| --on-hook-source | text | 否 | — | 挂断方，默认全部（见文档通用字段） |
| --call-remember | text | 否 | — | 主叫记忆：1 外呼主叫记忆，2 来电主叫记忆；默认全部 |
| --status-robot | text | 否 | — | 机器人接听状态：1 未应答，2 应答 |
| --investigation-keys | integer | 否 | — | 满意度评价 |
| --province | text | 否 | — | 客户归属地省份 |
| --city | text | 否 | — | 客户归属地城市 |
| --agent-answer-in-time | integer | 否 | — | 首次及时应答：0 否，1 是；默认全部 |
| --evaluation | integer | 否 | — | 是否邀评：0 否，1 是；默认全部 |
| --evaluation-solve-result | text | 否 | — | 会话评估是否解决：0 未解决，1 已解决；默认全部 |
| --user-field | text | 否 | — | 自定义字段 |
| --user-value | text | 否 | — | 自定义字段值，与 --user-field 配合 |
| --customer-mos | text | 否 | — | 客户侧通话质量 1-4（较差到优秀），逗号分隔 |
| --agent-mos | text | 否 | — | 座席侧通话质量 1-4（较差到优秀），逗号分隔 |
| --main-unique-id | text | 否 | — | 通话记录唯一标识 |
| --exist-ticket | integer | 否 | — | 工单：0 无，1 有；默认全部 |
| --exist-business | integer | 否 | — | 业务记录：0 无，1 有；默认全部 |
| --is-rtc-call | integer | 否 | — | 是否 RTC 通话：1 是，0 否；默认全部 |
| --bind-types | text | 否 | — | 接听设备：1 手机，2 IP话机，3 软电话；默认全部 |
| --detail-call-type | text | 否 | — | 呼叫类型，默认全部（见文档通用字段） |
| --bridge-status | text | 否 | — | 接听状态：0 人工未接听，1 人工接听；默认全部 |
| --bridge-status-detail | text | 否 | — | 人工未接听原因：2 座席拒接，3 振铃未接；默认全部 |
| --display-numbers | text | 否 | — | 呼转外显号码，逗号分隔 |
| --sip-cause-code | integer | 否 | — | SIP 状态码 |
| --call-type | text | 否 | — | 通话类型：4 预览外呼，6 主叫外呼；默认全部 |
| --left-clid | text | 否 | — | 外显号码，逗号分隔 |
| --sip-cause-type | text | 否 | — | 呼叫结果：0 呼叫成功，1 呼叫失败，2 线路故障，3 线路风控；默认全部 |
| --sip-cause | text | 否 | — | 呼叫失败原因（与 --sip-cause-type 级联）：-700 客户无人接听，710 客户占线，712 客户拒接，713 号码空号，714 号码关机，715 号码暂无法接听，716 号码停机；默认全部 |
| --sip-cause-raw | text | 否 | — | 被叫状态：710 客户占线，711 呼叫超时，712 客户拒接，713 号码空号，714 关机，715 号码暂无法接听，716 号码停机，717 呼叫受限，718 无人接听，719 正在通话中，720 暂停服务，721 来电提醒，722 不再使用，723 来电助手，724 号码格式不正确；默认全部 |
| --request-unique-id | text | 否 | — | 请求唯一 ID |
| --task-name | text | 否 | — | 外呼任务名称 |
| --clid | text | 否 | — | 外显号码，逗号分隔 |
| --callee-display-numbers | text | 否 | — | 转接外显号码，逗号分隔 |
| --degrade | integer | 否 | — | 是否呼叫降级：1 是，0 否；默认全部 |
| --trunk-group-key | text | 否 | — | 中继组号 |
| --field-to-sort | text | 否 | — | 排序字段，默认 cdrStartTime |
| --sort-desc | boolean | 否 | — | 排序：true 倒序，false 正序；默认 true |
| --call-intention | text | 否 | — | 进线意图 |
| --frequent-intention | text | 否 | — | 高频意图 |
| --intention-tag | text | 否 | — | 意向标签 |
| --solve | integer | 否 | — | 是否解决 |
| --first-ib-status | integer | 否 | — | 首次来电 |
| --first-ib-solve-status | integer | 否 | — | 首次来电解决 |
| --transfer-reason | text | 否 | — | 转人工原因 |
| --review-status | integer | 否 | — | 审阅状态：0 未读，1 已读 |
| --bot-ids | text | 否 | — | 机器人 ID，逗号分隔 |
| --round | integer | 否 | — | 对话轮次范围最小值，与 --round-end 配合 |
| --round-end | integer | 否 | — | 对话轮次范围最大值 |
| --interrupt-count | integer | 否 | — | 打断次数范围最小值，与 --interrupt-count-end 配合 |
| --interrupt-count-end | integer | 否 | — | 打断次数范围最大值 |
| --transfer | integer | 否 | — | 是否转人工：1 是，0 否；默认全部 |
| --transfer-bridge | text | 否 | — | 转人工接听状态，逗号分隔 |
| --task-id | text | 否 | — | 任务 ID，逗号分隔 |
| --greeting | integer | 否 | — | 开场白挂断点范围最小值，与 --greeting-end 配合 |
| --greeting-end | integer | 否 | — | 开场白挂断点范围最大值 |
| --end-flow | text | 否 | — | 流程挂断点 |
| --info | text | 否 | — | 信息捕获 |
| --ab-task-group-name | text | 否 | — | AB 测试组名 |
| --business-tag-names | text | 否 | — | 业务标签名称，逗号分隔 |

###### E.1.3.13.12 `zenava callcenter cdr list-auto-task`
查询外呼任务呼叫记录列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --all | boolean | 否 | false | 自动翻页拉全量 |
| --limit | integer | 否 | 10 | 每页条数，10–100 |
| --offset | integer | 否 | 0 | 分页偏移（与 limit 之和≤100000） |
| --scroll-id | text | 否 | — | 滚动查询游标（配合 --scroll-search；空表示结束） |
| --scroll-search | boolean | 否 | false | 启用滚动查询 |
| --intelligent-info | text | 否 | — | 信息捕获 |
| --intelligent-intention-tag | text | 否 | — | 意向标签 |
| --intelligent-end-flow | text | 否 | — | 流程挂断点 |
| --intelligent-greeting-end | integer | 否 | — | 开场白挂断点上限 |
| --intelligent-greeting | integer | 否 | — | 开场白挂断点下限 |
| --intelligent-transfer | integer | 否 | — | 0 否 1 转人工 |
| --intelligent-interrupt-count-end | integer | 否 | — | 打断次数上限 |
| --intelligent-interrupt-count | integer | 否 | — | 打断次数下限 |
| --intelligent-round-end | integer | 否 | — | 对话轮次上限 |
| --intelligent-round | integer | 否 | — | 对话轮次下限 |
| --intelligent-status-result | text | 否 | — | 1 正常应答 2 轮次上限 3 机器人异常 4 超并发（逗号分隔） |
| --intelligent-status | text | 否 | — | 1 机器人应答 2 机器人未应答（逗号分隔） |
| --intelligent-bot-ids | text | 否 | — | 机器人 ID，逗号分隔 |
| --intelligent-bridge-duration-end | integer | 否 | — | 机器人通话时长上限（秒） |
| --intelligent-bridge-duration | integer | 否 | — | 机器人通话时长下限（秒） |
| --intelligent-end-time-end | integer | 否 | — | 机器人结束时间止（Unix 秒） |
| --intelligent-end-time | integer | 否 | — | 机器人结束时间起（Unix 秒） |
| --intelligent-bridge-time-end | integer | 否 | — | 机器人接待时间止（Unix 秒） |
| --intelligent-bridge-time | integer | 否 | — | 机器人接待时间起（Unix 秒） |
| --agent-mos | text | 否 | — | 1–4 较差到优秀（逗号分隔） |
| --customer-mos | text | 否 | — | 1–4 较差到优秀（逗号分隔） |
| --user-value | text | 否 | — | 自定义字段值（与 --user-field 配合） |
| --user-field | text | 否 | — | 自定义字段名 |
| --business-tag-names | text | 否 | — | 业务标签，逗号分隔 |
| --finish-retry-flag | integer | 否 | — | 0 否 1 最终呼叫 |
| --ab-task-group-name | text | 否 | — | AB 测试组名 |
| --tel-retry | integer | 否 | — | 0 否 1 重呼 |
| --degrade | integer | 否 | — | 0 否 1 呼叫降级 |
| --ivr-ids | text | 否 | — | IVR ID，逗号分隔 |
| --task-ids | text | 否 | — | 任务 ID，逗号分隔 |
| --evaluation | integer | 否 | — | 0 否 1 邀评 |
| --request-unique-id | text | 否 | — | 请求唯一 ID（非当月查询需带开始时间范围） |
| --main-unique-id | text | 否 | — | 通话记录唯一标识 |
| --city | text | 否 | — | 客户归属地城市 |
| --province | text | 否 | — | 客户归属地省份 |
| --investigation-keys | integer | 否 | — | 满意度评价 |
| --on-hook-source | text | 否 | — | 1000 客户 1001 座席 1002 强拆（逗号分隔） |
| --sip-cause-raw | text | 否 | — | 被叫状态码，逗号分隔 |
| --sip-cause | text | 否 | — | 700 无人接听 710 占线 712 拒接 713 空号 714 关机 715 暂无法接听 716 停机（逗号分隔） |
| --sip-cause-type | text | 否 | — | 0 成功 1 失败 2 线路故障 3 线路风控（逗号分隔） |
| --status | text | 否 | — | 40 客户未接 41 客户接听 42 转人工未接 43 转人工接听（逗号分隔） |
| --xnumber | text | 否 | — | 虚拟号，逗号分隔 |
| --hotlines | text | 否 | — | 外显号，逗号分隔 |
| --customer-number-match-type | integer | 否 | — | 1 前缀 2 后缀 3 包含 |
| --customer-number | text | 否 | — | 客户号码 |
| --client-number | text | 否 | — | 座席电话 |
| --qnos | text | 否 | — | 队列号，逗号分隔 |
| --cnos | text | 否 | — | 座席工号，逗号分隔 |
| --total-duration-end | integer | 否 | — | 总时长上限（秒） |
| --total-duration | integer | 否 | — | 总时长下限（秒） |
| --customer-bridge-duration-end | integer | 否 | — | 客户接听时长上限（秒） |
| --customer-bridge-duration | integer | 否 | — | 客户接听时长下限（秒） |
| --hidden-type | integer | 否 | — | 0 不隐藏 1 中间四位 2 最后八位 3 全部 4 最后四位 |
| --end-time-end | integer | 否 | — | 通话结束时间止（Unix 秒） |
| --end-time | integer | 否 | — | 通话结束时间起（Unix 秒） |
| --up-time-end | integer | 否 | — | 客户接听时间止（Unix 秒） |
| --up-time | integer | 否 | — | 客户接听时间起（Unix 秒） |
| --start-time-end | integer | 是 | — | 呼叫开始时间止（Unix 秒） |
| --start-time | integer | 是 | — | 呼叫开始时间起（Unix 秒） |

###### E.1.3.13.13 `zenava callcenter cdr ob-copy`
座席外呼通话记录同步
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 数据表主键游标 |
| --month | text | 是 | — | yyyyMM |
| --limit | integer | 否 | 10 | 分页大小 |
| --user-field-key | text | 否 | — | 自定义字段名 |
| --user-field-value | text | 否 | — | 自定义字段值 |
| --return-count | integer | 否 | — | 0 不返回总条数 1 返回 [default: 1] |

###### E.1.3.13.14 `zenava callcenter cdr ob-detail`
查询外呼记录详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --hidden-type | integer | 否 | — | 号码隐藏：0 不隐藏，1 中间四位，2 最后八位，3 全部，4 最后四位；默认 0 |
| --main-unique-id | text | 是 | — | 通话记录唯一标识 |

###### E.1.3.13.15 `zenava callcenter cdr ob-get`
座席外呼通话记录详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --unique-id | text | 是 | — | 通话唯一标识 |

###### E.1.3.13.16 `zenava callcenter cdr ob-internal-detail`
查询内部呼叫记录详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --main-unique-id | text | 是 | — | 通话记录唯一标识 |
| --hidden-type | integer | 否 | — | 号码隐藏：0 不隐藏，1 中间四位，2 最后八位，3 全部号码，4 最后四位；默认值为 0 |

###### E.1.3.13.17 `zenava callcenter cdr ob-internal-list`
查询内部呼叫记录列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --start-time | integer | 否 | — | 开始时间，Unix 秒；默认当月第一天；与 --start-time-end 跨度不超过一个月 |
| --start-time-end | integer | 否 | — | 开始时间截止，Unix 秒；默认当前时间 |
| --bridge-time | integer | 否 | — | 接通时间，Unix 秒 |
| --bridge-time-end | integer | 否 | — | 接通时间截止，Unix 秒 |
| --end-time | integer | 否 | — | 结束时间，Unix 秒 |
| --end-time-end | integer | 否 | — | 结束时间截止，Unix 秒 |
| --bridge-duration | integer | 否 | — | 通话时长范围最小值（秒），与 --bridge-duration-end 配合 |
| --bridge-duration-end | integer | 否 | — | 通话时长范围最大值（秒） |
| --total-duration | integer | 否 | — | 总时长范围最小值（秒），与 --total-duration-end 配合 |
| --total-duration-end | integer | 否 | — | 总时长范围最大值（秒） |
| --cnos | text | 否 | — | 座席工号，逗号分隔；示例 0001,0002 |
| --client-number | text | 否 | — | 座席电话 |
| --internal-type | integer | 否 | — | 内部呼叫类型；示例 1 |
| --internal-obj | text | 否 | — | 内部呼叫对象，逗号分隔；示例 0002,0003 |
| --bridge-status | text | 否 | — | 接听状态，逗号分隔；示例 1 |
| --main-unique-id | text | 否 | — | 通话记录唯一标识 |
| --request-unique-id | text | 否 | — | 请求唯一 ID |
| --field-to-sort | text | 否 | — | 排序字段，默认 startTime |
| --sort-desc | boolean | 否 | — | 排序方向。true: 倒序，false: 正序。默认 true |
| --hidden-type | integer | 否 | — | 号码隐藏：0 不隐藏，1 中间四位，2 最后八位，3 全部号码，4 最后四位；默认值为 0 |
| --scroll-search | boolean | 否 | false | 是否滚动查询，默认 false；传此 flag 表示 true |
| --scroll-id | text | 否 | — | 滚动查询 ID；配合 --scroll-search，首次可不传；空表示滚动结束 |
| --offset | integer | 否 | — | 偏移量，范围 0-99990，默认 0；limit+offset 不超过 100000 |
| --limit | integer | 否 | — | 查询条数，范围 10-100，默认 10；limit+offset 不超过 100000 |

###### E.1.3.13.18 `zenava callcenter cdr ob-list`
查询外呼记录
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --offset | integer | 否 | — | 偏移量，范围 0-99990，默认 0；limit+offset 不超过 100000 |
| --limit | integer | 否 | — | 查询条数，范围 10-100，默认 10；limit+offset 不超过 100000 |
| --scroll-search | boolean | 否 | false | 是否滚动查询，默认 false；传此 flag 表示 true |
| --scroll-id | text | 否 | — | 滚动查询 ID；配合 --scroll-search，首次可不传；空表示滚动结束 |
| --start-time | integer | 否 | — | 开始时间，Unix 秒；默认当月第一天；与 --start-time-end 跨度不超过一个月 |
| --start-time-end | integer | 否 | — | 开始时间截止，Unix 秒；默认当前时间 |
| --answer-time | integer | 否 | — | 系统应答时间，Unix 秒 |
| --answer-time-end | integer | 否 | — | 系统应答时间截止，Unix 秒 |
| --up-time | integer | 否 | — | 客户接听时间，Unix 秒 |
| --up-time-end | integer | 否 | — | 客户接听时间截止，Unix 秒 |
| --bridge-time | integer | 否 | — | 接听时间，Unix 秒 |
| --bridge-time-end | integer | 否 | — | 接听时间截止，Unix 秒 |
| --end-time | integer | 否 | — | 结束时间，Unix 秒 |
| --end-time-end | integer | 否 | — | 结束时间截止，Unix 秒 |
| --hidden-type | integer | 否 | — | 号码隐藏：0 不隐藏，1 中间四位，2 最后八位，3 全部，4 最后四位；默认 0 |
| --bridge-duration | integer | 否 | — | 通话时长范围最小值（秒），与 --bridge-duration-end 配合 |
| --bridge-duration-end | integer | 否 | — | 通话时长范围最大值（秒） |
| --total-duration | integer | 否 | — | 总时长范围最小值（秒），与 --total-duration-end 配合 |
| --total-duration-end | integer | 否 | — | 总时长范围最大值（秒） |
| --cnos | text | 否 | — | 座席号，逗号分隔 |
| --qnos | text | 否 | — | 队列号，逗号分隔 |
| --cno | text | 否 | — | 座席号，逗号分隔 |
| --qno | text | 否 | — | 队列号，逗号分隔 |
| --first-call-cno | text | 否 | — | 首呼座席，逗号分隔 |
| --first-call-qno | text | 否 | — | 首呼队列，逗号分隔 |
| --first-call-number | text | 否 | — | 首呼座席电话 |
| --client-number | text | 否 | — | 座席电话 |
| --customer-number | text | 否 | — | 客户号码 |
| --customer-number-match-type | integer | 否 | — | 号码匹配：0 精确，1 前缀，2 后缀，3 包含；需与 --customer-number 配合 |
| --hotlines | text | 否 | — | 热线号码，逗号分隔 |
| --hotline-name | text | 否 | — | 热线别名 |
| --ivr-ids | text | 否 | — | IVR Id，逗号分隔 |
| --xnumber | text | 否 | — | 虚拟号码，逗号分隔 |
| --statuses | text | 否 | — | 接听状态（来电）：1 人工接听，2 人工未接听，3 系统应答，4 系统未应答；默认全部；逗号分隔（WebCall 枚举不同，见文档） |
| --status | text | 否 | — | 接听状态（外呼）：1 客户未接听，2 座席未接听，3 客户接听，4 座席接听；默认全部；逗号分隔（机器人列表为机器人接听状态） |
| --status-result | text | 否 | — | 呼叫结果，配合人工未接听/系统应答级联：1 已进入留言，2 客户速挂，3 座席拒接，4 振铃未接，8 IVR中放弃，9 已进IVR，10 未进IVR，11 队列中放弃，12 队列中溢出；默认全部 |
| --on-hook-source | text | 否 | — | 挂断方，默认全部（见文档通用字段） |
| --call-remember | text | 否 | — | 主叫记忆：1 外呼主叫记忆，2 来电主叫记忆；默认全部 |
| --status-robot | text | 否 | — | 机器人接听状态：1 未应答，2 应答 |
| --investigation-keys | integer | 否 | — | 满意度评价 |
| --province | text | 否 | — | 客户归属地省份 |
| --city | text | 否 | — | 客户归属地城市 |
| --agent-answer-in-time | integer | 否 | — | 首次及时应答：0 否，1 是；默认全部 |
| --evaluation | integer | 否 | — | 是否邀评：0 否，1 是；默认全部 |
| --evaluation-solve-result | text | 否 | — | 会话评估是否解决：0 未解决，1 已解决；默认全部 |
| --user-field | text | 否 | — | 自定义字段 |
| --user-value | text | 否 | — | 自定义字段值，与 --user-field 配合 |
| --customer-mos | text | 否 | — | 客户侧通话质量 1-4（较差到优秀），逗号分隔 |
| --agent-mos | text | 否 | — | 座席侧通话质量 1-4（较差到优秀），逗号分隔 |
| --main-unique-id | text | 否 | — | 通话记录唯一标识 |
| --exist-ticket | integer | 否 | — | 工单：0 无，1 有；默认全部 |
| --exist-business | integer | 否 | — | 业务记录：0 无，1 有；默认全部 |
| --is-rtc-call | integer | 否 | — | 是否 RTC 通话：1 是，0 否；默认全部 |
| --bind-types | text | 否 | — | 接听设备：1 手机，2 IP话机，3 软电话；默认全部 |
| --detail-call-type | text | 否 | — | 呼叫类型，默认全部（见文档通用字段） |
| --bridge-status | text | 否 | — | 接听状态：0 人工未接听，1 人工接听；默认全部 |
| --bridge-status-detail | text | 否 | — | 人工未接听原因：2 座席拒接，3 振铃未接；默认全部 |
| --display-numbers | text | 否 | — | 呼转外显号码，逗号分隔 |
| --sip-cause-code | integer | 否 | — | SIP 状态码 |
| --call-type | text | 否 | — | 通话类型：4 预览外呼，6 主叫外呼；默认全部 |
| --left-clid | text | 否 | — | 外显号码，逗号分隔 |
| --sip-cause-type | text | 否 | — | 呼叫结果：0 呼叫成功，1 呼叫失败，2 线路故障，3 线路风控；默认全部 |
| --sip-cause | text | 否 | — | 呼叫失败原因（与 --sip-cause-type 级联）：-700 客户无人接听，710 客户占线，712 客户拒接，713 号码空号，714 号码关机，715 号码暂无法接听，716 号码停机；默认全部 |
| --sip-cause-raw | text | 否 | — | 被叫状态：710 客户占线，711 呼叫超时，712 客户拒接，713 号码空号，714 关机，715 号码暂无法接听，716 号码停机，717 呼叫受限，718 无人接听，719 正在通话中，720 暂停服务，721 来电提醒，722 不再使用，723 来电助手，724 号码格式不正确；默认全部 |
| --request-unique-id | text | 否 | — | 请求唯一 ID |
| --task-name | text | 否 | — | 外呼任务名称 |
| --clid | text | 否 | — | 外显号码，逗号分隔 |
| --callee-display-numbers | text | 否 | — | 转接外显号码，逗号分隔 |
| --degrade | integer | 否 | — | 是否呼叫降级：1 是，0 否；默认全部 |
| --trunk-group-key | text | 否 | — | 中继组号 |
| --field-to-sort | text | 否 | — | 排序字段，默认 cdrStartTime |
| --sort-desc | boolean | 否 | — | 排序：true 倒序，false 正序；默认 true |
| --call-intention | text | 否 | — | 进线意图 |
| --frequent-intention | text | 否 | — | 高频意图 |
| --intention-tag | text | 否 | — | 意向标签 |
| --solve | integer | 否 | — | 是否解决 |
| --first-ib-status | integer | 否 | — | 首次来电 |
| --first-ib-solve-status | integer | 否 | — | 首次来电解决 |
| --transfer-reason | text | 否 | — | 转人工原因 |
| --review-status | integer | 否 | — | 审阅状态：0 未读，1 已读 |
| --bot-ids | text | 否 | — | 机器人 ID，逗号分隔 |
| --round | integer | 否 | — | 对话轮次范围最小值，与 --round-end 配合 |
| --round-end | integer | 否 | — | 对话轮次范围最大值 |
| --interrupt-count | integer | 否 | — | 打断次数范围最小值，与 --interrupt-count-end 配合 |
| --interrupt-count-end | integer | 否 | — | 打断次数范围最大值 |
| --transfer | integer | 否 | — | 是否转人工：1 是，0 否；默认全部 |
| --transfer-bridge | text | 否 | — | 转人工接听状态，逗号分隔 |
| --task-id | text | 否 | — | 任务 ID，逗号分隔 |
| --greeting | integer | 否 | — | 开场白挂断点范围最小值，与 --greeting-end 配合 |
| --greeting-end | integer | 否 | — | 开场白挂断点范围最大值 |
| --end-flow | text | 否 | — | 流程挂断点 |
| --info | text | 否 | — | 信息捕获 |
| --ab-task-group-name | text | 否 | — | AB 测试组名 |
| --business-tag-names | text | 否 | — | 业务标签名称，逗号分隔 |

###### E.1.3.13.19 `zenava callcenter cdr ob-query`
座席外呼通话记录查询
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --unique-id | text | 否 | — | 通话唯一标识 |
| --province | text | 否 | — | 省份 |
| --city | text | 否 | — | 城市 |
| --time-range-type | integer | 否 | 1 | 1 呼叫开始时间 2 呼叫结束时间 |
| --start-time | integer | 否 | — | 开始时间 Unix 秒 |
| --end-time | integer | 否 | — | 结束时间 Unix 秒 |
| --start | integer | 否 | 0 | 分页起始 |
| --limit | integer | 否 | 10 | 分页大小 |
| --user-field-key | text | 否 | — | 自定义字段名 |
| --user-field-value | text | 否 | — | 自定义字段值 |
| --customer-number | text | 否 | — | 客户号码 |
| --cno | text | 否 | — | 座席工号 |
| --request-unique-id | text | 否 | — | 请求唯一标识 |
| --call-type | integer | 否 | — | 4 预览外呼 6 主叫外呼 9 内部呼叫 |
| --status | integer | 否 | — | 30 座席未接听 31 座席接听未呼客户 32 座席接听客户未接听 33 双方接听 50 主叫外呼接听 51 主叫外呼客户未接听 52 主叫外呼双方接听 |
| --gno | text | 否 | — | 外呼组号 |
| --agent-number | text | 否 | — | 座席号码 |
| --agent-name | text | 否 | — | 座席姓名 |
| --clid | text | 否 | — | 主叫号码 |
| --left-display-number | text | 否 | — | 左侧外显号码 |
| --order | integer | 否 | — | 0 产生时序正序 1 逆序 2 结束时间正序 3 逆序 |
| --return-count | integer | 否 | — | 0 不返回总条数 1 返回 [default: 1] |
| --down-grade | integer | 否 | — | 0 否 1 呼叫降级 |
| --is-real-answer | integer | 否 | — | 0 否 1 真人接听 |

###### E.1.3.13.20 `zenava callcenter cdr predictive-call-query`
预测式外呼通话记录查询
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --unique-id | text | 否 | — | 通话唯一标识 |
| --province | text | 否 | — | 省份 |
| --city | text | 否 | — | 城市 |
| --time-range-type | integer | 否 | 1 | 1 呼叫开始时间 2 呼叫结束时间 |
| --start-time | integer | 否 | — | 开始时间 Unix 秒 |
| --end-time | integer | 否 | — | 结束时间 Unix 秒 |
| --start | integer | 否 | 0 | 分页起始 |
| --limit | integer | 否 | 10 | 分页大小 |
| --user-field-key | text | 否 | — | 自定义字段名 |
| --user-field-value | text | 否 | — | 自定义字段值 |
| --customer-number | text | 否 | — | 客户号码 |
| --cno | text | 否 | — | 座席工号 |
| --task-id | integer | 否 | — | 任务 Id |
| --task-file-id | integer | 否 | — | 批次 Id |
| --request-unique-id | text | 否 | — | 请求唯一标识 |
| --gno | text | 否 | — | 外呼组号 |
| --callee-number | text | 否 | — | 被叫号码 |
| --clid | text | 否 | — | 主叫号码 |
| --display-number | text | 否 | — | 外显号码 |
| --down-grade | integer | 否 | — | 0 否 1 呼叫降级 |
| --status | integer | 否 | — | 40 客户未接 41 客户接听 42 已呼叫 43 双方接听 |
| --agent-name | text | 否 | — | 座席姓名 |
| --is-real-answer | integer | 否 | — | 0 否 1 真人接听 |

###### E.1.3.13.21 `zenava callcenter cdr sip-query`
SIP 接入通话记录查询
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --unique-id | text | 否 | — | 通话唯一标识 |
| --customer-number | text | 否 | — | 客户号码 |
| --status | integer | 否 | — | 70 未呼叫 71 系统接听未呼客户 72 系统接听已呼客户 73 双方接听 |
| --province | text | 否 | — | 省份 |
| --city | text | 否 | — | 城市 |
| --start-time | integer | 否 | — | 开始时间 Unix 秒 |
| --end-time | integer | 否 | — | 结束时间 Unix 秒 |
| --start | integer | 否 | 0 | 分页起始 |
| --limit | integer | 否 | 10 | 分页大小 |
| --user-field-key | text | 否 | — | 自定义字段名 |
| --user-field-value | text | 否 | — | 自定义字段值 |
| --request-unique-id | text | 否 | — | 请求唯一标识 |
| --is-real-answer | integer | 否 | — | 0 否 1 真人接听 |

###### E.1.3.13.22 `zenava callcenter cdr webcall-list`
查询 WebCall 记录
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --offset | integer | 否 | — | 偏移量，范围 0-99990，默认 0；limit+offset 不超过 100000 |
| --limit | integer | 否 | — | 查询条数，范围 10-100，默认 10；limit+offset 不超过 100000 |
| --scroll-search | boolean | 否 | false | 是否滚动查询，默认 false；传此 flag 表示 true |
| --scroll-id | text | 否 | — | 滚动查询 ID；配合 --scroll-search，首次可不传；空表示滚动结束 |
| --start-time | integer | 否 | — | 开始时间，Unix 秒；默认当月第一天；与 --start-time-end 跨度不超过一个月 |
| --start-time-end | integer | 否 | — | 开始时间截止，Unix 秒；默认当前时间 |
| --answer-time | integer | 否 | — | 系统应答时间，Unix 秒 |
| --answer-time-end | integer | 否 | — | 系统应答时间截止，Unix 秒 |
| --up-time | integer | 否 | — | 客户接听时间，Unix 秒 |
| --up-time-end | integer | 否 | — | 客户接听时间截止，Unix 秒 |
| --bridge-time | integer | 否 | — | 接听时间，Unix 秒 |
| --bridge-time-end | integer | 否 | — | 接听时间截止，Unix 秒 |
| --end-time | integer | 否 | — | 结束时间，Unix 秒 |
| --end-time-end | integer | 否 | — | 结束时间截止，Unix 秒 |
| --hidden-type | integer | 否 | — | 号码隐藏：0 不隐藏，1 中间四位，2 最后八位，3 全部，4 最后四位；默认 0 |
| --bridge-duration | integer | 否 | — | 通话时长范围最小值（秒），与 --bridge-duration-end 配合 |
| --bridge-duration-end | integer | 否 | — | 通话时长范围最大值（秒） |
| --total-duration | integer | 否 | — | 总时长范围最小值（秒），与 --total-duration-end 配合 |
| --total-duration-end | integer | 否 | — | 总时长范围最大值（秒） |
| --cnos | text | 否 | — | 座席号，逗号分隔 |
| --qnos | text | 否 | — | 队列号，逗号分隔 |
| --cno | text | 否 | — | 座席号，逗号分隔 |
| --qno | text | 否 | — | 队列号，逗号分隔 |
| --first-call-cno | text | 否 | — | 首呼座席，逗号分隔 |
| --first-call-qno | text | 否 | — | 首呼队列，逗号分隔 |
| --first-call-number | text | 否 | — | 首呼座席电话 |
| --client-number | text | 否 | — | 座席电话 |
| --customer-number | text | 否 | — | 客户号码 |
| --customer-number-match-type | integer | 否 | — | 号码匹配：0 精确，1 前缀，2 后缀，3 包含；需与 --customer-number 配合 |
| --hotlines | text | 否 | — | 热线号码，逗号分隔 |
| --hotline-name | text | 否 | — | 热线别名 |
| --ivr-ids | text | 否 | — | IVR Id，逗号分隔 |
| --xnumber | text | 否 | — | 虚拟号码，逗号分隔 |
| --statuses | text | 否 | — | 接听状态（来电）：1 人工接听，2 人工未接听，3 系统应答，4 系统未应答；默认全部；逗号分隔（WebCall 枚举不同，见文档） |
| --status | text | 否 | — | 接听状态（外呼）：1 客户未接听，2 座席未接听，3 客户接听，4 座席接听；默认全部；逗号分隔（机器人列表为机器人接听状态） |
| --status-result | text | 否 | — | 呼叫结果，配合人工未接听/系统应答级联：1 已进入留言，2 客户速挂，3 座席拒接，4 振铃未接，8 IVR中放弃，9 已进IVR，10 未进IVR，11 队列中放弃，12 队列中溢出；默认全部 |
| --on-hook-source | text | 否 | — | 挂断方，默认全部（见文档通用字段） |
| --call-remember | text | 否 | — | 主叫记忆：1 外呼主叫记忆，2 来电主叫记忆；默认全部 |
| --status-robot | text | 否 | — | 机器人接听状态：1 未应答，2 应答 |
| --investigation-keys | integer | 否 | — | 满意度评价 |
| --province | text | 否 | — | 客户归属地省份 |
| --city | text | 否 | — | 客户归属地城市 |
| --agent-answer-in-time | integer | 否 | — | 首次及时应答：0 否，1 是；默认全部 |
| --evaluation | integer | 否 | — | 是否邀评：0 否，1 是；默认全部 |
| --evaluation-solve-result | text | 否 | — | 会话评估是否解决：0 未解决，1 已解决；默认全部 |
| --user-field | text | 否 | — | 自定义字段 |
| --user-value | text | 否 | — | 自定义字段值，与 --user-field 配合 |
| --customer-mos | text | 否 | — | 客户侧通话质量 1-4（较差到优秀），逗号分隔 |
| --agent-mos | text | 否 | — | 座席侧通话质量 1-4（较差到优秀），逗号分隔 |
| --main-unique-id | text | 否 | — | 通话记录唯一标识 |
| --exist-ticket | integer | 否 | — | 工单：0 无，1 有；默认全部 |
| --exist-business | integer | 否 | — | 业务记录：0 无，1 有；默认全部 |
| --is-rtc-call | integer | 否 | — | 是否 RTC 通话：1 是，0 否；默认全部 |
| --bind-types | text | 否 | — | 接听设备：1 手机，2 IP话机，3 软电话；默认全部 |
| --detail-call-type | text | 否 | — | 呼叫类型，默认全部（见文档通用字段） |
| --bridge-status | text | 否 | — | 接听状态：0 人工未接听，1 人工接听；默认全部 |
| --bridge-status-detail | text | 否 | — | 人工未接听原因：2 座席拒接，3 振铃未接；默认全部 |
| --display-numbers | text | 否 | — | 呼转外显号码，逗号分隔 |
| --sip-cause-code | integer | 否 | — | SIP 状态码 |
| --call-type | text | 否 | — | 通话类型：4 预览外呼，6 主叫外呼；默认全部 |
| --left-clid | text | 否 | — | 外显号码，逗号分隔 |
| --sip-cause-type | text | 否 | — | 呼叫结果：0 呼叫成功，1 呼叫失败，2 线路故障，3 线路风控；默认全部 |
| --sip-cause | text | 否 | — | 呼叫失败原因（与 --sip-cause-type 级联）：-700 客户无人接听，710 客户占线，712 客户拒接，713 号码空号，714 号码关机，715 号码暂无法接听，716 号码停机；默认全部 |
| --sip-cause-raw | text | 否 | — | 被叫状态：710 客户占线，711 呼叫超时，712 客户拒接，713 号码空号，714 关机，715 号码暂无法接听，716 号码停机，717 呼叫受限，718 无人接听，719 正在通话中，720 暂停服务，721 来电提醒，722 不再使用，723 来电助手，724 号码格式不正确；默认全部 |
| --request-unique-id | text | 否 | — | 请求唯一 ID |
| --task-name | text | 否 | — | 外呼任务名称 |
| --clid | text | 否 | — | 外显号码，逗号分隔 |
| --callee-display-numbers | text | 否 | — | 转接外显号码，逗号分隔 |
| --degrade | integer | 否 | — | 是否呼叫降级：1 是，0 否；默认全部 |
| --trunk-group-key | text | 否 | — | 中继组号 |
| --field-to-sort | text | 否 | — | 排序字段，默认 cdrStartTime |
| --sort-desc | boolean | 否 | — | 排序：true 倒序，false 正序；默认 true |
| --call-intention | text | 否 | — | 进线意图 |
| --frequent-intention | text | 否 | — | 高频意图 |
| --intention-tag | text | 否 | — | 意向标签 |
| --solve | integer | 否 | — | 是否解决 |
| --first-ib-status | integer | 否 | — | 首次来电 |
| --first-ib-solve-status | integer | 否 | — | 首次来电解决 |
| --transfer-reason | text | 否 | — | 转人工原因 |
| --review-status | integer | 否 | — | 审阅状态：0 未读，1 已读 |
| --bot-ids | text | 否 | — | 机器人 ID，逗号分隔 |
| --round | integer | 否 | — | 对话轮次范围最小值，与 --round-end 配合 |
| --round-end | integer | 否 | — | 对话轮次范围最大值 |
| --interrupt-count | integer | 否 | — | 打断次数范围最小值，与 --interrupt-count-end 配合 |
| --interrupt-count-end | integer | 否 | — | 打断次数范围最大值 |
| --transfer | integer | 否 | — | 是否转人工：1 是，0 否；默认全部 |
| --transfer-bridge | text | 否 | — | 转人工接听状态，逗号分隔 |
| --task-id | text | 否 | — | 任务 ID，逗号分隔 |
| --greeting | integer | 否 | — | 开场白挂断点范围最小值，与 --greeting-end 配合 |
| --greeting-end | integer | 否 | — | 开场白挂断点范围最大值 |
| --end-flow | text | 否 | — | 流程挂断点 |
| --info | text | 否 | — | 信息捕获 |
| --ab-task-group-name | text | 否 | — | AB 测试组名 |
| --business-tag-names | text | 否 | — | 业务标签名称，逗号分隔 |

###### E.1.3.13.23 `zenava callcenter cdr webcall-query`
webCall 通话记录查询
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --unique-id | text | 否 | — | 通话唯一标识 |
| --province | text | 否 | — | 省份 |
| --city | text | 否 | — | 城市 |
| --time-range-type | integer | 否 | 1 | 1 呼叫开始时间 2 呼叫结束时间 |
| --start-time | integer | 否 | — | 开始时间 Unix 秒 |
| --end-time | integer | 否 | — | 结束时间 Unix 秒 |
| --start | integer | 否 | 0 | 分页起始 |
| --limit | integer | 否 | 10 | 分页大小 |
| --user-field-key | text | 否 | — | 自定义字段名 |
| --user-field-value | text | 否 | — | 自定义字段值 |
| --customer-number | text | 否 | — | 客户号码 |
| --cno | text | 否 | — | 座席工号 |
| --request-unique-id | text | 否 | — | 请求唯一标识 |
| --status | integer | 否 | — | 20 TTS失败 21 客户未接 22 客户接听 23 已呼叫 24 双方接听 |
| --gno | text | 否 | — | 外呼组号 |
| --callee-number | text | 否 | — | 被叫号码 |
| --display-number | text | 否 | — | 外显号码 |
| --callee-display-number | text | 否 | — | 被叫侧外显号码 |
| --clid | text | 否 | — | 主叫号码 |
| --callee-clid | text | 否 | — | 被叫侧主叫号码 |
| --return-count | integer | 否 | — | 0 不返回总条数 1 返回 [default: 1] |
| --is-real-answer | integer | 否 | — | 0 否 1 真人接听 |

###### E.1.3.14 `zenava callcenter cdr-user-field`
话单自定义字段定义。查询话单时用 `--user-field`、`--user-value` 按这里的字段名过滤
**子命令：** `create`、`delete`、`get`、`list`、`update`
本级命令无专属参数。

###### E.1.3.14.1 `zenava callcenter cdr-user-field create`
新增话单自定义字段
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --value | text | 否 | — | 取值表达式；省略时默认 `${key}` |
| --key | text | 是 | — | 字段名，企业内唯一 |
| --name | text | 是 | — | 字段展示名 |

###### E.1.3.14.2 `zenava callcenter cdr-user-field delete`
删除话单自定义字段
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --key | text | 是 | — | 待删除的技术字段名 |

###### E.1.3.14.3 `zenava callcenter cdr-user-field get`
按字段名查询一条话单自定义字段
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --key | text | 是 | — | 技术字段名 |

###### E.1.3.14.4 `zenava callcenter cdr-user-field list`
获取话单自定义字段列表

###### E.1.3.14.5 `zenava callcenter cdr-user-field update`
更新话单自定义字段。字段名是身份，不能改成另一个字段
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --value | text | 否 | — | 新的取值表达式；不传则保持原值 |
| --name | text | 否 | — | 新的展示名；不传则保持原值 |
| --key | text | 是 | — | 待更新的技术字段名（身份键，不可改） |

###### E.1.3.15 `zenava callcenter crn`
外显导航管理
**子命令：** `list`
本级命令无专属参数。

###### E.1.3.15.1 `zenava callcenter crn list`
获取外显导航列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --crn-id | text | 否 | — | 外显导航 ID（模糊匹配） |
| --name | text | 否 | — | 外显导航名称（模糊匹配） |
| --start | integer | 否 | — | 分页起始，从 0 开始 |
| --limit | integer | 否 | — | 每页条数，最大 100 |

###### E.1.3.16 `zenava callcenter data-manager`
呼叫前业务缓存：写入、读取、删除
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --access-limit | text | 否 | 10000 | IVR 可访问次数（仅 set） |
| --expired | text | 否 | 3600 | 有效期秒数（仅 set） |
| --value | text | 否 | — | set 时必选；JSON 字符串 |
| --key | text | 是 | — | 缓存 key（≤256 字节） |
| --method | text | 是 | — | set 写入 get 读取 delete 删除 |

###### E.1.3.17 `zenava callcenter enterprise`
企业信息查询
**子命令：** `get`
本级命令无专属参数。

###### E.1.3.17.1 `zenava callcenter enterprise get`
获取企业信息

###### E.1.3.18 `zenava callcenter enterprise-hotline`
企业号码列表分页查询
**子命令：** `list-page`
本级命令无专属参数。

###### E.1.3.18.1 `zenava callcenter enterprise-hotline list-page`
号码列表分页查询
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --limit | integer | 否 | 10 | 分页大小 |
| --offset | integer | 否 | 0 | 分页偏移 |
| --end-time | integer | 否 | — | 创建时间毫秒时间戳 |
| --start-time | integer | 否 | — | 创建时间毫秒时间戳 |
| --label | text | 否 | — | 号码标签 |
| --trunk-group-key | text | 否 | — | 中继组编码 |
| --area-code | text | 否 | — | 区号精确匹配 |
| --number | text | 否 | — | 号码精确匹配 |
| --status | integer | 否 | — | 0 停用 1 启用 |
| --clid-type | text | 否 | — | 外显类型键逗号多选：isInUse,isIbRight,isIntl,isPredictiveLeft,isPredictiveRight,isPreviewRight,isSipLeft,isWebCallLeft,isWebCallRight |
| --number-type | text | 否 | — | 1 热线号码 2 固话号码 3 SIP手机号 4 虚拟手机号（逗号多选） |

###### E.1.3.19 `zenava callcenter enterprise-setting`
企业配置：列表、按名查询、更新
**子命令：** `get`、`list`、`update`
本级命令无专属参数。

###### E.1.3.19.1 `zenava callcenter enterprise-setting get`
获取配置信息
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --type | text | 否 | — | 类型（可选兼容） |
| --id | text | 否 | — | 配置 id（可选兼容） |
| --name | text | 是 | — | 配置名 |

###### E.1.3.19.2 `zenava callcenter enterprise-setting list`
获取配置列表

###### E.1.3.19.3 `zenava callcenter enterprise-setting update`
更新企业配置
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --property | text | 是 | — | 属性描述 |
| --value | text | 是 | — | 配置值（auto_clid_trunk_group_weight 时可传空字符串） |
| --name | text | 是 | — | 配置名 |

###### E.1.3.20 `zenava callcenter enterprise-time`
时间管理
**子命令：** `create`、`delete`、`list`、`update`
本级命令无专属参数。

###### E.1.3.20.1 `zenava callcenter enterprise-time create`
新增时间条件设置（仅 ）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --to-day | text | 否 | — | 终止日期 yyyy-MM-dd（type=2 时必填） |
| --from-day | text | 否 | — | 起始日期 yyyy-MM-dd（type=2 时必填） |
| --day-of-week | text | 否 | — | 星期（type=1 时必填）：周日=1、周一=2…周六=7，逗号分隔，例如 2,3,4 |
| --end-time | text | 是 | — | 结束时间 HH:mm |
| --start-time | text | 是 | — | 开始时间 HH:mm |
| --time-type | integer | 是 | — | 时间类型：1=连续，2=间隔 |
| --type | integer | 是 | — | 时间条件类型：1=按星期，2=按固定日期 |
| --priority | integer | 是 | — | 优先级（≥1；同企业唯一；越小越高） |
| --name | text | 是 | — | 时间条件名称（同企业唯一） |

###### E.1.3.20.2 `zenava callcenter enterprise-time delete`
删除时间条件设置（仅 ）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 否 | — | 时间条件名称（与 --id 至少一个） |
| --id | integer | 否 | — | 时间条件 id（与 --name 至少一个） |

###### E.1.3.20.3 `zenava callcenter enterprise-time list`
获取/查询时间条件设置列表（ + ）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --priority | integer | 否 | — | 优先级（精确匹配；越小越高） |
| --type | integer | 否 | — | 时间条件类型：1=按星期，2=按固定日期 |
| --name | text | 否 | — | 时间条件名称（精确匹配） |

###### E.1.3.20.4 `zenava callcenter enterprise-time update`
更新时间条件设置（仅 ）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --to-day | text | 否 | — | 终止日期 yyyy-MM-dd |
| --from-day | text | 否 | — | 起始日期 yyyy-MM-dd |
| --day-of-week | text | 否 | — | 星期（type=1 时必填）：周日=1、周一=2…周六=7，逗号分隔，例如 2,3,4 |
| --end-time | text | 否 | — | 结束时间 HH:mm |
| --start-time | text | 否 | — | 开始时间 HH:mm |
| --type | integer | 否 | — | 时间条件类型：1=按星期，2=按固定日期 |
| --priority | integer | 否 | — | 优先级 |
| --time-type | integer | 是 | — | 时间类型：1=连续，2=间隔 |
| --name | text | 否 | — | 时间条件名称（与 --id 至少一个） |
| --id | integer | 否 | — | 时间条件 id（与 --name 至少一个） |

###### E.1.3.21 `zenava callcenter enterprise-voice`
企业语音文件上传
**子命令：** `create`
本级命令无专属参数。

###### E.1.3.21.1 `zenava callcenter enterprise-voice create`
新增企业语音文件
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --path | text | 否 | — | 语音变量值（13 位时间戳） |
| --description | text | 否 | — | 描述 |
| --file | text | 是 | — | 本地 wav/mp3 路径 |
| --voice-name | text | 是 | — | 语音文件名 |

###### E.1.3.22 `zenava callcenter export-record`
任务呼叫记录异步导出、状态查询与下载地址获取
**子命令：** `create-cdr-auto-task`、`get-status`、`get-url`
本级命令无专属参数。

###### E.1.3.22.1 `zenava callcenter export-record create-cdr-auto-task`
创建任务呼叫记录导出 按与「查询任务呼叫记录列表」相同的筛选条件异步导出 Excel； 返回 exportUniqueId 后，轮询 get-status 直至成功，再调用 get-url 获取下载地址。 startTime/startTimeEnd 跨度不能超过 6 个月
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --intelligent-info | text | 否 | — | 信息捕获 |
| --intelligent-intention-tag | text | 否 | — | 意向标签 |
| --intelligent-end-flow | text | 否 | — | 流程挂断点 |
| --intelligent-greeting-end | integer | 否 | — | 开场白挂断点上限 |
| --intelligent-greeting | integer | 否 | — | 开场白挂断点下限 |
| --intelligent-transfer | integer | 否 | — | 0 否 1 转人工 |
| --intelligent-interrupt-count-end | integer | 否 | — | 打断次数上限 |
| --intelligent-interrupt-count | integer | 否 | — | 打断次数下限 |
| --intelligent-round-end | integer | 否 | — | 对话轮次上限 |
| --intelligent-round | integer | 否 | — | 对话轮次下限 |
| --intelligent-status-result | text | 否 | — | 1 正常应答 2 轮次上限 3 机器人异常 4 超并发（逗号分隔） |
| --intelligent-status | text | 否 | — | 1 机器人应答 2 机器人未应答（逗号分隔） |
| --intelligent-bot-ids | text | 否 | — | 机器人 ID，逗号分隔 |
| --intelligent-bridge-duration-end | integer | 否 | — | 机器人通话时长上限（秒） |
| --intelligent-bridge-duration | integer | 否 | — | 机器人通话时长下限（秒） |
| --intelligent-end-time-end | integer | 否 | — | 机器人结束时间止（Unix 秒） |
| --intelligent-end-time | integer | 否 | — | 机器人结束时间起（Unix 秒） |
| --intelligent-bridge-time-end | integer | 否 | — | 机器人接待时间止（Unix 秒） |
| --intelligent-bridge-time | integer | 否 | — | 机器人接待时间起（Unix 秒） |
| --agent-mos | text | 否 | — | 1–4 较差到优秀（逗号分隔） |
| --customer-mos | text | 否 | — | 1–4 较差到优秀（逗号分隔） |
| --user-value | text | 否 | — | 自定义字段值（与 --user-field 配合） |
| --user-field | text | 否 | — | 自定义字段名 |
| --business-tag-names | text | 否 | — | 业务标签，逗号分隔 |
| --finish-retry-flag | integer | 否 | — | 0 否 1 最终呼叫 |
| --ab-task-group-name | text | 否 | — | AB 测试组名 |
| --tel-retry | integer | 否 | — | 0 否 1 重呼 |
| --degrade | integer | 否 | — | 0 否 1 呼叫降级 |
| --ivr-ids | text | 否 | — | IVR ID，逗号分隔 |
| --task-ids | text | 否 | — | 任务 ID，逗号分隔 |
| --evaluation | integer | 否 | — | 0 否 1 邀评 |
| --request-unique-id | text | 否 | — | 请求唯一 ID（非当月查询需带开始时间范围） |
| --main-unique-id | text | 否 | — | 通话记录唯一标识 |
| --city | text | 否 | — | 客户归属地城市 |
| --province | text | 否 | — | 客户归属地省份 |
| --investigation-keys | integer | 否 | — | 满意度评价 |
| --on-hook-source | text | 否 | — | 1000 客户 1001 座席 1002 强拆（逗号分隔） |
| --sip-cause-raw | text | 否 | — | 被叫状态码，逗号分隔 |
| --sip-cause | text | 否 | — | 700 无人接听 710 占线 712 拒接 713 空号 714 关机 715 暂无法接听 716 停机（逗号分隔） |
| --sip-cause-type | text | 否 | — | 0 成功 1 失败 2 线路故障 3 线路风控（逗号分隔） |
| --status | text | 否 | — | 40 客户未接 41 客户接听 42 转人工未接 43 转人工接听（逗号分隔） |
| --xnumber | text | 否 | — | 虚拟号，逗号分隔 |
| --hotlines | text | 否 | — | 外显号，逗号分隔 |
| --customer-number-match-type | integer | 否 | — | 1 前缀 2 后缀 3 包含 |
| --customer-number | text | 否 | — | 客户号码 |
| --client-number | text | 否 | — | 座席电话 |
| --qnos | text | 否 | — | 队列号，逗号分隔 |
| --cnos | text | 否 | — | 座席工号，逗号分隔 |
| --total-duration-end | integer | 否 | — | 总时长上限（秒） |
| --total-duration | integer | 否 | — | 总时长下限（秒） |
| --customer-bridge-duration-end | integer | 否 | — | 客户接听时长上限（秒） |
| --customer-bridge-duration | integer | 否 | — | 客户接听时长下限（秒） |
| --hidden-type | integer | 否 | — | 0 不隐藏 1 中间四位 2 最后八位 3 全部 4 最后四位 |
| --end-time-end | integer | 否 | — | 通话结束时间止（Unix 秒） |
| --end-time | integer | 否 | — | 通话结束时间起（Unix 秒） |
| --up-time-end | integer | 否 | — | 客户接听时间止（Unix 秒） |
| --up-time | integer | 否 | — | 客户接听时间起（Unix 秒） |
| --start-time-end | integer | 是 | — | 开始时间查询截止（Unix 秒）。与 --start-time 跨度不能超过 6 个月 |
| --start-time | integer | 是 | — | 开始时间起（Unix 秒）。与 --start-time-end 跨度不能超过 6 个月 |
| --export-mode | text | 否 | — | 导出模式：all 全量导出（默认）；telDistinct 按号码去重导出。其它值返回参数错误（服务端校验） |
| --pack-zip | boolean | 否 | false | 是否将导出的文件打包为 ZIP（默认不打包；不传则不发送该字段） |
| --show-fields | text | 否 | — | 导出列字段 key 列表，逗号分隔；客户资料字段以 $_ 开头，业务记录字段以 #_ 开头；userField 表示导出高级字段（服务端按话单展开具体列）。 未传或为空时使用默认导出字段：customerNumber、customerArea、hotline、hotlineArea、xnumber、xnumberArea、mainUniqueId、onHookSource、callId、cno、clientName、startTime、bridgeDuration   合法 showFields 字段表： customerNumber 客户号码 customerNumberEncrypt 客户号码加密值 customerArea 客户归属地 customerName 客户名称 hotline 外显号码 hotlineArea 外显号码归属地 trunkGroupKey 中继组 xnumber 中间号 xnumberArea 中间号归属地 status 通话状态 tagNames 标签 mainUniqueId 通话唯一标识 requestUniqueId 请求唯一标识 obSipCause 外呼结果 obSipCauseRaw 外呼结果原始值 onHookSource 挂机方 recordFile 录音文件 tsiFile 质检相关文件 evaluation 评价 investigationKeys 满意度按键 callId 呼叫 ID webrtcCallId WebRTC 呼叫 ID cno 座席号 clientName 座席姓名 clientNumber 座席电话 startTime 开始时间 ringTime 振铃时间 upTime 客户接听时间 bridgeTime 接通时间 endTime 结束时间 bridgeDuration 桥接时长 customerBridgeDuration 客户接听时长 totalDuration 总时长 qno 队列号 obWaitDuration 外呼等待时长 customerRingingDuration 客户振铃时长 taskName 任务名称 taskId 任务 ID taskType 任务类型 callRouteStrategy 呼叫路由策略 existBusiness 是否有业务记录 existTicket 是否有工单 userField 高级字段（展开为实际自定义列） rasr ASR 相关 intelligentBridgeTime 机器人接通时间 intelligentEndTime 机器人结束时间 intelligentBridgeDuration 机器人通话时长 intelligentName 机器人名称 intelligentStatus 机器人状态 intelligentStatusResult 机器人状态结果 intelligentRound 机器人轮次 intelligentInterruptCount 打断次数 intelligentTransfer 是否转人工 intelligentCallIntention 呼叫意向 intelligentFrequentIntention 高频意向 intelligentIntentionTag 意向标签 intelligentSolve 是否解决 intelligentTransferReason 转人工原因 intelligentSummarize 总结 intelligentVAgentRecordFile 虚拟座席录音 intelligentTransferBridge 转人工接通 intelligentGreeting 开场白轮次 intelligentEndFlow 结束流程 abTaskGroupName AB 任务组 finishRetryFlag 完结重试标记 customerAreaCode 客户区号 ivrName IVR 名称 degradeRound 降级轮次 telRetryRound 号码重试轮次 customerMos 客户 MOS agentMos 座席 MOS sipCause SIP 原因码 obRingingDuration 外呼振铃时长 businessTagNames 业务标签 taskFileId 任务文件 ID taskFileName 任务文件名 |

###### E.1.3.22.2 `zenava callcenter export-record get-status`
获取导出记录状态 status：-2 未找到；-1 失败；0 生成中；1 成功；-3 未知
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --export-unique-id | text | 是 | — | 导出任务唯一标识，长度不超过 50 |

###### E.1.3.22.3 `zenava callcenter export-record get-url`
下载导出记录 导出成功后获取文件下载地址；fileUrl 为对象存储预签名地址，有效期约 1 天， 仅 status=1 且文件完整时返回
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --export-unique-id | text | 是 | — | 导出任务唯一标识，长度不超过 50 |

###### E.1.3.23 `zenava callcenter exten`
分机管理：新增、更新、删除、查询
**子命令：** `create`、`delete`、`get`、`update`
本级命令无专属参数。

###### E.1.3.23.1 `zenava callcenter exten create`
新增分机
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --active | integer | 否 | 1 | 0 未激活 1 激活 |
| --denoise | text | 否 | — | 0 关闭 1 开启降噪（仅 type=webrtc） |
| --property | text | 否 | — | 属性 JSON |
| --iad-name | text | 否 | — | IAD 网关（type=1 时有效） |
| --allow | text | 否 | — | 语音编码，如 g729,alaw,ulaw |
| --jitter-buffer | integer | 否 | 0 | 0 关闭网络防抖 1 开启 |
| --ob-record | integer | 否 | 1 | 0 不录音 1 录音 |
| --ib-record | integer | 否 | 1 | 0 不录音 1 录音 |
| --is-direct | integer | 否 | 1 | 0 不允许摘机外呼 1 可以 |
| --is-ob | text | 否 | 1 | 0 不允许外呼 1 可以 |
| --call-power | text | 否 | 0 | 0 无限制 1 国内长途 2 国内本市 3 内部呼叫 |
| --type | integer | 是 | — | 1 注册到 IAD 2 注册到 webrtc 3 注册到远程话机 |
| --area-code | text | 是 | — | 区号 |
| --password | text | 是 | — | 密码 |
| --exten | text | 是 | — | 分机号 3–11 位 |

###### E.1.3.23.2 `zenava callcenter exten delete`
删除分机
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --exten | text | 是 | — | 分机号 |

###### E.1.3.23.3 `zenava callcenter exten get`
查询分机
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --exten | text | 是 | — | 分机号 |

###### E.1.3.23.4 `zenava callcenter exten update`
更新分机（增量；password/active 有则改）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --active | integer | 否 | — | 0 未激活 1 激活；不传保持原值 |
| --denoise | integer | 否 | — | 0 关闭 1 开启降噪（仅 type=webrtc） |
| --property | text | 否 | — | 属性 JSON |
| --allow | text | 否 | — | 语音编码，如 g729,alaw,ulaw |
| --jitter-buffer | integer | 否 | — | 0 关闭网络防抖 1 开启 |
| --ob-record | integer | 否 | — | 0 不录音 1 录音 |
| --ib-record | integer | 否 | — | 0 不录音 1 录音 |
| --is-direct | integer | 否 | — | 0 不允许摘机外呼 1 可以 |
| --is-ob | integer | 否 | — | 0 不允许外呼 1 可以 |
| --call-power | text | 否 | — | 0 无限制 1 国内长途 2 国内本市 3 内部呼叫 |
| --password | text | 否 | — | 传入则更新密码 |
| --type | integer | 是 | — | 1 注册到 IAD 2 注册到 webrtc 3 注册到远程话机 |
| --area-code | text | 是 | — | 区号 |
| --exten | text | 是 | — | 分机号 |

###### E.1.3.24 `zenava callcenter hybrid-group`
号码池列表查询
**子命令：** `list`
本级命令无专属参数。

###### E.1.3.24.1 `zenava callcenter hybrid-group list`
获取号码池列表

###### E.1.3.25 `zenava callcenter intelligent-agent-rasr`
智能体对话文本查询
**子命令：** `query`
本级命令无专属参数。

###### E.1.3.25.1 `zenava callcenter intelligent-agent-rasr query`
查询智能体对话文本
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --in-call | text | 否 | — | 是否通话中查询。true：只返回通话过程中已缓存的转写文本，未就绪则对应通话不返回或为空列表；false 或不传：优先查通话中缓存，查不到再查归档数据 |
| --main-unique-ids | text | 是 | — | 通话唯一标识 mainUniqueIds，英文逗号分隔。远端最多 100 条（由服务端校验，CLI 不本地限条数）。示例：--main-unique-ids id1,id2 |

###### E.1.3.26 `zenava callcenter investigation`
满意度调查记录查询
**子命令：** `query`
本级命令无专属参数。

###### E.1.3.26.1 `zenava callcenter investigation query`
获取满意度调查记录
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --limit | integer | 否 | 10 | 分页大小 |
| --start | integer | 否 | 0 | 分页起始 |
| --end-time | integer | 否 | — | 秒级时间戳（不跨月硬拦） |
| --start-time | integer | 否 | — | 秒级时间戳（不本地伪造） |
| --cno | text | 否 | — | 座席工号 |
| --call-type | integer | 否 | — | 1 来电 2 webCall 4 预览外呼 6 主叫外呼 9 内部呼叫 |
| --unique-id | text | 否 | — | 非空时忽略其它过滤 |

###### E.1.3.27 `zenava callcenter ivr-profile`
语音导航管理
**子命令：** `batch-update-detail`、`delete`、`detail`、`export`、`import`、`list`、`property-help`
本级命令无专属参数。

###### E.1.3.27.1 `zenava callcenter ivr-profile batch-update-detail`
批量更新已有语音导航节点名称与 property 仅更新 Body 中出现的已有节点；不支持新增/删除节点，不支持修改节点类型或编号。 Body 按当前平台原生字段书写： 用 pathName， 用 name。 action 类型速查（property 完整字段见：zenava callcenter ivr-profile property-help）： 1 播放 2 选择 3 留言 4 队列 5 时间 6 地区 8 变量 9 收号 10 等待 11 判断 12 HTTP 13 直呼 15 会议室 16 分支 18 对话机器人 19 短信 21 应答 22 脚本 23 对话机器人WS 24 智能体
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ivr-id | integer | 是 | — | 语音导航 id（必选；一类企业接入 Query=id，二类企业接入 Query=ivrId） |
| --update-mode | text | 否 | — | property 更新模式：replace（整段覆盖）或 merge（仅合并 JSON 第一层）；不传则服务端默认 replace |
| --nodes | text | 是 | — | 节点 JSON 数组字符串（原样透传；一类企业接入 用 pathName，二类企业接入 用 name） |

###### E.1.3.27.2 `zenava callcenter ivr-profile delete`
删除语音导航设置
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ivr-id | integer | 否 | — | 语音导航 id（与 --ivr-name 二选一，不可同时为空） |
| --ivr-name | text | 否 | — | 语音导航名称（与 --ivr-id 二选一，不可同时为空） |

###### E.1.3.27.3 `zenava callcenter ivr-profile detail`
获取 IVR 详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ivr-id | integer | 否 | — | 语音导航 id（一类企业接入 可选；二类企业接入 不支持，传此参将拒绝） |
| --ivr-name | text | 否 | — | 语音导航名称（二类企业接入 必填；一类企业接入 不支持，传此参将拒绝） |

###### E.1.3.27.4 `zenava callcenter ivr-profile export`
导出 IVR 信息为 txt（失败不落盘）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ivr-id | integer | 否 | — | 语音导航 id（一类企业接入 必填；二类企业接入 与 --ivr-name 一并透传服务端，同时传入时优先使用名称） |
| --ivr-name | text | 否 | — | 语音导航名称（可选；与 --ivr-id 一并透传服务端） |
| --output | text | 是 | — | 导出文件本地保存路径（必选；仅成功时写入） |

###### E.1.3.27.5 `zenava callcenter ivr-profile import`
导入 IVR 信息文件（仅支持文件导入）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 是 | — | 语音导航信息文件（必选；可由 export 获得；最大 10M） |

###### E.1.3.27.6 `zenava callcenter ivr-profile list`
获取 IVR 列表信息

###### E.1.3.27.7 `zenava callcenter ivr-profile property-help`
打印语音导航节点 property 说明（本地，无需鉴权）

###### E.1.3.28 `zenava callcenter ivr-router`
呼入路由设置列表查询
**子命令：** `list`
本级命令无专属参数。

###### E.1.3.28.1 `zenava callcenter ivr-router list`
获取呼入路由设置列表

###### E.1.3.29 `zenava callcenter ivr-script`
IVR 脚本管理
**子命令：** `create`、`create-version`、`delete`、`get`、`list`、`update`、`update-version`
本级命令无专属参数。

###### E.1.3.29.1 `zenava callcenter ivr-script create`
新建脚本（不自动产生已发布版本）。正文仅通过 --script-file 提供
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --script-file | text | 否 | — | 可选初始正文文件路径（UTF-8）；不自动形成已发布版本 |
| --description | text | 否 | — | 描述，最长 100 |
| --name | text | 是 | — | 脚本名称，最长 20，企业内唯一 |

###### E.1.3.29.2 `zenava callcenter ivr-script create-version`
新建暂存版本（同时只允许一个暂存，版本上限 5）。正文仅通过 --script-file 提供
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --description | text | 否 | — | 版本描述 |
| --script-file | text | 是 | — | 暂存版本正文文件路径（UTF-8）；同时只允许一个暂存，版本上限 5 |
| --script-id | text | 是 | — | 脚本 ID |

###### E.1.3.29.3 `zenava callcenter ivr-script delete`
删除脚本及其版本（被语音导航节点或推送配置占用时不可删）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --script-id | text | 是 | — | 待删除的脚本 ID |

###### E.1.3.29.4 `zenava callcenter ivr-script get`
按 scriptId 查询脚本详情；有暂存时优先返回暂存正文
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --script-id | text | 是 | — | 脚本 ID |

###### E.1.3.29.5 `zenava callcenter ivr-script list`
查询脚本列表（按名称过滤，不含正文）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 否 | — | 按名称模糊过滤 |

###### E.1.3.29.6 `zenava callcenter ivr-script update`
更新脚本（名称、描述、生效版本或灰度）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --gray-percent | integer | 否 | — | 灰度百分比，须大于 0 |
| --gray-version | integer | 否 | — | 灰度版本号 |
| --active-version | integer | 否 | — | 切换生效版本（须已发布，且不能与灰度版本相同） |
| --description | text | 否 | — | 新描述，最长 100 |
| --name | text | 否 | — | 新名称，最长 20 |
| --script-id | text | 是 | — | 脚本 ID |

###### E.1.3.29.7 `zenava callcenter ivr-script update-version`
更新或发布版本（publish=true 发布暂存；setActive 仅在发布时生效）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --set-active | text | 否 | — | 发布后是否设为生效：true 或 false；未指定则不传；仅 publish=true 时有效 |
| --publish | text | 否 | — | 是否发布暂存：true 或 false；未指定则不传。setActive 仅在 publish=true 时有效 |
| --description | text | 否 | — | 版本描述 |
| --script-file | text | 否 | — | 可选：更新正文的文件路径（UTF-8） |
| --version | integer | 是 | — | 版本号 |
| --script-id | text | 是 | — | 脚本 ID |

###### E.1.3.30 `zenava callcenter monitor`
平台监控与实时统计（座席/队列/话机/业务/中继）
**子命令：** `agent`、`enterprise-call-latest`、`exten`、`queue`、`statistics-agent`、`statistics-investigation`、`statistics-queue`、`trunk-monitor`
本级命令无专属参数。

###### E.1.3.30.1 `zenava callcenter monitor agent`
查询座席监控信息
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --qnos | text | 否 | — | 队列号，逗号分隔，最多 500 |
| --cnos | text | 否 | — | 座席工号，逗号分隔，最多 500 |
| --state-code | text | 否 | — | s1 空闲 s2 置忙 s3 整理 s4 呼叫中 s5 响铃 s6 通话（逗号分隔） |
| --pause-type | text | 否 | — | 1 普通 2 休息 3 IM 4 强制（逗号分隔） |
| --pause-description | text | 否 | — | 置忙原因，逗号分隔 |
| --limit | integer | 否 | 10 | 条数 1–500 |
| --offset | integer | 否 | 0 | 从第几条开始 |

###### E.1.3.30.2 `zenava callcenter monitor enterprise-call-latest`
获取企业最新业务监控信息

###### E.1.3.30.3 `zenava callcenter monitor exten`
查询话机监控信息
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --extens | text | 否 | — | 分机号，逗号分隔，最多 100（与 cnos 二选一，优先 extens） |
| --cnos | text | 否 | — | 座席工号，逗号分隔，最多 100 |

###### E.1.3.30.4 `zenava callcenter monitor queue`
查询队列监控信息
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --queue-monitor-fields | text | 是 | — | 统计项：queueParams,agentStatuses,queueEntries,agentSummary（逗号分隔） |
| --qnos | text | 否 | — | 队列号，逗号分隔 |
| --qnames | text | 否 | — | 队列名称 |
| --cnos | text | 否 | — | 座席工号，逗号分隔 |

###### E.1.3.30.5 `zenava callcenter monitor statistics-agent`
查询当天座席实时统计数据
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --fields | text | 否 | — | 统计项名称，逗号分隔 |
| --cnos | text | 否 | — | 座席工号，逗号分隔 |
| --is-use-gno | integer | 否 | 0 | 0 关闭 1 开启外呼组查询 |
| --gno | text | 否 | — | 外呼组编号，逗号分隔 |
| --limit | integer | 否 | 10 | 条数，最大 500 |
| --offset | integer | 否 | 0 | 起始条数 |
| --start-hour | integer | 否 | — | 统计时段开始小时，0–23 |
| --end-hour | integer | 否 | — | 统计时段结束小时，1–24 |
| --is-need-queue-name | text | 否 | 0 | 0 不需要 1 需要返回队列名称 |

###### E.1.3.30.6 `zenava callcenter monitor statistics-investigation`
查询当天满意度调查实时统计数据
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --fields | text | 否 | — | 统计项名称，逗号分隔 |
| --cnos | text | 否 | — | 座席工号，逗号分隔 |

###### E.1.3.30.7 `zenava callcenter monitor statistics-queue`
查询当天队列实时统计数据
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --fields | text | 否 | — | 统计项名称，逗号分隔 |
| --qnos | text | 否 | — | 队列号，逗号分隔 |

###### E.1.3.30.8 `zenava callcenter monitor trunk-monitor`
获取中继组上一分钟实时并发数

###### E.1.3.31 `zenava callcenter push-action`
推送设置管理 推送类型 type（list / create / update 共用，叶子 --help 不重复展开）。 来电： 1=来电到达推送 2=座席侧响铃推送 5=来电接听推送 7=来电挂断推送 38=来电转移接听推送 39=来电咨询接听推送 54=队列排队详情推送 外呼： 3=预览外呼座席侧响铃推送 19=预览外呼客户侧响铃推送 6=预览外呼通话接听推送 8=外呼通话挂断推送 37=预览外呼座席接听推送 23=主叫外呼分机响铃推送 24=主叫外呼分机接听推送 25=主叫外呼客户侧响铃推送 26=主叫外呼双方接听推送 31=预测外呼客户侧响铃推送 16=预测外呼客户接听推送 17=预测外呼双方接听推送 42=预测外呼任务状态推送 52=预测外呼呼叫失败推送 53=预测外呼导入号码失败结果推送 1060=预测外呼降级执行结果推送 4=WebCall转接响铃推送 14=WebCall首叫响铃推送 20=WebCall首叫接听推送 22=WebCall转接接听推送 32=WebCall请求回调推送 SIP接入： 34=SIP接入推送 35=SIP接入响铃推送 36=SIP接入接听推送 状态： 9=座席状态变更推送 11=号码状态识别推送 12=录音状态推送 转写： 13=离线转写（ASR）结果推送 29=实时转写（RASR）结果推送 55=对话分析结果推送 58=智能体转写文本推送（整体） 1062=智能体转写文本推送（逐句） 其他： 10=DTMF按键推送 15=满意度调查结果推送 18=IVR交互完成推送 28=放音推送 27=会议室进出事件推送 40=主通话记录推送 41=从通话记录推送 51=号码管理操作日志推送 1059=录音质量分析推送 1061=机器人接通事件推送 scriptInputParamList[].type（脚本入参类型）。 create / update 的 --script-input-param-list 使用。 1=变量 2=固定值 3=毫秒时间戳 4=随机字符串 pushParamList[].type（脚本生成参数类型，create / update 的 --push-param-list 使用）。 1=变量 2=param（URL 参数） 3=header 4=body 5=body（覆盖）
**子命令：** `create`、`delete`、`export`、`get`、`import`、`list`、`update`
本级命令无专属参数。

###### E.1.3.31.1 `zenava callcenter push-action create`
新增推送设置
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --push-param-list | text | 否 | — | 脚本生成参数 JSON 数组；元素字段：desc（String，脚本生成参数描述）、name（String，脚本生成参数名称）、type（Integer，脚本生成参数类型，取值见 push-action --help）；示例：[{"desc":"d","name":"n","type":1}] |
| --script-input-param-list | text | 否 | — | 脚本入参 JSON 数组；元素字段：paramDesc（String，脚本入参描述）、paramName（String，脚本入参名称）、type（Integer，脚本入参类型，取值见 push-action --help）、paramVariable（String，脚本入参变量值）；示例：[{"paramDesc":"d","paramName":"n","type":1,"paramVariable":"v"}] |
| --params | text | 否 | — | 推送参数 JSON 数组；元素字段：encryptionRuleId（Integer，加密规则 ID，无加密传 -1）、paramName（String，参数描述名称）、paramVar（String，推送变量值）、pushParamName（String，推送参数名）、paramType（String，参数类型，未传时服务端默认 2）；示例：[{"encryptionRuleId":-1,"paramName":"企业ID","paramVar":"enterpriseId","pushParamName":"enterpriseId","paramType":"2"}] |
| --meet-conditions | text | 否 | — | 条件设置 JSON 数组；元素字段：conditionRelationship（String 数组，组内条件关系，例如 ["and"]）、meetGroup（对象数组，条件明细）。meetGroup 元素：condition（String，条件字段）、ruleName（String，比较规则）、ruleValue（String，比较值）；示例：[{"conditionRelationship":["and"],"meetGroup":[{"condition":"callType","ruleName":"eq","ruleValue":"5"}]}] |
| --delayed-push | text | 否 | — | 延迟推送 JSON 对象；字段：delay（Integer，延迟推送秒数，范围 0~900）；示例：{"delay":10} |
| --retry-strategy | text | 否 | — | 重试策略 JSON 对象；字段：retry（Integer，重试次数）、intervalTime（Integer，重试间隔，单位秒）；传入后优先于顶层 --retry/--interval-time；示例：{"retry":3,"intervalTime":20} |
| --custom-script-id | integer | 否 | — | 数据加工脚本 ID |
| --custom-script-switch | integer | 否 | — | 数据加工开关：0=关闭，1=开启 |
| --push-agent | integer | 否 | — | 座席推送：0=不推送，1=座席端，2=http+座席端 |
| --call-type | integer | 否 | — | 呼叫类型 |
| --interval-time | integer | 否 | — | 重试间隔秒 0~60 |
| --active | integer | 否 | — | 是否启用：0=停用，1=启用 |
| --retry | integer | 否 | — | 重试次数 0~3（无 retryStrategy 时） |
| --timeout | integer | 否 | — | 直配超时秒数 1~10 |
| --content-type | integer | 否 | — | 直配内容类型：1=form，2=json |
| --method | integer | 否 | — | 直配请求方式：0=POST，1=GET |
| --url | text | 否 | — | 直配目标地址（未传 target-url-id 时常用） |
| --target-url-id | integer | 否 | — | 目标接口 ID（目标接口模式） |
| --type | integer | 是 | — | 推送类型（Integer），取值见 push-action --help |
| --name | text | 是 | — | 推送设置名称（企业内唯一） |

###### E.1.3.31.2 `zenava callcenter push-action delete`
删除推送设置
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 推送设置 ID |

###### E.1.3.31.3 `zenava callcenter push-action export`
导出推送设置（JSON 文件流）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 推送设置 ID |
| --output | text | 否 | — | 导出文件本地路径；省略则将文件体打印到 stdout |

###### E.1.3.31.4 `zenava callcenter push-action get`
查询推送设置详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 否 | — | 推送设置名称 |
| --id | integer | 否 | — | 推送设置 ID |

###### E.1.3.31.5 `zenava callcenter push-action import`
导入推送设置
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 是 | — | 页面导出或 export 得到的 JSON 文件路径 |
| --active | integer | 是 | — | 导入后启用状态：0=停用，1=启用 |

###### E.1.3.31.6 `zenava callcenter push-action list`
分页查询推送设置列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --page-size | integer | 否 | — | 每页条数，默认 10，最大 100 |
| --page-number | integer | 否 | — | 页码，从 1 开始 |
| --url | text | 否 | — | 按目标接口地址过滤 |
| --type | integer | 否 | — | 推送类型（Integer），取值见 push-action --help |
| --name | text | 否 | — | 按名称模糊查询 |

###### E.1.3.31.7 `zenava callcenter push-action update`
更新推送设置
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --push-param-list | text | 否 | — | 脚本生成参数 JSON 数组；元素字段：desc（String，脚本生成参数描述）、name（String，脚本生成参数名称）、type（Integer，脚本生成参数类型，取值见 push-action --help）；示例：[{"desc":"d","name":"n","type":1}] |
| --script-input-param-list | text | 否 | — | 脚本入参 JSON 数组；元素字段：paramDesc（String，脚本入参描述）、paramName（String，脚本入参名称）、type（Integer，脚本入参类型，取值见 push-action --help）、paramVariable（String，脚本入参变量值）；示例：[{"paramDesc":"d","paramName":"n","type":1,"paramVariable":"v"}] |
| --params | text | 否 | — | 推送参数 JSON 数组；元素字段：encryptionRuleId（Integer，加密规则 ID，无加密传 -1）、paramName（String，参数描述名称）、paramVar（String，推送变量值）、pushParamName（String，推送参数名）、paramType（String，参数类型，未传时服务端默认 2）；示例：[{"encryptionRuleId":-1,"paramName":"企业ID","paramVar":"enterpriseId","pushParamName":"enterpriseId","paramType":"2"}] |
| --meet-conditions | text | 否 | — | 条件设置 JSON 数组；元素字段：conditionRelationship（String 数组，组内条件关系，例如 ["and"]）、meetGroup（对象数组，条件明细）。meetGroup 元素：condition（String，条件字段）、ruleName（String，比较规则）、ruleValue（String，比较值）；示例：[{"conditionRelationship":["and"],"meetGroup":[{"condition":"callType","ruleName":"eq","ruleValue":"5"}]}] |
| --delayed-push | text | 否 | — | 延迟推送 JSON 对象；字段：delay（Integer，延迟推送秒数，范围 0~900）；示例：{"delay":10} |
| --retry-strategy | text | 否 | — | 重试策略 JSON 对象；字段：retry（Integer，重试次数）、intervalTime（Integer，重试间隔，单位秒）；传入后优先于顶层 --retry/--interval-time；示例：{"retry":3,"intervalTime":20} |
| --custom-script-id | integer | 否 | — | 数据加工脚本 ID |
| --custom-script-switch | integer | 否 | — | 数据加工开关：0=关闭，1=开启 |
| --push-agent | integer | 否 | — | 座席推送：0=不推送，1=座席端，2=http+座席端 |
| --call-type | integer | 否 | — | 呼叫类型 |
| --interval-time | integer | 否 | — | 重试间隔秒 0~60 |
| --active | integer | 否 | — | 是否启用：0=停用，1=启用 |
| --retry | integer | 否 | — | 重试次数 0~3 |
| --timeout | integer | 否 | — | 直配超时秒数 1~10 |
| --content-type | integer | 否 | — | 直配内容类型：1=form，2=json |
| --method | integer | 否 | — | 直配请求方式：0=POST，1=GET |
| --url | text | 否 | — | 直配目标地址 |
| --target-url-id | integer | 否 | — | 目标接口 ID |
| --type | integer | 否 | — | 推送类型（Integer），取值见 push-action --help |
| --name | text | 否 | — | 推送设置名称 |
| --id | integer | 是 | — | 推送设置 ID |

###### E.1.3.32 `zenava callcenter push-target`
推送目标接口管理
**子命令：** `create`、`delete`、`get`、`list`、`update`
本级命令无专属参数。

###### E.1.3.32.1 `zenava callcenter push-target create`
新增目标接口
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --timeout | integer | 否 | — | 超时秒数，范围 1~10 |
| --content-type | integer | 是 | — | 内容类型：1=form，2=json |
| --method | integer | 是 | — | 请求方式：0=POST，1=GET |
| --url | text | 是 | — | 目标接口地址 |
| --name | text | 是 | — | 目标接口名称（企业内唯一） |

###### E.1.3.32.2 `zenava callcenter push-target delete`
删除目标接口
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 目标接口 ID |

###### E.1.3.32.3 `zenava callcenter push-target get`
查询目标接口详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 目标接口 ID |

###### E.1.3.32.4 `zenava callcenter push-target list`
分页查询目标接口列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --page-size | integer | 否 | — | 每页条数，默认 10，最大 100 |
| --page-number | integer | 否 | — | 页码，从 1 开始 |
| --name | text | 否 | — | 按名称模糊查询 |

###### E.1.3.32.5 `zenava callcenter push-target update`
更新目标接口
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --timeout | integer | 否 | — | 超时秒数，范围 1~10 |
| --content-type | integer | 否 | — | 内容类型：1=form，2=json |
| --method | integer | 否 | — | 请求方式：0=POST，1=GET |
| --url | text | 否 | — | 目标接口地址 |
| --name | text | 否 | — | 目标接口名称 |
| --id | integer | 是 | — | 目标接口 ID |

###### E.1.3.33 `zenava callcenter rasr`
RASR 机器人对话事件查询
**子命令：** `query`
本级命令无专属参数。

###### E.1.3.33.1 `zenava callcenter rasr query`
查询 RASR 事件信息
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --unique-id | text | 是 | — | 通话唯一标识 |

###### E.1.3.34 `zenava callcenter record`
通话录音：获取试听/下载地址
**子命令：** `get-batch-url`、`get-info`、`get-url`
本级命令无专属参数。

###### E.1.3.34.1 `zenava callcenter record get-batch-url`
批量获取录音试听/下载 URL（getBatchUrl）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --record-type | text | 是 | — | record 录音 voicemail 留言 tsi 彩铃 rasr 机器人客户侧 transfer 转接 consult 咨询 threeway 三方 |
| --record-file | text | 是 | — | 录音文件名，逗号分隔，最多 50 个 |
| --record-format | integer | 否 | — | 0 mp3 1 wav |
| --call-type | integer | 否 | — | 1 呼入 2 webcall 4 预览外呼 5 预测外呼 |
| --record-side | integer | 否 | — | 1 客户侧 2 座席侧（仅 wav；非空时 --call-type 必选） |
| --download | integer | 否 | — | 0 试听 1 下载 |

###### E.1.3.34.2 `zenava callcenter record get-info`
根据录音文件名获取试听/下载 URL
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --record-file | text | 是 | — | 录音文件名 |
| --record-type | text | 否 | — | record 录音 voicemail 留言 tsi 彩铃 rasr 机器人客户侧 transfer 转接 consult 咨询 threeway 三方 |
| --record-format | integer | 否 | — | 0 mp3 1 wav |
| --call-type | integer | 否 | — | 1 呼入 2 webcall 4 预览外呼 5 预测外呼 |
| --record-side | integer | 否 | — | 1 客户侧 2 座席侧（仅 wav；非空时 --call-type 必选） |
| --download | integer | 否 | — | 0 试听 1 下载 |
| --output | text | 否 | — | 落盘路径 |

###### E.1.3.34.3 `zenava callcenter record get-url`
根据录音文件名获取试听/下载 URL（getUrl）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --record-file | text | 是 | — | 录音文件名 |
| --record-type | text | 否 | — | record 录音 voicemail 留言 tsi 彩铃 rasr 机器人客户侧 transfer 转接 consult 咨询 threeway 三方 |
| --record-format | integer | 否 | — | 0 mp3 1 wav |
| --call-type | integer | 否 | — | 1 呼入 2 webcall 4 预览外呼 5 预测外呼 |
| --record-side | integer | 否 | — | 1 客户侧 2 座席侧（仅 wav；非空时 --call-type 必选） |
| --download | integer | 否 | — | 0 试听 1 下载 |

###### E.1.3.35 `zenava callcenter report`
数据报表（outboundReport）
**子命令：** `ob-callee-number`
本级命令无专属参数。

###### E.1.3.35.1 `zenava callcenter report ob-callee-number`
外呼被叫号码话单详情报表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --time-range-type | integer | 是 | — | 统计类型：1 日报表 2 周报表 3 月报表 4 自定义时间 |
| --statistic-method | integer | 是 | — | 统计方法：0 分时 1 分日 2 汇总 |
| --start-time | text | 是 | — | 开始时间，yyyy-MM-dd |
| --end-time | text | 是 | — | 结束时间，yyyy-MM-dd |
| --cnos | text | 否 | — | 座席工号，逗号分隔，最多 100 个 |
| --customer-number | text | 否 | — | 被叫号码 |
| --call-type | text | 否 | — | 呼叫类型：4 预览外呼 6 主叫外呼 |
| --start-hour | integer | 否 | 0 | 统计时段开始时间，取值 0–23 |
| --end-hour | integer | 否 | 23 | 统计时段结束时间，取值 0–23 |
| --start | integer | 否 | 0 | 查询起始位置，≥0 |
| --limit | integer | 否 | 10 | 查询条数，最大 1000 |

###### E.1.3.36 `zenava callcenter skill`
技能与座席/队列关系查询
**子命令：** `list-relation`
本级命令无专属参数。

###### E.1.3.36.1 `zenava callcenter skill list-relation`
查询技能座席队列关系
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --relation-type | text | 是 | — | 关系类型：qno 队列 / cno 座席 |
| --name | text | 否 | — | 技能名称 |
| --id | text | 否 | — | 技能 ID（与 name 二选一） |
| --limit | integer | 否 | 10 | 查询条数 |
| --offset | integer | 否 | 0 | 起始偏移 |

###### E.1.3.37 `zenava callcenter stat`
统计报表（/cc/stat_*）
**子命令：** `display-number`
本级命令无专属参数。

###### E.1.3.37.1 `zenava callcenter stat display-number`
外显号码报表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --start-time | text | 是 | — | 开始时间，yyyy-MM-dd |
| --end-time | text | 是 | — | 结束时间，yyyy-MM-dd |
| --statistic-method | integer | 否 | 2 | 统计方式：1 分日；2 汇总；3 分时累计；4 时序统计 |
| --display-numbers | text | 否 | — | 外显号码列表，逗号分隔；不传默认查询全部 |
| --trunk-group-keys | text | 否 | — | 中继组编号列表，逗号分隔 |
| --call-types | text | 否 | — | 呼叫类型筛选，逗号分隔：1,2,4,5,6（6 为主叫外呼） |
| --area-codes | text | 否 | — | 区号列表，逗号分隔，如 021,028 |
| --summary-type | integer | 否 | 1 | 汇总视角：1 按外显号码汇总；2 按中继组汇总 |
| --answered-rate-field | text | 否 | — | 接听率筛选字段，须与 --answered-rate-gt 配合：autoCustomerAnsweredRate；directCustomerAnsweredRate；ibTransferAnsweredRate；predictiveAgentAnsweredRate；predictiveCustomerAnsweredRate；previewCustomerAnsweredRate；sipAnsweredRate；webcallFirstAnsweredRate；webcallTransferAnsweredRate |
| --answered-rate-gt | number | 否 | — | 接听率阈值，仅保留严格大于该值的数据；须与 --answered-rate-field 配合 |
| --total-count-gt | integer | 否 | — | 外呼总数阈值，仅保留严格大于该值的数据 |
| --start-hour | integer | 否 | — | 开始小时，取值 0–23 |
| --end-hour | integer | 否 | — | 结束小时，取值 1–23，且必须大于 startHour |
| --field-to-sort | text | 否 | — | 排序字段，传返回字段中的英文 key |
| --sort-desc | boolean | 否 | true | 是否倒序：true 降序，false 升序 |

###### E.1.3.38 `zenava callcenter task`
预测/自动外呼任务管理、批次查询与运行监控
**子命令：** `create`、`delete`、`delete-tel`、`get`、`get-file`、`import-tel`、`list-file`、`list-tel`、`monitor`、`monitor-tasks`、`pause`、`query`、`start`、`stop`、`update`
本级命令无专属参数。

###### E.1.3.38.1 `zenava callcenter task create`
创建预测外呼或自动外呼任务（任务类型通过 type 字段区分）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --is-rewarm | integer | 否 | — | 0 关 1 暂停后重新预热 [default: 1] |
| --warm-up-duration | integer | 否 | — | 预热秒数 [default: 300] |
| --answer-rate | integer | 否 | — | 预热接通率 [default: 50] |
| --customer-voice | text | 否 | — | 客户侧提示音 path |
| --customer-moh | text | 否 | — | 客户侧等待音 path |
| --call-limit-strategy | text | 否 | — | 座席当日接听数限制 JSON |
| --predict-adjust | integer | 否 | — | 超呼率 [default: 100] |
| --quotiety | number | 否 | — | 骚扰率 [default: 1] |
| --min-available-agent-count | integer | 否 | — | 最小可用座席数 [default: 10] |
| --max-wait-time | integer | 否 | — | 座席最长等待秒数 [default: 40] |
| --wrapup | integer | 否 | — | 座席整理秒数 [default: 30] |
| --agent-timeout | integer | 否 | — | 座席超时秒数 [default: 10] |
| --call-strategy | integer | 否 | — | 1 随机 2 顺序 3 未进线最长 4 空闲最长 [default: 1] |
| --agent-group | text | 否 | — | 外呼组号 |
| --cnos | text | 否 | — | 座席工号列表，逗号分隔 |
| --ivr-name | text | 否 | — | 语音导航名称 |
| --ivr-id | integer | 否 | — | 语音导航 Id |
| --call-route-strategy | integer | 否 | — | 1 直连座席 2 AI转人工 |
| --time-strategy | text | 否 | — | 禁呼时间条件编号，逗号分隔 |
| --call-variables | text | 否 | — | 座席通道变量 JsonArray |
| --user-fields | text | 否 | — | 任务自定义字段 JsonArray |
| --concurrency | integer | 否 | — | 最大并发限制 |
| --customer-timeout | integer | 否 | — | 客户超时秒数 [default: 30] |
| --clid-pool-list | text | 否 | — | 号码池列表 JSON 字符串 |
| --customer-clids-group | text | 否 | — | 外显导航标识 |
| --customer-clids-category | integer | 否 | — | 5 外显导航 |
| --call-priority-strategy | text | 否 | — | 呼叫顺序 JSON 字符串 |
| --retry-strategy-only-today | integer | 否 | — | 0 否 1 仅当天生效 [default: 0] |
| --retry-strategy-time-type | integer | 否 | — | 重试时间类型：1 首次 2 上次 [default: 1] |
| --retry-strategy | text | 否 | — | 重试策略 JSON 字符串 |
| --auto-complete | integer | 否 | — | 自动完成：0 关闭 1 开启 [default: 1] |
| --auto-trigger-time-strategy | text | 否 | — | 间隔呼叫时间段，逗号分隔编号 |
| --auto-task-type | integer | 否 | — | 呼叫方式：0 连续 1 间隔 [default: 0] |
| --force-end-flag | integer | 否 | — | 定时完成强制结束：0 关闭 1 开启 [default: 0] |
| --auto-stop-time | text | 否 | — | 定时完成时间 HH:mm:ss |
| --auto-stop-day | text | 否 | — | 定时完成日期 yyyy-MM-dd |
| --auto-stop | integer | 否 | — | 定时完成：0 关闭 1 开启 [default: 0] |
| --auto-start-time | text | 否 | — | 定时开始时间 HH:mm:ss |
| --auto-start-day | text | 否 | — | 定时开始日期 yyyy-MM-dd |
| --auto-start | integer | 否 | — | 定时开始：0 关闭 1 开启 [default: 0] |
| --business-tag-names | text | 否 | — | 业务标签，英文逗号分隔 |
| --description | text | 否 | — | 任务描述 |
| --call-group-type | integer | 否 | — | 指定座席方式：1 工号 2 外呼组 [default: 1] |
| --auto-delete | integer | 否 | — | 超额自动删除：0 关闭 1 开启 [default: 0] |
| --template-name | text | 否 | — | 任务模板名称 |
| --type | integer | 是 | — | 1 预测外呼 2 自动外呼 |
| --name | text | 是 | — | 任务名称 |

###### E.1.3.38.2 `zenava callcenter task delete`
删除预测外呼或自动外呼任务（仅初始或完成状态可删，号码一并删除）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 是 | — | 任务 Id |

###### E.1.3.38.3 `zenava callcenter task delete-tel`
删除任务号码（按号码/批次/状态等，优先级由服务端决定）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 是 | — | 任务 Id |
| --file-id | text | 否 | — | 批次 Id |
| --file-name | text | 否 | — | 批次名称 |
| --status | integer | 否 | — | 号码状态 0 未呼叫 1 已呼叫 |
| --tels | text | 否 | — | 电话号码，逗号分隔 |

###### E.1.3.38.4 `zenava callcenter task get`
获取外呼任务信息，根据任务 Id 获取单个任务的配置信息
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 是 | — | 任务 Id |

###### E.1.3.38.5 `zenava callcenter task get-file`
获取任务批次信息
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 是 | — | 任务 Id |
| --file-id | text | 是 | — | 批次 Id |

###### E.1.3.38.6 `zenava callcenter task import-tel`
按批次导入号码，一次导入一个批次。 CSV 格式（UTF-8；首行为表头）：   必填列: tel 可选列: property, priority, backupTels, clid, answerRateLevel, clidGroup   列说明: tel 被叫号码（空行跳过） property 随路数据 / 自定义属性（字符串，常为 JSON） priority 号码级优先级（整数） backupTels 备用号码 clid 外呼显号 answerRateLevel 应答率等级（浮点数） clidGroup 显号组   示例: tel,priority,backupTels,clid 13800000001,1,13900000002,02112345678
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 是 | — | 任务 Id |
| --name | text | 是 | — | 批次名称 |
| --file | text | 是 | — | 本地号码 CSV 路径（须含表头 tel；可选列见本命令说明） |
| --batch-size | integer | 否 | 100000 | 单批导入上限（单批≤10 万） |
| --file-id | text | 否 | — | 向已有批次追加号码 |
| --priority | integer | 否 | — | 批次级优先级，0–999999 |
| --is-repeat | integer | 否 | — | 0 不排重 1 任务内排重 2 导入排重 3 批次内排重 |
| --bridge-voice-path | text | 否 | — | 座席接听双侧开场白语音变量值 |
| --bridge-voice-type | integer | 否 | — | 1 公共语音库 2 企业静态 3 企业动态 |
| --import-tel-auto-start | integer | 否 | — | 0 不自动启动 1 导入后自动启动任务 |

###### E.1.3.38.7 `zenava callcenter task list-file`
获取任务批次列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 是 | — | 任务 Id |
| --status | integer | 否 | — | 0 未导入 1 导入完成 2 加载到缓存 3 呼叫完 |
| --start-time | text | 否 | — | 统计开始时间，如 "2026-01-01 00:00:00" |
| --end-time | text | 否 | — | 统计结束时间，如 "2026-01-31 23:59:59" |
| --start | integer | 否 | 0 | 查询起始位置 |
| --limit | integer | 否 | 10 | 查询条数，最大 5000 |

###### E.1.3.38.8 `zenava callcenter task list-tel`
任务号码查询
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 是 | — | 任务 Id |
| --file-id | text | 否 | — | 批次 Id |
| --file-name | text | 否 | — | 批次名称筛选 |
| --status | text | 否 | — | 0 未呼叫 1 已呼叫 |
| --is-restrict | integer | 否 | — | 0 不在黑名单 1 在黑名单 |
| --tel | text | 否 | — | 号码筛选 |
| --backup-tel | text | 否 | — | 备选号码筛选 |
| --offset | integer | 否 | 0 | 从第几条开始 |
| --limit | integer | 否 | 10 | 查询条数，最大 5000 |
| --return-count | integer | 否 | — | 0 不返回总条数 1 返回 [default: 0] |
| --call-time-start | integer | 否 | — | 最近一次呼叫开始时间（Unix 秒，须与 --call-time-end 成对） |
| --call-time-end | integer | 否 | — | 最近一次呼叫结束时间（Unix 秒，须与 --call-time-start 成对） |
| --first-call-time-start | integer | 否 | — | 第一次呼叫开始时间（Unix 秒，须与 --first-call-time-end 成对） |
| --first-call-time-end | integer | 否 | — | 第一次呼叫结束时间（Unix 秒，须与 --first-call-time-start 成对） |

###### E.1.3.38.9 `zenava callcenter task monitor`
查询指定任务的监控详情（运行中或暂停状态有监控数据）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 是 | — | 外呼任务 id |
| --type | integer | 是 | — | 1 当日统计 2 任务汇总统计 |

###### E.1.3.38.10 `zenava callcenter task monitor-tasks`
查询运行中或暂停状态的外呼任务监控总览
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 否 | — | 外呼任务 id |
| --type | integer | 否 | — | 1 预测外呼 2 自动外呼 |
| --status | integer | 否 | — | 1 运行中 2 暂停 |
| --status-trigger-type | integer | 否 | — | 0 系统触发 1 人为触发 |
| --name | text | 否 | — | 任务名称，模糊查询 |
| --offset | integer | 否 | 0 | 从第几条开始获取 |
| --limit | integer | 否 | 10 | 取出条数，最大 100 |

###### E.1.3.38.11 `zenava callcenter task pause`
暂停预测外呼任务
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 是 | — | 任务 Id |
| --pause-duration | integer | 否 | — | 暂停时长 [default: 0] |

###### E.1.3.38.12 `zenava callcenter task query`
获取外呼任务列表，支持按照条件查询
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --type | integer | 是 | — | 1 预测外呼 2 自动外呼 |
| --name | text | 否 | — | 任务名称（模糊筛选） |
| --status | integer | 否 | — | 0 初始 1 运行 2 暂停 3 结束 |
| --auto-start | integer | 否 | — | 0 关闭 1 开启定时开始 |
| --auto-stop | integer | 否 | — | 0 关闭 1 开启定时完成 |
| --time-type | integer | 否 | — | 1 任务启动时间 2 任务结束时间 3 任务创建时间 |
| --start-time | text | 否 | — | 如 "2019-10-11 00:00:00" |
| --end-time | text | 否 | — | 如 "2019-10-11 23:59:59" |
| --start | integer | 否 | 0 | 从第几条开始 |
| --limit | integer | 否 | 10 | 取出条数，最大 100 |

###### E.1.3.38.13 `zenava callcenter task start`
启动预测外呼任务
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 是 | — | 任务 Id |

###### E.1.3.38.14 `zenava callcenter task stop`
结束预测外呼任务
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --task-id | text | 是 | — | 任务 Id |

###### E.1.3.38.15 `zenava callcenter task update`
更新外呼任务属性
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --is-rewarm | integer | 否 | — | 0 关 1 暂停后重新预热 [default: 1] |
| --warm-up-duration | integer | 否 | — | 预热秒数 [default: 300] |
| --answer-rate | integer | 否 | — | 预热接通率 [default: 50] |
| --customer-voice | text | 否 | — | 客户侧提示音 path |
| --customer-moh | text | 否 | — | 客户侧等待音 path |
| --call-limit-strategy | text | 否 | — | 座席当日接听数限制 JSON |
| --predict-adjust | integer | 否 | — | 超呼率 [default: 100] |
| --quotiety | number | 否 | — | 骚扰率 [default: 1] |
| --min-available-agent-count | integer | 否 | — | 最小可用座席数 [default: 10] |
| --max-wait-time | integer | 否 | — | 座席最长等待秒数 [default: 40] |
| --wrapup | integer | 否 | — | 座席整理秒数 [default: 30] |
| --agent-timeout | integer | 否 | — | 座席超时秒数 [default: 10] |
| --call-strategy | integer | 否 | — | 1 随机 2 顺序 3 未进线最长 4 空闲最长 [default: 1] |
| --agent-group | text | 否 | — | 外呼组号 |
| --cnos | text | 否 | — | 座席工号列表，逗号分隔 |
| --ivr-name | text | 否 | — | 语音导航名称 |
| --ivr-id | integer | 否 | — | 语音导航 Id |
| --call-route-strategy | integer | 否 | — | 1 直连座席 2 AI转人工 |
| --time-strategy | text | 否 | — | 禁呼时间条件编号，逗号分隔 |
| --call-variables | text | 否 | — | 座席通道变量 JsonArray |
| --user-fields | text | 否 | — | 任务自定义字段 JsonArray |
| --concurrency | integer | 否 | — | 最大并发限制 |
| --customer-timeout | integer | 否 | — | 客户超时秒数 [default: 30] |
| --clid-pool-list | text | 否 | — | 号码池列表 JSON 字符串 |
| --customer-clids-group | text | 否 | — | 外显导航标识 |
| --customer-clids-category | integer | 否 | — | 5 外显导航 |
| --call-priority-strategy | text | 否 | — | 呼叫顺序 JSON 字符串 |
| --retry-strategy-only-today | integer | 否 | — | 0 否 1 仅当天生效 [default: 0] |
| --retry-strategy-time-type | integer | 否 | — | 重试时间类型：1 首次 2 上次 [default: 1] |
| --retry-strategy | text | 否 | — | 重试策略 JSON 字符串 |
| --auto-complete | integer | 否 | — | 自动完成：0 关闭 1 开启 [default: 1] |
| --auto-trigger-time-strategy | text | 否 | — | 间隔呼叫时间段，逗号分隔编号 |
| --auto-task-type | integer | 否 | — | 呼叫方式：0 连续 1 间隔 [default: 0] |
| --force-end-flag | integer | 否 | — | 定时完成强制结束：0 关闭 1 开启 [default: 0] |
| --auto-stop-time | text | 否 | — | 定时完成时间 HH:mm:ss |
| --auto-stop-day | text | 否 | — | 定时完成日期 yyyy-MM-dd |
| --auto-stop | integer | 否 | — | 定时完成：0 关闭 1 开启 [default: 0] |
| --auto-start-time | text | 否 | — | 定时开始时间 HH:mm:ss |
| --auto-start-day | text | 否 | — | 定时开始日期 yyyy-MM-dd |
| --auto-start | integer | 否 | — | 定时开始：0 关闭 1 开启 [default: 0] |
| --business-tag-names | text | 否 | — | 业务标签，英文逗号分隔 |
| --description | text | 否 | — | 任务描述 |
| --name | text | 否 | — | 任务名称 |
| --task-id | text | 是 | — | 外呼任务 Id |

###### E.1.3.39 `zenava callcenter task-template`
外呼任务模板管理
**子命令：** `create`、`delete`、`get`、`query`、`update`
本级命令无专属参数。

###### E.1.3.39.1 `zenava callcenter task-template create`
新增外呼任务模板
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --is-rewarm | integer | 否 | — | 暂停后重新预热：0 关 1 开（主要为预测） [default: 1] |
| --warm-up-duration | integer | 否 | — | 预热秒数 60~600（主要为预测） [default: 300] |
| --answer-rate | integer | 否 | — | 预热接通率 1~100（主要为预测） [default: 50] |
| --customer-voice | text | 否 | — | 客户侧提示音 path（主要为预测） |
| --customer-moh | text | 否 | — | 客户侧等待音 path（主要为预测） |
| --call-limit-strategy | text | 否 | — | 座席当日接听数限制 JsonArray（主要为预测） |
| --predict-adjust | integer | 否 | — | 超呼率 50~400（主要为预测） [default: 100] |
| --quotiety | number | 否 | — | 骚扰率（主要为预测） [default: 1] |
| --min-available-agent-count | integer | 否 | — | 最小可用座席数 [default: 10] |
| --max-wait-time | integer | 否 | — | 座席最长等待秒数 [default: 40] |
| --wrapup | integer | 否 | — | 座席整理秒数 [default: 30] |
| --agent-timeout | integer | 否 | — | 座席超时秒数 [default: 10] |
| --call-strategy | integer | 否 | — | 座席分配：1 随机 2 顺序 3 未进线最长 4 空闲最长 [default: 1] |
| --agent-group | text | 否 | — | 外呼组号（callGroupType=2；主要为预测） |
| --cnos | text | 否 | — | 座席工号列表，逗号分隔（callGroupType=1；主要为预测） |
| --call-group-type | integer | 否 | — | 指定座席方式：1 工号列表 2 外呼组 [default: 1]（主要为预测） |
| --call-route-strategy | integer | 否 | — | 呼叫流转：1 直连座席 2 AI转人工（主要为预测/type=1） |
| --ivr-name | text | 否 | — | 语音导航名称（与 ivrId 二选一） |
| --ivr-id | integer | 否 | — | 语音导航 Id（与 ivrName 二选一，同时传以 Id 为准） |
| --auto-delete | integer | 否 | — | 超额自动删除：0 关闭 1 自动删除（仅接口调用时生效） |
| --time-strategy | text | 否 | — | 禁呼时间条件编号，逗号分隔 |
| --call-variables | text | 否 | — | 座席通道变量 JsonArray，最多 5 个 |
| --user-fields | text | 否 | — | 任务自定义字段 JsonArray；请求键为 userFields（非 taskFields） |
| --concurrency | integer | 否 | — | 最大并发限制（不超过企业上限） |
| --customer-timeout | integer | 否 | — | 客户超时秒数，范围 5~60 [default: 30] |
| --clid-pool-list | text | 否 | — | 外显导航号码池列表 JSON（主要为 一类企业接入；二类企业接入 可能不支持） |
| --customer-clids-group | text | 否 | — | 外显导航标识 |
| --customer-clids-category | integer | 否 | — | 客户侧外显号码类型：5 外显导航 |
| --call-priority-strategy | text | 否 | — | 呼叫顺序 JSON 字符串 |
| --retry-strategy-only-today | integer | 否 | — | 任务仅当天生效：0 关 1/2/3 见文档 [default: 0] |
| --retry-strategy-time-type | integer | 否 | — | 重试时间类型：1 基于首次呼叫 2 基于上次呼叫 [default: 1] |
| --retry-strategy | text | 否 | — | 重试策略 JSON 或 JsonArray 字符串 |
| --auto-complete | integer | 否 | — | 自动完成：0 关闭 1 开启 [default: 1] |
| --auto-trigger-time-strategy | text | 否 | — | 间隔呼叫时间段，时间条件编号逗号分隔（autoTaskType=1 必填） |
| --auto-task-type | integer | 否 | — | 呼叫方式：0 连续 1 间隔 [default: 0] |
| --force-end-flag | integer | 否 | — | 定时完成时强制结束：0 关闭 1 开启 [default: 0] |
| --auto-stop-time | text | 否 | — | 定时完成时间 HH:mm:ss（autoStop=1 时生效） |
| --auto-stop-day | text | 否 | — | 定时完成日期 yyyy-MM-dd（autoStop=1 时生效） |
| --auto-stop | integer | 否 | — | 定时完成：0 关闭 1 开启 [default: 0] |
| --auto-start-time | text | 否 | — | 定时开始时间 HH:mm:ss（autoStart=1 时生效） |
| --auto-start-day | text | 否 | — | 定时开始日期 yyyy-MM-dd（autoStart=1 时生效） |
| --auto-start | integer | 否 | — | 定时开始：0 关闭 1 开启 [default: 0] |
| --business-tag-names | text | 否 | — | 业务标签名称，英文逗号分隔，如 标签A,标签B |
| --description | text | 否 | — | 任务模板描述，UTF-8 URLEncode，长度小于200字 |
| --type | integer | 是 | — | 任务类型：1 预测外呼 2 自动外呼（一类企业接入 必填；二类企业接入 文档无此参） |
| --name | text | 是 | — | 任务模板名称，UTF-8 URLEncode，长度小于50字 |

###### E.1.3.39.2 `zenava callcenter task-template delete`
删除外呼任务模板
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 否 | — | 模板名称（一类企业接入 必填；二类企业接入 与 template-id 至少其一） |
| --template-id | integer | 否 | — | 模板 Id（仅 二类企业接入；与 name 同时传时 Id 优先；一类企业接入 传此参将拒绝） |

###### E.1.3.39.3 `zenava callcenter task-template get`
获取单个外呼任务模板
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 否 | — | 模板名称（一类企业接入 必填；二类企业接入 与 template-id 至少其一） |
| --template-id | integer | 否 | — | 模板 Id（仅 二类企业接入；与 name 同时传时 Id 优先；一类企业接入 传此参将拒绝） |

###### E.1.3.39.4 `zenava callcenter task-template query`
查询外呼任务模板列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --type | integer | 否 | — | 任务类型：1 预测外呼 2 自动外呼（一类企业接入 必填；二类企业接入 不传服务端） |
| --name | text | 否 | — | 模板名称，模糊查询 |
| --description | text | 否 | — | 模板描述，模糊查询 |
| --start | integer | 否 | — | 分页起始位置（一类企业接入 默认 0） |
| --limit | integer | 否 | — | 分页条数（一类企业接入 默认 10、最大 100；二类企业接入 文档默认 -1 不分页） |

###### E.1.3.39.5 `zenava callcenter task-template update`
更新外呼任务模板
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --is-rewarm | integer | 否 | — | 暂停后重新预热：0 关 1 开（主要为预测） [default: 1] |
| --warm-up-duration | integer | 否 | — | 预热秒数 60~600（主要为预测） [default: 300] |
| --answer-rate | integer | 否 | — | 预热接通率 1~100（主要为预测） [default: 50] |
| --customer-voice | text | 否 | — | 客户侧提示音 path（主要为预测） |
| --customer-moh | text | 否 | — | 客户侧等待音 path（主要为预测） |
| --call-limit-strategy | text | 否 | — | 座席当日接听数限制 JsonArray（主要为预测） |
| --predict-adjust | integer | 否 | — | 超呼率 50~400（主要为预测） [default: 100] |
| --quotiety | number | 否 | — | 骚扰率（主要为预测） [default: 1] |
| --min-available-agent-count | integer | 否 | — | 最小可用座席数 [default: 10] |
| --max-wait-time | integer | 否 | — | 座席最长等待秒数 [default: 40] |
| --wrapup | integer | 否 | — | 座席整理秒数 [default: 30] |
| --agent-timeout | integer | 否 | — | 座席超时秒数 [default: 10] |
| --call-strategy | integer | 否 | — | 座席分配：1 随机 2 顺序 3 未进线最长 4 空闲最长 [default: 1] |
| --agent-group | text | 否 | — | 外呼组号（callGroupType=2；主要为预测） |
| --cnos | text | 否 | — | 座席工号列表，逗号分隔（callGroupType=1；主要为预测） |
| --call-group-type | integer | 否 | — | 指定座席方式：1 工号列表 2 外呼组 [default: 1]（主要为预测） |
| --call-route-strategy | integer | 否 | — | 呼叫流转：1 直连座席 2 AI转人工（主要为预测/type=1） |
| --ivr-name | text | 否 | — | 语音导航名称（与 ivrId 二选一） |
| --ivr-id | integer | 否 | — | 语音导航 Id（与 ivrName 二选一，同时传以 Id 为准） |
| --auto-delete | integer | 否 | — | 超额自动删除：0 关闭 1 自动删除（仅接口调用时生效） |
| --time-strategy | text | 否 | — | 禁呼时间条件编号，逗号分隔 |
| --call-variables | text | 否 | — | 座席通道变量 JsonArray，最多 5 个 |
| --user-fields | text | 否 | — | 任务自定义字段 JsonArray；请求键为 userFields（非 taskFields） |
| --concurrency | integer | 否 | — | 最大并发限制（不超过企业上限） |
| --customer-timeout | integer | 否 | — | 客户超时秒数，范围 5~60 [default: 30] |
| --clid-pool-list | text | 否 | — | 外显导航号码池列表 JSON（主要为 一类企业接入；二类企业接入 可能不支持） |
| --customer-clids-group | text | 否 | — | 外显导航标识 |
| --customer-clids-category | integer | 否 | — | 客户侧外显号码类型：5 外显导航 |
| --call-priority-strategy | text | 否 | — | 呼叫顺序 JSON 字符串 |
| --retry-strategy-only-today | integer | 否 | — | 任务仅当天生效：0 关 1/2/3 见文档 [default: 0] |
| --retry-strategy-time-type | integer | 否 | — | 重试时间类型：1 基于首次呼叫 2 基于上次呼叫 [default: 1] |
| --retry-strategy | text | 否 | — | 重试策略 JSON 或 JsonArray 字符串 |
| --auto-complete | integer | 否 | — | 自动完成：0 关闭 1 开启 [default: 1] |
| --auto-trigger-time-strategy | text | 否 | — | 间隔呼叫时间段，时间条件编号逗号分隔（autoTaskType=1 必填） |
| --auto-task-type | integer | 否 | — | 呼叫方式：0 连续 1 间隔 [default: 0] |
| --force-end-flag | integer | 否 | — | 定时完成时强制结束：0 关闭 1 开启 [default: 0] |
| --auto-stop-time | text | 否 | — | 定时完成时间 HH:mm:ss（autoStop=1 时生效） |
| --auto-stop-day | text | 否 | — | 定时完成日期 yyyy-MM-dd（autoStop=1 时生效） |
| --auto-stop | integer | 否 | — | 定时完成：0 关闭 1 开启 [default: 0] |
| --auto-start-time | text | 否 | — | 定时开始时间 HH:mm:ss（autoStart=1 时生效） |
| --auto-start-day | text | 否 | — | 定时开始日期 yyyy-MM-dd（autoStart=1 时生效） |
| --auto-start | integer | 否 | — | 定时开始：0 关闭 1 开启 [default: 0] |
| --business-tag-names | text | 否 | — | 业务标签名称，英文逗号分隔，如 标签A,标签B |
| --description | text | 否 | — | 任务模板描述，UTF-8 URLEncode，长度小于200字 |
| --type | integer | 否 | — | 任务类型：1 预测 2 自动（主要为 一类企业接入） |
| --new-name | text | 否 | — | 修改后的模板名称；不传则不改名 |
| --name | text | 是 | — | 原任务模板名称 |

###### E.1.3.40 `zenava callcenter tts`
TTS 音色
**子命令：** `list`
本级命令无专属参数。

###### E.1.3.40.1 `zenava callcenter tts list`
查询当前企业可用的 TTS 音色列表 成功时 stdout 为完整 JSON。主要字段：   ttsVoiceTypes[] 按供应商分组的音色列表 ttsEngine Integer 引擎编号；写入节点 property 时用 supplierCode String 供应商编码，仅展示，不可代替 ttsEngine supplierName String 供应商名称 description String 供应商说明，可空 voices[] 该引擎下当前企业可见音色 name String 音色展示名 ttsVoiceType String 音色标识；写入节点 property 时用 （音色标识已含平台前缀规则时请原样写入） rate Integer 采样率 Hz，可空 tip String 音色说明，可空 使用注意：   - ttsEngine 与 ttsVoiceType 须取自同一分组下的同一音色项，不可跨组拼装。 - 无可见音色时 ttsVoiceTypes 为 []，仍表示成功。 - 语速/音量/音调（ttsSpeed/ttsVolume/ttsPitch）本接口不返回； 节点需要时在 property 中另行指定（常见范围 0.5～2.0，缺省 1.0）

###### E.1.3.41 `zenava callcenter webcall`
发起 webcall 呼叫
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --tel | text | 是 | — | 被叫号码，可逗号分隔多号 |
| --request-unique-id | text | 否 | — | 请求唯一标识 |
| --user-field | text | 否 | — | 用户自定义字段 |
| --timeout | integer | 否 | 30 | 呼叫超时秒数 |
| --amd | integer | 否 | 0 | 0 关闭 1 开启 AMD |
| --delay | integer | 否 | 0 | 延迟秒数 |
| --multi-tel-delay | integer | 否 | 0 | 多号码呼叫间隔秒数 |
| --multi-tel-push | integer | 否 | 0 | 0 顺序 1 同时 |
| --clid | text | 否 | — | 外显号码 |
| --clid-group | text | 否 | — | 外显号码组 |
| --clid-area-code | text | 否 | — | 外显区号 |
| --clid-list-json | text | 否 | — | 外显号码列表 JSON 数组字符串 |
| --ivr-id | text | 否 | — | IVR 流程 ID |
| --crn-id | text | 否 | — | 客户号码池 ID |
| --vid | integer | 否 | 1 | 语音文件 ID |
| --retry | integer | 否 | — | 重试次数 |
| --retry-interval | integer | 否 | — | 重试间隔秒数 |
| --expir-time | text | 否 | — | 过期时间 |
| --param-names | text | 否 | — | 动态参数名，逗号分隔 |
| --param-types | text | 否 | — | 动态参数类型，逗号分隔 |
| --param | text | 否 | — | 动态参数 KEY=VALUE，可重复 |

##### E.1.4 `zenava crm`
客户管理（按企业开通）
**子命令：** `business`、`customer`、`customize-menu`、`enterprise`、`field-sync`、`form-field`、`group`、`http-push`
本级命令无专属参数。

###### E.1.4.1 `zenava crm business`
业务记录
**子命令：** `count`、`create`、`get`、`list`
本级命令无专属参数。

###### E.1.4.1.1 `zenava crm business count`
查询业务记录条数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --customize | text | 否 | — | 自定义字段筛选 JSON 对象。key 为自定义字段 id，value 为筛选值。示例：'{"1":"","2":""}' |
| --customer-name | text | 否 | — | 客户名称 |
| --customer-tel | text | 否 | — | 客户号码 |
| --source | integer | 否 | — | 来源。0: 呼叫中心，1: 在线客服-网页，2: 在线客服-微信，3: 人工添加，4: 在线客服-小程序，5: 在线客服-微博，6: 电子邮件，7: app端，8: 在线客服-企业微信，9: 在线客服-微信客服（独立版），10: 在线客服-第三方接入，11: 呼叫中心-呼入，12: 呼叫中心-外呼，13: 呼叫中心-webcall，15: 在线客服-百度营销，16: 在线客服-自定义渠道，18: 在线客服-APP，19: 在线客服-微信客服，21: 在线客服-企微客服，23: 在线客服-飞书，24：座席助手，25：企微助手，30：接口创建 |
| --chat-id | text | 否 | — | 会话ID |
| --call-id | text | 否 | — | 通话ID |
| --customer-id | integer | 否 | — | 客户ID |
| --update-end-time | integer | 否 | — | 业务记录更新结束时间（十位秒级时间戳）。传值时 updateStartTime 必传 |
| --update-start-time | integer | 否 | — | 业务记录更新开始时间（十位秒级时间戳）。传值时 updateEndTime 必传 |
| --end-time | integer | 否 | — | 业务记录创建结束时间（十位秒级时间戳）。传值时 startTime 必传 |
| --start-time | integer | 否 | — | 业务记录创建开始时间（十位秒级时间戳）。传值时 endTime 必传 |

###### E.1.4.1.2 `zenava crm business create`
新增业务记录
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --chat-unique-id | text | 否 | — | 在线从会话ID |
| --call-unique-id | text | 否 | — | 从通话记录ID |
| --chat-start-time | integer | 否 | — | 会话添加开始时间（用于确定会话数据索引） |
| --customize | text | 否 | — | 自定义字段 JSON 数组。元素含 name（字段名称）、value（字段值）。   '[{"name":"备注","value":"这是一条备注"}]' |
| --source | integer | 否 | — | 来源。0: 呼叫中心，1: 在线客服-网页，2: 在线客服-微信，3: 人工添加，4: 在线客服-小程序，5: 在线客服-微博，6: 电子邮件，7: app端，8: 在线客服-企业微信，9: 在线客服-微信客服（独立版），10: 在线客服-第三方接入，11: 呼叫中心-呼入，12: 呼叫中心-外呼，13: 呼叫中心-webcall，15: 在线客服-百度营销，16: 在线客服-自定义渠道，18: 在线客服-APP，19: 在线客服-微信客服，21: 在线客服-企微客服，23: 在线客服-飞书，24：座席助手，25：企微助手，30：接口创建 |
| --topic | text | 否 | — | 业务主题 |
| --call-id | text | 否 | — | 通话记录ID。customerId / chatId / callId 必填其一（服务端校验） |
| --chat-id | text | 否 | — | 在线会话ID。customerId / chatId / callId 必填其一（服务端校验） |
| --customer-id | integer | 否 | — | 客户ID。customerId / chatId / callId 必填其一（由服务端校验；CLI 不强制） |

###### E.1.4.1.3 `zenava crm business get`
查询业务记录详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 业务记录 Id |

###### E.1.4.1.4 `zenava crm business list`
查询业务记录列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --customize | text | 否 | — | 自定义字段筛选 JSON 对象。key 为自定义字段 id，value 为筛选值。示例：'{"1":"","2":""}' |
| --customer-name | text | 否 | — | 客户名称 |
| --customer-tel | text | 否 | — | 客户号码 |
| --source | integer | 否 | — | 来源。0: 呼叫中心，1: 在线客服-网页，2: 在线客服-微信，3: 人工添加，4: 在线客服-小程序，5: 在线客服-微博，6: 电子邮件，7: app端，8: 在线客服-企业微信，9: 在线客服-微信客服（独立版），10: 在线客服-第三方接入，11: 呼叫中心-呼入，12: 呼叫中心-外呼，13: 呼叫中心-webcall，15: 在线客服-百度营销，16: 在线客服-自定义渠道，18: 在线客服-APP，19: 在线客服-微信客服，21: 在线客服-企微客服，23: 在线客服-飞书，24：座席助手，25：企微助手，30：接口创建 |
| --topic | text | 否 | — | 业务主题 |
| --chat-id | text | 否 | — | 会话ID |
| --call-id | text | 否 | — | 通话ID |
| --customer-id | integer | 否 | — | 客户ID |
| --update-end-time | integer | 否 | — | 业务记录更新结束时间（十位秒级时间戳）。传值时 updateStartTime 必传 |
| --update-start-time | integer | 否 | — | 业务记录更新开始时间（十位秒级时间戳）。传值时 updateEndTime 必传 |
| --end-time | integer | 否 | — | 业务记录创建结束时间（十位秒级时间戳）。传值时 startTime 必传 |
| --start-time | integer | 否 | — | 业务记录创建开始时间（十位秒级时间戳）。传值时 endTime 必传 |
| --limit | integer | 否 | — | 查询条数，范围 10-100，默认 10 |
| --offset | integer | 否 | — | 偏移量，范围大于等于 0，默认 0 |

###### E.1.4.2 `zenava crm customer`
客户资料
**子命令：** `create`、`delete`、`label`、`list`、`params`、`query`、`update`、`update-by-external-id`、`update-relevancy`
本级命令无专属参数。

###### E.1.4.2.1 `zenava crm customer create`
创建客户资料
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --label-id | integer | 否 | — | 客户标签 id，可多次指定 |
| --visitor-id | text | 否 | — | 访客 ID，可多次指定 |
| --source | integer | 否 | — | 来源：0 呼叫中心、1 在线咨询、2 微信、3 人工添加、4 小程序、5 微博、6 电子邮件、7 app端、8 企业微信、9 微信客服（独立版）、10 第三方接入、15 百度营销、16 自定义渠道、18 APP、19 微信客服、21 企微客服、23 飞书、24 座席助手、25 企微助手、30 接口创建。创建时默认 30 |
| --external-id | text | 否 | — | 外部企业客户 ID |
| --address | text | 否 | — | 地址 |
| --remark | text | 否 | — | 备注 |
| --email | text | 否 | — | 邮箱 |
| --sex | integer | 否 | — | 客户性别：0 男、1 女 |
| --share | text | 否 | — | 客户归属（员工组号或工号） |
| --level | integer | 否 | — | 客户等级：0 普通、1 VIP |
| --tel | text | 否 | — | 客户号码，可多次指定（String[]） |
| --name | text | 否 | — | 客户名称 |
| --customize | text | 是 | — | 自定义字段 JSON array。每项需 id、value；name 可省略或空字符串。示例：'[{"id":440,"name":"","value":"1"}]' |
| --share-type | integer | 是 | — | 归属类型：0 全体共享、1 员工组共享、2 员工私有、3 无归属。取 1 或 2 时须同时传 --share |

###### E.1.4.2.2 `zenava crm customer delete`
删除客户资料
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 客户 Id |

###### E.1.4.2.3 `zenava crm customer label`
客户标签
**子命令：** `list`
本级命令无专属参数。

###### E.1.4.2.3.1 `zenava crm customer label list`
查询客户资料可用标签
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 否 | — | 标签名称 |

###### E.1.4.2.4 `zenava crm customer list`
查询客户资料列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --last-chat-contact-end-time | integer | 否 | — | 最后在线客服联系时间-结束（秒级 Unix 时间戳，如 1536201058） |
| --last-chat-contact-start-time | integer | 否 | — | 最后在线客服联系时间-开始（秒级 Unix 时间戳，如 1536201058） |
| --last-cc-contact-end-time | integer | 否 | — | 最后电话联系时间-结束（秒级 Unix 时间戳，如 1536201058） |
| --last-cc-contact-start-time | integer | 否 | — | 最后电话联系时间-开始（秒级 Unix 时间戳，如 1536201058） |
| --first-chat-contact-end-time | integer | 否 | — | 首次在线客服联系时间-结束（秒级 Unix 时间戳，如 1536201058） |
| --first-chat-contact-start-time | integer | 否 | — | 首次在线客服联系时间-开始（秒级 Unix 时间戳，如 1536201058） |
| --first-cc-contact-end-time | integer | 否 | — | 首次电话联系时间-结束（秒级 Unix 时间戳，如 1536201058） |
| --first-cc-contact-start-time | integer | 否 | — | 首次电话联系时间-开始（秒级 Unix 时间戳，如 1536201058） |
| --first-contact-end-time | integer | 否 | — | 首次联系时间-结束（秒级 Unix 时间戳，如 1536201058） |
| --first-contact-start-time | integer | 否 | — | 首次联系时间-开始（秒级 Unix 时间戳，如 1536201058） |
| --last-contact-end-time | integer | 否 | — | 最后一次联系时间-结束（秒级 Unix 时间戳，如 1536201058） |
| --last-contact-start-time | integer | 否 | — | 最后一次联系时间-开始（秒级 Unix 时间戳，如 1536201058） |
| --assign-end-time | integer | 否 | — | 分配时间-结束（秒级 Unix 时间戳，如 1536201058） |
| --assign-start-time | integer | 否 | — | 分配时间-开始（秒级 Unix 时间戳，如 1536201058） |
| --retrieve-end-time | integer | 否 | — | 回收时间-结束（秒级 Unix 时间戳，如 1536201058） |
| --retrieve-start-time | integer | 否 | — | 回收时间-开始（秒级 Unix 时间戳，如 1536201058） |
| --last-repeat-promote-end-time | integer | 否 | — | 最近一次重复推广时间-结束（秒级 Unix 时间戳，如 1536201058） |
| --last-repeat-promote-start-time | integer | 否 | — | 最近一次重复推广时间-开始（秒级 Unix 时间戳，如 1536201058） |
| --update-end-time | integer | 否 | — | 修改时间范围-结束（秒级 Unix 时间戳，如 1536201058） |
| --update-start-time | integer | 否 | — | 修改时间范围-开始（秒级 Unix 时间戳，如 1536201058） |
| --end-time | integer | 否 | — | 创建时间范围-结束（秒级 Unix 时间戳，如 1536201058） |
| --start-time | integer | 否 | — | 创建时间范围-开始（秒级 Unix 时间戳，如 1536201058） |
| --customer-params | text | 否 | — | 查询条件 JSON object。key 为字段 id（先执行 crm customer params 获取），value 为查询值。简单示例：'{"45":"男","46":"17600055818"}'。客户归属 0 全体共享：'{"49":{"shareType":0}}'；1 员工组：'{"49":{"shareType":1,"share":"0001"}}'；2 员工私有：'{"49":{"shareType":2,"share":"0001"}}'；3 无归属：'{"49":{"shareType":3}}'。等级：0 普通、1 VIP。性别：0 男、1 女。来源：0 呼叫中心、1 在线咨询、2 微信、3 人工添加、4 小程序、5 微博、6 电子邮件、7 app端、8 企业微信、9 微信客服（独立版）、10 第三方接入、15 百度营销、16 自定义渠道、18 APP、19 微信客服、21 企微客服、23 飞书、24 座席助手、25 企微助手、30 接口创建。级联/复选框多个值用英文逗号分隔，如 '北京,北京市'。自定义日期/时间字段须同时传开始和结束：日期时间 '2019/09/09 00:00:00,2019/09/09 23:59:59'；日期 '2019/09/09,2019/09/09'；时间 '00:00:00,23:59:59' |
| --limit | integer | 否 | — | 查询条数，范围 10-100，默认 10 |
| --offset | integer | 否 | — | 偏移量，默认 0 |

###### E.1.4.2.5 `zenava crm customer params`
获取可用查询参数

###### E.1.4.2.6 `zenava crm customer query`
查询客户资料
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --tel | text | 否 | — | 电话号码（非加密） |
| --visitor-id | text | 否 | — | 访客 ID |
| --customer-id | integer | 否 | — | 客户资料 id |

###### E.1.4.2.7 `zenava crm customer update`
更新客户资料
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --label-id | integer | 否 | — | 客户标签 id，可多次指定 |
| --external-id | text | 否 | — | 外部企业客户 ID |
| --customize | text | 否 | — | 自定义字段 JSON array。每项需 id、value；name 可省略或空字符串。示例：'[{"id":440,"name":"","value":"1"}]' |
| --renovate | integer | 否 | — | 更新方式：0 增量更新（空值不覆盖）、1 全量覆盖（默认 1） |
| --address | text | 否 | — | 地址 |
| --remark | text | 否 | — | 备注 |
| --email | text | 否 | — | 邮箱 |
| --sex | integer | 否 | — | 客户性别：0 男、1 女 |
| --share | text | 否 | — | 客户归属（员工组号或工号） |
| --level | integer | 否 | — | 客户等级：0 普通、1 VIP |
| --tel | text | 否 | — | 客户号码，可多次指定（String[]） |
| --name | text | 否 | — | 客户名称 |
| --visitor-id | text | 否 | — | 访客 ID |
| --id | integer | 否 | — | 客户 ID，不传则按 visitorId 更新 |
| --share-type | integer | 是 | — | 归属类型：0 全体共享、1 员工组共享、2 员工私有、3 无归属。取 1 或 2 时须同时传 --share |

###### E.1.4.2.8 `zenava crm customer update-by-external-id`
根据第三方 ID 更新客户资料
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --label-id | integer | 否 | — | 客户标签 id，可多次指定 |
| --customize | text | 否 | — | 自定义字段 JSON array。每项需 id、value；name 可省略或空字符串。示例：'[{"id":440,"name":"","value":"1"}]' |
| --renovate | integer | 否 | — | 更新方式：0 增量更新（空值不覆盖）、1 全量覆盖（默认 1） |
| --address | text | 否 | — | 地址 |
| --remark | text | 否 | — | 备注 |
| --email | text | 否 | — | 邮箱 |
| --sex | integer | 否 | — | 客户性别：0 男、1 女 |
| --share | text | 否 | — | 客户归属（员工组号或工号） |
| --level | integer | 否 | — | 客户等级：0 普通、1 VIP |
| --tel | text | 否 | — | 客户号码，可多次指定（String[]） |
| --name | text | 否 | — | 客户名称 |
| --share-type | integer | 是 | — | 归属类型：0 全体共享、1 员工组共享、2 员工私有、3 无归属。取 1 或 2 时须同时传 --share |
| --external-id | text | 是 | — | 外部企业客户 ID（定位键，必填） |

###### E.1.4.2.9 `zenava crm customer update-relevancy`
更新客户关联
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --operation-type | integer | 否 | — | 更新方式：null/0 增加 visitorId 关联；1 解除 visitorId 关联；2 更新关联的企业客户。0/1 须传 --visitor-id；2 须传 --enterprise-customer-id |
| --enterprise-customer-id | integer | 否 | — | 企业客户 ID；operationType 为 2 时必传 |
| --visitor-id | text | 否 | — | 访客 ID；operationType 为 0 或 1 时必传 |
| --id | integer | 是 | — | 客户 ID |

###### E.1.4.3 `zenava crm customize-menu`
CRM 自定义 Tab（customize_menu）配置。 在客户资料详情、呼叫工作台、在线工作台嵌入第三方页面；企业最多 5 条（服务端强制）。   入参形态： displayRange / effectiveRange 用逗号分隔（如 --display-range a,b） Object / JSON / JSON 数组用 --*-json   displayRange（至少一项；禁止过时值 customerAgentDetail / customerConsoleDetail）： agentTodayCall 座席端今日通话 agentTodoCall 座席端待处理通话 agentHistoryCall 座席端通话历史 agentChatTodoCall 座席端待处理会话 agentChatQueueCall 座席端排队中会话 agentChatSkimCall 座席端浏览中会话 agentChatHistoryCall 座席端历史会话 consoleCustomerDetail 管理员-客户资料详情 agentCustomerDetail 座席-客户资料详情   effectiveRange（至少一项）： effectiveCustomerDetail 客户管理 effectiveCallcenter 呼叫工作台 effectiveOnline 在线工作台   菜单变量（--menu-var-json）： type：0 系统变量，1 自定义变量，2 客户变量，3 企业客户变量 code：仅系统变量必填，见下方 type=0 key：URL 参数名，同一菜单内不可重复，最长 100（按字符码计） value：见各类型说明 check：是否勾选，0 否，1 是。不传默认 1   系统变量 type=0（页面固定 7 项，用 code 认，不是任意 key）。第三列是默认 key： 1 企业 enterpriseId 8 客户ID customerId 9 客户名称 customerName 10 电话 customerTel 11 等级 customerLevel 12 通话ID/会话ID mainUniqueId 13 座席工号 cno key 不传则回填默认 key；传入则作为页面「自定义变量值」，即改写 URL 参数名。 系统变量没有取值字段，value 不用传，服务置空。code 不可重复。   自定义变量 type=1：key、value 都是调用方自填，均必填，最长 100。最多 10 个。code 不传默认 0。   客户变量 type=2：key 为 URL 参数名（自填）；value 为客户模块字段，系统字段传 key，自定义字段传 fieldId 字符串。须是该企业客户资料字段。   企业客户变量 type=3：同客户变量，但 value 须是企业客户模块字段。   popupMethod：0 IFrame，1 新窗口（未传默认 0） enabled：0 关闭，1 启用（创建未传默认 0） securityFlag：0/1；为 1 时 --external-token 必填 名称规则（1–8 字符等）由服务端校验；改排序只走 sort，update 不改 priority。 叶子命令 --help 含各 JSON 明细与示例。
**子命令：** `create`、`delete`、`enable`、`get`、`get-tab-url`、`list`、`sort`、`update`
本级命令无专属参数。

###### E.1.4.3.1 `zenava crm customize-menu create`
新建自定义 Tab
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 是 | — | Tab 名称（必填；规则见组 --help） |
| --link | text | 是 | — | 第三方页面地址（必填） |
| --display-range | text | 是 | — | 展示范围，逗号分隔；枚举见 crm customize-menu --help |
| --effective-range | text | 是 | — | 生效范围，逗号分隔；枚举见 crm customize-menu --help |
| --icon | text | 否 | — | 图标，默认 app:customize_menu_0 |
| --popup-method | integer | 否 | — | 0 IFrame，1 新窗口；枚举见 crm customize-menu --help |
| --enabled | integer | 否 | — | 0 关闭，1 启用；枚举见 crm customize-menu --help |
| --security-flag | integer | 否 | — | 对接鉴权 0/1；为 1 时 --external-token 必填 |
| --external-token | text | 否 | — | 第三方 token；securityFlag=1 时必填。示例占位 YOUR_TOKEN |
| --menu-var-json | text | 否 | — | URL 变量 JSON array。元素：type(0系统/1自定义/2客户/3企业客户)、key、value 或 code、check(0/1)。type=0/1/2/3 的规则与 code 枚举见 crm customize-menu --help。示例：'[{"key":"customerId","type":0,"code":8,"check":1},{"key":"from","type":1,"value":"crm","check":1}]' |

###### E.1.4.3.2 `zenava crm customize-menu delete`
删除自定义 Tab
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 菜单主键（必填） |

###### E.1.4.3.3 `zenava crm customize-menu enable`
启停自定义 Tab
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 菜单主键（必填） |
| --enabled | integer | 是 | — | 目标状态：0 关闭，1 启用（非翻转） |

###### E.1.4.3.4 `zenava crm customize-menu get`
查询自定义 Tab 详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 菜单主键（必填） |

###### E.1.4.3.5 `zenava crm customize-menu get-tab-url`
预览自定义 Tab 最终 URL
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 菜单主键（必填） |
| --param-json | text | 是 | — | 预览变量 JSON object；无变量必须传 {}。示例：'{"customerId":"10001","from":"crm"}' 或 '{}' |

###### E.1.4.3.6 `zenava crm customize-menu list`
查询自定义 Tab 列表

###### E.1.4.3.7 `zenava crm customize-menu sort`
自定义 Tab 排序
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --menus-json | text | 否 | — | 排序项 JSON array。元素：id（int）、priority（int）；空数组合法（无操作）。示例：'[{"id":2,"priority":1},{"id":1,"priority":2}]' |

###### E.1.4.3.8 `zenava crm customize-menu update`
更新自定义 Tab
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 菜单主键（必填） |
| --name | text | 否 | — | 名称（可选；不传沿用原值） |
| --link | text | 否 | — | 第三方页面地址（可选） |
| --display-range | text | 否 | — | 展示范围，逗号分隔；枚举见 crm customize-menu --help |
| --effective-range | text | 否 | — | 生效范围，逗号分隔；枚举见 crm customize-menu --help |
| --icon | text | 否 | — | 图标，默认 app:customize_menu_0 |
| --popup-method | integer | 否 | — | 0 IFrame，1 新窗口；枚举见 crm customize-menu --help |
| --enabled | integer | 否 | — | 0 关闭，1 启用；枚举见 crm customize-menu --help |
| --security-flag | integer | 否 | — | 对接鉴权 0/1；为 1 时 --external-token 必填 |
| --external-token | text | 否 | — | 第三方 token；securityFlag=1 时必填。示例占位 YOUR_TOKEN |
| --menu-var-json | text | 否 | — | URL 变量 JSON array。元素：type(0系统/1自定义/2客户/3企业客户)、key、value 或 code、check(0/1)。type=0/1/2/3 的规则与 code 枚举见 crm customize-menu --help。示例：'[{"key":"customerId","type":0,"code":8,"check":1},{"key":"from","type":1,"value":"crm","check":1}]' |

###### E.1.4.4 `zenava crm enterprise`
企业客户
**子命令：** `create`、`delete`、`query`、`update`
本级命令无专属参数。

###### E.1.4.4.1 `zenava crm enterprise create`
创建企业客户
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --source | integer | 否 | — | 来源。30：接口创建。默认接口创建 |
| --customize | text | 是 | — | 自定义字段 JSON 数组。每项需 id、value；name 可省略。示例：'[{"id":440,"name":"","value":"1"}]' |
| --share-no | text | 否 | — | 客户归属：员工组共享时为组号，员工私有时为工号；shareType 为 1 或 2 时必传 |
| --share-type | integer | 是 | — | 归属类型：0 全体共享、1 员工组共享、2 员工私有。取 1 或 2 时须同时传 --share-no |
| --level | text | 否 | — | 客户等级（后台配置） |
| --name | text | 否 | — | 企业客户名称（后台配置） |

###### E.1.4.4.2 `zenava crm enterprise delete`
删除企业客户
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 企业客户 Id |

###### E.1.4.4.3 `zenava crm enterprise query`
查询企业客户
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 否 | — | 企业名称 |
| --id | integer | 否 | — | 企业客户 id；不传则按 --name 查询 |

###### E.1.4.4.4 `zenava crm enterprise update`
更新企业客户
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --customize | text | 是 | — | 自定义字段 JSON 数组。每项需 id、value；name 可省略。示例：'[{"id":440,"name":"","value":"1"}]' |
| --share-no | text | 否 | — | 客户归属：员工组共享时为组号，员工私有时为工号；shareType 为 1 或 2 时必传 |
| --share-type | integer | 否 | — | 归属类型：0 全体共享、1 员工组共享、2 员工私有。取 1 或 2 时须同时传 --share-no |
| --level | text | 否 | — | 客户等级（后台配置） |
| --name | text | 否 | — | 企业客户名称（后台配置） |
| --name-search | text | 否 | — | 企业客户名称（查询用）；与 --id 至少传其一 |
| --id | integer | 否 | — | 企业客户 ID；不传则按 --name-search 更新 |
| --renovate | integer | 否 | — | 更新方式：0 增量更新（空值不覆盖）、1 全量覆盖（默认 1） |

###### E.1.4.5 `zenava crm field-sync`
CRM 字段同步配置。 坐席在业务记录或企业客户表单改触发字段后，按规则调第三方并回写本条记录。  客户资料、群客户无此能力；企业每 type 最多 5 条。   type（规则对象）： 1 业务记录 2 企业客户   action： 1 失焦 2 选值后（外部拓展触发必须为 2，其它触发必须为 1）   enabled： 0 关闭 1 启用 仅 enable / list 筛选使用。   method：仅 GET（CLI --method 默认 GET）。   ID 语义： triggerFieldId 与 syncFields[].fieldId 均为 field 表主键（fieldId）。 可选字段用 list-optional-field 查询。   触发字段类型： 业务记录仅单行 1 不限制 / 2 数值 / 3 邮箱 / 4 IP地址 企业客户再加 18 外部拓展   回写字段类型： 1 不限制 / 2 数值 / 3 邮箱 / 4 IP地址，以及 5 多行文本 / 9 单选框 / 10 复选框 不能是 18 外部拓展
**子命令：** `create`、`delete`、`enable`、`get`、`list`、`list-optional-field`、`update`
本级命令无专属参数。

###### E.1.4.5.1 `zenava crm field-sync create`
新建字段同步
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 是 | — | 规则名称（必填；企业内唯一） |
| --type | integer | 是 | — | 规则对象：1 业务记录，2 企业客户；枚举见 crm field-sync --help |
| --trigger-field-id | integer | 是 | — | 触发字段 field.id（必填） |
| --trigger-field-name | text | 否 | — | 仅用于错误文案，服务端会按字段表覆盖 |
| --action | integer | 是 | — | 触发动作：1 失焦，2 选值后；枚举见 crm field-sync --help |
| --trigger-field-key | text | 是 | — | 传给第三方的触发字段 key（英文数字，最长 30） |
| --sync-fields | text | 是 | — | 回写映射 JSON array（必填）。每项：fieldId（int，field 表主键）、returnFieldName（string，支持 a.b）；fieldName 服务端按字段表覆盖，可省略。示例：'[{"fieldId":10002,"returnFieldName":"company.name"}]' |
| --url | text | 是 | — | 第三方地址（须 https://） |
| --method | text | 否 | GET | 同步方式；仅 GET；枚举见 crm field-sync --help |
| --timeout | integer | 是 | — | 超时秒数（1–10） |
| --retry-count | integer | 是 | — | 重试次数（0–3） |
| --token | text | 否 | — | 对接 token（可选）。示例占位 YOUR_TOKEN |

###### E.1.4.5.2 `zenava crm field-sync delete`
删除字段同步
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 规则主键（必填） |

###### E.1.4.5.3 `zenava crm field-sync enable`
启停字段同步
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 规则主键（必填） |
| --enabled | integer | 是 | — | 目标状态：0 关闭，1 启用（非翻转） |

###### E.1.4.5.4 `zenava crm field-sync get`
查询字段同步详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 规则主键（必填） |

###### E.1.4.5.5 `zenava crm field-sync list`
查询字段同步列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --limit | integer | 否 | 10 | 每页条数 |
| --offset | integer | 否 | 0 | 偏移，从 0 开始 |
| --type | integer | 否 | — | 规则对象：1/2；不传返回两类；枚举见 crm field-sync --help |
| --enabled | integer | 否 | — | 0 关闭，1 启用；枚举见 crm field-sync --help |
| --name | text | 否 | — | 名称模糊匹配 |

###### E.1.4.5.6 `zenava crm field-sync list-optional-field`
查询字段同步可选字段
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --type | integer | 是 | — | 规则对象：1 业务记录，2 企业客户；枚举见 crm field-sync --help |

###### E.1.4.5.7 `zenava crm field-sync update`
修改字段同步（整份更新，不改开关）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 规则主键（必填） |
| --name | text | 否 | — | 规则名称（可选；不传沿用原值） |
| --type | integer | 是 | — | 规则对象：1 业务记录，2 企业客户；枚举见 crm field-sync --help |
| --trigger-field-id | integer | 是 | — | 触发字段 field.id（必填） |
| --trigger-field-name | text | 否 | — | 仅用于错误文案，服务端会按字段表覆盖 |
| --action | integer | 是 | — | 触发动作：1 失焦，2 选值后；枚举见 crm field-sync --help |
| --trigger-field-key | text | 是 | — | 传给第三方的触发字段 key（英文数字，最长 30） |
| --sync-fields | text | 是 | — | 回写映射 JSON array（必填）。每项：fieldId（int，field 表主键）、returnFieldName（string，支持 a.b）；fieldName 服务端按字段表覆盖，可省略。示例：'[{"fieldId":10002,"returnFieldName":"company.name"}]' |
| --url | text | 是 | — | 第三方地址（须 https://） |
| --method | text | 否 | GET | 同步方式；仅 GET；枚举见 crm field-sync --help |
| --timeout | integer | 是 | — | 超时秒数（1–10） |
| --retry-count | integer | 是 | — | 重试次数（0–3） |
| --token | text | 否 | — | 对接 token（可选）。示例占位 YOUR_TOKEN |

###### E.1.4.6 `zenava crm form-field`
CRM 自定义字段（form_field）配置。 用 --feature 区分模块。   feature： 0 客户资料 2 业务记录 11 企业客户 12 群客户   共用枚举 — 字段类型 type（四模块都支持）： 1 单行文本-不限制 2 单行文本-数值 3 单行文本-邮箱 4 单行文本-IP地址 5 多行文本 6 下拉列表（options） 7 自定义级联（cascade） 8 地区级联 9 单选框（options） 10 复选框（options） 11 日期时间 12 日期 13 时间   仅部分模块： 17 下拉多选（仅 feature=2，options） 18 外部检索（仅 feature=11，externalSearch） 100 电话号码（feature 0/11/12；脱敏开关） 101 身份证号（仅 feature=0；脱敏开关） 102 银行卡号（仅 feature=0；脱敏开关）   开关类字段取值一律 0/1。 服务端新建：开关默认 0，searchDisplay 默认 1；priority 未传排到模块最后。 CLI --id = form_field.id；资料写入用返回体 fieldId，勿与本 --id 混淆。 update：未传字段不改（服务端）；options/cascade/externalSearch 传入则整份覆盖。 叶子命令 --help 含各 JSON 明细与示例。
**子命令：** `create`、`delete`、`list`、`update`
本级命令无专属参数。

###### E.1.4.6.1 `zenava crm form-field create`
新建自定义字段
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --feature | integer | 是 | — | 模块：0/2/11/12；枚举见 crm form-field --help |
| --name | text | 是 | — | 字段名称（必填，同模块不可重名） |
| --type | integer | 是 | — | 字段类型（必填）；枚举见 crm form-field --help |
| --placeholder | text | 否 | — | 占位提示 |
| --priority | integer | 否 | — | 排序，须 >=1；不传则服务端排到最后 |
| --unique | integer | 否 | — | 是否唯一，取值 0/1 |
| --required | integer | 否 | — | 是否必填，取值 0/1 |
| --import-required | integer | 否 | — | 导入是否必填，取值 0/1 |
| --search-display | integer | 否 | — | 查询是否展示，取值 0/1 |
| --hidden | integer | 否 | — | 管理员是否隐藏，取值 0/1 |
| --client-readonly | integer | 否 | — | 普通座席只读，取值 0/1 |
| --client-hidden | integer | 否 | — | 普通座席隐藏，取值 0/1 |
| --client-required | integer | 否 | — | 座席必填，取值 0/1 |
| --quick-copy | integer | 否 | — | 一键复制，取值 0/1 |
| --list-shortcut | integer | 否 | — | 列表快捷操作，取值 0/1 |
| --choose-last | integer | 否 | — | 级联是否必须选到末级，取值 0/1（type 7/8） |
| --cascade-style | integer | 否 | — | 级联样式 0 默认 / 1 层级（仅 feature=2 且 type 7/8） |
| --select-others | integer | 否 | — | 是否允许「其他」，取值 0/1（type 6/9） |
| --multiple-selection | integer | 否 | — | 是否多选，取值 0/1（type 6/9） |
| --card-number-hidden | integer | 否 | — | 是否脱敏隐藏，取值 0/1（type 100/101/102） |
| --hidden-type | integer | 否 | — | 隐藏方式 0 后四位 / 1 后六位（type 100/101/102） |
| --agent-set | integer | 否 | — | 号码脱敏座席端勾选，取值 0/1 |
| --console-set | integer | 否 | — | 号码脱敏管理员端勾选，取值 0/1 |
| --share | integer | 否 | — | 是否共享，取值 0/1（仅 feature 0/11/12） |
| --options | text | 否 | — | 选项 JSON array（仅 type 6/9/10/17）。明细：name（必填）；value（默认=name）；selected（0/1，整字段最多一个 1）。示例：'[{"name":"高","value":"高","selected":0},{"name":"中","value":"中","selected":1}]' |
| --cascade | text | 否 | — | 自定义级联 JSON array（仅 type 7）。明细：title；options（子节点）。不要传 property。业务值按路径拼接如 华东,上海。示例：'[{"title":"华东","options":[{"title":"上海"},{"title":"杭州"}]}]' |
| --external-search | text | 否 | — | 外部检索 JSON object（仅 type 18）。明细：url（必填）；method（1=GET）；paramName；displayParamName；token；timeout（1–10）；retry（0–3）。示例：'{"url":"https://example.com/search","method":1,"paramName":"q","displayParamName":"name","token":"YOUR_TOKEN","timeout":3,"retry":0}' |

###### E.1.4.6.2 `zenava crm form-field delete`
删除自定义字段
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | form_field.id（必填） |
| --feature | integer | 是 | — | 模块，须与字段所属一致 |

###### E.1.4.6.3 `zenava crm form-field list`
查询自定义字段（GET /crm/list_form_field）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --feature | integer | 是 | — | 模块：0/2/11/12；枚举见 crm form-field --help |
| --id | integer | 否 | — | form_field.id；不传返回该模块全部字段 |

###### E.1.4.6.4 `zenava crm form-field update`
局部更新自定义字段
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | form_field.id（必填） |
| --feature | integer | 是 | — | 模块，须与原字段一致；枚举见 crm form-field --help |
| --name | text | 否 | — | 字段名称（可选；空串语义由服务端决定） |
| --type | integer | 否 | — | 一般不可改；业务记录 1–4→5 由服务端允许 |
| --placeholder | text | 否 | — | 占位提示 |
| --priority | integer | 否 | — | 排序，须 >=1；不传则服务端排到最后 |
| --unique | integer | 否 | — | 是否唯一，取值 0/1 |
| --required | integer | 否 | — | 是否必填，取值 0/1 |
| --import-required | integer | 否 | — | 导入是否必填，取值 0/1 |
| --search-display | integer | 否 | — | 查询是否展示，取值 0/1 |
| --hidden | integer | 否 | — | 管理员是否隐藏，取值 0/1 |
| --client-readonly | integer | 否 | — | 普通座席只读，取值 0/1 |
| --client-hidden | integer | 否 | — | 普通座席隐藏，取值 0/1 |
| --client-required | integer | 否 | — | 座席必填，取值 0/1 |
| --quick-copy | integer | 否 | — | 一键复制，取值 0/1 |
| --list-shortcut | integer | 否 | — | 列表快捷操作，取值 0/1 |
| --choose-last | integer | 否 | — | 级联是否必须选到末级，取值 0/1（type 7/8） |
| --cascade-style | integer | 否 | — | 级联样式 0 默认 / 1 层级（仅 feature=2 且 type 7/8） |
| --select-others | integer | 否 | — | 是否允许「其他」，取值 0/1（type 6/9） |
| --multiple-selection | integer | 否 | — | 是否多选，取值 0/1（type 6/9） |
| --card-number-hidden | integer | 否 | — | 是否脱敏隐藏，取值 0/1（type 100/101/102） |
| --hidden-type | integer | 否 | — | 隐藏方式 0 后四位 / 1 后六位（type 100/101/102） |
| --agent-set | integer | 否 | — | 号码脱敏座席端勾选，取值 0/1 |
| --console-set | integer | 否 | — | 号码脱敏管理员端勾选，取值 0/1 |
| --share | integer | 否 | — | 是否共享，取值 0/1（仅 feature 0/11/12） |
| --options | text | 否 | — | 选项 JSON array（仅 type 6/9/10/17）。明细：name（必填）；value（默认=name）；selected（0/1，整字段最多一个 1）。示例：'[{"name":"高","value":"高","selected":0},{"name":"中","value":"中","selected":1}]' |
| --cascade | text | 否 | — | 自定义级联 JSON array（仅 type 7）。明细：title；options（子节点）。不要传 property。业务值按路径拼接如 华东,上海。示例：'[{"title":"华东","options":[{"title":"上海"},{"title":"杭州"}]}]' |
| --external-search | text | 否 | — | 外部检索 JSON object（仅 type 18）。明细：url（必填）；method（1=GET）；paramName；displayParamName；token；timeout（1–10）；retry（0–3）。示例：'{"url":"https://example.com/search","method":1,"paramName":"q","displayParamName":"name","token":"YOUR_TOKEN","timeout":3,"retry":0}' |

###### E.1.4.7 `zenava crm group`
企微群客户
**子命令：** `query`、`update`
本级命令无专属参数。

###### E.1.4.7.1 `zenava crm group query`
查询企微群客户资料
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --visitor-id | text | 否 | — | 访客 ID；不传则按 tel 查询结果 |
| --customer-id | integer | 否 | — | 客户资料 id；不传则按 visitorId 查询 |

###### E.1.4.7.2 `zenava crm group update`
更新企微群客户资料
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --label-ids | text | 否 | — | 客户标签 id JSON 数组。示例：'[1,2]' |
| --customize | text | 否 | — | 自定义字段 JSON 数组。每项需 id、value；name 可省略。示例：'[{"id":0,"name":"测试字段","value":"123"}]' |
| --name | text | 否 | — | 客户名称（后台配置） |
| --visitor-id | text | 否 | — | 访客 ID |
| --id | integer | 否 | — | 客户 ID；不传则按 visitorId 更新 |
| --renovate | integer | 否 | — | 更新方式：0 增量更新（空值不覆盖）、1 全量覆盖（默认 1） |

###### E.1.4.8 `zenava crm http-push`
CRM HTTP 数据推送配置。 客户资料 / 业务记录 / 企业客户 / 群客户在指定事件时把字段推到第三方 HTTP；仅 二类企业接入。   feature（列表模块）： 0 客户资料 2 业务记录 11 企业客户 12 群客户   type（推送事件，按 feature）： 客户资料 1 座席创建 2 座席修改 3 座席领取 4 座席改阶段 7 OpenAPI 创建 8 OpenAPI 更新 10 网页合并 11 手动关联企业客户 12 在线工作台自动创建 13 在线工作台自动更新 业务记录 5 网页创建 6 网页修改 9 OpenAPI 更新 企业客户 200 员工创建 201 员工修改 202 OpenAPI 创建 203 OpenAPI 更新 群客户 100 自动创建 101 OpenAPI 更新 102 员工编辑 103 自动更新   method： 0 POST 1 GET   contentType（POST 时）： multipart/form-data application/x-www-form-urlencoded application/json   authentication： 0 不鉴权 1 鉴权（为 1 时 token 必填）   status： 0 停用 1 启用 create 未传服务端默认 1；启停用 enable 传目标状态（非翻转）。   token 语义： 查询回显 ******；update 传全 *（如 ******）表示不改原 token。   嵌套： parameter / variable / condition 为 JSON 数组；customerPhase 为阶段 id 列表 （仅客户资料类 type 有意义）；可选阶段用 list-customer-phase 查询。
**子命令：** `create`、`delete`、`enable`、`get`、`list`、`list-customer-phase`、`update`
本级命令无专属参数。

###### E.1.4.8.1 `zenava crm http-push create`
新建数据推送
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --type | integer | 是 | — | 推送事件 type；枚举见 crm http-push --help |
| --name | text | 否 | — | 名称（可选；最长 20） |
| --url | text | 是 | — | 推送地址（http/https，最长 255） |
| --method | integer | 是 | — | 0 POST，1 GET；枚举见 crm http-push --help |
| --content-type | text | 否 | — | POST 时 Content-Type（条件必选）；枚举见 crm http-push --help |
| --timeout | integer | 是 | — | 超时秒数（1–10） |
| --retry | integer | 是 | — | 重试次数（0–3） |
| --authentication | integer | 是 | — | 0 不鉴权，1 鉴权；枚举见 crm http-push --help |
| --token | text | 否 | — | 对接 token（条件必选）。authentication=1 时必填。示例占位 YOUR_TOKEN |
| --status | integer | 否 | — | 0 停用，1 启用（可选；create 未传服务端默认 1） |
| --parameter | text | 否 | — | 推送参数 JSON array（可选）。元素：fieldId（int，可选）、name、value、dataType（1 字符串 / 2 数值 / 3 时间戳 / 4 数组字符串 / 5 AES）、sourceType（1 客户 / 2 业务 / 3 企业）、description（服务回填可省略）。示例：'[{"fieldId":8,"name":"customerName"}]' |
| --variable | text | 否 | — | 自定义变量 JSON array（可选）。元素：name、value、type（0 表达式 / 1 字符串）。示例：'[{"name":"source","value":"crm","type":1}]' |
| --condition | text | 否 | — | 触发条件 JSON array（可选）。元素：field、expression（1 包含 / 2 不包含）、value（多值逗号分隔）。示例：'[{"field":"level","expression":1,"value":"A,B"}]' |
| --customer-phase | text | 否 | — | 客户阶段 id，逗号分隔（可选；仅客户资料 type 有意义）。可用 list-customer-phase 查询。示例：11,12 |

###### E.1.4.8.2 `zenava crm http-push delete`
删除数据推送
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 推送主键（必填） |

###### E.1.4.8.3 `zenava crm http-push enable`
启停数据推送
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 推送主键（必填） |
| --status | integer | 是 | — | 目标状态：0 停用，1 启用（非翻转） |

###### E.1.4.8.4 `zenava crm http-push get`
查询数据推送详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 推送主键（必填） |

###### E.1.4.8.5 `zenava crm http-push list`
查询数据推送列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --feature | integer | 是 | — | 模块：0/2/11/12；枚举见 crm http-push --help |
| --limit | integer | 否 | 10 | 每页条数 |
| --offset | integer | 否 | 0 | 偏移，从 0 开始 |
| --type | integer | 否 | — | 仅查该模块下某一事件；枚举见 crm http-push --help |

###### E.1.4.8.6 `zenava crm http-push list-customer-phase`
查询可选客户阶段

###### E.1.4.8.7 `zenava crm http-push update`
修改数据推送（整份更新）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 推送主键（必填） |
| --type | integer | 是 | — | 推送事件 type；枚举见 crm http-push --help |
| --name | text | 否 | — | 名称（可选；最长 20） |
| --url | text | 是 | — | 推送地址（http/https，最长 255） |
| --method | integer | 是 | — | 0 POST，1 GET；枚举见 crm http-push --help |
| --content-type | text | 否 | — | POST 时 Content-Type（条件必选）；枚举见 crm http-push --help |
| --timeout | integer | 是 | — | 超时秒数（1–10） |
| --retry | integer | 是 | — | 重试次数（0–3） |
| --authentication | integer | 是 | — | 0 不鉴权，1 鉴权；枚举见 crm http-push --help |
| --token | text | 否 | — | 对接 token（条件必选）。authentication=1 时必填。示例占位 YOUR_TOKEN |
| --status | integer | 否 | — | 0 停用，1 启用（可选；create 未传服务端默认 1） |
| --parameter | text | 否 | — | 推送参数 JSON array（可选）。元素：fieldId（int，可选）、name、value、dataType（1 字符串 / 2 数值 / 3 时间戳 / 4 数组字符串 / 5 AES）、sourceType（1 客户 / 2 业务 / 3 企业）、description（服务回填可省略）。示例：'[{"fieldId":8,"name":"customerName"}]' |
| --variable | text | 否 | — | 自定义变量 JSON array（可选）。元素：name、value、type（0 表达式 / 1 字符串）。示例：'[{"name":"source","value":"crm","type":1}]' |
| --condition | text | 否 | — | 触发条件 JSON array（可选）。元素：field、expression（1 包含 / 2 不包含）、value（多值逗号分隔）。示例：'[{"field":"level","expression":1,"value":"A,B"}]' |
| --customer-phase | text | 否 | — | 客户阶段 id，逗号分隔（可选；仅客户资料 type 有意义）。可用 list-customer-phase 查询。示例：11,12 |

##### E.1.5 `zenava feedback`
提交意见反馈（可选附带本地日志）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --message | text | 是 | — | 反馈内容（必填） |
| --attach-log | boolean | 否 | False | 是否附带 ~/.zenava/logs/zenava.log 的 zip（true/false） |

##### E.1.6 `zenava livechat`
在线客服（按企业开通）
**子命令：** `client`、`comment`、`log`、`monitor`、`record`、`session`、`setting`、`stat`
本级命令无专属参数。

###### E.1.6.1 `zenava livechat client`
客服管理
**子命令：** `login`、`logout`、`status`
本级命令无专属参数。

###### E.1.6.1.1 `zenava livechat client login`
客服登录
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --pause-description | text | 否 | — | 座席置忙状态描述（置忙时必填） |
| --pause-type | integer | 否 | — | 座席置忙类型 pauseType（置忙时必填）：1 置忙、2 休息、4 强制置忙 |
| --chat-login-status | integer | 是 | — | 座席登录状态 chatLoginStatus：0 离线、1 在线空闲、2 在线置忙。为 2 时必须同时传 --pause-type 与 --pause-description |
| --cno | text | 是 | — | 座席工号 |

###### E.1.6.1.2 `zenava livechat client logout`
客服登出
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --cno | text | 是 | — | 座席工号 |

###### E.1.6.1.3 `zenava livechat client status`
客服状态变更
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --status | integer | 是 | — | 坐席状态 status：1 强制空闲、2 强制置忙 |
| --cno | text | 是 | — | 座席工号 |

###### E.1.6.2 `zenava livechat comment`
留言管理
**子命令：** `assign`、`page`
本级命令无专属参数。

###### E.1.6.2.1 `zenava livechat comment assign`
批量分配留言
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --main-unique-ids | text | 是 | — | 留言主会话 ID 列表 mainUniqueIds，逗号分隔，一次最多 10 条。示例：--main-unique-ids id1,id2 |
| --cno | text | 是 | — | 被分配坐席号 |

###### E.1.6.2.2 `zenava livechat comment page`
查询留言列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --page-index | integer | 否 | — | 当前页 pageIndex，默认服务端 1 |
| --page-size | integer | 否 | — | 页大小 pageSize，默认服务端 10，最大 50。接口频率限制 3 次/秒 |

###### E.1.6.3 `zenava livechat log`
座席工作日志
**子命令：** `client-work`、`client-work-duration`
本级命令无专属参数。

###### E.1.6.3.1 `zenava livechat log client-work`
座席工作日志查询
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --actions | text | 否 | — | 操作类型列表 JSON 数组。枚举：NONE（下线）、PAUSE_NORMAL（置忙）、PAUSE_RESET（休息）、READY_NORMAL（空闲）。示例：'["READY_NORMAL","PAUSE_NORMAL"]' |
| --qnos | text | 否 | — | 队列号列表 JSON 数组字符串；不传则查询全部队列。示例：'["1001","1002"]' |
| --cnos | text | 否 | — | 座席号列表 JSON 数组字符串；不传则查询全部座席。示例：'["2029","389400069"]' |
| --end-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm:ss"；起止跨度不能超过 1 个月；结束时间不能超过次日零点。示例：--start-time "2026-06-01 00:00:00" --end-time "2026-06-30 23:59:59" |
| --start-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm:ss"；起止跨度不能超过 1 个月；结束时间不能超过次日零点。示例：--start-time "2026-06-01 00:00:00" --end-time "2026-06-30 23:59:59" |
| --page-index | integer | 否 | — | 当前页，默认 1，范围 1–2000 |
| --page-size | integer | 否 | — | 页大小，默认 10，最大 500 |

###### E.1.6.3.2 `zenava livechat log client-work-duration`
座席工作时长日志查询
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --states | text | 否 | — | 座席状态列表 JSON 数组。枚举：READY（空闲）、PAUSE（置忙）。示例：'["READY","PAUSE"]' |
| --qnos | text | 否 | — | 队列号列表 JSON 数组字符串；不传则查询全部队列。示例：'["1001","1002"]' |
| --cnos | text | 否 | — | 座席号列表 JSON 数组字符串；不传则查询全部座席。示例：'["2029","389400069"]' |
| --end-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm:ss"；起止跨度不能超过 1 个月；结束时间不能超过次日零点。示例：--start-time "2026-06-01 00:00:00" --end-time "2026-06-30 23:59:59" |
| --start-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm:ss"；起止跨度不能超过 1 个月；结束时间不能超过次日零点。示例：--start-time "2026-06-01 00:00:00" --end-time "2026-06-30 23:59:59" |
| --page-index | integer | 否 | — | 当前页，默认 1，范围 1–2000 |
| --page-size | integer | 否 | — | 页大小，默认 10，最大 500 |

###### E.1.6.4 `zenava livechat monitor`
队列监控
**子命令：** `queue-status`
本级命令无专属参数。

###### E.1.6.4.1 `zenava livechat monitor queue-status`
队列状态监控
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --qnos | text | 否 | — | 队列号，逗号分隔；不传则查询所有队列。示例：--qnos 2021,2019 |

###### E.1.6.5 `zenava livechat record`
会话记录只读 / 按日同步
**子命令：** `copy-comments`、`copy-details`、`copy-messages`、`investigation-page`、`last-message-by-app`、`message`、`session`、`session-detail-page`、`session-page`
本级命令无专属参数。

###### E.1.6.5.1 `zenava livechat record copy-comments`
按日同步会话评论
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --limit | integer | 否 | — | 查询记录条数，默认 10，范围 10–1000 |
| --scroll-id | text | 否 | — | 滚动查询游标 ID；首页不传，续刷传上一页返回的 scrollId。游标有效期 5 分钟。接口频率限制约 3 次/秒 |
| --date | text | 是 | — | 会话所在日期，格式 yyyyMMdd。示例：--date 20230710 |

###### E.1.6.5.2 `zenava livechat record copy-details`
按日同步会话详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --limit | integer | 否 | — | 查询记录条数，默认 10，范围 10–1000 |
| --scroll-id | text | 否 | — | 滚动查询游标 ID；首页不传，续刷传上一页返回的 scrollId。游标有效期 5 分钟。接口频率限制约 3 次/秒 |
| --date | text | 是 | — | 会话所在日期，格式 yyyyMMdd。示例：--date 20230710 |

###### E.1.6.5.3 `zenava livechat record copy-messages`
按日同步会话消息
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --limit | integer | 否 | — | 查询记录条数，默认 10，范围 10–1000 |
| --scroll-id | text | 否 | — | 滚动查询游标 ID；首页不传，续刷传上一页返回的 scrollId。游标有效期 5 分钟。接口频率限制约 3 次/秒 |
| --date | text | 是 | — | 会话所在日期，格式 yyyyMMdd。示例：--date 20230710 |

###### E.1.6.5.4 `zenava livechat record investigation-page`
满意度记录分页
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --page-index | integer | 否 | — | 当前页，默认 1 |
| --page-size | integer | 否 | — | 页大小，默认 10 |
| --end-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm"；起止跨度不可超过三个月。示例：--start-time "2026-09-01 00:00" --end-time "2026-09-02 23:59" |
| --start-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm"；起止跨度不可超过三个月。示例：--start-time "2026-09-01 00:00" --end-time "2026-09-02 23:59" |

###### E.1.6.5.5 `zenava livechat record last-message-by-app`
按接入号查询访客最近消息
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --contact-type | integer | 否 | — | 渠道类型（contactType）：1 微信公众号、2 网页（默认）、4 微信小程序、5 微博、6 企业微信、7 百度营销、8 自定义渠道、9 微信客服（独立版）、10 第三方接入、11 APP、12 企微客服、13 飞书、14 抖音、15 小红书、19 微信客服（联合版，推荐）。本接口仅支持 2 网页、11 APP |
| --size | integer | 否 | — | 返回条数，默认 50，最高不超过 50 |
| --end-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm"；起止跨度不可超过 15 天；结束时间最晚不能超过当天 23:59 |
| --start-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm"；起止跨度不可超过 15 天；结束时间最晚不能超过当天 23:59 |
| --visitor-id | text | 是 | — | 访客 id |

###### E.1.6.5.6 `zenava livechat record message`
会话消息
**子命令：** `list`
本级命令无专属参数。

###### E.1.6.5.6.1 `zenava livechat record message list`
查询会话消息列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --main-unique-id | text | 是 | — | 在线客服会话 ID（mainUniqueId） |

###### E.1.6.5.7 `zenava livechat record session`
按会话 ID 查询详情
**子命令：** `get`
本级命令无专属参数。

###### E.1.6.5.7.1 `zenava livechat record session get`
查询会话详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --main-unique-id | text | 是 | — | 在线客服会话 ID（mainUniqueId） |

###### E.1.6.5.8 `zenava livechat record session-detail-page`
同步从会话记录（分页）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --page-index | integer | 否 | — | 当前页，默认 1 |
| --page-size | integer | 否 | — | 页大小，默认 10 |
| --end-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm"；起止跨度不可超过三个月。示例：--start-time "2026-09-01 00:00" --end-time "2026-09-02 23:59" |
| --start-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm"；起止跨度不可超过三个月。示例：--start-time "2026-09-01 00:00" --end-time "2026-09-02 23:59" |

###### E.1.6.5.9 `zenava livechat record session-page`
同步会话记录（分页）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --page-index | integer | 否 | — | 当前页，默认 1 |
| --page-size | integer | 否 | — | 页大小，默认 10 |
| --end-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm"；起止跨度不可超过三个月。示例：--start-time "2026-09-01 00:00" --end-time "2026-09-02 23:59" |
| --start-time | text | 是 | — | 时间格式 "yyyy-MM-dd HH:mm"；起止跨度不可超过三个月。示例：--start-time "2026-09-01 00:00" --end-time "2026-09-02 23:59" |

###### E.1.6.6 `zenava livechat session`
会话管理
**子命令：** `close`、`investigate`、`message`、`open`、`quit-queue`、`transfer`、`upload`、`withdraw`
本级命令无专属参数。

###### E.1.6.6.1 `zenava livechat session close`
访客结束会话
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --session-id | text | 是 | — | 会话 ID |

###### E.1.6.6.2 `zenava livechat session investigate`
访客完成满意度评价
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --solve | integer | 否 | — | 解决状态 |
| --remark | text | 否 | — | 评价备注 |
| --session-detail-unique-id | text | 否 | — | 从会话 ID（sessionDetailUniqueId） |
| --options-json | text | 是 | — | 评价信息 JSON 数组（ChatInvestigationSaveOption[]，必填）。示例：--options-json '[{"name":"满意度","star":5,"label":["标签1","标签2"]}]' |
| --session-id | text | 是 | — | 会话 ID |

###### E.1.6.6.3 `zenava livechat session message`
发消息给客服
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --media-id | text | 否 | — | 文件 id（mediaId） |
| --file | text | 否 | — | 本地文件路径（可选）；messageType 不为 1 时，file / fileUrl / mediaId 三选一，文件限制 20M |
| --file-name | text | 否 | — | 文件名；有 fileUrl 或 mediaId 时必填 |
| --file-url | text | 否 | — | 文件类型消息访问地址 |
| --content | text | 否 | — | 消息内容（文本消息必填） |
| --message-type | integer | 是 | — | 消息类型 messageType：1 文本、2 图片、3 文件、4 视频、7 语音。类型为 1 时 content 必填（最大 1000）；非 1 时 file / fileUrl / mediaId 必传其一（文件≤20M） |
| --session-id | text | 是 | — | 会话 ID |

###### E.1.6.6.4 `zenava livechat session open`
访客发起会话（仅自定义渠道）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --visitor-tags | text | 否 | — | 访客标签，逗号分隔，最多 3 个。示例：--visitor-tags vip,new |
| --create-time | integer | 否 | — | 会话创建时间，毫秒级时间戳 |
| --visitor-extra-info-json | text | 否 | — | 访客接入自定义参数 JSON 对象（visitorExtraInfo）。示例：--visitor-extra-info-json '{"key":"value"}' |
| --customer-fields-json | text | 否 | — | 客户资料 JSON 对象（customerFields）。示例：--customer-fields-json '{"name":"张三","tel":["13800000000"],"email":"a@b.c","sex":0,"address":"上海","level":0,"remark":"备注"}' |
| --message-sync-only | boolean | 否 | false | 是否只做消息同步（出现即 true；未传不写入请求体） |
| --messages-json | text | 否 | — | 同步消息列表 JSON 数组（ChatMessageSyncModel）。示例：--messages-json '[{"senderId":"v1","senderName":"访客","senderType":2,"messageType":1,"content":"你好","createTime":1637828073723}]' |
| --qno | text | 否 | — | 队列编号 |
| --cno | text | 否 | — | 座席编号 |
| --avatar | text | 否 | — | 访客头像 |
| --visitor-name | text | 否 | — | 访客名称 |
| --visitor-id | text | 否 | — | 访客 ID |
| --app-id | text | 是 | — | 渠道 ID（appId），由 AICC 后台渠道配置生成。注意：该接口只支持自定义渠道，不支持其他任何渠道 |

###### E.1.6.6.5 `zenava livechat session quit-queue`
访客退出排队
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --session-id | text | 是 | — | 会话 ID |

###### E.1.6.6.6 `zenava livechat session transfer`
访客转人工
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --session-id | text | 是 | — | 会话 ID |

###### E.1.6.6.7 `zenava livechat session upload`
访客上传文件
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 是 | — | 本地文件路径（必填）；支持上传 200M 以下文件 |
| --session-id | text | 是 | — | 会话 ID |

###### E.1.6.6.8 `zenava livechat session withdraw`
消息撤回
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --access-id | text | 是 | — | 接入号 ID |
| --message-id | text | 是 | — | 消息 ID |
| --visitor-id | text | 是 | — | 访客 ID |
| --session-id | text | 是 | — | 会话 ID |

###### E.1.6.7 `zenava livechat setting`
渠道配置
**子命令：** `web`
本级命令无专属参数。

###### E.1.6.7.1 `zenava livechat setting web`
网页渠道配置
**子命令：** `copy`、`update`
本级命令无专属参数。

###### E.1.6.7.1.1 `zenava livechat setting web copy`
复制网页渠道配置
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --access-id | text | 是 | — | 渠道 ID accessId（必填） |

###### E.1.6.7.1.2 `zenava livechat setting web update`
修改网页渠道配置
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --access-id | text | 是 | — | 渠道 ID accessId（必填） |
| --access-name | text | 否 | — | 渠道名称 accessName：仅中文、字母、数字、下划线、空格；长度不超过 30 |
| --logo | text | 否 | — | 窗口图标 logo URL |
| --title | text | 否 | — | 窗口标题 title，长度不超过 50 |
| --artificial-enabled | integer | 否 | — | 转人工开关 artificialEnabled。开关：0 关闭，1 开启 |
| --avatar-enable | integer | 否 | — | 客服/机器人头像开关 avatarEnable。开关：0 关闭，1 开启 |
| --nick-name-enable | integer | 否 | — | 客服昵称开关 nickNameEnable。开关：0 关闭，1 开启 |
| --robot-nick-name-enable | integer | 否 | — | 机器人昵称开关 robotNickNameEnable。开关：0 关闭，1 开启 |
| --cno-enabled | integer | 否 | — | 座席工号开关 cnoEnabled。开关：0 关闭，1 开启 |
| --visitor-avatar-enabled | integer | 否 | — | 访客头像开关 visitorAvatarEnabled。开关：0 关闭，1 开启 |
| --font-size | integer | 否 | — | 访客端字体大小 fontSize：0 默认，1 大 |
| --visitor-link | integer | 否 | — | 访客端链接开关 visitorLink。开关：0 关闭，1 开启 |
| --announcement-content | text | 否 | — | 公告内容 announcement.content，长度不超过 100；须与 --announcement-enabled 同时传入 |
| --announcement-enabled | integer | 否 | — | 公告开关 announcement.enabled：0 关闭，1 开启；须与 --announcement-content 同时传入 |

###### E.1.6.8 `zenava livechat stat`
在线报表
**子命令：** `client-attendance`、`client-cno`、`client-workload-home`、`investigation-cno`、`investigation-qno`、`queue-period`、`queue-qno`、`queue-workload`、`session-app`、`session-period`
本级命令无专属参数。

###### E.1.6.8.1 `zenava livechat stat client-attendance`
工作量考勤报表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --end-time | text | 是 | — | 统计结束日期 endTime，格式 yyyy-MM-dd（整日）。只查询开始日期与结束日期之间的整日数据 |
| --start-time | text | 是 | — | 统计开始日期 startTime，格式 yyyy-MM-dd（整日）。只查询开始日期与结束日期之间的整日数据 |
| --contact-types | text | 否 | — | 接入渠道类型 contactTypes，逗号分隔整数：1 微信公众号、2 网页、4 微信小程序、5 微博、6 企业微信、7 百度营销、8 自定义渠道、9 微信客服（独立版）、10 第三方接入、11 APP、12 企微客服、13 飞书、14 抖音、15 小红书、19 微信客服（联合版，推荐） |
| --page-index | integer | 否 | — | 当前页 pageIndex，默认服务端 1 |
| --page-size | integer | 否 | — | 页大小 pageSize，默认服务端 10 |
| --cnos | text | 否 | — | 座席号 cnos，逗号分隔，例如 8001,8002 |

###### E.1.6.8.2 `zenava livechat stat client-cno`
座席工作量报表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --end-time | text | 是 | — | 统计结束时间 endTime，格式 yyyy-MM-dd HH:mm |
| --start-time | text | 是 | — | 统计开始时间 startTime，格式 yyyy-MM-dd HH:mm |
| --app-names | text | 否 | — | 接入号名称 appNames，逗号分隔；仅当 contactTypes 非空时生效，查询该渠道下的接入号名称 |
| --contact-types | text | 否 | — | 接入渠道类型 contactTypes，逗号分隔整数：1 微信公众号、2 网页、4 微信小程序、5 微博、6 企业微信、7 百度营销、8 自定义渠道、9 微信客服（独立版）、10 第三方接入、11 APP、12 企微客服、13 飞书、14 抖音、15 小红书、19 微信客服（联合版，推荐）；appNames 依赖本字段非空 |
| --page-index | integer | 否 | — | 当前页 pageIndex，默认服务端 1 |
| --page-size | integer | 否 | — | 页大小 pageSize，默认服务端 10 |
| --query-type | integer | 否 | 0 | 查询类型 queryType：0 汇总（默认）、1 分时。为 1 时必须同时传 --period-type |
| --period-type | integer | 否 | — | 分时查询时间维度 periodType：1 半小时、2 小时、3 天、4 月。查询类型为 1 时此字段不能为空 |
| --cnos | text | 否 | — | 座席号 cnos，逗号分隔，例如 8001,8002 |
| --qnos | text | 否 | — | 队列号 qnos，逗号分隔，例如 0001,0002 |

###### E.1.6.8.3 `zenava livechat stat client-workload-home`
座席工作台首页数据
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --statistic-method | integer | 否 | — | 统计方式 statisticMethod：2 汇总（默认）、3 分时 |
| --date | text | 是 | — | 同步日期 date，格式 yyyyMMdd，例如 20260901 |

###### E.1.6.8.4 `zenava livechat stat investigation-cno`
满意度报表_按座席统计
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --end-time | text | 是 | — | 统计结束时间 endTime，格式 yyyy-MM-dd HH:mm |
| --start-time | text | 是 | — | 统计开始时间 startTime，格式 yyyy-MM-dd HH:mm |
| --page-index | integer | 否 | — | 当前页 pageIndex，默认服务端 1 |
| --page-size | integer | 否 | — | 页大小 pageSize，默认服务端 10 |
| --cnos | text | 否 | — | 座席号 cnos，逗号分隔，例如 8001,8002 |
| --qnos | text | 否 | — | 队列号 qnos，逗号分隔，例如 0001,0002 |
| --app-names | text | 否 | — | 接入号名称 appNames，逗号分隔；仅当 contactTypes 非空时生效，查询该渠道下的接入号名称 |
| --contact-types | text | 否 | — | 接入渠道类型 contactTypes，逗号分隔整数：1 微信公众号、2 网页、4 微信小程序、5 微博、6 企业微信、7 百度营销、8 自定义渠道、9 微信客服（独立版）、10 第三方接入、11 APP、12 企微客服、13 飞书、14 抖音、15 小红书、19 微信客服（联合版，推荐）；appNames 依赖本字段非空 |

###### E.1.6.8.5 `zenava livechat stat investigation-qno`
满意度报表_按队列统计
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --end-time | text | 是 | — | 统计结束时间 endTime，格式 yyyy-MM-dd HH:mm |
| --start-time | text | 是 | — | 统计开始时间 startTime，格式 yyyy-MM-dd HH:mm |
| --page-index | integer | 否 | — | 当前页 pageIndex，默认服务端 1 |
| --page-size | integer | 否 | — | 页大小 pageSize，默认服务端 10 |
| --qnos | text | 否 | — | 队列号 qnos，逗号分隔，例如 0001,0002 |
| --app-names | text | 否 | — | 接入号名称 appNames，逗号分隔；仅当 contactTypes 非空时生效，查询该渠道下的接入号名称 |
| --contact-types | text | 否 | — | 接入渠道类型 contactTypes，逗号分隔整数：1 微信公众号、2 网页、4 微信小程序、5 微博、6 企业微信、7 百度营销、8 自定义渠道、9 微信客服（独立版）、10 第三方接入、11 APP、12 企微客服、13 飞书、14 抖音、15 小红书、19 微信客服（联合版，推荐）；appNames 依赖本字段非空 |

###### E.1.6.8.6 `zenava livechat stat queue-period`
队列报表_按时间统计
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --end-time | text | 是 | — | 统计结束时间 endTime，格式 yyyy-MM-dd HH:mm。注：结束时间为 12:03，如果是半小时维度，代表结束时间按 12:00 查询 |
| --start-time | text | 是 | — | 统计开始时间 startTime，格式 yyyy-MM-dd HH:mm。注：开始时间为 12:03，如果是半小时维度，代表开始时间按 12:00 查询 |
| --qnos | text | 否 | — | 队列号 qnos，逗号分隔，例如 0001,0002 |
| --app-names | text | 否 | — | 接入号名称 appNames，逗号分隔；仅当 contactTypes 非空时生效，查询该渠道下的接入号名称 |
| --contact-types | text | 否 | — | 接入渠道类型 contactTypes，逗号分隔整数：1 微信公众号、2 网页、4 微信小程序、5 微博、6 企业微信、7 百度营销、8 自定义渠道、9 微信客服（独立版）、10 第三方接入、11 APP、12 企微客服、13 飞书、14 抖音、15 小红书、19 微信客服（联合版，推荐）；appNames 依赖本字段非空 |
| --period-type | integer | 否 | — | 数据列表时间维度 periodType：1 半小时、2 小时、3 天、4 月。跨度约束（CLI 不强制）：日报仅半小时/小时；1–7 天半小时/小时/天；8–15 天小时/天；16–30 天天；31–180 天天/月；180 天以上仅月 |

###### E.1.6.8.7 `zenava livechat stat queue-qno`
队列报表_按队列统计
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --end-time | text | 是 | — | 统计结束时间 endTime，格式 yyyy-MM-dd HH:mm |
| --start-time | text | 是 | — | 统计开始时间 startTime，格式 yyyy-MM-dd HH:mm |
| --page-index | integer | 否 | — | 当前页 pageIndex，默认服务端 1 |
| --page-size | integer | 否 | — | 页大小 pageSize，默认服务端 10 |
| --qnos | text | 否 | — | 队列号 qnos，逗号分隔，例如 0001,0002 |
| --app-names | text | 否 | — | 接入号名称 appNames，逗号分隔；仅当 contactTypes 非空时生效，查询该渠道下的接入号名称 |
| --contact-types | text | 否 | — | 接入渠道类型 contactTypes，逗号分隔整数：1 微信公众号、2 网页、4 微信小程序、5 微博、6 企业微信、7 百度营销、8 自定义渠道、9 微信客服（独立版）、10 第三方接入、11 APP、12 企微客服、13 飞书、14 抖音、15 小红书、19 微信客服（联合版，推荐）；appNames 依赖本字段非空 |

###### E.1.6.8.8 `zenava livechat stat queue-workload`
队列工作量报表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --statistic-method | integer | 否 | — | 统计方式 statisticMethod：2 汇总（默认）、3 分时 |
| --date | text | 是 | — | 同步日期 date，格式 yyyyMMdd，例如 20260901 |

###### E.1.6.8.9 `zenava livechat stat session-app`
会话量报表_按接入号统计
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --end-time | text | 是 | — | 统计结束时间 endTime，格式 yyyy-MM-dd HH:mm |
| --start-time | text | 是 | — | 统计开始时间 startTime，格式 yyyy-MM-dd HH:mm |
| --app-names | text | 否 | — | 接入号名称 appNames，逗号分隔；仅当 contactTypes 非空时生效，查询该渠道下的接入号名称 |
| --contact-types | text | 否 | — | 接入渠道类型 contactTypes，逗号分隔整数：1 微信公众号、2 网页、4 微信小程序、5 微博、6 企业微信、7 百度营销、8 自定义渠道、9 微信客服（独立版）、10 第三方接入、11 APP、12 企微客服、13 飞书、14 抖音、15 小红书、19 微信客服（联合版，推荐）；appNames 依赖本字段非空 |
| --period-type | integer | 否 | — | 数据列表时间维度 periodType：1 半小时、2 小时、3 天、4 月。跨度约束（CLI 不强制）：日报仅半小时/小时；1–7 天半小时/小时/天；8–15 天小时/天；16–30 天天；31–180 天天/月；180 天以上仅月 |
| --page-index | integer | 否 | — | 当前页 pageIndex，默认服务端 1 |
| --page-size | integer | 否 | — | 页大小 pageSize，默认服务端 10 |

###### E.1.6.8.10 `zenava livechat stat session-period`
会话量报表_按会话统计
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --end-time | text | 是 | — | 统计结束时间 endTime，格式 yyyy-MM-dd HH:mm |
| --start-time | text | 是 | — | 统计开始时间 startTime，格式 yyyy-MM-dd HH:mm |
| --app-names | text | 否 | — | 接入号名称 appNames，逗号分隔；仅当 contactTypes 非空时生效，查询该渠道下的接入号名称 |
| --contact-types | text | 否 | — | 接入渠道类型 contactTypes，逗号分隔整数：1 微信公众号、2 网页、4 微信小程序、5 微博、6 企业微信、7 百度营销、8 自定义渠道、9 微信客服（独立版）、10 第三方接入、11 APP、12 企微客服、13 飞书、14 抖音、15 小红书、19 微信客服（联合版，推荐）；appNames 依赖本字段非空 |
| --period-type | integer | 否 | — | 数据列表时间维度 periodType：1 半小时、2 小时、3 天、4 月。跨度约束（CLI 不强制）：日报仅半小时/小时；1–7 天半小时/小时/天；8–15 天小时/天；16–30 天天；31–180 天天/月；180 天以上仅月 |

##### E.1.7 `zenava profile`
管理 ~/.zenava/profile.json 多配置
**子命令：** `delete`、`list`、`set`、`use`
本级命令无专属参数。

###### E.1.7.1 `zenava profile delete`
删除指定 profile（需二次确认；不可删除 currentProfile）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
|  | text | 是 | — | — |

###### E.1.7.2 `zenava profile list`
展示所有 profile 信息（token/SK 脱敏；--json 时输出 JSON）

###### E.1.7.3 `zenava profile set`
创建或修改 profile 配置（增量更新）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 是 | — | profile 名称（须满足 ^[a-z][a-z0-9-]{0,63}$） |
| --platform-type | text | 否 | — | 平台类型：cticloud 或 clink2（默认 cticloud） |
| --endpoint | text | 否 | — | API 基址，填写项目提供的开放接口地址 |
| --validate-type | integer | 否 | — | 一类企业接入：1 部门编号验证 2 企业编号验证 |
| --enterprise-id | text | 否 | — | 呼叫中心编号（validateType=2 时使用） |
| --department-id | text | 否 | — | 部门编号（validateType=1 时使用） |
| --token | text | 否 | — | 一类企业接入 部门鉴权 token（参与 sign 计算） |
| --access-key-id | text | 否 | — | 二类企业接入 AccessKeyId |
| --access-key-secret | text | 否 | — | 二类企业接入 AccessKeySecret |
| --expires | integer | 否 | — | 二类企业接入 签名有效秒数（1–86400，缺省运行时 60） |
| --log | text | 否 | — | 是否写入本地文件日志：true 开启 false 关闭 |

###### E.1.7.4 `zenava profile use`
将 currentProfile 设为指定 profile（不改写 config.json）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
|  | text | 是 | — | — |

##### E.1.8 `zenava ticket`
工单（按企业开通）
**子命令：** `approve`、`assign`、`category`、`child-form`、`close`、`comment`、`create`、`custom-field`、`field`、`file-url`、`finish`、`flow`、`form`、`form-template`、`get`、`list`、`mock`、`plugin`、`preserve`、`remind`、`restart`、`stage`、`stat`、`store`、`sys-form`、`update`、`update-prefabricated`、`workflow`
本级命令无专属参数。

###### E.1.8.1 `zenava ticket approve`
工单审批（审批节点；节点流转填表单请用 ticket flow）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --approver-id | text | 是 | — | 审批人 ID（审批节点；节点流转填表单请用 ticket flow） |
| --task-id | text | 是 | — | 任务 ID |
| --id | integer | 否 | — | 工单 ID（与 --external-id 二者必有一） |
| --external-id | text | 否 | — | 外部工单 ID（与 --id 二者必有一） |
| --approver-id-type | integer | 否 | — | 审批人类型 1 用户id 2 用户手机号 3 用户名 4 用户工号，默认为用户ID |
| --approval-result | integer | 否 | — | 审批结果 0 同意 1 拒绝，默认 0 |
| --approval-comment | text | 否 | — | 审批意见 |

###### E.1.8.2 `zenava ticket assign`
分配工单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 工单 ID |
| --handler-type | integer | 是 | — | 处理类型 0 座席 1 队列 |
| --handler-id | text | 是 | — | 处理人 ID |
| --handler-id-type | integer | 否 | — | 处理人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --task-id | text | 否 | — | 任务 ID |
| --operator-id | text | 否 | — | 操作人 ID |
| --operator-id-type | integer | 否 | — | 操作人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --auto-assign | integer | 否 | — | 是否开启自动分配 |
| --content | text | 否 | — | 分配备注 |

###### E.1.8.3 `zenava ticket category`
工单模板类别
**子命令：** `list`
本级命令无专属参数。

###### E.1.8.3.1 `zenava ticket category list`
查询工单模板类别列表

###### E.1.8.4 `zenava ticket child-form`
子表单 CRUD
**子命令：** `create`、`delete`、`get`、`list`、`update`
本级命令无专属参数。

###### E.1.8.4.1 `zenava ticket child-form create`
创建子表单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --fields | text | 否 | — | 子表单字段 JSON array，如 '[{"group":"1,11,12","groupDesc":"一","fieldId":95262,"required":0,"type":8,"priority":1}]'；fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |
| --form-config | text | 否 | — | 子表单配置 JSON object，如 '{"exportColumnMode":0}'；exportColumnMode：0 分类数据在一列中展示 1 按照分类分成多列展示 |
| --name | text | 否 | — | 子表单名称 |
| --description | text | 否 | — | 子表单描述 |
| --cascade | integer | 否 | — | 是否级联 0 下拉 1 级联 |

###### E.1.8.4.2 `zenava ticket child-form delete`
删除子表单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --form-id | integer | 是 | — | 子表单 ID |

###### E.1.8.4.3 `zenava ticket child-form get`
子表单详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --form-id | integer | 是 | — | 子表单 ID |

###### E.1.8.4.4 `zenava ticket child-form list`
子表单列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --form-id | integer | 否 | — | 子表单 ID |
| --form-name | text | 否 | — | 子表单名称 |
| --limit | integer | 否 | — | 查询条数，范围 10-100。默认值为 10 |
| --offset | integer | 否 | — | 偏移量，范围 大于等于0。默认值为 0 |

###### E.1.8.4.5 `zenava ticket child-form update`
更新子表单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --fields | text | 否 | — | 子表单字段 JSON array，如 '[{"group":"1,11,12","groupDesc":"一","fieldId":95262,"required":0,"type":8,"priority":1}]'；fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |
| --form-config | text | 否 | — | 子表单配置 JSON object，如 '{"exportColumnMode":0}'；exportColumnMode：0 分类数据在一列中展示 1 按照分类分成多列展示 |
| --form-id | integer | 是 | — | 子表单 ID |
| --name | text | 否 | — | 子表单名称 |
| --description | text | 否 | — | 子表单描述 |
| --cascade | integer | 否 | — | 是否级联 0 列表 1 级联 |

###### E.1.8.5 `zenava ticket close`
关闭工单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ticket-id | integer | 是 | — | 工单 ID |
| --content | text | 否 | — | 关闭备注 |
| --operator-id | text | 否 | — | 操作人 ID |
| --operator-id-type | integer | 否 | — | 操作人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |

###### E.1.8.6 `zenava ticket comment`
备注工单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 否 | — | 附件 multipart part，格式 NAME=PATH，可多次指定。示例：--file 3=/path/a.pdf --file 3=/path/b.pdf；备注附件 part 名 fileName；催单附件 part 名 files |
| --id | integer | 否 | — | 工单 ID（与 --external-id 至少其一） |
| --external-id | text | 否 | — | 外部工单 ID（与 --id 至少其一） |
| --content | text | 是 | — | 备注内容 |
| --commentator-id | text | 否 | — | 评论人 ID |
| --commentator-id-type | integer | 否 | — | 评论人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --state-id | text | 否 | — | 工单状态 id |
| --state-id-type | integer | 否 | — | 工单状态 id 类型 1 id 2 名称 |

###### E.1.8.7 `zenava ticket create`
创建工单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 否 | — | 附件 multipart part，格式 NAME=PATH，可多次指定。示例：--file 3=/path/a.pdf --file 3=/path/b.pdf；备注附件 part 名 fileName；催单附件 part 名 files |
| --form | text | 是 | — | 表单 JSON object，如 '{"id":1,"name":"表单名称","fields":[{"id":1,"name":"字段1","type":1,"required":0,"value":"xxx"}]}'；fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |
| --tags | text | 否 | — | 标签 JSON array，如 '[{"name":"标签1","color":1},{"name":"标签2","color":2}]' |
| --focus | text | 否 | — | 关注人 JSON array，如 '["123","1234"]' |
| --relate-ticket-id | text | 否 | — | 关联工单 JSON array，如 '[2,3]' |
| --customize-system-fields | text | 否 | — | 工单属性表单字段 JSON array，如 '[{"id":1,"type":1,"name":"单行文本","value":"文本内容"}]'；type 取值同 --form 的 fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |
| --workflow-id | integer | 是 | — | 工单模板 ID |
| --handler-type | integer | 是 | — | 处理类型 0 座席 1 队列 |
| --handler-id | text | 是 | — | 处理人 ID |
| --customer-id | integer | 否 | — | 客户资料 ID |
| --topic | text | 否 | — | 工单主题 |
| --level | integer | 否 | — | 优先级 0 低 1 中 2 高 3 紧急 |
| --creator-id | text | 否 | — | 创建人 ID |
| --creator-id-type | integer | 否 | — | 创建人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --handler-id-type | integer | 否 | — | 处理人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --focus-id-type | integer | 否 | — | 关注人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --state-selected | text | 否 | — | 当前工单状态 |
| --external-id | text | 否 | — | 外部工单 ID |
| --create-time | integer | 否 | — | 创建时间：毫秒时间戳（Unix epoch ms），如 1788242857317 |
| --close | integer | 否 | — | 是否创建关闭工单 0 否 1 是（人工工单） |
| --call-id | text | 否 | — | 通话唯一标识（与 --chat-id 不可同时传） |
| --chat-id | text | 否 | — | 会话唯一标识（与 --call-id 不可同时传） |
| --chat-start-time | integer | 否 | — | 会话开始时间：毫秒时间戳（Unix epoch ms），如 1788242857317；传 --chat-id 时必填 |
| --not-fill-fields | integer | 否 | — | 未传字段是否补全 1 不补全 0 补全 |

###### E.1.8.8 `zenava ticket custom-field`
工单自定义字段库写入（仅 feature=1；不支持工单属性字段 feature=5）。 查询请用 ticket field list。   共用枚举 — 字段类型 type： 1 单行文本（fieldConfig） 2 数值 3 邮箱 4 IP地址 5 多行文本（fieldConfig/hyperLink） 6 下拉列表（options） 7 自定义级联（cascade） 8 地区级联（勿传 cascade） 9 单选框（options） 10 复选框（options/fieldConfig.displayMode4Checkbox） 11 日期时间 12 日期 13 时间 14 附件（fieldConfig） 15 签名 16 定位 17 自增表格（tableFieldIds） 18 级联多选（cascade） 19 时间段 22 查找（fieldConfig.findTarget，创建必填） 100 电话（fieldConfig） 103 字段计算（formula） 105 员工 107 外部扩展下拉（externalExpansion） 109 外部扩展列表检索（externalListSearch） 110 富文本   开关类字段取值一律 0/1。 新建未传默认 0（含 searchDisplay）。 update 局部更新：未传的字段不改。 字符串显式传空串表示清空。 类型专属配置块传了则整段替换。 配置块与 type 对照见上。 叶子命令 --help 含各 JSON 明细与示例。
**子命令：** `create`、`delete`、`update`
本级命令无专属参数。

###### E.1.8.8.1 `zenava ticket custom-field create`
新建自定义字段（feature=1）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 是 | — | 字段名称（必填，企业内 feature=1 唯一） |
| --type | integer | 是 | — | 字段类型（必填）；枚举见 ticket custom-field --help |
| --feature | integer | 否 | — | 仅允许 1 或不传 |
| --description | text | 否 | — | 描述；update 显式空串可清空 |
| --placeholder | text | 否 | — | 占位提示 |
| --search-display | integer | 否 | — | 查询是否展示，取值 0/1 |
| --select-others | integer | 否 | — | 是否支持选择其他，取值 0/1 |
| --multiple-selection | integer | 否 | — | 是否支持多选，取值 0/1 |
| --extend-code | integer | 否 | — | 是否支持扩展编码，取值 0/1 |
| --any-level-selection | integer | 否 | — | 是否支持任意一级选择，取值 0/1 |
| --external-expansion-switch | integer | 否 | — | 是否开启外部扩展，取值 0/1 |
| --hyper-link | integer | 否 | — | 是否支持超链接，取值 0/1 |
| --full-line-display | integer | 否 | — | 是否整行展示，取值 0/1 |
| --query-multi | integer | 否 | — | 查询是否支持多选，取值 0/1 |
| --show-color | integer | 否 | — | 是否显示颜色，取值 0/1 |
| --field-config | text | 否 | — | 扩展配置 JSON object（整对象覆盖）。按 type 使用子集：limit/verifyConfig（1/5）；displayMode4Checkbox（10：1 平铺/2 下拉）；fileKey/fileName（14）；showAllLevels（18）；findTarget/displayFieldKey（22，创建必填 findTarget；更新一旦传 fieldConfig 也必须带）；enablePhoneHiddenRule（100）。示例：'{"findTarget":"customer","displayFieldKey":"name"}' |
| --options | text | 否 | — | 选项 JSON array（仅 type 6/9/10）。明细：name（文案）；value（落库以 name 为主）；code（extendCode=1 时可用）；selected（0/1，整字段最多一个 1）。示例：'[{"name":"高","selected":0},{"name":"中","selected":1},{"name":"低","selected":0}]' |
| --cascade | text | 否 | — | 级联树 JSON array（仅 type 7/18；type=8 不可传）。明细：title；code（可选）；options（子节点，最多 5 级）。示例：'[{"title":"华东","options":[{"title":"上海"},{"title":"杭州"}]}]' |
| --external-expansion | text | 否 | — | 外部扩展下拉 JSON object（仅 type 107）。明细：url（须 http:// 或 https:// 开头）；method；token；timeout（1–10）；retryCount（0–3）；returnParameter（string[]）。示例：'{"url":"https://example.com/api","method":"GET","token":"YOUR_TOKEN","timeout":3,"retryCount":1,"returnParameter":["id","name"]}' |
| --external-list-search | text | 否 | — | 列表检索 JSON object（仅 type 109）。明细：invokeType（1 API / 2 智能体）；url（invokeType=1 必填）；agentId（invokeType=2）；displayParamName（必填）；token/timeout/retryCount/id。示例：'{"invokeType":1,"url":"https://example.com/search","displayParamName":"name","token":"YOUR_TOKEN","timeout":3,"retryCount":0}' |
| --table-field-ids | text | 否 | — | 自增表格引用字段 id 的 JSON array of integer（仅 type 17，至少一项）。示例：'[1001,1002]' |
| --formula | text | 否 | — | 合计公式（仅 type 103）；可同传 --check-field-ids 试算 |
| --check-field-ids | text | 否 | — | 公式试算字段 id，逗号分隔；仅与本次 formula 一并生效，不单独落库 |

###### E.1.8.8.2 `zenava ticket custom-field delete`
删除自定义字段
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | field.id（必填） |

###### E.1.8.8.3 `zenava ticket custom-field update`
局部更新自定义字段
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | field.id（必填） |
| --name | text | 否 | — | 字段名称（可选） |
| --type | integer | 否 | — | 若传须与库中相同；枚举见 ticket custom-field --help |
| --feature | integer | 否 | — | 仅允许 1 或不传 |
| --description | text | 否 | — | 描述；update 显式空串可清空 |
| --placeholder | text | 否 | — | 占位提示 |
| --read-only-content | text | 否 | — | 只读域（仅 update；最长 2000；显式空串可清空） |
| --search-display | integer | 否 | — | 查询是否展示，取值 0/1 |
| --select-others | integer | 否 | — | 是否支持选择其他，取值 0/1 |
| --multiple-selection | integer | 否 | — | 是否支持多选，取值 0/1 |
| --extend-code | integer | 否 | — | 是否支持扩展编码，取值 0/1 |
| --any-level-selection | integer | 否 | — | 是否支持任意一级选择，取值 0/1 |
| --external-expansion-switch | integer | 否 | — | 是否开启外部扩展，取值 0/1 |
| --hyper-link | integer | 否 | — | 是否支持超链接，取值 0/1 |
| --full-line-display | integer | 否 | — | 是否整行展示，取值 0/1 |
| --query-multi | integer | 否 | — | 查询是否支持多选，取值 0/1 |
| --show-color | integer | 否 | — | 是否显示颜色，取值 0/1 |
| --field-config | text | 否 | — | 扩展配置 JSON object（整对象覆盖）。按 type 使用子集：limit/verifyConfig（1/5）；displayMode4Checkbox（10：1 平铺/2 下拉）；fileKey/fileName（14）；showAllLevels（18）；findTarget/displayFieldKey（22，创建必填 findTarget；更新一旦传 fieldConfig 也必须带）；enablePhoneHiddenRule（100）。示例：'{"findTarget":"customer","displayFieldKey":"name"}' |
| --options | text | 否 | — | 选项 JSON array（仅 type 6/9/10）。明细：name（文案）；value（落库以 name 为主）；code（extendCode=1 时可用）；selected（0/1，整字段最多一个 1）。示例：'[{"name":"高","selected":0},{"name":"中","selected":1},{"name":"低","selected":0}]' |
| --cascade | text | 否 | — | 级联树 JSON array（仅 type 7/18；type=8 不可传）。明细：title；code（可选）；options（子节点，最多 5 级）。示例：'[{"title":"华东","options":[{"title":"上海"},{"title":"杭州"}]}]' |
| --external-expansion | text | 否 | — | 外部扩展下拉 JSON object（仅 type 107）。明细：url（须 http:// 或 https:// 开头）；method；token；timeout（1–10）；retryCount（0–3）；returnParameter（string[]）。示例：'{"url":"https://example.com/api","method":"GET","token":"YOUR_TOKEN","timeout":3,"retryCount":1,"returnParameter":["id","name"]}' |
| --external-list-search | text | 否 | — | 列表检索 JSON object（仅 type 109）。明细：invokeType（1 API / 2 智能体）；url（invokeType=1 必填）；agentId（invokeType=2）；displayParamName（必填）；token/timeout/retryCount/id。示例：'{"invokeType":1,"url":"https://example.com/search","displayParamName":"name","token":"YOUR_TOKEN","timeout":3,"retryCount":0}' |
| --table-field-ids | text | 否 | — | 自增表格引用字段 id 的 JSON array of integer（仅 type 17，至少一项）。示例：'[1001,1002]' |
| --formula | text | 否 | — | 合计公式（仅 type 103）；可同传 --check-field-ids 试算 |
| --check-field-ids | text | 否 | — | 公式试算字段 id，逗号分隔；仅与本次 formula 一并生效，不单独落库 |

###### E.1.8.9 `zenava ticket field`
工单字段
**子命令：** `list`、`update-property`
本级命令无专属参数。

###### E.1.8.9.1 `zenava ticket field list`
查询工单字段列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ids | text | 否 | — | 字段 ID 集合，逗号分隔整数 |

###### E.1.8.9.2 `zenava ticket field update-property`
更新工单字段选项属性
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 字段 ID |
| --property | text | 是 | — | 字段选项值 JSON 字符串（array），如 '[{"name":"示例_下拉1","selected":0},{"name":"示例_下拉2","selected":0}]' |

###### E.1.8.10 `zenava ticket file-url`
查询工单附件下载 URL（不落盘）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file-key | text | 是 | — | 工单附件 fileKey |

###### E.1.8.11 `zenava ticket finish`
完成工单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ticket-id | integer | 是 | — | 工单 ID |
| --content | text | 否 | — | 完成备注 |
| --operator-id | text | 否 | — | 操作人 ID |
| --operator-id-type | integer | 否 | — | 操作人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |

###### E.1.8.12 `zenava ticket flow`
流转工单（节点流转填表单；审批节点请用 ticket approve）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 否 | — | 附件 multipart part，格式 NAME=PATH，可多次指定。示例：--file 3=/path/a.pdf --file 3=/path/b.pdf；备注附件 part 名 fileName；催单附件 part 名 files |
| --ticket-id | integer | 是 | — | 工单 ID |
| --handler-id | text | 是 | — | 当前节点处理人 ID |
| --task-id | text | 是 | — | 任务 ID（详情 status 中获取） |
| --handler-id-type | integer | 否 | — | 处理人类型 1 用户id 2 用户手机号 3 用户名 4 用户工号 5 sso标识，不传默认 1 |
| --form | text | 是 | — | 表单 JSON object，如 '{"id":1,"name":"表单名称","fields":[{"id":1,"name":"字段1","type":1,"required":0,"value":"xxx"}]}'；fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |
| --next-handler-id | text | 否 | — | 下一节点处理人 ID |
| --next-handler-id-type | integer | 否 | — | 下一节点处理人类型 1 用户id 2 用户手机号 3 用户名 4 用户工号 5 sso标识，不传默认 1 |
| --state-id | integer | 否 | — | 下一节点自定义状态 ID |
| --customize-system-fields | text | 否 | — | 工单属性表单字段 JSON array，如 '[{"id":1,"type":1,"name":"单行文本","value":"文本内容"}]'；type 取值同 --form 的 fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |

###### E.1.8.13 `zenava ticket form`
工单表单
**子命令：** `get`
本级命令无专属参数。

###### E.1.8.13.1 `zenava ticket form get`
查询表单详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 表单 ID |

###### E.1.8.14 `zenava ticket form-template`
工单主表单模版写入（查询请用 ticket form get / sys-form get / child-form）
**子命令：** `create`、`delete`、`update`
本级命令无专属参数。

###### E.1.8.14.1 `zenava ticket form-template create`
新建主表单模版
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --name | text | 是 | — | 表单名称（必填，最长 20，企业内唯一） |
| --description | text | 否 | — | 表单描述（可选，最长 200） |
| --form-config | text | 否 | — | 表单配置 JSON object（可选）。明细：summaryOpen（integer，0 不显示摘要 / 1 显示，不传视为关）；summary（string，摘要文案，最长 200，summaryOpen=1 时才有意义）。检验产品不要写在 formConfig。示例：'{"summaryOpen":1,"summary":"客户问题摘要"}' |
| --fields | text | 是 | — | 表单字段 JSON array（必填，至少 1 条由服务端校验）。每项二选一：普通字段传 fieldId，挂已有子表单传 childrenFormId（不可同时、不可都缺）。写入字段明细：fieldId（integer，企业字段库已有字段）；childrenFormId（integer，已存在子表单 id）；priority（integer，排序，建议从 1 递增，不传当 0）；span（integer，仅 1/2/3/4，不传按字段类型默认）；permission（integer，1 必填 / 2 选填 / 3 只读 / 4 隐藏）；required/hidden/readonly（integer 0/1，旧权限，仅当不传 permission 时生效）；unique（integer，0/1，不传当 0）；externalCustomerVisible（integer，1 可见 / 0 不可见，不传默认 1）；formFieldConfig（object，可选）：relatedProductsSwitch（检验产品开关 1/0）、relatedProductsFieldId（关联产品字段 id，开检验产品时必填且须出现在本次 fields）、occupancySwitch、externalCustomerVisible、defaultValue、createHidden、rolePermissionSwitch、syncCustomerFieldSwitch、syncCustomerFieldVal、externalExpansionSwitch、listSearchConfig；extendedConfig（JSON 字符串，非对象；仅 externalExpansionSwitch=1 时需要）内含：invokeType（1 HTTP / 2 智能体）、url、token、timeout、retryCount、agentId、requestParamMappings、responseParamMappings。勿传 schema / type / name；布局由服务端按 priority/span 生成。示例：'[{"fieldId":2001,"priority":1,"span":2,"permission":1,"externalCustomerVisible":1,"unique":0},{"fieldId":2002,"priority":2,"permission":1},{"fieldId":2019,"priority":3,"permission":1,"formFieldConfig":{"relatedProductsSwitch":1,"relatedProductsFieldId":2002}},{"childrenFormId":3001,"priority":4,"permission":2},{"fieldId":2003,"priority":5,"permission":2,"formFieldConfig":{"externalExpansionSwitch":1},"extendedConfig":"{\"invokeType\":1,\"url\":\"https://example.com/api\",\"token\":\"YOUR_TOKEN\",\"timeout\":3,\"retryCount\":1,\"requestParamMappings\":[],\"responseParamMappings\":[]}"}]' |

###### E.1.8.14.2 `zenava ticket form-template delete`
删除主表单模版
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 表单主键 id（必填） |

###### E.1.8.14.3 `zenava ticket form-template update`
更新主表单模版（fields 整份覆盖）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 是 | — | 表单主键 id（必填） |
| --name | text | 否 | — | 表单名称（可选；改名时企业内唯一） |
| --description | text | 否 | — | 表单描述（可选，最长 200） |
| --form-config | text | 否 | — | 表单配置 JSON object（可选）。明细：summaryOpen（integer，0 不显示摘要 / 1 显示，不传视为关）；summary（string，摘要文案，最长 200，summaryOpen=1 时才有意义）。检验产品不要写在 formConfig。示例：'{"summaryOpen":1,"summary":"客户问题摘要"}' |
| --fields | text | 是 | — | 表单字段 JSON array（必填，至少 1 条由服务端校验）。每项二选一：普通字段传 fieldId，挂已有子表单传 childrenFormId（不可同时、不可都缺）。写入字段明细：fieldId（integer，企业字段库已有字段）；childrenFormId（integer，已存在子表单 id）；priority（integer，排序，建议从 1 递增，不传当 0）；span（integer，仅 1/2/3/4，不传按字段类型默认）；permission（integer，1 必填 / 2 选填 / 3 只读 / 4 隐藏）；required/hidden/readonly（integer 0/1，旧权限，仅当不传 permission 时生效）；unique（integer，0/1，不传当 0）；externalCustomerVisible（integer，1 可见 / 0 不可见，不传默认 1）；formFieldConfig（object，可选）：relatedProductsSwitch（检验产品开关 1/0）、relatedProductsFieldId（关联产品字段 id，开检验产品时必填且须出现在本次 fields）、occupancySwitch、externalCustomerVisible、defaultValue、createHidden、rolePermissionSwitch、syncCustomerFieldSwitch、syncCustomerFieldVal、externalExpansionSwitch、listSearchConfig；extendedConfig（JSON 字符串，非对象；仅 externalExpansionSwitch=1 时需要）内含：invokeType（1 HTTP / 2 智能体）、url、token、timeout、retryCount、agentId、requestParamMappings、responseParamMappings。勿传 schema / type / name；布局由服务端按 priority/span 生成。示例：'[{"fieldId":2001,"priority":1,"span":2,"permission":1,"externalCustomerVisible":1,"unique":0},{"fieldId":2002,"priority":2,"permission":1},{"fieldId":2019,"priority":3,"permission":1,"formFieldConfig":{"relatedProductsSwitch":1,"relatedProductsFieldId":2002}},{"childrenFormId":3001,"priority":4,"permission":2},{"fieldId":2003,"priority":5,"permission":2,"formFieldConfig":{"externalExpansionSwitch":1},"extendedConfig":"{\"invokeType\":1,\"url\":\"https://example.com/api\",\"token\":\"YOUR_TOKEN\",\"timeout\":3,\"retryCount\":1,\"requestParamMappings\":[],\"responseParamMappings\":[]}"}]' |

###### E.1.8.15 `zenava ticket get`
查询工单详情
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 否 | — | 工单 ID（与 --external-id 至少其一） |
| --external-id | text | 否 | — | 外部工单 ID（与 --id 至少其一） |
| --include-save-form | integer | 否 | — | forms 是否含保存/草稿：1 包含；0/不传 不包含 |

###### E.1.8.16 `zenava ticket list`
查询工单列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --start-time | text | 是 | — | 开始时间，yyyy-MM-dd HH:mm:ss |
| --end-time | text | 是 | — | 结束时间，yyyy-MM-dd HH:mm:ss |
| --id | integer | 否 | — | 工单 ID |
| --custom-id | text | 否 | — | 工单自定义编号 |
| --handle-status | integer | 否 | — | 处理状态 0 待领取 2 处理中 4 已完成 5 已关闭 9 待接单 |
| --creator-id | integer | 否 | — | 创建人 ID |
| --topic | text | 否 | — | 工单主题 |
| --workflow-id | integer | 否 | — | 工单模板 ID |
| --handler-type | integer | 否 | — | 处理类型 0 座席 1 队列 |
| --handler-id | integer | 否 | — | 处理人 ID |
| --level | integer | 否 | — | 优先级 0 低 1 中 2 高 3 紧急 |
| --tag | text | 否 | — | 工单标签名称 |
| --type | integer | 否 | — | 类别 1 预制工作流 2 人工分配 |
| --close-time-start | text | 否 | — | 关闭开始时间，yyyy-MM-dd HH:mm:ss |
| --close-time-end | text | 否 | — | 关闭结束时间，yyyy-MM-dd HH:mm:ss |
| --end-time-start | text | 否 | — | 完成开始时间，yyyy-MM-dd HH:mm:ss |
| --end-time-end | text | 否 | — | 完成结束时间，yyyy-MM-dd HH:mm:ss |
| --update-time-start | text | 否 | — | 更新开始时间，yyyy-MM-dd HH:mm:ss |
| --update-time-end | text | 否 | — | 更新结束时间，yyyy-MM-dd HH:mm:ss |
| --last-reminder-time-start | text | 否 | — | 催单开始日期，yyyy-MM-dd |
| --last-reminder-time-end | text | 否 | — | 催单结束日期，yyyy-MM-dd |
| --reminder-count | integer | 否 | — | 催单次数 |
| --customer-name | text | 否 | — | 客户名称 |
| --customer-tel | text | 否 | — | 客户号码 |
| --customer-id | integer | 否 | — | 客户资料 ID |
| --task-key | text | 否 | — | 节点唯一标识 |
| --fields | text | 否 | — | 自定义字段 JSON object（可含多组 key-value），如 '{"234653":"下拉1","339334":"已处理"}' |
| --system-fields | text | 否 | — | 自定义系统属性字段 JSON object（可含多组 key-value），如 '{"291033":"下拉1","291035":"单选1"}' |
| --source | integer | 否 | — | 来源：0 呼叫中心；1 在线咨询；2 微信；3 人工添加；4 小程序；5 微博；6 电子邮件；7 app端；8 企业微信；9 微信客服（独立版）；10 第三方接入；11 接口创建；12 企微客服；14 抖音企业号；15 百度营销；16 sdk渠道；17 自助工单；18 访客端APP；19 微信客服；20 人工导入创建；21 企微助手；22 自动化任务创建；23 飞书；24 留言节点；30 接口创建；31 知识库审批；32 智能质检；33 触发器；34 视频客服；35 邮件工单；36 在线留言；37 机器人工单；38 小红书 |
| --limit | integer | 否 | — | 分页 查询条数，范围 10-100。默认值为 10 |
| --offset | integer | 否 | — | 分页 偏移量，范围 大于等于0。默认值为 0 |

###### E.1.8.17 `zenava ticket mock`
创建、更新、审批工单参数示例
**子命令：** `create`、`remind`、`update`
本级命令无专属参数。

###### E.1.8.17.1 `zenava ticket mock create`
获取创建工单 model 样例
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --workflow-name | text | 是 | — | 工单模板名称（mock_save_ticket） |

###### E.1.8.17.2 `zenava ticket mock remind`
获取催单 model 样例
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ticket-id | integer | 否 | — | 工单 ID |
| --custom-id | text | 否 | — | 自定义编号 |

###### E.1.8.17.3 `zenava ticket mock update`
获取更新工单 model 样例
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 否 | — | 工单 ID |
| --external-id | text | 否 | — | 外部 ID |
| --custom-id | text | 否 | — | 自定义编号 |
| --form-id | integer | 否 | — | 表单 ID（预制流） |
| --task-id | text | 否 | — | 任务 ID（预制流） |

###### E.1.8.18 `zenava ticket plugin`
工单插件
**子命令：** `get`
本级命令无专属参数。

###### E.1.8.18.1 `zenava ticket plugin get`
查询工单插件（嵌入 URL / workflowId）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 否 | — | 工单插件 ID（与 --ext-param 至少填一个；都传则以 id 为准） |
| --ext-param | text | 否 | — | 外部参数（与 --id 至少填一个；都传则以 id 为准） |

###### E.1.8.19 `zenava ticket preserve`
工单保存
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 否 | — | 附件 multipart part，格式 NAME=PATH，可多次指定。示例：--file 3=/path/a.pdf --file 3=/path/b.pdf；备注附件 part 名 fileName；催单附件 part 名 files |
| --ticket-id | integer | 是 | — | 工单 ID |
| --handler-id | text | 是 | — | 当前节点处理人 ID |
| --task-id | text | 是 | — | 任务 ID（详情 status 中获取） |
| --handler-id-type | integer | 否 | — | 处理人类型 1 用户id 2 用户手机号 3 用户名 4 用户工号 5 sso标识，不传默认 1 |
| --form | text | 是 | — | 表单 JSON object，如 '{"id":1,"name":"表单名称","fields":[{"id":1,"name":"字段1","type":1,"required":0,"value":"xxx"}]}'；fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |
| --state-id | integer | 否 | — | 自定义状态 ID |

###### E.1.8.20 `zenava ticket remind`
催单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 否 | — | 附件 multipart part，格式 NAME=PATH，可多次指定。示例：--file 3=/path/a.pdf --file 3=/path/b.pdf；备注附件 part 名 fileName；催单附件 part 名 files |
| --user-id | text | 否 | — | 催单员工 ID |
| --user-id-type | integer | 否 | — | 催单人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --reminder-remark | text | 否 | — | 催单描述 |
| --task-id | text | 否 | — | 催单任务 id（预制流必填） |
| --ticket-id | integer | 否 | — | 工单 ID（与 --custom-id 至少其一） |
| --custom-id | text | 否 | — | 自定义编号（与 --ticket-id 至少其一） |

###### E.1.8.21 `zenava ticket restart`
重启工单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --ticket-id | integer | 否 | — | 工单 ID（与 --custom-id 至少其一） |
| --custom-id | text | 否 | — | 自定义编号（与 --ticket-id 至少其一） |
| --handler-id | text | 否 | — | 处理人 ID |
| --handler-id-type | integer | 否 | — | 处理人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --handler-cno | text | 否 | — | 处理人工号 |
| --handler-user-name | text | 否 | — | 处理人名称 |
| --content | text | 否 | — | 重启描述 |
| --after-restart-handler-id | text | 否 | — | 重启后处理人 ID |
| --after-restart-handler-id-type | integer | 否 | — | 重启后处理人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --after-restart-handler-cno | text | 否 | — | 重启后处理人工号 |
| --after-restart-handler-user-name | text | 否 | — | 重启后处理人名称 |

###### E.1.8.22 `zenava ticket stage`
暂存工单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 否 | — | 附件 multipart part，格式 NAME=PATH，可多次指定。示例：--file 3=/path/a.pdf --file 3=/path/b.pdf；备注附件 part 名 fileName；催单附件 part 名 files |
| --form | text | 是 | — | 表单 JSON object，如 '{"id":1,"name":"表单名称","fields":[{"id":1,"name":"字段1","type":1,"required":0,"value":"xxx"}]}'；fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |
| --tags | text | 否 | — | 标签 JSON array，如 '[{"name":"标签1","color":1},{"name":"标签2","color":2}]' |
| --focus | text | 否 | — | 关注人 JSON array，如 '["123","1234"]' |
| --relate-ticket-id | text | 否 | — | 关联工单 JSON array，如 '[2,3]' |
| --customize-system-fields | text | 否 | — | 工单属性表单字段 JSON array，如 '[{"id":1,"type":1,"name":"单行文本","value":"文本内容"}]'；type 取值同 --form 的 fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |
| --creator-code | integer | 是 | — | 创建人类型 1 员工ID 2 手机号 3 用户名 4 座席工号 |
| --creator-value | text | 是 | — | 创建人值 |
| --workflow-id | integer | 是 | — | 工单模板 ID |
| --customer-id | integer | 否 | — | 客户资料 ID |
| --topic | text | 否 | — | 工单主题 |
| --level | integer | 否 | — | 优先级 0 低 1 中 2 高 3 紧急 |
| --handler-type | integer | 否 | — | 处理类型 0 座席 1 队列 |
| --handler-id | text | 否 | — | 处理人 ID |
| --handler-id-type | integer | 否 | — | 处理人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --focus-id-type | integer | 否 | — | 关注人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --state-selected | text | 否 | — | 当前工单状态 |
| --external-id | text | 否 | — | 外部工单 ID |
| --create-time | integer | 否 | — | 创建时间：毫秒时间戳（Unix epoch ms），如 1788242857317 |
| --close | integer | 否 | — | 是否创建关闭工单 0 否 1 是（人工工单） |
| --call-id | text | 否 | — | 通话唯一标识（与 --chat-id 不可同时传） |
| --chat-id | text | 否 | — | 会话唯一标识（与 --call-id 不可同时传） |
| --chat-start-time | integer | 否 | — | 会话开始时间：毫秒时间戳（Unix epoch ms），如 1788242857317；传 --chat-id 时必填 |

###### E.1.8.23 `zenava ticket stat`
工单统计报表
**子命令：** `client`、`overall`、`queue`
本级命令无专属参数。

###### E.1.8.23.1 `zenava ticket stat client`
工单座席情况统计报表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --date | text | 是 | — | 同步日期，yyyyMMdd |
| --fields | text | 否 | — | 指定显示字段，逗号分隔；默认全部 |
| --cnos | text | 否 | — | 座席号集合，逗号分隔；默认全部 |

###### E.1.8.23.2 `zenava ticket stat overall`
工单整体统计报表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --date | text | 是 | — | 同步日期，yyyyMMdd |
| --fields | text | 否 | — | 指定显示字段，逗号分隔；默认全部 |
| --tag | text | 否 | — | 标签 |
| --sources | text | 否 | — | 渠道来源，逗号分隔：0 呼叫中心；1 在线咨询；2 微信；3 人工添加；4 小程序；5 微博；6 电子邮件；7 app端；8 企业微信；9 微信客服（独立版）；10 第三方接入；11 接口创建；12 企微客服；14 抖音企业号；15 百度营销；16 sdk渠道；17 自助工单；18 访客端APP；19 微信客服；20 人工导入创建；21 企微助手；22 自动化任务创建；23 飞书；24 留言节点；30 接口创建；31 知识库审批；32 智能质检；33 触发器；34 视频客服；35 邮件工单；36 在线留言；37 机器人工单 |
| --statistic-method | integer | 否 | 1 | 统计方式：1 分时；2 分日 |
| --levels | text | 否 | — | 工单优先级，逗号分隔整数 |
| --workflow-ids | text | 否 | — | 工单模版 ID，逗号分隔整数 |
| --system-field-map | text | 否 | — | 自定义系统属性字段 JSON object（可含多组 key-value），如 '{"291033":"下拉1","291035":"单选1"}' |
| --field-map | text | 否 | — | 自定义字段 JSON object（可含多组 key-value），如 '{"234653":"下拉1","339334":"已处理"}' |

###### E.1.8.23.3 `zenava ticket stat queue`
工单座席组情况统计报表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --date | text | 是 | — | 同步日期，yyyyMMdd |
| --fields | text | 否 | — | 指定显示字段，逗号分隔；默认全部 |
| --qnos | text | 否 | — | 座席组集合，逗号分隔；默认全部 |

###### E.1.8.24 `zenava ticket store`
工单存草稿
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 否 | — | 附件 multipart part，格式 NAME=PATH，可多次指定。示例：--file 3=/path/a.pdf --file 3=/path/b.pdf；备注附件 part 名 fileName；催单附件 part 名 files |
| --ticket-id | integer | 是 | — | 工单 ID |
| --handler-id | text | 是 | — | 当前节点处理人 ID |
| --task-id | text | 是 | — | 任务 ID（详情 status 中获取） |
| --handler-id-type | integer | 否 | — | 处理人类型 1 用户id 2 用户手机号 3 用户名 4 用户工号 5 sso标识，不传默认 1 |
| --form | text | 是 | — | 表单 JSON object，如 '{"id":1,"name":"表单名称","fields":[{"id":1,"name":"字段1","type":1,"required":0,"value":"xxx"}]}'；fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |

###### E.1.8.25 `zenava ticket sys-form`
工单系统属性表单
**子命令：** `get`
本级命令无专属参数。

###### E.1.8.25.1 `zenava ticket sys-form get`
查询系统表单详情

###### E.1.8.26 `zenava ticket update`
更新工单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 否 | — | 附件 multipart part，格式 NAME=PATH，可多次指定。示例：--file 3=/path/a.pdf --file 3=/path/b.pdf；备注附件 part 名 fileName；催单附件 part 名 files |
| --form | text | 否 | — | 表单 JSON object，如 '{"id":1,"name":"表单名称","fields":[{"id":1,"name":"字段1","type":1,"required":0,"value":"xxx"}]}'；fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |
| --tags | text | 否 | — | 标签 JSON array，如 '[{"name":"标签1","color":1},{"name":"标签2","color":2}]' |
| --focus | text | 否 | — | 关注人 JSON array，如 '["123","1234"]' |
| --relate-ticket-id | text | 否 | — | 关联工单 JSON array，如 '[2,3]' |
| --customize-system-fields | text | 否 | — | 工单属性表单字段 JSON array，如 '[{"id":1,"type":1,"name":"单行文本","value":"文本内容"}]'；type 取值同 --form 的 fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本 |
| --id | integer | 否 | — | 工单 ID |
| --external-id | text | 否 | — | 外部工单 ID |
| --custom-id | text | 否 | — | 自定义编号 |
| --topic | text | 否 | — | 工单主题 |
| --level | integer | 否 | — | 优先级 0 低 1 中 2 高 3 紧急 |
| --focus-id-type | integer | 否 | — | 关注人类型 1 用户id 2 手机号 3 用户名 4 工号 5 sso |
| --state-selected | text | 否 | — | 当前工单状态 |
| --update-time | integer | 否 | — | 更新时间：毫秒时间戳（Unix epoch ms），如 1788242857317 |

###### E.1.8.27 `zenava ticket update-prefabricated`
更新预制流历史表单
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --file | text | 否 | — | 附件 multipart part，格式 NAME=PATH，可多次指定。示例：--file 3=/path/a.pdf --file 3=/path/b.pdf；备注附件 part 名 fileName；催单附件 part 名 files |
| --id | integer | 否 | — | 工单 ID（与 --external-id 二者必有一） |
| --external-id | text | 否 | — | 外部工单 ID（与 --id 二者必有一） |
| --form | text | 否 | — | 表单 JSON object，如 '{"id":1,"name":"表单名称","fields":[{"id":1,"name":"字段1","type":1,"required":0,"value":"xxx"}]}'；fields[].type：1 单行文本 2 数值 3 邮件 4 IP地址 5 多行文本 6 下拉框 7 自定义级联 8 地区级联 9 单选框 10 复选框 11 日期和时间 12 日期 13 时间 14 文件 15 签名 16 定位 17 自增表格 18 级联多选 99 子表单 100 电话 105 员工 107 外部扩展下拉列表 109 外部扩展列表检索 110 富文本；若传 form 则其中 taskId 必填 |
| --update-time | integer | 否 | — | 更新时间：毫秒时间戳（Unix epoch ms），如 1788242857317 |
| --operator-id | text | 否 | — | 操作人 ID |
| --operator-id-type | integer | 否 | — | 操作人类型 1 用户id 2 用户手机号 3 用户名 4 用户工号 5 sso标识，不传默认 1 |

###### E.1.8.28 `zenava ticket workflow`
工单模板
**子命令：** `list`
本级命令无专属参数。

###### E.1.8.28.1 `zenava ticket workflow list`
查询工单模板列表
| 参数 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| --id | integer | 否 | — | 工单模板 ID |
| --category | integer | 否 | — | 工单模板类别 ID |
| --name | text | 否 | — | 工单模板名称 |
| --limit | integer | 否 | — | 分页 查询条数，范围 10-100。默认值为 10 |
| --offset | integer | 否 | — | 分页 偏移量，范围 大于等于0。默认值为 0 |

##### E.1.9 `zenava update`
检测版本更新
**子命令：** `check`
本级命令无专属参数。

###### E.1.9.1 `zenava update check`
检测版本更新