SuperAPI AI 工具集

telnyx-voice-gather-curl

通用与其它

查看项目

更新于 10-16 03:37

技能介绍

用途:该技能面向 Telnyx Voice Gather,通过 Call Control API 用 curl 采集呼叫者输入的 DTMF 信号或语音,用于搭建交互式语音菜单与 AI 语音助手。

主要能力:提供多类接口。Gather 采集 DTMF,可设置 minimum_digits、maximum_digits、valid_digits、terminating_digit 及各类超时;Gather using audio 播放音频并采集按键,支持 invalid_audio_url;Gather using speak 用 TTS 播报并采集,必填 voice、payload,可选 payload_type(text/ssml)、language、service_level;Gather using AI 依据 JSON Schema 的 parameters 由语音助手采集信息;另有 gather_stop 停止采集,以及 AI Assistant 的 start、stop、add_messages。

使用方式:先设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",再以 curl 加 Authorization: Bearer $TELNYX_API_KEY 和 Content-Type: application/json 调用 https://api.telnyx.com/v2/calls/{call_control_id}/actions/... 各端点。执行 gather 前需先发送 Answer 命令。

Webhook:需配置回调地址,事件包括 callGatherEnded、CallAIGatherEnded、CallAIGatherMessageHistoryUpdated、CallAIGatherPartialResults,返回 call_control_id、from、to、message_history、status、digits 等字段。Telnyx 使用 Ed25519 签名,请求含 telnyx-signature-ed25519 与 telnyx-timestamp 头,生产环境应校验签名并拒绝超过 5 分钟的时间戳;端点须在 2 秒内返回 2xx,否则最多重试 3 次。

错误处理:调用可能返回 401、403、404、422、429 等状态码,需处理网络错误、限流与校验错误。

限制:curl 已预装于 macOS、Linux 与 Windows 10+;具体计费、价格与配额资料暂未提供。