用途:通过 Telnyx JavaScript SDK 配置和管理电话号码,涵盖主叫显示、呼叫转移、消息启用、连接分配、紧急设置等号码级配置。
安装与初始化:npm install telnyx@6.74.2;使用 import Telnyx from 'telnyx' 创建客户端,API Key 从环境变量 TELNYX_API_KEY 读取。
主要能力:列出/检索/更新/删除电话号码;列出带消息设置或语音设置的号码;批量更新消息配置(messaging_numbers_bulk_updates)并查询状态;批量删除号码、批量更新号码、批量更新紧急设置(每批最多一千个号码);校验号码归属(verify_ownership);查询号码任务(jobs)。列表方法返回自动分页迭代器,可用 for await 遍历。
使用要点:号码须为 E.164 格式(如 +13125550001),含 + 与国家代码,不含空格、短横线或括号。生产代码需处理错误:401 无效密钥、403 权限不足、404 未找到、422 校验错误、429 限流(按 retry-after 指数退避重试)。
限制:批量操作每 API 调用最多一千个号码;批量更新号码时至少提交一个可更新字段;部分字段与返回结构以官方文档为准。具体收费、价格与平台支持范围资料暂未提供。