配置 OpenAI 以支持 3CX AI 坐席

介绍

本指南介绍如何将 OpenAI 与 3CX AI 坐席集成，以实现由 AI 驱动的智能接待员和呼叫处理场景。

此功能需要3CX 企业版许可证。

步骤 1：设置 OpenAI  帐户

如果您还没有 OpenAI 帐户，则需要创建一个帐户，设置账单，并生成 API 密钥。

创建项目并设置账单

  1. 前往OpenAI 登录页面登录您的账户。
  2. 创建一个新项目，并为其取一个描述性名称。
  3. 前往“设置 → 账单并完成计费设置。
  4. 请确保您的账户余额足以满足预期使用需求。

注意：您必须拥有付费的 OpenAI 帐户才能使用正确的功能；试用帐户功能有限，并且可能会出现无法预料的问题或错误，向 OpenAI 支付 100 美元以上的账户通常会直接升级到第 3 级。

配置模型访问权限和限制

  1. 进入 Project → Limits（项目 → 限制）。
  2. 设置预算以控制支出。
  3. 在 “Allow or block models”（允许或阻止模型） 中启用以下模型：
  1. gpt-5-mini
  2. gpt-5-nano
  3. gpt-5
  4. gpt-4o (legacy compatibility)
  5. gpt-4o-mini (legacy compatibility)
  6. gpt-realtime
  7. gpt-realtime-mini
  1. 在 Rate limits（速率限制） 部分，根据需要提高上述模型的速率限制（规模较大的部署可能需要更高的限制，以避免出现不可预测的行为）。

注意：您能否提高速率限制取决于您的 OpenAI API 使用级别/帐户历史记录。

创建新的 API 密钥

  1. 进入 Dashboard → API Keys（仪表板 → API 密钥）。
  2. 点击 Create a New Secret Key（创建新的密钥）。
  3. 输入一个描述性名称，并将权限设置为 “All”（全部）。
  4. 复制并妥善保存。

步骤 2：在 3CX 中配置 OpenAI

  • 登录到 3CX 管理控制台,导航至管理 → 集成 →  AI ，然后点击 OpenAI API。

  • 粘贴你的OpenAI 密钥。
  • 选择型号：
  • OpenAI实时通话模型：gpt-realtime（推荐）
  • OpenAI 文本模型：gpt-5o-mini（推荐）
  • 填写：
  • 公司名称
  • 公司简介; 这是  AI 代理使用它来了解您组织的背景。
  • 点击“确定”保存配置。

步骤 3：添加知识源/RAG（自带内容）

知识源允许客服人员在通话/聊天期间检索公司特定的内容（例如政策、常见问题解答、路由规则、产品文档）。在 OpenAI 的生态系统中，这通常是通过文件导入 + 嵌入/向量搜索来实现的。

  • 在管理控制台中，转到“管理 → 集成 →  AI “
  • 点击知识来源按钮，然后是添加 按钮

  • 设置一个名称和描述用于您的知识库
  • 上传包含与您的业务相关的任何文件（PDF/文档/文本），例如：
  • 营业时间和节假日规定
  • 部门路由指令
  • 产品/价格常见问题解答
  • “我们做什么/如何谈论我们”的措辞
  • 小提示
  • 确保”描述”的内容栏内准确填入描述知识库的内容，以提高信息检索效率
  • 如果您有涵盖不同且不相关内容的文档（例如医疗文档和内部差旅政策文档），请不要将它们放在同一个知识库中；请为每个内容创建单独的知识库。
  • OpenAI API 不会在每次更改时都更新 3CX。每次更改后，请按“刷新”按钮并耐心等待。

注意：知识源是在您配置的 OpenAI 项目/密钥下创建的，并且会根据该 OpenAI 项目/密钥进行计费。

