Telnyx 语音电话
这包给代理商一个电话工具和语音提供商 telnyx SDK和Telnyx呼叫控制系统 它把外出电话,把文本写成电话,挂断电话,使网络hook事件正常化.
安装
npm install @framers/agentos-ext-voice-telnyx
同伴依赖 : @framers/agentos,在此包所声明的最小版本上.
使用量
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需要声明的核心对等层.
释放
新版本发表于 架设层/剂-外延 由 GitHub Actions 通过 npm 信任的出版, 并附有出处声明 .
许可证
阿帕奇 - 2.0