当「人工坐席成本上涨」遇上「7×24 服务刚需」企业需要的不是又一个聊天机器人而是一套能真正打电话、接来电、转人工、留固话、可审计的全链路客服基础设施。Smart AI Service 正是为此而生。一、项目背景及简介1.1 行业背景传统呼叫中心面临三重压力人力成本一线坐席招聘难、培训周期长、夜间与节假日排班成本陡增服务时效用户习惯「即问即答」排队等待直接转化为投诉与流失合规要求通话录音留存、客户隐私脱敏、操作可追溯已成为金融、政务、医疗等行业的硬性门槛。与此同时大模型与语音技术ASR/TTS的成熟让「AI 先应答、复杂问题再转人工」成为可行路径。但多数开源方案停留在 Web 聊天或 Demo 拨号缺少外呼任务引擎、电信网关适配、固话号码保留、RBAC 权限与合规审计等企业落地所需的全套能力。1.2 项目简介Smart AI ServiceAI 智能客服系统是一套面向企业客服场景的开源解决方案采用Java Spring Boot 后端 Vue3 管理后台架构覆盖能力域说明智能外呼模板变量播报、批量任务、全生命周期调度AI 接听FAQ 知识库应答、语音回调处理、超范围自动转人工线路管理固话号码保留、多网关切换MOCK / HTTP / 腾讯云 CCC运营后台仪表盘、导入导出、账号权限、审计日志合规安全手机号加密存储、PII 脱敏、录音访问控制项目代码结构清晰本地可零 Redis 启动调试生产环境可按需接入 Redis 幂等、MinIO 录音归档与腾讯云联络中心适合作为企业 AI 客服中台的技术底座或二次开发起点。二、目标客户Smart AI Service 面向以下典型客户群体客户类型典型诉求中小企业客服团队用 AI 承接高频咨询降低人工接听量外呼通知、回访、催缴SaaS / 系统集成商需要可私有化部署的客服模块对接自有 CRM 或业务系统政务 / 公共服务热线7×24 政策咨询、办事指引复杂事项转人工窗口金融 / 保险 / 医疗合规录音、敏感信息脱敏、操作审计、角色分级授权电商 / 本地生活订单状态外呼、售后 AI 初筛、满意度采集DTMF技术团队 / 架构师希望参考「电信回调 任务引擎 合规层」的完整工程实践不适合仅需网页嵌入式 Chatbot、无需电话触达的场景或对「开箱即用商用 SIP 中继」有强依赖且不愿对接云厂商的客户。三、平台定位3.1 一句话定位「能打电话的 AI 客服中台」—— 外呼与接听一体AI 与人工协同合规与运营并重。3.2 三层定位模型┌─────────────────────────────────────────┐ │ 业务层外呼通知 · AI 接听 · 转人工工单 │ ├─────────────────────────────────────────┤ │ 平台层任务引擎 · 模板 · 知识库 · RBAC │ ├─────────────────────────────────────────┤ │ 接入层MOCK · HTTP 网关 · 腾讯云 CCC │ └─────────────────────────────────────────┘不是单纯的 LLM 对话 Demo而是带任务调度、通话归档、工单流转的业务系统不是绑死单一云厂商网关抽象支持本地 MOCK 调试、HTTP 自定义对接、腾讯云 SDK 生产部署是可渐进式落地的工程化方案开发期无 Redis/无 MinIO 也能跑通主流程上线期按需打开分布式幂等与对象存储。3.3 与常见方案的差异维度通用 Chatbot传统 IVRSmart AI Service触达方式网页/App按键菜单外呼 智能语音 转人工批量外呼❌有限✅ 任务引擎 重试补偿固话保留—✅✅ 线路配置独立管理合规审计弱中等✅ 审计日志 加密脱敏私有化视厂商昂贵✅ 开源可部署四、平台技术4.1 技术栈总览层级技术选型说明后端框架Java 17 Spring Boot 3REST API、JPA、Security、Scheduling持久化MySQL 811 张核心业务表schema seed 脚本开箱即用缓存/幂等Redis可选app.redis.enabled开关关闭时用内存 Noop 实现管理前端Vue 3 Element Plus Vite主流后台布局侧栏 顶栏 内容区对象存储MinIO / S3 兼容录音远程 URL 拉取后持久化归档语音能力外部 ASR/TTS HTTP解耦供应商配置 URL Token 即可电话网关MOCK / HTTP_GATEWAY / TENCENT_CCC策略模式运行时切换 providerType云集成腾讯云 Java SDK 3.0CommonClient 泛化调用 回调字段映射4.2 架构示意flowchart LR subgraph Admin[管理端 Vue3] A1[仪表盘] -- A2[外呼任务] A2 -- A3[AI客服/工单] A3 -- A4[导入导出] end subgraph Backend[Spring Boot API] B1[OutboundTaskService] B2[AiQaService] B3[TelephonyGatewayService] B4[CallArchiveService] B5[IdempotencyService] end subgraph Infra[基础设施] MySQL[(MySQL)] Redis[(Redis 可选)] MinIO[(MinIO 可选)] end subgraph Telephony[电信/云] GW[HTTP Gateway] CCC[腾讯云 CCC] end Admin -- Backend Backend -- MySQL Backend -- Redis Backend -- MinIO B3 -- GW B3 -- CCC CCC --|回调| B44.3 关键工程设计1Redis 可选 —— 降低本地开发门槛app: redis: enabled: false # false幂等/去重走 NoopIdempotencyService management: health: redis: enabled: false # 健康检查不依赖 Redis生产环境将app.redis.enabled设为true外呼幂等与电信回调事件去重走 Redis避免重复处理。2电信回调双通道标准回调POST /api/telephony/callbackHMAC 验签 Event-Id 幂等腾讯原始报文POST /api/telephony/callback/tencentapp.tencent-ccc.mapping.*字段映射3合规分层库内手机号 AES 加密JPA Converter接口层按角色脱敏ADMIN / SUPERVISOR / AGENT 策略可配全链路/api/*审计日志 Filter4外呼任务引擎线程池并发拨号app.task.concurrency失败自动重试 定时补偿扫描OutboundRetryScheduler单条幂等键防重复外呼五、平台核心功能5.1 线路与模板固话配置保留企业电信固话号码外呼/接听统一展示品牌线路网关管理MOCK本地模拟、HTTP_GATEWAY自定义 REST、TENCENT_CCC云联络中心话术模板支持变量占位外呼时按客户维度渲染 TTS 内容。5.2 智能外呼功能描述任务创建绑定模板 客户清单单条或 CSV 批量导入生命周期创建 → 启动 → 暂停 → 终止 → 重启进度追踪总数 / 完成 / 成功 / 失败实时统计明细管理每条外呼记录状态、重试次数、拨号结果失败补偿可配置最大重试次数与扫描间隔5.3 AI 客服与转人工知识问答库维护 FAQAI 来电时语义匹配应答通话会话记录方向、状态、问答文本、时长、满意度对话 transcript多轮对话逐句归档转人工工单AI 无法回答时自动建单坐席「认领 → 处理 → 结案」闭环。5.4 导入导出模板 CSV 导入、外呼任务 CSV 导入通话记录 XLSX 导出便于质检与运营分析。5.5 账号与权限RBAC角色典型权限ADMIN账号管理、全量配置、可选明文手机号SUPERVISOR任务调度、线路配置、数据导出AGENT工单处理、通话查看录音权限可单独关闭5.6 管理后台模块侧栏七大模块仪表盘 · 线路与模板 · 外呼任务 · AI 客服与工单 · 知识问答 · 导入导出 · 账号权限符合企业后台操作习惯上手成本低。六、平台独特优势优势 1外呼 接听一体化不是「半套客服」多数开源项目只做聊天或只做外呼。Smart AI Service 将外呼任务引擎、AI 接听、转人工工单、通话归档放在同一数据模型与后台运营人员一个系统完成全流程管理。优势 2网关抽象开发调试与生产部署平滑切换本地MOCK零依赖跑通业务逻辑联调阶段接HTTP_GATEWAY上线对接腾讯云联络中心SDK 参数、Action、回调字段均可 YAML 配置无需改代码。优势 3「可关 Redis」的务实工程观很多 Spring Boot 项目本地一启动就报 Redis Connection refused。本项目通过app.redis.enabledmanagement.health.redis.enabled双开关让开发者先跑通业务再补基础设施——这一点对团队推广和 CI 流水线极其友好。优势 4合规能力内置而非事后补丁加密存储、PII 脱敏、审计日志、录音访问控制均在配置层开关满足政企、金融客户对「可证明合规」的基本诉求。优势 5前端主流范式二次开发友好Vue3 Element Plus 侧栏布局模块即视图API 代理清晰适合作为内部中台快速定制 UI 与报表。优势 6数据库脚本完整11 表 2 行种子数据schema.sqldata.sql一键初始化默认账号admin / supervisor / agent三级角色演示与压测开箱即用。七、平台安装使用7.1 环境要求组件版本建议是否必须JDK17✅Maven3.8✅MySQL8.0✅Node.js18 LTS推荐✅ 前端Redis6可选生产建议开启MinIO最新稳定版可选录音归档7.2 快速部署四步Step 1 — 初始化数据库mysql -uroot -p -e CREATE DATABASE IF NOT EXISTS ai_cs CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; mysql -uroot -p ai_cs backend/sql/schema.sql mysql -uroot -p ai_cs backend/sql/data.sqlStep 2 — 启动后端cd backend mvn spring-boot:run本地 MySQL 无密码时mvn spring-boot:run -Dspring-boot.run.arguments--spring.datasource.usernameroot --spring.datasource.password服务地址http://localhost:8080Step 3 — 启动前端cd frontend npm install npm run dev管理后台http://localhost:5173/api代理至 8080Step 4 — 登录体验用户名密码角色supervisorsuper123主管推荐日常体验adminadmin123管理员agentagent123坐席7.3 核心配置速查application.ymlapp: redis: enabled:false # 本地 false生产 true security: callback-secret:*** # 电信回调验签 encryption-key:*** # 16 字节 AES 密钥 task: max-retry:2 concurrency:4 speech: asr-url: tts-url: storage: endpoint: # MinIO 地址空则跳过归档 bucket:ai-cs-recordings tencent-ccc: sdk: enabled:false # 接腾讯云时 true详细配置说明见项目根目录 README.md。7.4 典型使用路径线路与模板→ 配置固话与网关类型 → 新建外呼话术模板外呼任务→ 创建任务、导入客户 CSV → 启动任务 → 查看明细与成功率知识问答→ 录入 FAQAI 客服与工单→ 查看来电会话、处理转人工工单导入导出→ 批量导入或导出通话报表。八、应用场景及案例说明场景 1银行信用卡还款提醒外呼痛点每月数万笔临近还款客户人工外呼成本高、接通率低。方案在「线路与模板」配置银行官方固话与 TENCENT_CCC 网关创建模板您好 ${customerName}您尾号 ${cardTail} 的信用卡本期账单 ${amount} 元请于 ${dueDate} 前还款。;CSV 导入客户清单启动外呼任务失败号码自动重试全程录音存 MinIO报表 XLSX 导出交质检。价值AI TTS 统一口径合规录音可追溯主管在仪表盘实时看成功率。场景 2政务 12345 夜间 AI 接听Inbound 转人工痛点夜间人工坐席缩减简单政策咨询仍大量涌入。方案知识库录入「公积金提取」「居住证办理」等高频 FAQ来电经网关回调 → AI 匹配问答 → 写入 transcript超范围问题自动建转人工工单次日坐席认领处理敏感手机号加密存储列表默认脱敏审计日志记录坐席操作。价值7×24 覆盖 80% 重复咨询复杂个案不断档流转。场景 3电商大促物流异常通知批量外呼 MOCK 联调痛点大促期间物流延迟需快速通知用户开发期不能打真实电话。方案开发环境providerTypeMOCK完整跑通任务创建、并发、重试逻辑联调环境切换HTTP_GATEWAY对接自建 SIP 网关上线前切换腾讯云 CCC配置 SDK Action 与回调 mappingRedis 幂等打开防止云厂商重复回调导致重复扣费或重复通知。价值同一套代码三环境渐进降低 telecom 联调风险。场景 4保险回访满意度采集DTMF 归档痛点理赔完成后需电话回访并采集满意度按键。方案外呼模板播报回访话术电信回调写入dtmfFeedback、customerSatisfaction字段通话会话与录音 URL 关联归档AGENT 角色默认不可听录音SUPERVISOR 以上按合规策略开放。价值结构化满意度数据直接进入 MySQL无需人工填表。结语Smart AI Service 试图回答一个工程问题如何把「AI 客服」从 PPT 变成可部署、可审计、能打电话的系统它不是最完美的商用 CCAAS 替代品但在「外呼引擎 AI 接听 转人工 网关适配 合规开关 可选 Redis/MinIO」的组合上提供了一条可运行、可扩展、可私有化的路径。无论你是要落地一个企业热线还是要学习电信回调与任务调度如何在一个 Spring Boot 项目里协作Smart AI Service 都值得 fork 下来跑一遍。项目仓库结构smartAIService/ ├── backend/ # Spring Boot API SQL 腾讯 SDK 文档 ├── frontend/ # Vue3 管理后台 ├── README.md # 安装与配置手册 └── 平台简介.md # 本文延伸阅读腾讯云云联络中心腾讯云 Java SDK项目内backend/docs/tencentcloud-sdk-integration.md