呼叫流程脚本：创建 Grok xAI 实时语音坐席

介绍

grokvoiceagent.cs 示例将 3CX 入站呼叫连接到 xAI Grok 实时语音会话。该代理可以应答呼叫者、搜索批准的公司目录、连接呼叫、提供语音信箱或聊天，并在配置后保存呼叫者上下文。

该示例包含一个已禁用的 get_department_hours 自定义工具，用于演示如何注册一个安全的 AI 可调用函数。

此脚本需要3CX AI 版许可证、PBX 版本 Update 10 以及 xAI API 账户。

在 3CX 中创建呼叫脚本

• 登录 3CX 管理控制台。
• 前往集成>呼叫脚本。
• 选择 +从商店添加。

• 选择 grokvoiceagent.cs.

• 请输入不带空格的小写名称，例如 grokreception。
• 选择脚本的运行方式，并分配所需的 DID、中继路由或内部目标。
• 选择所属部门。
• 继续打开代码编辑器。

配置 xAI 和脚本

将以下受保护参数添加到 PBX：

• GROK_API_KEY - 您的 xAI 账户的 API 密钥
• GROK_REALTIME_MODEL - Grok Realtime 语音模型。

在脚本中保留 ApiKeyOverride 和 ModelOverride 为空。当这些值为空时，脚本会自动从 PBX 参数读取 API 密钥和模型。

请勿直接在脚本中输入 Grok API 密钥，尤其当脚本会被共享、导出或发布时。在 ApiKeyOverride 或 ModelOverride 中配置的值将优先于对应的 PBX 参数，且通常仅用于临时测试。

接下来，请查看脚本顶部附近的这些客户设置：

在生产环境中，请将 AllowAllVisibilityForTesting 设为 false，并配置最小可行的可见性列表。

要激活可选工具示例，请检查其处理程序并取消注释：

RegisterExampleCustomTool();



选择 保存，并在脚本输出中确认编译成功。

工作原理

• 呼叫者到达脚本。
• 脚本创建一个受限的目录可见性列表。
• 3CX 准备媒体通道并启动 Grok 实时语音会话。
• 代理与呼叫者对话并调用批准的 3CX 函数。
• 转接通过工具执行，而非通过会话中的承诺。
• 提供商或媒体故障会将呼叫者路由到配置的回退目标。

测试脚本

• 确认所选 Grok 语音和多语言行为。
• 搜索允许和隐藏的分机。
• 确认坐席在呼叫者确认后执行转接。
• 当用户不可用时测试语音信箱和聊天。
• 说再见并验证会话正常关闭。
• 测试提供商故障和回退行为。

另请参阅

• 会话立即失败： 验证 GROK_API_KEY、支持的模型、许可证、PBX 版本和出站提供商连接。
• 转接被宣布但未执行： 确认自定义指令仍然要求使用连接工具，且未被覆盖。
• 目录搜索返回过多结果： 禁用 AddAll() 并限制可见性。
• 回退失败： 验证目标和部门权限。
• 提示缺失： 确认活动提示集中存在 ERROR。

另请参阅

• 创建呼叫处理脚本
• 用于 PIN 的呼叫处理脚本示例
• 3CX 管理手册

最后更新时间

本指南最后更新于2026年7月30日。

https://www.3cx.cn/docs/grok-ai-voice-agent/