用途:该技能面向使用 Telnyx 平台进行 SIP 中继集成的 Ruby 开发者,提供通过官方 Ruby SDK 管理自定义存储凭证、Dialogflow 连接与外部连接的示例代码。
主要能力:
- 自定义存储凭证:检索、创建、更新、删除(backend 支持 gcs、s3、azure)。
- Dialogflow 连接:检索、创建、更新、删除,用于保存 Dialogflow 凭证供其他 Telnyx 服务使用。
- 外部连接:列出、创建、检索、更新、删除,支持 zoom、operator_connect 等外部 SIP 连接类型,可配置入站/出站、标签、Webhook 事件 URL 与超时。
- 日志消息:列出、检索、忽略外部连接日志。
- 电话与地址:管理外部连接下的电话号码、civic addresses、locations 及静态紧急地址。
- 上传与发布:面向 Microsoft Teams 的 Upload 请求与 Release 请求管理,含状态刷新与待处理计数。
使用方式:安装 gem install telnyx,初始化 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]),随后调用对应资源方法。分页可用 .auto_paging_each 自动迭代。
限制与注意:所有 API 调用可能因网络、限流(429)、校验(422)或认证(401)失败,生产代码需处理错误并配合指数退避重试。删除外部连接可能因号码占用、连接处于活动状态或为 Operator Connect 连接而被阻止,后者需联系 Telnyx 支持。Upload 请求中 civic_address_id 与 location_id 只能二选一,number_ids 最多 1000 个。具体收费、价格与平台支持范围暂未提供。