用途:该技能面向使用 JavaScript/Node.js 构建语音应用的开发者,通过 Telnyx 官方 npm 包调用 TeXML(兼容 TwiML)接口,管理应用、呼叫、会议、录音、队列与媒体流等资源。
安装与初始化:npm install telnyx;随后 import Telnyx from 'telnyx',用 new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] }) 创建客户端。
主要能力:呼叫方面支持获取账户下多个呼叫资源、发起外呼(POST /texml/Accounts/{account_sid}/Calls,必填 To、From、ApplicationSid,可选录音、机器检测、状态回调、SIP 区域等)、查询与更新单个呼叫、获取与创建呼叫录音、更新录音、创建与更新 Siprec 会话、启动与更新媒体流。会议方面支持列出与获取会议、更新会议、列出/新增/获取/更新/删除会议参与者、列出会议录音及获取录音 JSON。
使用方式:调用形如 client.texml.accounts.calls.retrieveCalls('account_sid')、client.texml.accounts.calls.calls('account_sid', {...}) 等方法;列表方法返回自动分页迭代器,可用 for await (const item of result) 遍历全部页面。更新呼叫时负载键名须使用 CamelCase。
错误处理:需处理网络错误、429 限流(按 retry-after 指数退避重试)、422 校验错误与 401 认证错误;常见状态码包括 401、403、404、422、429。
限制:部分端点最终一致性;资料未提供价格、配额与完整队列接口细节,暂未提供。