用途:该技能面向使用 Ruby 构建呼叫中心或电话会议应用的开发者,基于 Telnyx Ruby SDK 管理会议、队列与多方通话会话。
安装与初始化:gem install telnyx;随后 require "telnyx" 并用 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 初始化客户端。
主要能力:会议方面支持创建会议(POST /conferences,必填 call_control_id、name)、列出/检索/结束会议、加入与离开会议、静音/取消静音、保持/取消保持、播放音频、发送 DTMF、TTS 朗读、录音开始/暂停/恢复/停止、更新参与者 supervisor_role(barge、monitor、none、whisper)等。队列方面支持列出、创建、检索、更新、删除队列,以及将呼叫入队(enqueue)和离队(leave_queue)。会议在全部参与者离开后或 4 小时后过期。
使用方式:所有示例假定 client 已初始化;分页可用 page.auto_paging_each 迭代。生产代码需处理错误:APIConnectionError(网络)、RateLimitError(429,指数退避重试)、APIStatusError(如 422 校验错误)。常见状态码:401 密钥无效、403 权限不足、404 资源不存在、422 校验失败、429 限流。
适用场景:呼叫中心排队、多方会议、会议录音、参与者管控与语音提示。
限制:资料未提供价格、平台支持范围、并发上限等具体信息;会议最长 4 小时,参与者上限由创建时的 max_participants 决定。