用途:该技能围绕 Telnyx 的 Python SDK 使用 TeXML(兼容 TwiML 的标记语言)构建与管理语音应用,覆盖呼叫、会议、录音、队列和媒体流等资源。
主要能力:查询账户呼叫列表与单个呼叫(返回方向、状态、时长、价格等字段);发起外呼 TeXML 呼叫(需提供 XML Request URL);更新呼叫;录音的查询与发起;Siprec 会话的创建与更新;从呼叫向指定 WebSocket 地址发起媒体流并更新;会议资源的列表、查询、更新;会议参与者的列表、拨入、查询、更新与删除;会议录音的列表与查询;队列的列表、创建与查询。
安装与初始化:pip install telnyx;使用 Telnyx(api_key=os.environ.get("TELNYX_API_KEY")) 初始化客户端。外呼需在 Mission Control Portal 中为连接配置 XML Request URL。列表方法返回自动分页迭代器,可用 for item in page_result 自动遍历全部页面。
错误处理:调用可能因网络、限流(429)、校验(422)或认证(401)失败;建议捕获 telnyx.APIConnectionError、telnyx.RateLimitError 与 telnyx.APIStatusError,限流时按 Retry-After 退避重试。呼叫与相关端点最终一致。更新呼叫时负载键名须为 CamelCase。
限制:资料未提供定价、配额、语音质量或平台支持范围等信息;具体参数与返回字段以官方文档为准。