用途:telnyx-messaging-go 是 Telnyx 消息能力的 Go 客户端,用于在 Go 程序中发送与接收 SMS/MMS,支撑通知、2FA 或消息应用等场景。
安装:go get github.com/team-telnyx/telnyx-go
初始化:使用 telnyx.NewClient 并传入 API Key,例如 option.WithAPIKey(os.Getenv("TELNYX_API_KEY"))。
主要能力:发送短信(client.Messages.Send,POST /messages);使用字母数字发送方 ID 发送;发送群组 MMS(POST /messages/group_mms);长码、号码池、短码发送路径;定时发送(POST /messages/schedule);发送 WhatsApp 消息;接收消息与投递状态回调。还可检索消息、取消定时消息、管理字母数字发送方 ID、托管号码、退订列表和消息配置文件指标等。
用法要点:号码必须是 E.164 格式(如 +13125550001),需含 + 和国家代码,无空格、短横线或括号。列表可用 ListAutoPaging() 自动分页。错误处理需覆盖网络错误、429 限流、422 校验和 401 认证等,建议对 429 使用指数退避重试。回调使用 Ed25519 签名,请求带 telnyx-signature-ed25519 和 telnyx-timestamp 头,生产环境应通过 client.Webhooks.Unwrap 验证签名。
限制:发送号码须已绑定正确的消息配置文件;美国 A2P 长码在正式发送前必须完成 10DLC 注册,否则可能被运营商拦截或严格过滤;投递回调是异步的,发送响应仅代表请求被接受,不代表运营商最终投递。不要自行编造参数、枚举、响应字段或回调字段,未内联给出的字段需查阅随附参考文档。具体收费、价格与配额信息暂未提供。