telnyx-sip-integrations-go

用途

Telnyx SIP Integrations - Go 是面向 Go 开发者的技能，用于通过 Telnyx 官方 Go SDK 管理 SIP 中继相关的集成配置。它覆盖自定义存储凭据、Dialogflow 连接、外部连接（External Connections）、日志消息、市政地址与位置以及电话号码等资源的操作，适用于需要在 Go 项目中集成 Telnyx 语音与 SIP 能力的场景。

主要能力

自定义存储凭据（Custom Storage Credentials）：支持获取、创建、更新、删除存储凭据，后端类型包括 gcs、s3、azure。
Dialogflow 连接（Dialogflow Connections）：支持获取、创建、更新、删除与 CallControl 连接关联的 Dialogflow 连接，可保存服务账号凭据供其他 Telnyx 服务使用。
外部连接（External Connections）：支持列出、创建、获取、更新、删除外部连接，用于配置与 Telnyx 合作伙伴（如 Zoom、Operator Connect）的 SIP 中继集成。
日志消息（Log Messages）：支持列出所有外部连接的日志消息、获取单条日志消息、忽略（Dismiss）日志消息。
市政地址与位置（Civic Addresses & Locations）：支持列出 Microsoft Teams 的市政地址与位置、获取单个市政地址、更新位置的静态紧急地址。
电话号码（Phone Numbers）：支持列出与外部连接关联的所有活跃电话号码、获取单个电话号码详情。

使用方式

安装：

go get github.com/team-telnyx/telnyx-go

初始化客户端：

import (
  "context"
  "fmt"
  "os"

  "github.com/team-telnyx/telnyx-go"
  "github.com/team-telnyx/telnyx-go/option"
)

client := telnyx.NewClient(
  option.WithAPIKey(os.Getenv("TELNYX_API_KEY")),
)

错误处理：所有 API 调用可能因网络错误、速率限制（429）、验证错误（422）或认证错误（401）而失败。生产代码中应始终处理错误，常见错误码包括 401（无效 API 密钥）、403（权限不足）、404（资源未找到）、422（验证错误）、429（速率限制，建议使用指数退避重试）。

分页：使用 ListAutoPaging() 进行自动迭代：

iter := client.Resource.ListAutoPaging(ctx, params)
for iter.Next() {
  item := iter.Current()
}

各资源的具体调用示例（如 client.CustomStorageCredentials.Get、client.DialogflowConnections.New、client.ExternalConnections.List 等）在技能文档中均有完整代码，涵盖请求参数与返回字段。

适用场景

在 Go 应用中配置和管理 Telnyx SIP 中继集成。
将通话录音、媒体存储与外部存储后端（GCS、S3、Azure）对接。
集成 Dialogflow 实现语音交互。
管理 Zoom、Operator Connect 等外部语音集成。
查询和更新与外部连接关联的电话号码及紧急地址信息。

限制

删除外部连接时，若该连接正被电话号码使用、处于活跃状态或属于 Operator Connect 连接，删除可能被阻止；移除 Operator Connect 集成需联系 Telnyx 支持。
文档未提供收费、价格、平台兼容性等额外信息。

技能介绍

用途

主要能力

使用方式

适用场景

限制