用途:面向使用 Telnyx Python SDK 的开发者,演示如何通过代码管理 SIP 中继相关的集成资源,包括呼叫录音与媒体存储、Dialogflow 集成和外部连接。
安装与初始化:安装命令 pip install telnyx;随后用 from telnyx import Telnyx 创建 client,api_key 从环境变量 TELNYX_API_KEY 读取。
主要能力:
- 自定义存储凭据(custom_storage_credentials):按 connection_id 检索、创建、更新、删除,支持 gcs、s3、azure 等后端。
- Dialogflow 连接(dialogflow_connections):检索、创建、更新、删除与 CallControl 连接关联的 Dialogflow 配置,需传入 service_account。
- 外部连接(external_connections):列出、创建、检索、更新、删除,创建必填 external_sip_connection(zoom、operator_connect)与 outbound,可选 webhook、tags、inbound 等。
- 日志消息(log_messages):列出、检索、忽略外部连接日志。
- 民事地址与位置:列出 Microsoft Teams 的地址与位置、检索单个地址、更新位置的静态紧急地址。
- 电话号码:列出、检索、更新外部连接下的号码。
- 发布(releases)与上传(uploads):列出和检索发布请求;创建上传请求需 number_ids,可选 civic_address_id 或 location_id(两者只能提供一个),number_ids 最多 1000 个。
使用方式:所有示例假定 client 已初始化;列表方法返回自动分页迭代器,可用 for item in page_result 遍历。
限制与注意:需处理网络错误、限流 429、校验 422、认证 401 等;常见错误码含 401、403、404、422、429。删除外部连接在号码占用、处于活动状态或为 Operator Connect 时可能被阻止,Operator Connect 需联系 Telnyx 支持。具体收费、价格与效果资料未提供。