用途:面向美国 A2P 短信合规的 10DLC 品牌(Brand)与活动(Campaign)注册,以及将电话号码或消息配置分配给活动的流程。
主要能力:创建品牌、提交活动、将消息配置分配到活动、将电话号码关联到活动;并提供查询品牌、活动、品牌反馈、按用例资格校验、成本查询等操作,以及活动状态更新等 Webhook 处理。
安装与初始化: 使用 go get github.com/team-telnyx/telnyx-go 安装。 通过 telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY"))) 初始化客户端。
核心流程:10DLC 具有顺序性,需先创建品牌,再提交活动,然后附加消息配置等发送基础设施。仅完成注册调用并不足够,必须等待分配步骤成功;在返回的状态字段确认之前,不应假定活动已可发送。控制流中应使用注册状态字段。
错误处理:API 调用可能返回网络错误、限流(429)、校验错误(422)或认证错误(401)。应始终处理错误,常见状态码包括 401、403、404、422、429;429 可配合指数退避重试。分页可使用 ListAutoPaging()。
Webhook:Telnyx 使用 Ed25519 签名,请求包含 telnyx-signature-ed25519 与 telnyx-timestamp 头,生产环境应始终验证签名,可使用 client.Webhooks.Unwrap 解析。
限制:资料未提供收费、价格或具体平台支持范围等详细信息;不要臆造参数、枚举、响应字段或 Webhook 字段,未内联给出的字段需查阅参考资料后再编写代码。