用途:该技能面向使用 Telnyx Python SDK 开发电话会议与呼叫中心应用的场景,提供会议、参与者、队列相关的 API 调用方式。
主要能力:支持创建、检索、列出和结束会议;加入、离开、暂停、取消暂停、静音、取消静音会议参与者;播放音频、朗读文本(TTS)、发送 DTMF、采集 DTMF;会议录音的启动、暂停、恢复和停止;管理呼叫队列(入队、离队、列出和创建队列)。会议在全部参与者离开后或 4 小时后过期,按 expires_at 降序排列。
使用方式:安装命令为 pip install telnyx。初始化时使用 client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。调用 client.conferences、client.queues、client.calls.actions 下的方法完成操作。列表方法返回自动分页迭代器,可用 for item in page_result 遍历。
限制与注意:所有 API 调用可能因网络错误、限流(429)、校验错误(422)或认证错误(401)失败,生产代码应处理 telnyx.APIConnectionError、telnyx.RateLimitError、telnyx.APIStatusError 等异常。常见错误码:401 无效 API 密钥,403 权限不足,404 资源不存在,422 字段校验错误,429 需指数退避重试。会议活动参与者上限由创建时的 max_participants 参数设定。具体定价、配额与完整字段语义暂未提供。