Telnyx 10DLC - Ruby 是一个面向 Ruby 开发者的技能文档,用于通过 Telnyx SDK 完成美国 A2P 10DLC 的品牌与活动注册,以及将电话号码分配到活动。
用途 本技能聚焦于美国 A2P 短信的 10DLC 合规注册流程,包括创建品牌、提交活动、分配消息配置文件,以及处理注册状态与 Webhook 事件。
主要能力 核心任务包括:创建品牌(client.messaging_10dlc.brand.create)、提交活动(client.messaging_10dlc.campaign_builder.submit)、将消息配置文件分配到活动(client.messaging_10dlc.phone_number_assignment_by_profile.assign)。支持操作包括获取品牌、按用例资格查询、创建电话号码活动、获取活动、列出品牌、获取品牌反馈等。还提供 Webhook 签名验证(Ed25519)与错误处理指导。
使用方式 需先安装 gem:gem install telnyx。初始化客户端:require "telnyx"; client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。所有 API 调用都可能因网络错误、速率限制(429)、验证错误(422)或认证错误(401)失败,生产代码应始终处理错误。分页可使用 .auto_paging_each 自动迭代。注册流程是顺序的:先创建品牌,再提交活动,然后附加消息配置文件等消息基础设施。仅完成注册调用还不够,必须成功完成分配步骤后才能使用活动发送消息。应将注册状态字段作为控制流的一部分,不要假定活动在返回状态字段确认前已可发送。
适用场景 适用于在 Ruby 应用中集成 Telnyx 10DLC 品牌与活动注册、管理电话号码分配、以及验证 Telnyx Webhook 的开发者。
限制 不得虚构 Telnyx 参数、枚举、响应字段或 Webhook 字段。如果需要的参数、枚举或响应字段未在技能中内联显示,应先阅读 references/api-details.md 再编写代码。使用附加操作前应阅读可选参数部分和响应模式部分。阅读或匹配内联示例之外的 Webhook 字段前,应阅读 Webhook 负载参考。Webhook 使用 Ed25519 签名,请求包含 telnyx-signature-ed25519 和 telnyx-timestamp 头,生产环境应验证签名。关于费用、价格、平台支持等具体信息暂未提供。