---
title: avavox 智能外呼 Skill
---

# avavox 智能外呼 Skill

`avavox-call` 是基于 avavox 官方开放 API 的智能外呼技能包。将它安装到 WorkBuddy，或其他具备文件读取、Python 3 执行和 HTTPS 访问能力的智能体宿主后，可以通过自然语言完成外呼业务操作。

## 能做什么

| 使用场景 | 支持的操作 |
| --- | --- |
| 资源查询 | 查询已发布机器人、可用线路和机器人变量 |
| 任务管理 | 创建、筛选、查看、修改、暂停、恢复和删除任务 |
| 客户导入 | 向指定任务导入客户，触发后续外呼流程 |
| 禁呼名单 | 查询、检查、添加和删除禁呼号码 |
| 账单查询 | 查询账户、空间、机器人和任务账单及计费项 |
| 质检洞察 | 查询通话质检结果、详情、录音地址和筛选字典 |

## 获取技能

- [前往 SkillHub 安装 avavox 智能外呼](https://skillhub.cn/skills/user_8d0762a9/avavox-call)
- [下载本站技能包（v0.7.0）](https://avavox.com/docs/openskills/avavox-call_0.7.0.zip)

本站下载包与 SkillHub 市场版本同步更新，当前版本为 `0.7.0`。

### 让智能体帮你安装

将下面这段话发送给你的智能体。它会先检查当前宿主是否支持下载、文件操作和 Python 3，再按照宿主自身的技能安装规范处理：

```text
请帮我安装 avavox 智能外呼 Skill。

技能包下载地址：https://avavox.com/docs/openskills/avavox-call_0.7.0.zip

请完成以下操作：
1. 下载并解压技能包，确保 SKILL.md、scripts/、references/ 和 config.json 保持原有目录结构。
2. 按当前智能体宿主的技能安装规范加载根目录中的 SKILL.md，不要猜测或写死安装目录。
3. 阅读 SKILL.md 和其中要求的运行说明，确认 Python 3 与 HTTPS 访问能力可用。
4. 运行 scripts/avavox_call.py --version 验证安装，但暂时不要配置凭据或调用真实业务接口。
5. 完成后告诉我安装位置、版本检查结果和当前可用能力。如果宿主不支持其中某一步，请说明受限原因和需要我手动完成的操作。

不要索取、写入或回显我的 App Key；凭据由我在安装完成后单独配置。
```

::: tip
智能体能否自动安装取决于宿主权限。无法下载、解压或写入技能目录时，它应给出需要手动完成的步骤。
:::

## 配置 App Key

所有 API 请求都需要 avavox App Key。请先参照 [App Key 创建与管理](https://avavox.com/docs/developer/app-key.html) 创建凭据，并按照实际用途选择授权范围。

安装完成后，通过宿主的密钥管理功能或 `AVAVOX_APP_KEY` 环境变量配置 App Key。宿主不支持时，让智能体按照技能包说明完成包外配置。不要把完整密钥写入技能正文、对话或日志。

## 使用示例

配置完成后，可以直接向智能体描述目标，例如：

- “查询当前可用的机器人和线路。”
- “查看任务 12345 的详情和机器人变量。”
- “查询本月的账户账单，并列出计费项。”
- “查找昨天的质检洞察，并获取指定记录的录音地址。”
- “检查这些号码是否在禁呼名单中。”

创建任务本身不会拨打；导入客户或恢复已有任务可能触发真实外呼。请在指令中明确机器人、线路、任务和客户范围；智能体会依据已授权的范围执行。

## 结果说明

- 创建任务本身不会产生客户，只有导入客户后才会进入后续外呼流程。
- 客户导入接口返回 `requestId` 仅表示请求已受理，不代表全部导入成功或电话已经拨通。
- 最终导入结果和通话结果分别通过异步回调确认，技能包不包含回调接收服务。回调配置和数据结构见 [导入结果回调](https://avavox.com/docs/developer/data-import-callback.html) 与 [通话记录回调](https://avavox.com/docs/developer/call-record.html)。
- 任务删除不可恢复；脚本要求明确提供任务 ID，且不会在删除失败时自动暂停任务。

完整的接口、字段和业务流程请参阅 [API 总览](https://avavox.com/docs/developer/)。