SuperAPI AI 工具集

telnyx-voice-javascript

通用与其它

查看项目

更新于 10-16 08:11

技能介绍

用途:通过 Telnyx Node.js SDK(telnyx@6.74.2)以编程方式控制语音呼叫,包括外呼、接听、转接、桥接、拒接、挂断、SIP Refer、发送 SIP INFO,并处理实时呼叫事件。

主要能力:client.calls.dial() 发起外呼;client.calls.actions.answer() 接听呼入;transfer() 转接、bridge() 桥接、reject() 拒接、hangup() 挂断;retrieveStatus() 查询呼叫状态;connections.listActiveCalls() 列出某连接下活跃呼叫;callControlApplications 的增删改查管理 Call Control 应用;webhook 事件覆盖 call.initiated、call.answered、call.hangup、call.bridged 等。

用法:先 import Telnyx from 'telnyx' 并用 API key 初始化 client。电话号码须为 E.164 格式(如 +13125550001),带 + 和国家码,不含空格、短横线或括号。调用为事件驱动:外呼由 dial() 开始,呼入须先在 webhook 中应答才能执行后续命令;后续控制命令需使用 webhook 负载中的 call_control_id。列表方法返回自动分页迭代器,可用 for await 遍历全部页。webhook 使用 Ed25519 签名,请求含 telnyx-signature-ed25519 与 telnyx-timestamp 头,生产环境应用 client.webhooks.unwrap() 验证(如 Express 需使用原始 body)。

限制与注意:需要公网可达的 webhook 端点,否则电话可接通但应用无法驱动通话状态。API 调用可能遇到网络错误、401 认证失败、403 权限不足、404 资源不存在、422 校验错误、429 限流(应指数退避重试),生产代码需处理异常。参数、枚举、响应字段与 webhook 字段均不可臆造,未列出的需查阅 references/api-details.md。其他可选参数、响应结构和低频 webhook 负载暂未在资料中完整提供。