SuperAPI AI 工具集

telnyx-numbers-services-go

办公与效率

查看项目

更新于 10-16 07:24

技能介绍

用途:该技能围绕 Telnyx 号码服务,给出 Go SDK 示例,用于为电话号码配置语音通道、动态紧急地址与端点(E911)以及语音留言设置。

安装与初始化:执行 go get github.com/team-telnyx/telnyx-go 安装;使用 telnyx.NewClient 并配合 option.WithAPIKey(os.Getenv("TELNYX_API_KEY")) 初始化客户端。后续示例均假定 client 已按此方式创建。

主要能力:

  • 语音通道:GET /channel_zones 列出非美国区域的语音通道,PUT /channel_zones/{channel_zone_id} 更新其通道数;GET /inbound_channels 列出美国区域语音通道,PATCH /inbound_channels 更新通道数;GET /list 与 GET /list/{channel_zone_id} 按区域列出使用通道计费的号码。
  • 动态紧急地址:GET/POST /dynamic_emergency_addresses 列表与创建,GET/DELETE /dynamic_emergency_addresses/{id} 获取与删除。
  • 动态紧急端点:GET/POST /dynamic_emergency_endpoints 列表与创建,GET/DELETE /dynamic_emergency_endpoints/{id} 获取与删除。
  • 语音留言:GET、POST、PATCH /phone_numbers/{phone_number_id}/voicemail 获取、创建与更新,涉及 enabled(布尔)与 pin(字符串)。

使用方式:调用上述客户端方法(如 client.ChannelZones.List、client.DynamicEmergencyAddresses.New、client.PhoneNumbers.Voicemail.Get),传入对应参数结构体并处理返回值与错误。

错误处理:所有调用可能因网络错误、限流(429)、校验错误(422)或认证错误(401)失败,建议用 errors.As 判断 *telnyx.Error 并按 StatusCode 分支处理,429 时采用指数退避重试。

分页:使用 ListAutoPaging() 自动迭代,配合 iter.Next() 与 iter.Current()。

限制:资料未说明具体计费、配额或平台支持范围;实际字段格式与枚举以接口返回为准,使用前需自行准备有效的 TELNYX_API_KEY。