用途:该技能基于 Telnyx 官方 Go SDK,用于在 Go 应用中创建和管理短信配置文件(messaging profiles),并管理与之关联的号码与短码,适合需要批量、高并发短信发送的场景。
主要能力:配置文件支持号码池设置(number_pool_settings)、粘性发送与地理位置匹配等字段;可配置 Webhook(webhook_url、webhook_failover_url、health_webhook_url、webhook_api_version)、每日消费限额(daily_spend_limit/daily_spend_limit_enabled)、MMS 回退到 SMS、MMS 转码、智能编码、移动网络限定及白名单目的地(whitelisted_destinations)等。短码接口可用于高量级短信发送。
使用方式:先安装 SDK:go get github.com/team-telnyx/telnyx-go。初始化客户端时通过 option.WithAPIKey 传入环境变量 TELNYX_API_KEY。创建配置文件需提供 name 和 whitelisted_destinations 两个必填字段。列表接口支持 ListAutoPaging() 自动分页。
主要 API:GET/POST /messaging_profiles、GET/PATCH/DELETE /messaging_profiles/{id}、GET /messaging_profiles/{id}/phone_numbers、GET /messaging_profiles/{id}/short_codes、GET /short_codes、GET /short_codes/{id}、PATCH /short_codes/{id}(必填 messaging_profile_id,置为 null 或空字符串可解绑)。
限制与注意:所有调用可能返回网络错误、401 认证失败、403 权限不足、404 不存在、422 校验错误、429 限流;生产代码应处理错误并对 429 使用指数退避重试。部分字段如 redaction_enabled、redaction_level、v1_secret 仅在返回结果中出现,本资料未提供其详细说明。价格、配额及具体开通条件暂未提供。