SuperAPI AI 工具集

telnyx-voice-gather-java

编程与开发

查看项目

更新于 10-16 04:57

技能介绍

用途:在 Java 项目中通过 Telnyx Call Control API 采集来电者的 DTMF 按键或语音输入,构建交互式语音菜单(IVR)与 AI 语音助手。

安装:Maven 依赖 com.telnyx.sdk:telnyx:6.89.0;Gradle 为 implementation("com.telnyx.sdk:telnyx:6.89.0")。初始化:TelnyxClient client = TelnyxOkHttpClient.fromEnv();

主要能力:gather 采集 DTMF,可设 valid_digits、最大/最小位数、终止符、初始与位间超时等,需先执行 Answer 命令;gather_stop 停止并触发 call.gather.ended。gather_using_audio 播放音频文件直至收到有效按键。gather_using_speak 将文本或 SSML 转为语音播放并采集按键,必填 voice、payload。gather_using_ai 用 voice assistant 按 JSON Schema 参数采集信息,必填 parameters。另可 addAiAssistantMessages、startAiAssistant、stopAiAssistant 管理通话中的 AI 助手。

Webhook:事件包括 CallAIGatherEnded、CallAIGatherMessageHistoryUpdated、CallAIGatherPartialResults、callGatherEnded。使用 Ed25519 签名校验,请求头为 telnyx-signature-ed25519 与 telnyx-timestamp,可通过 client.webhooks().unwrap() 验证。

错误处理:可能返回 401、403、404、422、429,建议捕获 TelnyxServiceException,对 429 采用指数退避重试。

适用场景:电话 IVR 菜单、按键收集、AI 语音助手信息采集。限制:需先应答通话再采集;用量、计费与平台细节资料未提供。