# avavox 帮助文档

> 本指南帮助你在 4 个步骤内完成从登录到外呼任务的全流程操作。

下列页面链接指向 .md 版本，正文仅改写链接目标。

## 产品使用

- [欢迎使用 avavox](https://avavox.com/docs/index.md): 本指南帮助你在 4 个步骤内完成从登录到外呼任务的全流程操作。
- [注册登录](https://avavox.com/docs/sign-up.md): avavox 官网链接： https://avavox.com
- [概览](https://avavox.com/docs/dashboard.md): 可查看该企业今日/本周/本月的数据：
- [数据分析](https://avavox.com/docs/data-analysis.md): 数据分析模块用于查看外呼业务的整体表现。入口：左侧导航栏「运行」→「数据分析」。
- [智能洞察](https://avavox.com/docs/insight.md): 智能洞察用于对通话进行 AI 质检：由大模型按照规则组设定的评分标准对通话自动打分，输出洞察结果，帮助运营人员发现通话质量问题。
- [机器人](https://avavox.com/docs/robot-manage/manage.md): 按照以下步骤创建机器人：
  - [人设与回复逻辑（提示词） 进阶指南](https://avavox.com/docs/robot-manage/advanced.md): 首先，选择通过模板创建/自定义创建，并选择语言。（选择模板创建时，可以直接使用模板创建的内容结构，无需重新搭建提示词结构）。
  - [机器人设置](https://avavox.com/docs/robot-manage/config.md): 机器人设置在提示词之外配置机器人的声音、响应时机与分析能力，直接影响通话的听感和识别准确率。
  - [钉钉推送设置](https://avavox.com/docs/robot-manage/dingtalk.md): 为了将 AI 筛选出的高意向客户实时推送到钉钉群，需要在钉钉群中添加群机器人，获取 Webhook 地址，并在 avavox 中完成推送设置。
  - [企业微信推送设置](https://avavox.com/docs/robot-manage/qiwei.md): 为了将 AI 筛选出的高意向客户实时推送到企业微信群，需要在企业微信群中添加群机器人，获取 Webhook 地址，并在 avavox 中完成推送设置。
  - [飞书推送设置](https://avavox.com/docs/robot-manage/feishu.md): 通过飞书群机器人，您可以将机器人筛选出的高意向客户实时推送至指定飞书群，方便销售或运营团队及时跟进。
- [线路号码](https://avavox.com/docs/line-manage.md): 当您拥有自有线路资源时，可直接创建至系统中使用。
- [变量](https://avavox.com/docs/variable.md): 变量功能，能让您在提示词模板中提前留好空位，比如客户姓名、地址，在创建外呼任务时，可批量导入该项数据，在外呼时，系统会自动填充这些变量，让每通沟通都更精准个性化，无需手动重复修改。
- [标签](https://avavox.com/docs/tag.md): AI 标签需配合机器人使用，请先在标签库建立标签，然后返回机器人发布页面，选中创建好的AI 标签，同时发布机器人。
  - [标签测评](https://avavox.com/docs/tag-eval.md): 想知道 AI 标签打得准不准？标签测评让你用真实通话验证打标效果，再决定要不要发布到线上生效。
- [工具调用（Function Call）使用指南](https://avavox.com/docs/function-call.md): 工具调用（function call）是指机器人在通话过程中，根据客户的问题调用您配置的外部接口，获取实时业务数据后再继续回复客户。
- [声音克隆](https://avavox.com/docs/voice-clone.md): 付费规则：声音克隆按照每一个使用一年 188 元计算，单次购买的声音克隆服务有效期一年，次年可续费。
- [任务](https://avavox.com/docs/task-manage.md): 点击列表上的任务模块，可以看到任务模块，在任务页面可以看到每个任务的进展和状态，根据需要点击任务进入任务详情，管理任务。
- [呼叫记录](https://avavox.com/docs/call-records.md): 呼叫记录用于查看每一次外呼的明细结果，并支持按标签快速筛选意向客户。
- [短信记录](https://avavox.com/docs/sms-records.md): 短信记录用于查看外呼业务中短信的发送情况。
- [禁呼名单](https://avavox.com/docs/blacklist.md): 禁呼名单用于在外呼拨打前自动拦截不需要拨打的号码。号码加入禁呼名单后，系统不会拨打该号码，也不消耗外呼积分。禁呼名单是「每个空间单独设置」的，如果同一个号码在 A 空间被禁呼，但在 B 空间没有被禁呼，那么在 B 空间仍然可以正常拨打该号码。请根据实际业务需要，在各个空间分别维护。
- [集成记录](https://avavox.com/docs/integration-records.md): 集成记录用于查看系统与外部系统之间的数据交互情况。入口：左侧导航栏「系统」→「集成记录」。
- [全部更新](https://avavox.com/docs/changelog/all.md): avavox 的产品迭代记录。我们会在这里同步重大更新、新功能、体验优化、问题修复。
  - [重大更新](https://avavox.com/docs/changelog/major.md): 发票申请支持线上办理；海外版 avavox 新增任务时区；智能洞察新增问题案例库
  - [新功能](https://avavox.com/docs/changelog/feature.md): 空间自主充值支持企业购买并发和声音克隆
  - [体验优化](https://avavox.com/docs/changelog/optimization.md): 渠道后台账户新增「可分配金额」
  - [问题修复](https://avavox.com/docs/changelog/fixes.md): 修复「无通话记录不打标签」、「分配线路后依旧提示无线路」问题
- [企业后台](https://avavox.com/docs/corp-dashboard.md): 查看企业当前的整体数据，包括空间总数量、剩余积分、钱包余额等。
- [权限设置](https://avavox.com/docs/permission-settings.md): 在企业后台设置→ 角色权限中操作。
- [平台计费与充值规则说明](https://avavox.com/docs/billing-rules.md): 本平台采用 "基础通话费 + 增值服务费" 的组合计费模式。所有消费均通过平台积分结算。
- [空间自主充值](https://avavox.com/docs/agent-recharge.md): 空间自主充值用于将企业统一财务账户调整为空间独立账户。开启后，每个空间可以独立充值、消费和购买付费资源，各空间的余额、积分及付费资产互不共享。
- [通话振铃音状态说明](https://avavox.com/docs/call-ringtone-status.md): 本页用于说明外呼任务中的振铃音识别结果与通话状态映射，方便运营、质检和数据查看时快速判断每条记录的实际含义。
- [运营主体及相关协议更新说明](https://avavox.com/docs/announcements/entity-update-20260917.md): avavox 平台运营及协议主体由「鼎富智能科技有限公司」调整为「北京诠识科技有限公司」。本页汇总本次涉及的协议、隐私政策及业务文件，可在新标签页中逐份打开原始 PDF。

## 开发者文档

- [总览](https://avavox.com/docs/developer/index.md): 本页汇总 AVAVOX 开放 API 的对接流程与全部接口清单，帮助你在深入具体接口文档前，先建立一个全局认知：有哪些接口、分别做什么、以及一个典型对接流程该按什么顺序调用它们。
- [App Key 创建与管理](https://avavox.com/docs/developer/app-key.md): App Key 是接口调用时的身份凭证，用于标识调用方身份并进行校验。
- [avavox 智能外呼 Skill](https://avavox.com/docs/developer/avavox-call.md): avavox-call 是基于 avavox 官方开放 API 的智能外呼技能包。将它安装到 WorkBuddy，或其他具备文件读取、Python 3 执行和 HTTPS 访问能力的智能体宿主后，可以通过自然语言完成外呼业务操作。
- [机器人查询](https://avavox.com/docs/developer/query-robot.md): 查询已发布的机器人列表
- [线路查询](https://avavox.com/docs/developer/query-line.md): 该接口用于查询已申请通过或自建线路列表（仅返回开启状态线路）
- [任务创建](https://avavox.com/docs/developer/task/create.md): 该接口用于创建外呼任务。使用前需确保已在系统中完成以下准备工作：
- [任务查询](https://avavox.com/docs/developer/task/query.md): https://dashboard.avavox.com/open/api/task/list
- [任务修改](https://avavox.com/docs/developer/task/update.md): 该接口用于修改已存在的任务，包括修改任务名称、使用的机器人、并发数、线路以及背景音。
- [任务暂停](https://avavox.com/docs/developer/task/pause.md): 对指定任务执行 “暂停” 操作。适用于任务处于 未开始（pending） 或 进行中（running） 状态时，将其状态置为 暂停（paused）。
- [任务恢复](https://avavox.com/docs/developer/task/resume.md): 对指定任务执行 “恢复/开启” 操作，将 已暂停（paused） 的任务恢复为可继续执行状态。用于在手动暂停后重新投入执行。
- [任务删除](https://avavox.com/docs/developer/task/delete.md): 根据任务 ID 删除指定的外呼任务。删除后该任务及其关联的拨打配置将被移除，任务列表中不再展示。
- [任务机器人变量查询](https://avavox.com/docs/developer/task/query-robot-variables.md): 用于查询指定任务所使用的机器人下，关联的全部变量列表
- [任务详情查询](https://avavox.com/docs/developer/task/query-details.md): https://dashboard.avavox.com/open/api/task/{taskId}
- [客户导入](https://avavox.com/docs/developer/data-import.md): 该接口用于导入客户到任务中并开始进行外呼。使用该接口前需要先在系统中创建任务，再根据查询任务列表获取到任务ID。
  - [导入结果回调](https://avavox.com/docs/developer/data-import-callback.md): 在调用号码导入接口之后，将导入的结果通过异步的方式回调到调用方
- [通话记录回调](https://avavox.com/docs/developer/call-record.md): 在接收通话记录回调之前，需要先在平台中配置回调地址。
- [批量写入黑名单](https://avavox.com/docs/developer/blacklist/create.md): 该接口用于将一批号码写入号码黑名单。命中黑名单的号码在外呼时将被拦截。
- [批量删除黑名单](https://avavox.com/docs/developer/blacklist/delete.md): 该接口用于根据号码批量删除黑名单记录。删除后该号码在外呼时不再被拦截。
- [查询号码是否在黑名单](https://avavox.com/docs/developer/blacklist/check.md): 该接口用于查询单个号码是否在黑名单中。命中时一并返回该号码的原因与备注。
- [查询黑名单列表](https://avavox.com/docs/developer/blacklist/query.md): 该接口用于分页查询全部黑名单号码。
- [账单](https://avavox.com/docs/developer/bill/index.md): 账单接口用于以编程方式查询 AVAVOX 的账单数据，覆盖 账户、空间、机器人、任务 四个维度，支持月粒度与日粒度，可用于对接企业财务系统、BI 报表或内部成本核算。
  - [账户账单](https://avavox.com/docs/developer/bill/account.md): 查询账户级的账单汇总，支持月粒度与日粒度，对应控制台「月度账单」页面及其日详情。
  - [空间账单](https://avavox.com/docs/developer/bill/space.md): 按空间维度查询账单，支持月粒度与日粒度，对应控制台账单页面的「账单列表」及其「查看详情」。
  - [机器人账单](https://avavox.com/docs/developer/bill/robot.md): 按机器人维度查询账单，支持月粒度与日粒度，对应控制台账单页面的「机器人账单」及其「查看详情」。
  - [任务账单](https://avavox.com/docs/developer/bill/task.md): 按任务维度查询账单，支持月粒度与日粒度，对应控制台账单页面的「任务账单」及其「查看详情」。
  - [查询 Key 信息](https://avavox.com/docs/developer/bill/key-info.md): 查询当前 App Key 的授权范围与绑定信息。建议将本接口作为对接的第一个调用，用于确认 Key 的权限边界，并排查「用错 Key」一类的问题。
  - [查询空间列表](https://avavox.com/docs/developer/bill/space-list.md): 查询当前 App Key 可访问的空间列表，用于获取空间账单、机器人账单、任务账单接口中 spaceIds 参数所需的空间 ID。
  - [查询计费项字典](https://avavox.com/docs/developer/bill/fee-items.md): 查询平台当前全部计费项的枚举，用于把账单接口返回的 feeItems[].itemCode 映射为可读名称，或在报表中预置计费项列。
- [洞察数据](https://avavox.com/docs/developer/insight/index.md): 洞察数据接口用于以编程方式查询 AVAVOX 的通话质检洞察结果，覆盖 列表筛选、洞察详情、通话录音、筛选字典 四个场景，可用于对接自有质检看板、抽检工单系统或数据仓库。
  - [洞察列表查询](https://avavox.com/docs/developer/insight/record-query.md): 按多种条件分页查询通话质检的洞察记录，并可同时返回该筛选条件下的合格 / 不合格统计，对应控制台「洞察明细」页面的筛选、表格与顶部统计。
  - [洞察详情](https://avavox.com/docs/developer/insight/record-detail.md): 查询单条洞察记录的评分、诊断条目与通话对话内容，对应控制台洞察详情页的评分环、诊断卡片列表与通话原声文本。
  - [通话录音地址](https://avavox.com/docs/developer/insight/record-audio.md): 获取某条洞察记录对应通话的录音播放地址，返回一个有效期 15 分钟的签名 URL，对应控制台洞察详情页的通话原声播放。
  - [查询筛选字典](https://avavox.com/docs/developer/insight/dicts.md): 一次性拉取规则组、失分项、机器人、数据标签四类字典数据，用于初始化洞察列表查询的筛选下拉框，以及把 itemCode、robotId、tagId 映射为可读名称。

## 全文合集

- [llms-full.txt](https://avavox.com/docs/llms-full.txt)
- [llms-developer.txt](https://avavox.com/docs/llms-developer.txt)
- [llms-product.txt](https://avavox.com/docs/llms-product.txt)