# @framers/agentos-ext-voice-telnyx 中文文档

规范地址：https://npmcn.com/package/%40framers/agentos-ext-voice-telnyx/

版本：0\.2\.3
npm 元数据更新时间：2026-11-11T08:02:04.103Z
中文译文更新时间：2026-11-15T12:20:24.851Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40framers/agentos-ext-voice-telnyx
原文对照：https://npmcn.com/package/%40framers/agentos-ext-voice-telnyx/?lang=original
项目主页：https://github.com/framerslab/agentos-extensions/tree/master/registry/curated/voice/telnyx#readme
源码仓库：https://github.com/framerslab/agentos-extensions

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：86.2 kB，24 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- peer 依赖：@framers/agentos \>=0\.13\.104
- 首次发布：2026-02-08T04:23:01.109Z
- 最新版本发布：2026-11-11T08:02:03.718Z
- 近 30 天下载量：20333（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

AgentOS的 Telnyx 语音呼叫服务商——通过 Telnyx 呼叫控制 v2 的出站/入站呼叫

## 安装

```sh
npm install @framers/agentos-ext-voice-telnyx
```

也可以使用：`pnpm add @framers/agentos-ext-voice-telnyx`、`yarn add @framers/agentos-ext-voice-telnyx`、`bun add @framers/agentos-ext-voice-telnyx`

## README

# Telnyx 语音电话

这包给代理商一个电话工具和语音提供商 `telnyx` SDK和Telnyx呼叫控制系统 它把外出电话,把文本写成电话,挂断电话,使网络hook事件正常化.

## 安装

```bash
npm install @framers/agentos-ext-voice-telnyx
```

同伴依赖 : `@framers/agentos`,在此包所声明的最小版本上.

## 使用量

```ts
import { AgentOS } from '@framers/agentos';

const agentos = await AgentOS.create({
  extensionManifest: {
    packs: [
      {
        package: '@framers/agentos-ext-voice-telnyx',
        options: {
          apiKey: process.env.TELNYX_API_KEY,
          connectionId: process.env.TELNYX_CONNECTION_ID,
          publicKey: process.env.TELNYX_PUBLIC_KEY,
          fromNumber: process.env.TELNYX_FROM_NUMBER,
        },
      },
    ],
  },
});
```

## 配置

直接选项的全权证书决定,然后 `options.secrets`,然后按顺序排列列出的环境变量.

| 选项 | 秘密编号 | 环境变量 | 需求 | 默认 |
| --- | --- | --- | --- | --- |
| `apiKey` | `telnyx.apiKey` | `TELNYX_API_KEY`, (中文(简体) ), `TELNYX_API_V2_KEY` | 对 | 无,缺席时投出 |
| `connectionId` | `telnyx.connectionId` | `TELNYX_CONNECTION_ID`, (中文(简体) ), `TELNYX_APP_ID` | 对 | 无,缺席时投出 |
| `publicKey` | `telnyx.publicKey` | `TELNYX_PUBLIC_KEY` | 没有 | `undefined` |
| `fromNumber` | 无 | `TELNYX_FROM_NUMBER` | 没有 | `undefined` 在服务中, 管理器配置中的空字符串 |
| `webhookBaseUrl` | 无 | 无 | 没有 | `undefined` |
| `priority` | 无 | 无 | 没有 | `50` |
| `secrets` | 上面包含秘密编号的地图 | 无 | 没有 | `undefined` |
| `callManager` | 无 | 无 | 没有 | 已曝光的包拥有管理器 |

## 工具

| 工具 | 它会做什么 |
| --- | --- |
| `telnyxVoiceCall` | 通过Telnyx进行和管理电话通话,包括外出通话,呼叫TTS,挂起和状态查询. |