步骤 4：创建和配置 AI 坐席

  • 点击“管理 → 集成 →  AI → 添加坐席“ 按钮：

  • 选择坐席类型：
  • 前台接待员：面向公司的 AI 坐席，负责基本的电话处理和路由。
  • 个人助理：专为处理特定用户（例如老板）的来电而设计

  • 在坐席信息选项卡：
  • 定义常规设置适用于您的  AI 坐席
  • 分机号码 – 为 AI 坐席分配的唯一分机号
  • 助理（仅限助理PA）——指定该个人助理代表哪位用户
  • 部门成员资格——设定该 AI 坐席归属的部门
  • AI 坐席姓名 – 在通话中播报或界面上显示的身份名称
  • 已分配的DID号码——可直接呼入该 AI 坐席的电话号码
  • 配置语音和通话设置：
  • 语音风格 – 选择偏好的语音选项
  • 通话录音  – 关闭 / 全部 / 仅限外部
  • 最长通话时长
  • 客服通话链接 – 可从网站点击通话或聊天；字段留空将禁用此坐席的链接。
  • 在坐席类型选项卡：
  • 设置知识来源– 选择坐席可以访问的知识源
  • 设置引言语言– 默认问候语
  • 你也可以勾选允许语言切换
  • 设置欢迎信息——给来电者的第一条信息
  • 在坐席指示标签页，你的 AI 行为指令已预先配置；但如有必要，自定义提示该按钮可用于调整语气、政策范围和“可行/不可行”规则。
  • 在拦截垃圾电话选项卡：
  • 垃圾邮件防护默认启用
  • 您可以在什么才算垃圾电话下方的框内，对“垃圾电话”与“欺诈行为”进行定义，以及应该采取什么行动：
  • 结束通话
  • 转交给（经理/审核人）
  • 发送弹窗摘要 + 断开连接
  • 在呼叫路由选项卡（仅限接待员）：

  • 添加路由行为规则，以便您的  AI 坐席可以根据您的描述智能地将呼叫和聊天路由到不同的目的地。
  • 例如，如果来电者说：“我收到错误 404”， AI 坐席可以将其分类为支持电话，并转接到一个带有“如果出现 HTTP 错误，请转接到这里”等描述的目的地。
  • 您可以创建多个路由条目，但请避免过度重叠，以确保路由准确。
  • 如果你勾选允许按名称进行分机路由您的 AI 坐席将根据来电者说出的姓名进行转接；例如“将电话转给乔治”。
  • 开启保密模式可实现：
  • 防止 AI 泄露姓氏和员工信息等机密信息
  • 请记住，如果将此功能与“允许按名称进行分机路由”结合使用，你的 AI 坐席即无法对重名的情况进行提示及引导。例如，它无法询问“我们有两个Georges，George Takei和George Washington，您想接通哪一位？”，而是会要求来电者提供被转接对象的全名。
  • 在来电筛选选项卡：
  • 你可以通过关闭已知联系人的来电筛选，放宽对电话簿中存储的已知、可信联系人的筛选过程。
  • 您可以在转接电话前通过启用通话转移前请先检查是否忙线的复选框，确保目标分机号码可用。

  • 在选项选项卡：
  • 来电者响应操作重点关注两类问题来电者：
  • 充满敌意或辱骂的来电者。
  • 不配合、阻碍对话的来电者。
  • 可以配置适当的措施来自动管理这些情况。

技术说明

  • 音频编解码器：仅支持 PCMU。
  • 网络/防火墙配置：
  • OpenAI 服务：api.openai.com
  • 确保允许以下出站访问：
  • TCP 443（HTTPS）
  • UDP 3478（OpenAI 会话的 STUN/TURN）。
  • 关于 AI 模型的说明：
  • OpenAI 会持续更新其模型，随着新版和改进版模型的推出，旧版模型将逐步弃用。本文档中的信息将不定期进行更新，以反映当前推荐使用的选项。您需要确保自己的 OpenAI 账户已配置为允许 3CX 使用较新的模型。。
  • 3CX 的新版本将自动把已配置的模型更新为更新的对应模型。

最后更新时间

本文件最后更新日期为2026年2月3日

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