该技能基于 Telnyx 官方 JavaScript SDK,用于在应用中集成托管短信号码、免费电话(toll-free)验证与 RCS 富消息能力,适合号码迁移或启用富消息功能的场景。
安装:npm install telnyx@6.74.2
初始化:import Telnyx from 'telnyx'; 使用 new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] }) 创建客户端,后续示例均基于已初始化的 client。
主要能力:
- RCS:发送 RCS 消息(POST /messages/rcs)、生成 RCS deeplink、列出/获取/修改 RCS 代理、批量或单个检查 RCS 能力、添加测试号码。
- 托管号码:列出/创建/获取/删除托管号码订单、检查托管资格、上传文档、创建与校验验证码。
- 免费电话验证:列出、提交、获取、更新验证请求,覆盖企业信息、用例、选择加入流程等字段。
用法与限制:号码须为 E.164 格式(含 + 与国家代码,无空格、短横线、括号)。列表方法返回自动分页迭代器,可用 for await (const item of result) 遍历。API 调用可能因网络、限流(429)、校验(422)或鉴权(401)失败,生产代码需捕获 Telnyx.APIConnectionError、RateLimitError、APIError,其中 429 建议按 retry-after 指数退避重试。
费用、价格、具体平台与效果资料暂未提供。