用途：本技能提供用 curl 调用 Telnyx Voice（Call Control）API 的示例与参数说明，用于程序化控制电话呼叫，包括外呼、接听来电、转接、桥接、拒绝、挂断、采集 DTMF、流式传输音频，并通过 webhook 接收实时通话事件。
主要能力：外呼 POST /calls（必填 to、from、connection_id）；接听来电 POST /calls/{call_control_id}/actions/answer；转接 POST /calls/{call_control_id}/actions/transfer；挂断、桥接、拒绝、检索呼叫状态、列出连接下活跃呼叫、管理 Call Control 应用等。另有 SIP Refer、Send SIP info 等操作，完整可选参数、响应结构与低频 webhook 载荷见 references/api-details.md。
使用方式：$TELNYX_API_KEY 预先设置（curl 已预装于 macOS、Linux、Windows 10+）；请求头 Authorization: Bearer $TELNYX_API_KEY 与 Content-Type: application/json；号码须为 E.164 格式（含 + 与国家码，无空格、连字符、括号）。示例：curl -X POST -H "Authorization: Bearer $TELNYX_API_KEY" -H "Content-Type: application/json" -d '{"to":"+13125550001","from":"+18005550101","connection_id":"550e8400-e29b-41d4-a716-446655440000"}' "https://api.telnyx.com/v2/calls"。
适用场景与限制：Call Control 为事件驱动，外呼先 dial()，来电须先从 webhook 中 answer 再执行后续命令；实际通话控制需公网可达的 webhook 端点，否则可接通但无法驱动状态。webhook 使用 Ed25519 签名，请求头含 telnyx-signature-ed25519 与 telnyx-timestamp，应在生产环境验证签名并拒绝超过 5 分钟的时间戳；端点须在 2 秒内返回 2xx，否则 Telnyx 最多重试 3 次。列出接口使用 page[number] 与 page[size] 分页，可查 meta.total_pages。常见错误码 401、403、404、422、429。使用前不得臆造参数、枚举、响应字段或 webhook 字段，未内联的须查阅 references/api-details.md。费用、价格与具体平台支持暂未提供。