用途:通过 Telnyx Ruby SDK 管理消息配置(Messaging Profiles),用于组织短信/彩信发送策略,支持号码池、粘性发送、地理匹配等特性,并可配置短码以应对高并发消息。
主要能力:列出、创建、检索、更新、删除消息配置;列出配置关联的电话号码与短码;列出、检索、更新短码(可将短码绑定或解绑到配置,设置标签)。创建配置时必填 name 与 whitelisted_destinations,可选字段包括 alpha_sender、daily_spend_limit、mms_fall_back_to_sms、mms_transcoding、mobile_only、number_pool_settings、smart_encoding、url_shortener_settings、webhook_url、webhook_failover_url、webhook_api_version 等。
使用方式:安装 gem install telnyx,初始化 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。调用如 client.messaging_profiles.list、create、retrieve、update、delete,以及 list_phone_numbers、list_short_codes;短码操作用 client.short_codes.list、retrieve、update。分页可用 page.auto_paging_each 迭代。
限制与错误处理:API 可能返回网络错误、429 限流、422 校验错误、401 认证错误,生产代码应捕获 Telnyx::Errors::APIConnectionError、RateLimitError、APIStatusError 等并重试。更新短码时 messaging_profile_id 为必填,解绑需设为 null 或空字符串。具体收费、价格与平台细节暂未提供。