用途:该技能面向 Go 开发者,用于在应用中集成 Telnyx 的消息基础设施,涵盖托管短信号码(hosted SMS numbers)、免付费号码验证(toll-free verification)以及 RCS 富媒体消息三类能力,适合号码迁移、启用富媒体消息等场景。
安装与初始化:使用 go get github.com/team-telnyx/telnyx-go 安装;通过 telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY"))) 初始化客户端,所有示例均假定 client 已初始化。
主要能力:发送 RCS 消息(POST /messages/rcs,必填 agent_id、to、messaging_profile_id、agent_message);生成 RCS deeplink;列出与检索、修改 RCS 代理;批量或单个查询 RCS 能力;添加 RCS 测试号码。托管号码方面,支持列出、创建、检索、删除托管号码订单,检查托管资格,上传托管号码文档,创建与验证托管号码校验码,以及删除托管号码。免付费验证方面,支持列出、提交、按 ID 获取验证请求。
错误处理与限制:API 调用可能因网络、限流(429)、校验(422)或认证(401)失败,生产代码需处理错误。常见错误码还包括 403 权限不足、404 资源不存在。电话号码必须为 E.164 格式(如 +13125550001),含 + 与国家代码,不可含空格、短横线或括号。分页可使用 ListAutoPaging() 自动迭代(iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() })。
资料未提供费用、价格与配额等计费细节,暂未提供。