用途:该技能面向使用 Python 构建语音应用的开发者,基于 Telnyx 的 TeXML(兼容 TwiML 的标记语言)与官方 telnyx Python SDK,管理应用、呼叫、会议、录音、队列和媒体流。
安装与初始化:pip install telnyx;随后 import os、from telnyx import Telnyx,用 client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY")) 初始化,后续示例均假定 client 已就绪。
主要能力:呼叫方面支持获取多个呼叫资源(GET /texml/Accounts/{account_sid}/Calls,最终一致)、发起外呼(POST 同路径,必填 To、From、ApplicationSid,可选 Record、MachineDetection、StatusCallback、SipRegion、SuperviseCallSid 等)、获取与更新单个呼叫。录音方面支持获取呼叫录音、请求录音、更新录音。媒体方面支持启动与更新呼叫的 siprec 会话、启动与更新媒体流(Streams)。会议方面支持列出、获取、更新会议,列出与拨入参与者,获取、更新、删除参与者,以及列出和获取会议录音。
使用方式:列表方法返回自动分页迭代器,可用 for item in page_result 遍历全部页。更新呼叫时 payload 键必须使用 CamelCase。
错误处理:需处理网络错误(APIConnectionError)、限流(RateLimitError,429,建议指数退避并参考 Retry-After)、状态错误(APIStatusError,如 401 密钥无效、403 权限不足、404 资源不存在、422 校验失败)。
限制:部分端点最终一致;具体可用参数、返回字段与配额以官方文档为准,资料未提供价格与计费信息。