用途:通过 Telnyx WhatsApp Business API 的 Go SDK 集成 WhatsApp 消息功能,包括发送模板消息与自由文本消息、管理模板、WhatsApp Business Account(WABA)和电话号码,并处理 webhook 回调。
主要能力与用法:先安装依赖 go get github.com/team-telnyx/telnyx-go,再用 telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY"))) 初始化客户端。发送消息调用 client.Messages.SendWhatsapp()(POST /messages/whatsapp),必填 From、To(均为 E.164 格式,含 + 与国家码)及 WhatsappMessage;模板消息可用名称+语言或直接传 Telnyx template_id。模板管理调用 client.Whatsapp.Templates.List()、Create();WABA 用 client.Whatsapp.BusinessAccounts.List(),电话号码用 client.Whatsapp.PhoneNumbers.List()。列表接口支持 iter.Next() 自动分页。Webhook 使用 Ed25519 签名验证:webhook.ConstructEvent(payload, header, timestamp, telnyxPublicKey),可接收 message.sent、message.finalized 及模板状态变更事件。
适用场景:订单通知、发货提醒、账户提醒、OTP 验证及营销消息等。
限制与注意:模板需处于 APPROVED 状态才能发送;自由文本消息仅能在客户最后一次消息后的 24 小时窗口内发送;模板名须为小写加下划线。常见错误码包括 401、403、404、422、429,以及 WhatsApp 专用的 40008、131047、131026、132000、132015。发送号码须注册 WABA 并关联消息配置文件。资料未提供收费与价格信息。