SuperAPI AI 工具集

telnyx-messaging-hosted-go

通用与其它

查看项目

更新于 10-16 04:53

技能介绍

用途:该技能面向使用 Go 语言接入 Telnyx 消息能力的开发者,覆盖托管短信号码(hosted SMS numbers)、免付费号码验证(toll-free verification)与 RCS 富消息三类场景,适用于号码迁移或启用富消息功能。

安装与初始化:执行 go get github.com/team-telnyx/telnyx-go 安装 SDK;通过 telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY"))) 创建客户端,后续示例均假定 client 已初始化。

主要能力:

  1. RCS:发送 RCS 消息(POST /messages/rcs,必填 agent_id、to、messaging_profile_id、agent_message,可选 mms_fallback、sms_fallback、type、webhook_url);生成 RCS 深链(GET /messages/rcs/deeplinks/{agent_id});列出、获取、修改 RCS 代理;批量与单个检查 RCS 能力;添加 RCS 测试号码。
  2. 托管号码:列出、创建、获取、删除托管号码订单;检查托管资格;上传托管号码文档;创建与校验验证码;删除托管号码。
  3. 免付费验证:列出验证请求、提交验证请求(必填 businessName、corporateWebsite、businessAddr1、businessCity、businessState、businessZip、联系人信息、messageVolume、phoneNumbers、useCase、useCaseSummary、productionMessageContent、optInWorkflow、optInWorkflowImageURLs、additionalInformation 等)、按 ID 获取验证请求。

使用要点:电话号码须为 E.164 格式(如 +13125550001),含 + 与国家代码,不含空格、连字符或括号;分页可用 ListAutoPaging() 自动迭代。

错误处理:API 调用可能返回网络错误、限流(429)、校验错误(422)或认证错误(401),生产代码应统一处理;常见状态码包括 401 无效 API 密钥、403 权限不足、404 资源不存在、422 字段格式错误、429 需指数退避重试。

限制:资料未提供收费、价格、平台支持范围或具体效果数据,暂未提供。