### `telnyxVoiceCall` 参数

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `action` | `string`, enum: (中文(简体) ) `call`, (中文(简体) ), `speak`, (中文(简体) ), `hangup`, (中文(简体) ), `status`, (中文(简体) ), `list` | 对 | 语音呼叫动作 |
| `toNumber` | `string` | 没有 | E.164 电话(需要)`call`" 行动 " |
| `message` | `string` | 没有 | 要发言的信息(用于)`call`" 以通知方式,或 "`speak`" 行动 " |
| `mode` | `string`, enum: (中文(简体) ) `notify`, (中文(简体) ), `conversation` | 没有 | 调用交互模式( 默认 ): "`conversation`" ) |
| `callId` | `string` | 没有 | 拨打身份证(需要)`speak`" , "`hangup`" ,和 "`status`" 行动 " ) |

## 页:1

软件包需要节点.js `>=22`活化能动态地加载SDK并初始化服务. 解禁只处理原包自有管理器并发布SDK客户端参考.

该工具具有副作用: `call` 打个电话, `speak` 发送 TTS 命令 `hangup` 结束一个电话。 需要运行时间检查 `toNumber` 页:1 `call`, (中文(简体) ), `callId` 财务报告和审定财务报表 `message` 页:1 `speak`,以及 `callId` 页:1 `hangup` 或者说 `status`。计划只需要 `action`。 。 。 .

提供者使用配置的连接ID,呼叫器号码和webhook URL. `notify` 启动答录机检测. `conversation` 随入轨轨道通过媒体流 URL。 呼叫状态被编码为外出请求. 服务默认 TTS 为女性语音和 `en-US` 带有文本有效载荷.

提供商调用启动,回答,挂起,机器检测和流接事件. 它试图在 `publicKey` 设置并拒绝其新鲜度窗口外缺少的签名头、失败的验证或时间戳。 无 `publicKey`,它接受不需签名验证的webhooks.

包登记 `voice-provider` 名称 `telnyx` 代表呼吁管理层 `CallManager`。其文件不会启动 HTTP 网页浏览器或执行媒体套接字服务器.

## 主机呼叫管理器绑定

返回的包暴露了管理器的调用工具通过 `binding.manager`供应 `options.callManager` 用于使用主机拥有的管理器;否则,被曝光的默认属于包. `binding.setManager(next)` 在替换和修改后续工具操作时登记同一提供者。 主机在重新绑定前排出或传输活动调用; 没有调用状态通过绑定迁移 .

语音提供者描述器保存原始的 Telnyx 提供者并添加只读 `binding` 属性。 因此,登记消费者和返回的包送达同一个管理者和工具处理者。 拆卸只处理原包自有的经理,包括被替换时. 东道主的管理人员从未被这一扩展处理。 施工现场没有航母呼叫.

这种修复不会改变遗留的载体协议,签名政策或回调行为. 明确使用核心载体简介作为持久保证。 这个约束性API需要声明的核心对等层.

## 释放

新版本发表于 [架设层/剂-外延](https://github.com/framerslab/agentos-extensions) 由 GitHub Actions 通过 npm 信任的出版, 并附有出处声明 .

## 许可证

阿帕奇 - 2.0

## 常见问题

### @framers/agentos-ext-voice-telnyx 是什么？

AgentOS的 Telnyx 语音呼叫服务商——通过 Telnyx 呼叫控制 v2 的出站/入站呼叫

### 如何安装 @framers/agentos-ext-voice-telnyx？

在项目目录运行 npm install @framers/agentos-ext-voice-telnyx，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@framers/agentos（\>=0\.13\.104）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @framers/agentos-ext-voice-telnyx 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @framers/agentos-ext-voice-telnyx 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @framers/agentos-ext-voice-telnyx 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @framers/agentos-ext-voice-telnyx 可以商用吗？

@framers/agentos-ext-voice-telnyx 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @framers/agentos-ext-voice-telnyx 的下载量有多少？

根据 npm 官方下载统计，@framers/agentos-ext-voice-telnyx 在 2026/10/16 – 2026/11/14 这 30 天内被下载 20,333 次，日均约 678 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @framers/agentos-ext-voice-telnyx 还在维护吗？

最新版本 0\.2\.3 发布于 2026/11/11（4 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/02/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。