用途:该技能面向希望在 Python 中调用 Telnyx Programmable Fax API 的开发者,用于以编程方式发送和接收传真,并管理传真应用与传真媒体。
安装与初始化:使用 pip install telnyx 安装,然后导入 Telnyx 并以 TELNYX_API_KEY 环境变量初始化客户端,后续示例均假设 client 已初始化。
主要能力: 传真应用管理:列出、创建、检索、更新、删除传真应用。创建时必填 application_name 与 webhook_event_url;创建后可通过 /phone_numbers 端点为其分配电话号码。删除时若应用仍被电话号码使用可能被阻止。 传真记录管理:列出传真、发送传真、查看传真、删除传真。发送传真必填 connection_id、from、to,可选 media_url、quality、monochrome、t38_enabled、webhook_url 等;文件超过 50MB 或超过 350 页会分别以 file_size_limit_exceeded 与 page_count_limit_exceeded 失败。 传真操作:可取消处于 queued、media.processed、originated 或 sending 状态的出站传真;可刷新入站传真已过期的 media_url。 Webhook:Telnyx 用 Ed25519 对 Webhook 签名,请求包含 telnyx-signature-ed25519 与 telnyx-timestamp 头,生产环境应使用 client.webhooks.unwrap() 验签。事件包括 fax.delivered、fax.failed、fax.media.processed、fax.queued、fax.sending.started。
用法要点:电话号码须为 E.164 格式(如 +13125550001),包含加号与国家代码,不含空格、短横线或括号;列表方法返回可自动翻页的迭代器。错误处理需覆盖网络错误、限流(429)、校验错误(422)与认证错误(401)等,常见状态码含 401、403、404、422、429。
限制:资料未提供计费、价格、平台覆盖或具体业务合规信息。