用途:基于 Telnyx API 的 Ruby SDK(gem install telnyx),用于在 Ruby 应用中创建和管理电话会议、呼叫队列与多方通话会话,适合构建呼叫中心或会议类应用。
主要能力:支持会议全生命周期管理,包括创建会议(需 call_control_id 与 name,可设 max_participants、beep_enabled、region 等)、列出与检索会议、结束会议;支持参会者管理,如加入、离开、列出与检索参会者、更新参会者属性及 supervisor_role(barge、monitor、none、whisper);提供会议内操作,包括对指定参会者播放音频、语音合成播报(speak)、发送 DTMF、收集 DTMF(gather_using_audio)、静音/取消静音、保持/取消保持、停止播放;支持会议录音的开始、暂停、恢复、停止。队列方面支持创建、列出、检索、更新、删除队列及管理队列内呼叫。会议会在所有参会者离开后或 4 小时后过期,列表按 expires_at 降序。
使用方式:先 gem install telnyx,再 require "telnyx" 并用 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 初始化客户端;通过 client.conferences、client.queues、client.calls.actions 等调用对应接口,如 enqueue、leave_queue、join、leave、mute、unmute、hold、unhold、play、speak、send_dtmf、record_start 等。分页可用 page.auto_paging_each { |item| puts item.id }。
限制与注意:生产代码需处理网络错误、429 限流(可参考 Retry-After 并指数退避重试)、422 校验错误、401 认证错误等;常见错误码含义为 401 密钥无效、403 权限不足、404 资源不存在、422 字段格式问题、429 限流。录音停止后预期 webhook 为 conference.recording.saved,参会者离开预期 conference.participant.left。其余细节(如具体计费、价格、依赖版本)暂未提供。