用途:该技能用于通过 Telnyx Python SDK 管理 SIP 中继相关集成,包括自定义存储凭据、Dialogflow 连接以及外部连接(External Connections),用于配置与 Telnyx 合作伙伴的外部语音集成。
安装与初始化: 安装命令:pip install telnyx 初始化示例: import os from telnyx import Telnyx client = Telnyx( api_key=os.environ.get("TELNYX_API_KEY"), )
主要能力:
- 自定义存储凭据(custom_storage_credentials):检索、创建、更新、删除存储凭据,支持 gcs、s3、azure 后端。
- Dialogflow 连接(dialogflow_connections):检索、创建、更新、删除与 CallControl 连接关联的 Dialogflow 凭据。
- 外部连接(external_connections):列出、创建、检索、更新、删除外部连接;管理日志消息、civic 地址与位置、电话号码、Release 请求与 Upload 请求。
错误处理:所有 API 调用可能返回网络错误、限流(429)、校验错误(422)或认证错误(401)。示例展示了捕获 APIConnectionError、RateLimitError、APIStatusError 并处理常见状态码的方式。
分页:列表方法返回自动分页迭代器,可直接用于遍历全部结果。
限制:删除外部连接时,若被电话号码占用、处于活动状态或为 Operator Connect 连接,可能无法删除,需联系 Telnyx 支持。创建 Upload 请求时 civic_address_id 与 location_id 只能提供一个,号码数量上限为 1000。部分功能细节与定价暂未提供。