SuperAPI AI 工具集

telnyx-10dlc-ruby

通用与其它

查看项目

更新于 10-16 03:40

技能介绍

用途:面向美国 A2P 10DLC 合规流程,使用 Telnyx Ruby SDK 完成品牌(Brand)注册、活动(Campaign)提交,以及将电话号码或消息配置文件分配到活动,使短信基础设施达到可发送状态。

主要能力:创建品牌(client.messaging_10dlc.brand.create,POST /10dlc/brand);提交活动(client.messaging_10dlc.campaign_builder.submit,POST /10dlc/campaignBuilder);按配置文件分配(client.messaging_10dlc.phone_number_assignment_by_profile.assign,POST /10dlc/phoneNumberAssignmentByProfile);创建电话号码活动(client.messaging_10dlc.phone_number_campaigns.create)。还支持查询品牌、活动、反馈、共享活动、外部审核、SMS OTP、活动申诉与操作状态等操作。

使用方式:安装 gem install telnyx,初始化 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。10DLC 流程是顺序的:先创建品牌,再提交活动,然后附加消息配置文件等基础设施。注册调用本身不足,必须完成分配步骤后消息才能使用该活动。应将注册状态字段纳入控制流,不要假定活动已可发送,直到返回的状态字段确认。分页可用 page.auto_paging_each。

Webhook:Telnyx 使用 Ed25519 签名,请求含 telnyx-signature-ed25519 与 telnyx-timestamp 头,生产环境应使用 client.webhooks.unwrap(payload, headers) 验证签名。

限制:不要臆造参数、枚举、响应字段或 Webhook 字段;未内联展示的字段需先阅读 references/api-details.md 或 Webhook 负载参考。常见错误码包括 401、403、404、422、429,需处理网络错误与限流重试。具体收费、价格与平台支持范围资料未提供。