用途:通过 Telnyx Ruby SDK 集成短信与多媒体消息能力,覆盖发送、接收、退订管理和投递状态回调,可用于通知、双因素认证(2FA)或消息类应用。
安装与初始化:gem install telnyx;require "telnyx";client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。
主要能力:发送 SMS(client.messages.send_,POST /messages);使用字母数字发送方 ID 发送(send_with_alphanumeric_sender);群发 MMS(send_group_mms);长码、短码、号码池发送(send_long_code、send_short_code、send_number_pool);定时发送(schedule);发送 WhatsApp 消息(send_whatsapp)。还提供消息检索、取消定时消息、字母数字发送方 ID 的增删查、托管号码管理、退订列表、消息配置文件指标与自动回复设置等操作。
Webhook:Telnyx 使用 Ed25519 签名,请求头包含 telnyx-signature-ed25519 与 telnyx-timestamp,生产环境应使用 client.webhooks.unwrap(payload, headers) 校验签名。投递更新事件类型为 message.sent、message.finalized,入站消息为 message.received。
限制与注意:电话号码须为 E.164 格式(含 + 与国家代码,无空格、短横线或括号);发送号码须先绑定到正确的消息配置文件;美国 A2P 长码流量在生产发送前须完成 10DLC 注册,否则可能被运营商拦截或严格过滤;投递 webhook 是异步的,发送响应仅代表请求被接受,不代表运营商最终投递;错误码包括 401、403、404、422、429,429 需指数退避重试。分页可用 auto_paging_each。不要臆造参数、枚举、响应字段或 webhook 字段,未内联的字段应查阅 references/api-details.md 与 webhook 载荷参考。