用途:该技能面向使用 curl 调用 Telnyx Voice 高级呼叫控制 REST API 的场景,覆盖 DTMF 发送、SIPREC 录制、噪声抑制、客户端状态更新、AI 助手会话加入以及主管控制。
主要能力与用法:需先设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",随后用 Bearer 令牌调用 https://api.telnyx.com/v2 接口。加入 AI 助手会话:POST /calls/{call_control_id}/actions/ai_assistant_join,必填 conversation_id、participant,可选 client_state、command_id。更新客户端状态:PUT /calls/{call_control_id}/actions/client_state_update,必填 client_state。发送 DTMF:POST /calls/{call_control_id}/actions/send_dtmf,必填 digits,可选 client_state、command_id、duration_millis。SIPREC 启动:POST /calls/{call_control_id}/actions/siprec_start,可选 client_state、connector_name、include_metadata_custom_headers、secure、session_timeout_secs、sip_transport、siprec_track;停止为 POST /calls/{call_control_id}/actions/siprec_stop。噪声抑制为 BETA:suppression_start 与 suppression_stop,start 可选 direction、noise_suppression_engine(Denoiser、DeepFilterNet、Krisp、AiCoustics)等。主管角色切换:POST /calls/{call_control_id}/actions/switch_supervisor_role,必填 role。
错误处理:生产代码需处理网络错误、401 认证失败、403 权限不足、404 资源不存在、422 校验错误与 429 限流(重试并退避)。Webhook 使用 Ed25519 签名,请求含 telnyx-signature-ed25519 与 telnyx-timestamp 头,建议用 SDK 的 client.webhooks.unwrap 校验,端点须在 2 秒内返回 2xx,最多重试 3 次,可在门户配置故障转移 URL。事件包括通话会话结束、洞察生成、DTMF 接收、机器检测与语音问候结束、Refer 事件及 SIPREC 事件等。价格、配额与具体参数默认值暂未提供。