SuperAPI AI 工具集

telnyx-messaging-go

通用与其它

查看项目

更新于 10-16 08:11

技能介绍

用途:Telnyx Messaging 的 Go 语言集成技能,通过官方 telnyx-go SDK 调用消息接口,实现短信与彩信的发送、接收、退订及投递状态回调处理,可用于通知、两步验证(2FA)和消息类应用。

安装与初始化:执行 go get github.com/team-telnyx/telnyx-go 安装。使用 telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY"))) 初始化客户端,示例假设 client 已就绪。

主要能力:发送短信 client.Messages.Send()(POST /messages);使用字母数字发送方 ID(SendWithAlphanumericSender);群发彩信(SendGroupMms);长号、短码及号码池发送(SendLongCode、SendShortCode、SendNumberPool);预约发送(Schedule);发送 WhatsApp(SendWhatsapp)。另外提供查询消息、取消预约消息、字母数字发送方 ID 的增删查、群彩信查询、托管号码查询与更新、退订列表、消息配置指标及密钥重生成等操作。

webhook 与错误处理:webhook 使用 Ed25519 签名,请求含 telnyx-signature-ed25519 与 telnyx-timestamp 头,生产环境需用 client.Webhooks.Unwrap(body, r.Header) 校验签名。投递更新(message.sent、message.finalized)与入站消息(message.received)的字段已在资料中列出。API 调用可能返回 401、403、404、422、429 等错误,需在代码中处理,429 可用指数退避重试。

限制:电话号码须为 E.164 格式(如 +13125550001),不加空格、短横线或括号。发送号码必须已绑定到正确的消息配置。美国 A2P 长码流量需完成 10DLC 注册,否则可能被运营商拦截或过滤。投递 webhook 是异步的,发送响应仅代表请求被接受,并非最终投递成功。资料提示不要自行臆造参数、枚举、响应字段或 webhook 字段,额外字段应查阅 references/api-details.md 与 webhook 参考文档。分页可用 ListAutoPaging() 自动迭代。收费、价格等信息资料未提供。