用途:通过 Telnyx WhatsApp Business API 的 Ruby SDK 集成 WhatsApp 消息能力,支持发送模板消息与自由文本消息,并管理 WABA、模板和电话号码。
安装与初始化:gem install telnyx;require "telnyx";client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。
主要能力:发送模板消息与 24 小时窗口内的自由文本消息;列出 WhatsApp Business 账户(WABA);列出、创建模板并按状态/类别过滤;列出 WABA 下电话号码;获取模板详情与业务资料;配置 Webhook。
常用调用:client.messages.send_whatsapp()(POST /messages/whatsapp,需 from、to、whatsapp_message);client.whatsapp.business_accounts.list();client.whatsapp.templates.list(waba_id:);client.whatsapp.templates.create(...);client.whatsapp.phone_numbers.list(waba_id:)。列表接口支持 response.auto_paging_each 分页。
错误与限制:需处理 401、403、404、422、429;WhatsApp 专用错误包括 40008、131047、131026、132000、132015。电话号码须为 E.164 格式(含 + 与国家代码);模板消息可随时发送,自由文本仅限客户最后来信后 24 小时内;发送号码须注册到 WABA 并关联消息配置;模板须为 APPROVED 状态,名称须小写加下划线;创建模板需提供真实示例值,类别(AUTHENTICATION、UTILITY、MARKETING)影响计费且 Meta 可能重新分类。Webhook 使用 Ed25519 签名,需用 Telnyx::Webhook.construct_event 验签。未提供的参数、枚举或响应字段应先查阅技能内引用文档,不应自行编造。