SuperAPI AI 工具集

telnyx-voice-conferencing-python

编程与开发

查看项目

更新于 10-16 03:37

技能介绍

用途:该技能面向呼叫中心与多方会议场景,提供基于 Python 的 Telnyx 语音会议与队列管理能力。

安装:pip install telnyx

初始化:import os; from telnyx import Telnyx; client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。后续示例均假定 client 已初始化。

主要能力:创建会议(POST /conferences,需 call_control_id、name,可选 max_participants、region、beep_enabled 等);列出/检索会议;结束会议;参与者加入、离开、静音、取消静音、保持、取消保持;播放音频、TTS 语音播报(speak,需 payload、voice);发送与采集 DTMF;会议录音的开始、暂停、恢复、停止;更新参与者 supervisor_role;队列创建、列出,以及入队(POST /calls/{call_control_id}/actions/enqueue,需 queue_name)和离队。会议在参与者全部离开或 4 小时后过期。

使用方式:通过 client.conferences、client.queues、client.calls.actions 等调用,列表方法返回自动分页迭代器。

错误处理:需捕获 telnyx.APIConnectionError、telnyx.RateLimitError、telnyx.APIStatusError;常见状态码 401、403、404、422、429,429 建议指数退避重试。

限制:需有效 Telnyx API Key 与账户权限;部分操作会触发 Webhook(如 conference.participant.left、conference.recording.saved);会议参与者数量受 max_participants 约束;会议最长存活 4 小时。具体计费与价格信息暂未提供。