创建与接听
发起呼出电话，或接听路由至 Voice API Control 的来电。
查看文档构建语音体验的
基础能力。
使用单独操作实时控制通话，也可用一次请求执行有序动作链。
动作链示例
先说，
再听，
然后继续处理。
此请求在现有通话中播放欢迎语并收集语音回答，应用决定如何使用结果。
- 身份验证
X-Api-Key- 请求格式
application/json- 本端点必填
Idempotency-Key
将占位符替换为服务器端凭据和有效通话控制会话。只有完全相同的请求才能复用同一个幂等键。
阅读动作链文档请求体 · JSON
POST
/api/v1/voice/call-control/execute{
"call_control_id": "YOUR_CALL_CONTROL_ID",
"actions": [
{
"type": "speak",
"text": "Welcome to our support line."
},
{
"type": "gather",
"input": "speech",
"prompt_text": "How can we help?",
"speech_language": "en-US",
"timeout_ms": 8000,
"save_as": "request"
}
]
}电话号码Voice API Control 路由
↓振铃事件
↓call_ringing您的应用接听 → 控制通话
call_initiatedcall_ringingcall_answeredcall_completed请验证签名、及时确认投递，并按事件 ID 去重。重试可能重复投递同一事件。
选择适合您的
构建方式。
通过通话控制实现应用逻辑，并连接语音体验需要的其他工具。
电话号码 API
在平台流程中搜索、订购和配置号码。
了解电话号码Webphone SDK
使用文档中的 SDK 和短期令牌认证，将浏览器通话加入界面。
阅读 SDK 文档AI 语音坐席
在客户平台中结合知识库和可视化流程，配置来电助手。
了解 AI 语音坐席首次集成之前，
请先了解。
咨询我们的团队Voice API 就是 SIP 中继吗？+
不是。SIP 连接用于接入电话系统或平台；Voice API 提供应用可请求的通话控制，例如文字转语音、收集输入和转接。
可以处理来电和呼出吗？+
可以。文档包含呼出创建和来电接听。处理来电时，将号码路由至 Voice API Control，再遵循振铃事件及接听流程。
可以收集语音和按键输入吗？+
可以。gather 端点支持语音和 DTMF 输入，请按文档选择流程支持的输入方式、语言和超时。
通话外也能使用语音功能吗？+
可以。API 文档提供独立的语音转文字和文字转语音端点，用于音频与文本转换。通话内则使用 Voice API 的 gather 和 speak 操作。
语音功能如何收费？+
客户平台公布当前语音转文字及文字转语音费率，Voice API 的 gather 和 speak 按这些费率计费。请同时检查适用通话费用。
API 密钥应该放在哪里？+
账户 API 密钥应保存在服务器端应用。浏览器通话使用 Webphone SDK 文档中的短期令牌流程，不应暴露账户密钥。
连接应用前可以先探索接口吗？+
客户平台提供端点文档、请求和响应示例、OpenAPI 规范及 API 调试工具。调试请求可能执行真实操作，请先检查所选请求再运行。
构建应用
真正需要的通话流程。
从端点文档和当前请求示例开始。