Telnyx WhatsApp Business API - Go 是一个面向 Go 开发者的技能，用于通过 Telnyx 的 WhatsApp Business API 发送消息并管理相关资源。
用途 该技能覆盖 WhatsApp 消息发送与账号、模板、号码管理，适合需要在 Go 应用中集成 WhatsApp 业务消息能力的场景。
安装与初始化 安装命令：
go get github.com/team-telnyx/telnyx-go
初始化客户端：
import ( "context" "fmt" "os"
"github.com/team-telnyx/telnyx-go"
"github.com/team-telnyx/telnyx-go/option"
)
client := telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY")))
主要能力
- 发送 WhatsApp 模板消息：通过 client.Messages.SendWhatsapp() 调用 POST /messages/whatsapp，可使用模板名称加语言，或直接使用 Telnyx 模板 UUID（template_id）。模板消息不受 24 小时窗口限制。
- 发送自由文本消息：同样通过 client.Messages.SendWhatsapp()，但只能在客户最后一次发消息后的 24 小时会话窗口内发送。
- 管理 WABA：列出 WhatsApp Business Account，使用 client.Whatsapp.BusinessAccounts.List() 调用 GET /v2/whatsapp/business_accounts。
- 管理模板：列出模板（client.Whatsapp.Templates.List()，GET /v2/whatsapp/message_templates）、创建模板（client.Whatsapp.Templates.Create()，POST /v2/whatsapp/message_templates）、获取模板详情（client.WhatsappMessageTemplates.Retrieve()）。
- 管理电话号码：列出 WABA 下的电话号码（client.Whatsapp.PhoneNumbers.List()，GET /v2/whatsapp/phone_numbers）。
- Webhook 验证：使用 github.com/team-telnyx/telnyx-go/webhook 的 webhook.ConstructEvent 验证 Ed25519 签名。
使用方式 所有 API 调用需处理网络错误、限流（429）、校验错误（422）和认证错误（401）。示例中展示了使用 errors.As 解析 *telnyx.Error 的方式。常见错误码包括 401、403、404、422、429，以及 WhatsApp 特有的 40008、131047、131026、132000、132015。
电话号码必须为 E.164 格式（例如 +13125550001），包含 + 前缀和国家代码。模板名称必须为小写并使用下划线（例如 order_confirmation），不能包含空格、连字符或大写字母。创建模板时需为正文参数提供真实示例值，Meta 审核时会检查。模板类别影响计费：AUTHENTICATION 用于 OTP/验证码，UTILITY 用于事务性消息，MARKETING 用于推广内容；Meta 可能重新分类模板类别。
适用场景 适用于在 Go 后端服务中集成 WhatsApp 业务消息，例如订单确认、发货通知、账户提醒、验证码发送等事务性或营销消息场景。
限制 发送号码必须注册到 WhatsApp Business Account（WABA）并关联消息配置文件。模板必须处于 APPROVED 状态才能用于发送。自由文本消息只能在 24 小时窗口内发送。列表接口返回分页结果，可使用 iter.Next() 自动分页迭代器。不要自行编造 Telnyx 参数、枚举、响应字段或 Webhook 字段；如需使用未内联展示的字段，应先阅读 references/api-details.md 或 Webhook 载荷参考。