Merge pull request 'feat/multi-channel-framework [AC-INIT]合并功能代码' (#12) from feat/multi-channel-framework into main
Reviewed-on: MerCry/ai-robot#12
This commit is contained in:
commit
b9f678a203
|
|
@ -24,3 +24,5 @@
|
||||||
hs_err_pid*
|
hs_err_pid*
|
||||||
replay_pid*
|
replay_pid*
|
||||||
|
|
||||||
|
/target/
|
||||||
|
/.idea/
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,271 @@
|
||||||
|
# ai-robot-MCA - Progress
|
||||||
|
|
||||||
|
> 多渠道适配主框架架构改造进度文档
|
||||||
|
> 遵循 `docs/session-handoff-protocol.md` 协议
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 Context
|
||||||
|
|
||||||
|
- module: `ai-robot`
|
||||||
|
- feature: `MCA` (Multi-Channel Adapter)
|
||||||
|
- status: 🔄 进行中
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 Spec References (SSOT)
|
||||||
|
|
||||||
|
- agents: `AGENTS.md`
|
||||||
|
- contracting: `spec/contracting.md`
|
||||||
|
- requirements: `spec/ai-robot/requirements.md`
|
||||||
|
- openapi_provider: `spec/ai-robot/openapi.provider.yaml`
|
||||||
|
- openapi_deps: `spec/ai-robot/openapi.deps.yaml`
|
||||||
|
- design: `spec/ai-robot/design.md`
|
||||||
|
- tasks: `spec/ai-robot/tasks.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 Overall Progress (Phases)
|
||||||
|
|
||||||
|
- [x] Phase 1: 基础设施 (100%) ✅ [tasks.md: TASK-001 ~ TASK-005]
|
||||||
|
- [x] Phase 2: 渠道适配层 (100%) ✅ [tasks.md: TASK-010 ~ TASK-013]
|
||||||
|
- [x] Phase 3: 消息路由层 (100%) ✅ [tasks.md: TASK-020 ~ TASK-023]
|
||||||
|
- [x] Phase 4: AI 服务客户端 (100%) ✅ [tasks.md: TASK-030 ~ TASK-033]
|
||||||
|
- [ ] Phase 5: 集成测试 (0%) ⏳ [tasks.md: TASK-040 ~ TASK-042]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔄 Current Phase
|
||||||
|
|
||||||
|
### Goal
|
||||||
|
完成集成测试，验证多渠道适配框架的完整功能。
|
||||||
|
|
||||||
|
### Sub Tasks
|
||||||
|
- [x] TASK-030: 定义 AI 服务 DTO ✅ [AC-MCA-04-REQ, AC-MCA-05]
|
||||||
|
- [x] TASK-031: 实现 AiServiceClient ✅ [AC-MCA-04, AC-MCA-05]
|
||||||
|
- [x] TASK-032: 实现熔断与降级 ✅ [AC-MCA-06, AC-MCA-07]
|
||||||
|
- [x] TASK-033: 删除旧 AiService ✅
|
||||||
|
- [ ] TASK-040: 集成测试 ⏳
|
||||||
|
- [ ] TASK-041: 端到端测试 ⏳
|
||||||
|
- [ ] TASK-042: 性能测试 ⏳
|
||||||
|
|
||||||
|
### Next Action (Must be Specific)
|
||||||
|
|
||||||
|
**Immediate**: 执行 Phase 5 集成测试任务。
|
||||||
|
|
||||||
|
**Details**:
|
||||||
|
1. task: TASK-040 集成测试
|
||||||
|
2. action: 编写集成测试验证消息路由流程
|
||||||
|
3. reference:
|
||||||
|
- `spec/ai-robot/tasks.md` TASK-040 定义
|
||||||
|
4. constraints:
|
||||||
|
- 测试覆盖 InboundMessage → AI Service → OutboundMessage 完整流程
|
||||||
|
- 验证幂等性、熔断降级逻辑
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🏗️ Technical Context
|
||||||
|
|
||||||
|
### Module Structure (Only What Matters)
|
||||||
|
|
||||||
|
```
|
||||||
|
src/main/java/com/wecom/robot/
|
||||||
|
├── dto/
|
||||||
|
│ ├── InboundMessage.java # TASK-001 ✅
|
||||||
|
│ ├── OutboundMessage.java # TASK-001 ✅
|
||||||
|
│ ├── SignatureInfo.java # TASK-001 ✅
|
||||||
|
│ └── ai/
|
||||||
|
│ ├── ChatRequest.java # TASK-030
|
||||||
|
│ └── ChatResponse.java # TASK-030
|
||||||
|
├── config/
|
||||||
|
│ ├── AiServiceConfig.java # TASK-002 ✅
|
||||||
|
│ └── ChannelConfig.java # TASK-002 ✅
|
||||||
|
├── adapter/
|
||||||
|
│ ├── ChannelAdapter.java # TASK-010 ✅
|
||||||
|
│ ├── ServiceStateCapable.java # TASK-010 ✅
|
||||||
|
│ ├── TransferCapable.java # TASK-010 ✅
|
||||||
|
│ ├── MessageSyncCapable.java # TASK-010 ✅
|
||||||
|
│ ├── WeChatAdapter.java # TASK-011 ✅
|
||||||
|
│ └── ChannelAdapterFactory.java # TASK-012 ✅
|
||||||
|
├── service/
|
||||||
|
│ ├── MessageRouterService.java # TASK-020 ✅
|
||||||
|
│ ├── AiServiceClient.java # TASK-031
|
||||||
|
│ └── impl/
|
||||||
|
│ ├── MessageRouterServiceImpl.java # TASK-021 ✅
|
||||||
|
│ └── AiServiceClientImpl.java # TASK-031
|
||||||
|
├── util/
|
||||||
|
│ └── IdempotentHelper.java # TASK-005 ✅
|
||||||
|
└── entity/
|
||||||
|
└── Session.java # TASK-003 ✅
|
||||||
|
```
|
||||||
|
|
||||||
|
### Key Decisions (Why / Impact)
|
||||||
|
|
||||||
|
- decision: 统一消息模型 (InboundMessage/OutboundMessage)
|
||||||
|
reason: 实现渠道无关的消息处理，Controller 层负责验签/解析，Router 层处理统一消息
|
||||||
|
impact: 后续新增渠道只需实现 ChannelAdapter，无需修改核心路由逻辑
|
||||||
|
|
||||||
|
- decision: 使用 Resilience4j 实现熔断
|
||||||
|
reason: 与 Spring Boot 2.7 兼容良好，支持断路器、限流、超时
|
||||||
|
impact: AI 服务调用具备熔断/降级能力，提升系统稳定性
|
||||||
|
|
||||||
|
- decision: 内部字段统一用 `content`，AI 服务契约用 `currentMessage`
|
||||||
|
reason: 保持内部命名一致性，映射在 AiServiceClient 层处理
|
||||||
|
impact: 避免后续 DTO 命名混乱
|
||||||
|
|
||||||
|
- decision: ChannelAdapter 接口分离为核心能力和可选能力
|
||||||
|
reason: 不同渠道支持的能力不同，接口分离允许按需实现
|
||||||
|
impact: WeChatAdapter 实现全部接口，其他渠道可按需实现
|
||||||
|
|
||||||
|
### Code Snippets (Reference)
|
||||||
|
|
||||||
|
```java
|
||||||
|
// ChannelAdapter 接口定义 (design.md 3.1)
|
||||||
|
public interface ChannelAdapter {
|
||||||
|
String getChannelType();
|
||||||
|
boolean sendMessage(OutboundMessage message);
|
||||||
|
}
|
||||||
|
|
||||||
|
// MessageRouterService 接口定义 (design.md 3.2)
|
||||||
|
public interface MessageRouterService {
|
||||||
|
void processInboundMessage(InboundMessage message);
|
||||||
|
void routeBySessionState(Session session, InboundMessage message);
|
||||||
|
void dispatchToAiService(Session session, InboundMessage message);
|
||||||
|
void dispatchToManualCs(Session session, InboundMessage message);
|
||||||
|
void dispatchToPendingPool(Session session, InboundMessage message);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🧾 Session History
|
||||||
|
|
||||||
|
### Session #5 (2026-02-24)
|
||||||
|
- completed:
|
||||||
|
- L2 契约升级: openapi.provider.yaml L0 → L2 ✅
|
||||||
|
- L2 契约对齐: DTO 添加 validation 注解 ✅
|
||||||
|
- L2 契约对齐: Controller 添加 @Valid 校验 ✅
|
||||||
|
- L2 契约对齐: 创建全局异常处理器 ✅
|
||||||
|
- changes:
|
||||||
|
- 更新 spec/ai-robot/openapi.provider.yaml (L0 → L2)
|
||||||
|
- 更新 src/main/java/com/wecom/robot/dto/ApiResponse.java (code=200 → 0, 添加注解)
|
||||||
|
- 更新 src/main/java/com/wecom/robot/dto/SessionInfo.java (添加 @NotBlank, @Size, channelType 字段)
|
||||||
|
- 更新 src/main/java/com/wecom/robot/dto/MessageInfo.java (添加 @NotBlank, @Size)
|
||||||
|
- 更新 src/main/java/com/wecom/robot/dto/AcceptSessionRequest.java (添加 @NotBlank, @Size)
|
||||||
|
- 更新 src/main/java/com/wecom/robot/dto/SendMessageRequest.java (添加 @NotBlank, @Size)
|
||||||
|
- 更新 src/main/java/com/wecom/robot/controller/SessionController.java (添加 @Valid, channelType 参数)
|
||||||
|
- 新增 src/main/java/com/wecom/robot/config/GlobalExceptionHandler.java
|
||||||
|
- commits: f09f22f, 0786e6a
|
||||||
|
|
||||||
|
### Session #4 (2026-02-24)
|
||||||
|
- completed:
|
||||||
|
- TASK-001: 定义统一消息模型 DTO ✅
|
||||||
|
- TASK-002: 新增配置类 ✅
|
||||||
|
- TASK-003: 数据库 Schema 变更 ✅
|
||||||
|
- TASK-004: 添加 Resilience4j 依赖 ✅
|
||||||
|
- TASK-005: 消息幂等性工具类 ✅
|
||||||
|
- TASK-030: 定义 AI 服务 DTO ✅
|
||||||
|
- TASK-031: 实现 AiServiceClient ✅
|
||||||
|
- TASK-032: 实现熔断与降级 ✅
|
||||||
|
- TASK-033: 删除旧 AiService ✅
|
||||||
|
- changes:
|
||||||
|
- 新增 src/main/java/com/wecom/robot/dto/InboundMessage.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/dto/OutboundMessage.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/dto/SignatureInfo.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/config/AiServiceConfig.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/config/ChannelConfig.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/config/RestTemplateConfig.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/util/IdempotentHelper.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/dto/ai/ChatRequest.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/dto/ai/ChatResponse.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/dto/ai/ChatMessage.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/service/AiServiceClient.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/service/impl/AiServiceClientImpl.java
|
||||||
|
- 新增 src/main/resources/db/migration/V1__add_channel_type.sql
|
||||||
|
- 删除 src/main/java/com/wecom/robot/service/AiService.java
|
||||||
|
- 删除 src/main/java/com/wecom/robot/config/AiConfig.java
|
||||||
|
- 更新 src/main/resources/application.yml (添加 ai-service, channel, resilience4j 配置)
|
||||||
|
- 更新 src/main/java/com/wecom/robot/service/impl/MessageRouterServiceImpl.java
|
||||||
|
- 更新 src/main/java/com/wecom/robot/controller/DebugController.java
|
||||||
|
- 更新 pom.xml (添加 Resilience4j 依赖)
|
||||||
|
- commits: 多个独立 commit
|
||||||
|
|
||||||
|
### Session #3 (2026-02-24)
|
||||||
|
- completed:
|
||||||
|
- TASK-010: 定义 ChannelAdapter 接口 ✅
|
||||||
|
- TASK-011: 实现 WeChatAdapter ✅
|
||||||
|
- TASK-012: 创建 ChannelAdapterFactory ✅
|
||||||
|
- TASK-013: 重构 WecomCallbackController ✅
|
||||||
|
- TASK-022: 重构 MessageProcessService ✅
|
||||||
|
- changes:
|
||||||
|
- 新增 src/main/java/com/wecom/robot/adapter/ChannelAdapter.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/adapter/ServiceStateCapable.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/adapter/TransferCapable.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/adapter/MessageSyncCapable.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/adapter/WeChatAdapter.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/adapter/ChannelAdapterFactory.java
|
||||||
|
- 更新 src/main/java/com/wecom/robot/controller/WecomCallbackController.java
|
||||||
|
- 更新 src/main/java/com/wecom/robot/service/MessageProcessService.java
|
||||||
|
- commits: 4e9c5ba, 2631c53, 07561fe
|
||||||
|
|
||||||
|
### Session #2 (2026-02-24)
|
||||||
|
- completed:
|
||||||
|
- TASK-020: 定义 MessageRouterService 接口
|
||||||
|
- TASK-021: 实现 MessageRouterServiceImpl
|
||||||
|
- 创建 `src/main/java/com/wecom/robot/service/MessageRouterService.java`
|
||||||
|
- 创建 `src/main/java/com/wecom/robot/service/impl/MessageRouterServiceImpl.java`
|
||||||
|
- 实现 5 个核心方法：processInboundMessage, routeBySessionState, dispatchToAiService, dispatchToManualCs, dispatchToPendingPool
|
||||||
|
- 实现幂等性检查（基于 Redis SETNX）
|
||||||
|
- changes:
|
||||||
|
- 新增 src/main/java/com/wecom/robot/service/MessageRouterService.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/service/impl/MessageRouterServiceImpl.java
|
||||||
|
- 更新 docs/progress/ai-robot-mca-progress.md
|
||||||
|
- 更新 spec/ai-robot/tasks.md
|
||||||
|
- commits: b9792c8, 0b6fcf5
|
||||||
|
|
||||||
|
### Session #2 (2026-02-24)
|
||||||
|
- completed:
|
||||||
|
- TASK-020: 定义 MessageRouterService 接口
|
||||||
|
- TASK-021: 实现 MessageRouterServiceImpl
|
||||||
|
- TASK-022: 重构 MessageProcessService
|
||||||
|
- TASK-023: 更新 SessionManagerService 支持 channelType
|
||||||
|
- 创建 `src/main/java/com/wecom/robot/service/MessageRouterService.java`
|
||||||
|
- 创建 `src/main/java/com/wecom/robot/service/impl/MessageRouterServiceImpl.java`
|
||||||
|
- 更新 Session 实体添加 channelType 字段
|
||||||
|
- 更新 SessionManagerService 支持按渠道类型创建和筛选会话
|
||||||
|
- 实现 5 个核心方法：processInboundMessage, routeBySessionState, dispatchToAiService, dispatchToManualCs, dispatchToPendingPool
|
||||||
|
- 实现幂等性检查（基于 Redis SETNX）
|
||||||
|
- changes:
|
||||||
|
- 新增 src/main/java/com/wecom/robot/service/MessageRouterService.java
|
||||||
|
- 新增 src/main/java/com/wecom/robot/service/impl/MessageRouterServiceImpl.java
|
||||||
|
- 更新 src/main/java/com/wecom/robot/service/MessageProcessService.java
|
||||||
|
- 更新 src/main/java/com/wecom/robot/entity/Session.java
|
||||||
|
- 更新 src/main/java/com/wecom/robot/service/SessionManagerService.java
|
||||||
|
- 更新 docs/progress/ai-robot-mca-progress.md
|
||||||
|
- 更新 spec/ai-robot/tasks.md
|
||||||
|
- commits: b9792c8, 0b6fcf5, db378af, a8d7474
|
||||||
|
|
||||||
|
### Session #1 (2026-02-24)
|
||||||
|
- completed:
|
||||||
|
- 创建 spec/ai-robot/ 目录结构
|
||||||
|
- 编写 requirements.md (v0.2.0)
|
||||||
|
- 编写 openapi.deps.yaml (L0)
|
||||||
|
- 编写 openapi.provider.yaml (L0)
|
||||||
|
- 编写 design.md (v0.2.0)
|
||||||
|
- 编写 tasks.md (20 个任务)
|
||||||
|
- 所有规范文件已提交到 Git
|
||||||
|
- changes:
|
||||||
|
- 新增 spec/ai-robot/requirements.md
|
||||||
|
- 新增 spec/ai-robot/openapi.deps.yaml
|
||||||
|
- 新增 spec/ai-robot/openapi.provider.yaml
|
||||||
|
- 新增 spec/ai-robot/design.md
|
||||||
|
- 新增 spec/ai-robot/tasks.md
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 Startup Guide
|
||||||
|
|
||||||
|
1. 读取本进度文档，定位当前 Phase 与 Next Action。
|
||||||
|
2. 打开并阅读 Spec References 指向的模块规范（requirements/openapi/design/tasks）。
|
||||||
|
3. 直接执行 Next Action（TASK-030: 创建 ChatRequest/ChatResponse DTO）。
|
||||||
|
4. 每完成一个子任务，更新本进度文档并提交 Git。
|
||||||
Binary file not shown.
|
|
@ -0,0 +1,137 @@
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<project xmlns="http://maven.apache.org/POM/4.0.0"
|
||||||
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||||
|
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
|
||||||
|
<modelVersion>4.0.0</modelVersion>
|
||||||
|
|
||||||
|
<groupId>com.wecom</groupId>
|
||||||
|
<artifactId>wecom-robot</artifactId>
|
||||||
|
<version>1.0.0</version>
|
||||||
|
<packaging>jar</packaging>
|
||||||
|
|
||||||
|
<name>wecom-robot</name>
|
||||||
|
<description>企业微信智能客服系统</description>
|
||||||
|
|
||||||
|
<parent>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-starter-parent</artifactId>
|
||||||
|
<version>2.7.18</version>
|
||||||
|
<relativePath/>
|
||||||
|
</parent>
|
||||||
|
|
||||||
|
<properties>
|
||||||
|
<java.version>1.8</java.version>
|
||||||
|
<mybatis-plus.version>3.5.3.1</mybatis-plus.version>
|
||||||
|
<hutool.version>5.8.22</hutool.version>
|
||||||
|
<fastjson.version>2.0.40</fastjson.version>
|
||||||
|
<resilience4j.version>2.1.0</resilience4j.version>
|
||||||
|
<project.basedir>${project.basedir}</project.basedir>
|
||||||
|
</properties>
|
||||||
|
|
||||||
|
<dependencies>
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-starter-web</artifactId>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-starter-websocket</artifactId>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-starter-data-redis</artifactId>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-starter-validation</artifactId>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>com.mysql</groupId>
|
||||||
|
<artifactId>mysql-connector-j</artifactId>
|
||||||
|
<scope>runtime</scope>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>com.baomidou</groupId>
|
||||||
|
<artifactId>mybatis-plus-boot-starter</artifactId>
|
||||||
|
<version>${mybatis-plus.version}</version>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>cn.hutool</groupId>
|
||||||
|
<artifactId>hutool-all</artifactId>
|
||||||
|
<version>${hutool.version}</version>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>com.alibaba</groupId>
|
||||||
|
<artifactId>fastjson</artifactId>
|
||||||
|
<version>${fastjson.version}</version>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.projectlombok</groupId>
|
||||||
|
<artifactId>lombok</artifactId>
|
||||||
|
<optional>true</optional>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-starter-test</artifactId>
|
||||||
|
<scope>test</scope>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>commons-codec</groupId>
|
||||||
|
<artifactId>commons-codec</artifactId>
|
||||||
|
<version>1.9</version>
|
||||||
|
<scope>system</scope>
|
||||||
|
<systemPath>${project.basedir}/lib/commons-codec-1.9.jar</systemPath>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>io.github.resilience4j</groupId>
|
||||||
|
<artifactId>resilience4j-spring-boot2</artifactId>
|
||||||
|
<version>${resilience4j.version}</version>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>io.github.resilience4j</groupId>
|
||||||
|
<artifactId>resilience4j-timelimiter</artifactId>
|
||||||
|
<version>${resilience4j.version}</version>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.flywaydb</groupId>
|
||||||
|
<artifactId>flyway-core</artifactId>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.flywaydb</groupId>
|
||||||
|
<artifactId>flyway-mysql</artifactId>
|
||||||
|
</dependency>
|
||||||
|
</dependencies>
|
||||||
|
|
||||||
|
<build>
|
||||||
|
<plugins>
|
||||||
|
<plugin>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-maven-plugin</artifactId>
|
||||||
|
<configuration>
|
||||||
|
<includeSystemScope>true</includeSystemScope>
|
||||||
|
<excludes>
|
||||||
|
<exclude>
|
||||||
|
<groupId>org.projectlombok</groupId>
|
||||||
|
<artifactId>lombok</artifactId>
|
||||||
|
</exclude>
|
||||||
|
</excludes>
|
||||||
|
</configuration>
|
||||||
|
</plugin>
|
||||||
|
</plugins>
|
||||||
|
</build>
|
||||||
|
|
||||||
|
</project>
|
||||||
|
|
@ -0,0 +1,636 @@
|
||||||
|
---
|
||||||
|
feature_id: "MCA"
|
||||||
|
title: "多渠道适配主框架架构设计"
|
||||||
|
status: "draft"
|
||||||
|
version: "0.2.0"
|
||||||
|
owners:
|
||||||
|
- "architect"
|
||||||
|
- "backend"
|
||||||
|
last_updated: "2026-02-24"
|
||||||
|
---
|
||||||
|
|
||||||
|
# 多渠道适配主框架架构设计（design.md）
|
||||||
|
|
||||||
|
## 1. 系统架构
|
||||||
|
|
||||||
|
### 1.1 整体架构图
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
||||||
|
│ 外部系统 │
|
||||||
|
├─────────────────┬─────────────────┬─────────────────┬───────────────────────┤
|
||||||
|
│ 企业微信 API │ 抖音 API │ 京东 API │ 前端工作台 │
|
||||||
|
└────────┬────────┴────────┬────────┴────────┬────────┴──────────┬────────────┘
|
||||||
|
│ │ │ │
|
||||||
|
▼ ▼ ▼ ▼
|
||||||
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
||||||
|
│ Java 主框架 (Spring Boot) │
|
||||||
|
├─────────────────────────────────────────────────────────────────────────────┤
|
||||||
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ 入口层 (Controller Layer) │ │
|
||||||
|
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
|
||||||
|
│ │ │WecomCallback │ │DouyinCallback│ │ JdCallback │ (预留) │ │
|
||||||
|
│ │ │ Controller │ │ Controller │ │ Controller │ │ │
|
||||||
|
│ │ └──────┬───────┘ └──────────────┘ └──────────────┘ │ │
|
||||||
|
│ │ │ │ │
|
||||||
|
│ │ │ 验签/解密/解析 → InboundMessage │ │
|
||||||
|
│ │ ▼ │ │
|
||||||
|
│ └─────────┼───────────────────────────────────────────────────────────┘ │
|
||||||
|
│ │ │
|
||||||
|
│ ▼ │
|
||||||
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ 消息路由层 (Message Router) │ │
|
||||||
|
│ │ ┌──────────────────────────────────────────────────────────────┐ │ │
|
||||||
|
│ │ │ MessageRouterService (渠道无关) │ │ │
|
||||||
|
│ │ │ - processInboundMessage(InboundMessage) │ │ │
|
||||||
|
│ │ │ - routeBySessionState(Session, InboundMessage) │ │ │
|
||||||
|
│ │ │ - dispatchToAiService(Session, InboundMessage) │ │ │
|
||||||
|
│ │ │ - dispatchToManualCs(Session, InboundMessage) │ │ │
|
||||||
|
│ │ └──────────────────────────────────────────────────────────────┘ │ │
|
||||||
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
||||||
|
│ │ │
|
||||||
|
│ ▼ │
|
||||||
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ 渠道适配层 (Channel Adapter) │ │
|
||||||
|
│ │ ┌──────────────────────────────────────────────────────────────┐ │ │
|
||||||
|
│ │ │ ChannelAdapter 接口 (核心能力) │ │ │
|
||||||
|
│ │ │ - getChannelType() │ │ │
|
||||||
|
│ │ │ - sendMessage(OutboundMessage) │ │ │
|
||||||
|
│ │ └──────────────────────────────────────────────────────────────┘ │ │
|
||||||
|
│ │ ┌──────────────────────────────────────────────────────────────┐ │ │
|
||||||
|
│ │ │ 可选能力接口 (Optional Capabilities) │ │ │
|
||||||
|
│ │ │ - ServiceStateCapable - TransferCapable - MessageSyncCapable│ │ │
|
||||||
|
│ │ └──────────────────────────────────────────────────────────────┘ │ │
|
||||||
|
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
|
||||||
|
│ │ │ WeChatAdapter│ │DouyinAdapter │ │ JdAdapter │ (预留) │ │
|
||||||
|
│ │ │ (已实现) │ │ (预留) │ │ (预留) │ │ │
|
||||||
|
│ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │
|
||||||
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
||||||
|
│ │ │
|
||||||
|
│ ┌─────────────────────────┼─────────────────────────┐ │
|
||||||
|
│ ▼ ▼ ▼ │
|
||||||
|
│ ┌──────────────┐ ┌──────────────────────┐ ┌──────────────┐ │
|
||||||
|
│ │ AI 服务客户端 │ │ 会话管理层 │ │ WebSocket 服务│ │
|
||||||
|
│ │AiServiceClient│ │SessionManagerService │ │WebSocketService│ │
|
||||||
|
│ └──────┬───────┘ └──────────────────────┘ └──────────────┘ │
|
||||||
|
│ │ │
|
||||||
|
└─────────┼───────────────────────────────────────────────────────────────────┘
|
||||||
|
│ HTTP
|
||||||
|
▼
|
||||||
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
||||||
|
│ Python AI 服务 (独立部署) │
|
||||||
|
├─────────────────────────────────────────────────────────────────────────────┤
|
||||||
|
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||||
|
│ │ OpenAI Client│ │DeepSeek Client│ │ 其他模型 │ │
|
||||||
|
│ └──────┬───────┘ └──────┬───────┘ └──────────────┘ │
|
||||||
|
│ │ │ │
|
||||||
|
│ ▼ ▼ │
|
||||||
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ AI 服务核心逻辑 │ │
|
||||||
|
│ │ - /ai/chat 生成 AI 回复 │ │
|
||||||
|
│ │ - /ai/health 健康检查 │ │
|
||||||
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
||||||
|
└─────────────────────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 1.2 模块职责
|
||||||
|
|
||||||
|
| 模块 | 职责 | 关联 AC |
|
||||||
|
|-----|------|--------|
|
||||||
|
| **入口层** | 接收渠道回调，验签/解密/解析，转换为统一的 InboundMessage | AC-MCA-08 |
|
||||||
|
| **消息路由层** | 渠道无关的消息路由，根据会话状态分发到 AI 或人工 | AC-MCA-08 ~ AC-MCA-10 |
|
||||||
|
| **渠道适配层** | 封装各渠道 API 差异，提供统一的消息发送接口 | AC-MCA-01 ~ AC-MCA-03 |
|
||||||
|
| **AI 服务客户端** | 调用 Python AI 服务，处理超时/降级 | AC-MCA-04 ~ AC-MCA-07 |
|
||||||
|
| **会话管理层** | 管理会话生命周期、状态变更、消息持久化 | AC-MCA-11 ~ AC-MCA-12 |
|
||||||
|
| **WebSocket 服务** | 实时推送消息到人工客服工作台 | AC-MCA-10 |
|
||||||
|
| **Python AI 服务** | AI 模型推理、置信度评估、转人工建议 | AC-MCA-04 ~ AC-MCA-05 |
|
||||||
|
|
||||||
|
## 2. 统一消息模型
|
||||||
|
|
||||||
|
### 2.1 入站消息 (InboundMessage)
|
||||||
|
|
||||||
|
```java
|
||||||
|
@Data
|
||||||
|
public class InboundMessage {
|
||||||
|
private String channelType; // 渠道类型: wechat/douyin/jd
|
||||||
|
private String channelMessageId; // 渠道原始消息ID (用于幂等)
|
||||||
|
private String sessionKey; // 会话标识 (customerId + kfId 组合)
|
||||||
|
private String customerId; // 客户ID
|
||||||
|
private String kfId; // 客服账号ID
|
||||||
|
private String sender; // 发送者标识
|
||||||
|
private String content; // 消息内容 (统一字段名)
|
||||||
|
private String msgType; // 消息类型: text/image/voice 等
|
||||||
|
private String rawPayload; // 原始消息体 (JSON/XML)
|
||||||
|
private Long timestamp; // 消息时间戳
|
||||||
|
private SignatureInfo signatureInfo; // 签名信息
|
||||||
|
private Map<String, Object> metadata; // 扩展元数据
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class SignatureInfo {
|
||||||
|
private String signature; // 签名值
|
||||||
|
private String timestamp; // 签名时间戳
|
||||||
|
private String nonce; // 随机数
|
||||||
|
private String algorithm; // 签名算法 (可选)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.2 出站消息 (OutboundMessage)
|
||||||
|
|
||||||
|
```java
|
||||||
|
@Data
|
||||||
|
public class OutboundMessage {
|
||||||
|
private String channelType; // 渠道类型
|
||||||
|
private String receiver; // 接收者ID (customerId)
|
||||||
|
private String kfId; // 客服账号ID
|
||||||
|
private String content; // 消息内容
|
||||||
|
private String msgType; // 消息类型
|
||||||
|
private Map<String, Object> metadata; // 扩展元数据
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.3 字段映射策略
|
||||||
|
|
||||||
|
> **重要**：内部统一使用 `content` 字段名，与 AI 服务契约 (`currentMessage`) 的映射在 AiServiceClient 层处理。
|
||||||
|
|
||||||
|
| 内部字段 | AI 服务契约字段 | 映射位置 |
|
||||||
|
|---------|----------------|---------|
|
||||||
|
| `InboundMessage.content` | `ChatRequest.currentMessage` | `AiServiceClient.generateReply()` |
|
||||||
|
| `InboundMessage.sessionKey` | `ChatRequest.sessionId` | `AiServiceClient.generateReply()` |
|
||||||
|
| `InboundMessage.channelType` | `ChatRequest.channelType` | `AiServiceClient.generateReply()` |
|
||||||
|
|
||||||
|
```java
|
||||||
|
public ChatRequest toChatRequest(InboundMessage msg, List<Message> history) {
|
||||||
|
ChatRequest request = new ChatRequest();
|
||||||
|
request.setSessionId(msg.getSessionKey());
|
||||||
|
request.setCurrentMessage(msg.getContent()); // content → currentMessage
|
||||||
|
request.setChannelType(msg.getChannelType());
|
||||||
|
request.setHistory(history);
|
||||||
|
return request;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 3. 核心接口设计
|
||||||
|
|
||||||
|
### 3.1 渠道适配器接口
|
||||||
|
|
||||||
|
```java
|
||||||
|
// 核心能力接口（所有渠道必须实现）
|
||||||
|
public interface ChannelAdapter {
|
||||||
|
String getChannelType();
|
||||||
|
void sendMessage(OutboundMessage message);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 可选能力接口：服务状态管理
|
||||||
|
public interface ServiceStateCapable {
|
||||||
|
ServiceState getServiceState(String kfId, String customerId);
|
||||||
|
boolean transServiceState(String kfId, String customerId, int newState, String servicerId);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 可选能力接口：转人工
|
||||||
|
public interface TransferCapable {
|
||||||
|
boolean transferToPool(String kfId, String customerId);
|
||||||
|
boolean transferToManual(String kfId, String customerId, String servicerId);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 可选能力接口：消息同步
|
||||||
|
public interface MessageSyncCapable {
|
||||||
|
SyncMsgResponse syncMessages(String kfId, String cursor);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 消息路由服务接口
|
||||||
|
|
||||||
|
```java
|
||||||
|
public interface MessageRouterService {
|
||||||
|
void processInboundMessage(InboundMessage message);
|
||||||
|
void routeBySessionState(Session session, InboundMessage message);
|
||||||
|
void dispatchToAiService(Session session, InboundMessage message);
|
||||||
|
void dispatchToManualCs(Session session, InboundMessage message);
|
||||||
|
void dispatchToPendingPool(Session session, InboundMessage message);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.3 AI 服务客户端接口
|
||||||
|
|
||||||
|
```java
|
||||||
|
public interface AiServiceClient {
|
||||||
|
ChatResponse generateReply(ChatRequest request);
|
||||||
|
boolean healthCheck();
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 4. 核心流程
|
||||||
|
|
||||||
|
### 4.1 消息处理主流程（渠道无关）
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
|
||||||
|
│ 渠道回调入口 │────▶│ 验签/解密/解析 │────▶│ 构建 InboundMessage│
|
||||||
|
│ (Controller) │ │ (渠道专属逻辑) │ │ (统一消息模型) │
|
||||||
|
└──────────────────┘ └────────┬─────────┘ └──────────────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌──────────────────┐
|
||||||
|
│ MessageRouter │
|
||||||
|
│ processInbound │
|
||||||
|
│ Message() │
|
||||||
|
└────────┬─────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌──────────────────┐
|
||||||
|
│ 幂等检查 (msgId) │
|
||||||
|
│ Redis SETNX │
|
||||||
|
└────────┬─────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌──────────────────┐
|
||||||
|
│ 获取/创建会话 │
|
||||||
|
│ SessionManager │
|
||||||
|
└────────┬─────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌──────────────────┐
|
||||||
|
│ 获取渠道服务状态 │
|
||||||
|
│ (可选能力检测) │
|
||||||
|
└────────┬─────────┘
|
||||||
|
│
|
||||||
|
┌───────────────┼───────────────┐
|
||||||
|
▼ ▼ ▼
|
||||||
|
┌──────────┐ ┌──────────┐ ┌──────────┐
|
||||||
|
│ AI 状态 │ │ POOL 状态 │ │MANUAL 状态│
|
||||||
|
│ │ │ │ │ │
|
||||||
|
└────┬─────┘ └────┬─────┘ └────┬─────┘
|
||||||
|
│ │ │
|
||||||
|
▼ ▼ ▼
|
||||||
|
┌──────────────┐ ┌──────────┐ ┌──────────────┐
|
||||||
|
│dispatchTo │ │dispatchTo│ │dispatchTo │
|
||||||
|
│ AiService │ │PendingPool│ │ ManualCs │
|
||||||
|
└──────┬───────┘ └──────────┘ └──────────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌──────────────┐
|
||||||
|
│ 判断是否转人工│
|
||||||
|
│shouldTransfer│
|
||||||
|
└──────┬───────┘
|
||||||
|
│
|
||||||
|
┌───────┴───────┐
|
||||||
|
▼ ▼
|
||||||
|
┌───────┐ ┌──────────────┐
|
||||||
|
│发送回复│ │ 转入待接入池 │
|
||||||
|
│给用户 │ │ TransferCapable│
|
||||||
|
└───────┘ └──────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.2 AI 服务调用流程
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────────────┐
|
||||||
|
│ 构造 ChatRequest │
|
||||||
|
│ sessionId │
|
||||||
|
│ currentMessage │←── content 映射
|
||||||
|
│ channelType │
|
||||||
|
│ history (可选) │
|
||||||
|
└────────┬─────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌──────────────────┐ ┌──────────────────┐
|
||||||
|
│ HTTP POST │────▶│ Python AI 服务 │
|
||||||
|
│ /ai/chat │ │ 超时: 5s │
|
||||||
|
└────────┬─────────┘ └────────┬─────────┘
|
||||||
|
│ │
|
||||||
|
│ ┌──────────────┼──────────────┐
|
||||||
|
│ ▼ ▼ ▼
|
||||||
|
│ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
||||||
|
│ │ 成功响应 │ │ 超时/失败 │ │ 服务不可用│
|
||||||
|
│ │ 200 OK │ │ Timeout │ │ 503 │
|
||||||
|
│ └────┬─────┘ └────┬─────┘ └────┬─────┘
|
||||||
|
│ │ │ │
|
||||||
|
│ ▼ ▼ ▼
|
||||||
|
│ ┌──────────┐ ┌──────────────────────┐
|
||||||
|
│ │ 返回回复 │ │ 降级处理 │
|
||||||
|
│ │ reply │ │ 返回固定回复 │
|
||||||
|
│ │confidence│ │ "正在转接人工客服..." │
|
||||||
|
│ │shouldTransfer│ └──────────┬───────────┘
|
||||||
|
│ └──────────┘ │
|
||||||
|
│ ▼
|
||||||
|
│ ┌──────────────┐
|
||||||
|
│ │ 触发转人工 │
|
||||||
|
│ │ TransferCapable│
|
||||||
|
│ └──────────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌──────────────────┐
|
||||||
|
│ 处理响应 │
|
||||||
|
│ - 保存消息 │
|
||||||
|
│ - 发送给用户 │
|
||||||
|
│ - 判断转人工 │
|
||||||
|
└──────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
## 5. 数据模型
|
||||||
|
|
||||||
|
### 5.1 实体关系图
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────────────┐ ┌──────────────────┐
|
||||||
|
│ Session │ │ Message │
|
||||||
|
├──────────────────┤ ├──────────────────┤
|
||||||
|
│ sessionId (PK) │──────▶│ msgId (PK) │
|
||||||
|
│ customerId │ 1:N │ sessionId (FK) │
|
||||||
|
│ kfId │ │ senderType │
|
||||||
|
│ channelType (新) │ │ senderId │
|
||||||
|
│ status │ │ content │
|
||||||
|
│ wxServiceState │ │ msgType │
|
||||||
|
│ manualCsId │ │ rawData │
|
||||||
|
│ createdAt │ │ createdAt │
|
||||||
|
│ updatedAt │ └──────────────────┘
|
||||||
|
└──────────────────┘
|
||||||
|
│
|
||||||
|
│ 1:N
|
||||||
|
▼
|
||||||
|
┌──────────────────┐
|
||||||
|
│ TransferLog │
|
||||||
|
├──────────────────┤
|
||||||
|
│ id (PK) │
|
||||||
|
│ sessionId (FK) │
|
||||||
|
│ triggerReason │
|
||||||
|
│ triggerTime │
|
||||||
|
│ acceptedCsId │
|
||||||
|
│ acceptedTime │
|
||||||
|
└──────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.2 数据库变更
|
||||||
|
|
||||||
|
> **口径说明**：本次仅做最小 schema 变更，新增 `channel_type` 字段，默认值为 `wechat`；可通过在线 DDL 方式执行；不涉及数据迁移。符合 requirements.md 中"仅增加渠道类型字段，不进行大规模迁移"的范围约定。
|
||||||
|
|
||||||
|
| 表名 | 变更类型 | 变更内容 |
|
||||||
|
|-----|---------|---------|
|
||||||
|
| `session` | 新增字段 | `channel_type VARCHAR(20) DEFAULT 'wechat'` |
|
||||||
|
|
||||||
|
**DDL 示例**：
|
||||||
|
```sql
|
||||||
|
ALTER TABLE session ADD COLUMN channel_type VARCHAR(20) DEFAULT 'wechat'
|
||||||
|
COMMENT '渠道类型: wechat/douyin/jd';
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.3 Redis 缓存结构
|
||||||
|
|
||||||
|
| Key 模式 | 类型 | 说明 | TTL |
|
||||||
|
|---------|------|------|-----|
|
||||||
|
| `wecom:access_token` | String | 微信 access_token | 7200s - 300s |
|
||||||
|
| `wecom:cursor:{openKfId}` | String | 消息同步游标 | 永久 |
|
||||||
|
| `session:status:{sessionId}` | String | 会话状态缓存 | 24h |
|
||||||
|
| `session:msg_count:{sessionId}` | String | 消息计数 | 24h |
|
||||||
|
| `idempotent:{msgId}` | String | 消息幂等键 | 1h |
|
||||||
|
|
||||||
|
## 6. 跨模块调用策略
|
||||||
|
|
||||||
|
### 6.1 AI 服务调用
|
||||||
|
|
||||||
|
| 配置项 | 值 | 说明 |
|
||||||
|
|-------|---|------|
|
||||||
|
| **超时时间** | 5 秒 | 连接 + 读取总超时 |
|
||||||
|
| **重试次数** | 0 | 不重试，直接降级 |
|
||||||
|
| **熔断阈值** | 5 次/分钟 | 连续失败 5 次触发熔断 |
|
||||||
|
| **熔断时间** | 30 秒 | 熔断后等待时间 |
|
||||||
|
| **降级策略** | 返回固定回复 + 转人工 | 见下方降级逻辑 |
|
||||||
|
|
||||||
|
### 6.2 熔断器选型
|
||||||
|
|
||||||
|
> **选型决策**：使用 **Resilience4j** 作为熔断器实现，与 Spring Boot 2.7 兼容。
|
||||||
|
|
||||||
|
| 方案 | 说明 |
|
||||||
|
|-----|------|
|
||||||
|
| **Resilience4j** | 推荐。轻量级，支持断路器、限流、重试，与 Spring Boot 2.7 兼容良好 |
|
||||||
|
| 最小实现 | 仅做 timeout + fallback，不做熔断（不推荐，与 requirements 不一致） |
|
||||||
|
|
||||||
|
**熔断状态存储**：
|
||||||
|
- 单实例：内存存储（CircuitBreakerRegistry）
|
||||||
|
- 多实例：可扩展为 Redis 存储（通过 Resilience4j + Redis 实现）
|
||||||
|
|
||||||
|
**依赖配置**：
|
||||||
|
```xml
|
||||||
|
<dependency>
|
||||||
|
<groupId>io.github.resilience4j</groupId>
|
||||||
|
<artifactId>resilience4j-spring-boot2</artifactId>
|
||||||
|
<version>2.1.0</version>
|
||||||
|
</dependency>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.3 降级逻辑
|
||||||
|
|
||||||
|
```java
|
||||||
|
@Service
|
||||||
|
public class AiServiceClientImpl implements AiServiceClient {
|
||||||
|
|
||||||
|
@CircuitBreaker(name = "aiService", fallbackMethod = "fallback")
|
||||||
|
@TimeLimiter(name = "aiService")
|
||||||
|
public ChatResponse generateReply(ChatRequest request) {
|
||||||
|
// HTTP 调用 Python AI 服务
|
||||||
|
}
|
||||||
|
|
||||||
|
public ChatResponse fallback(ChatRequest request, Throwable cause) {
|
||||||
|
log.warn("AI 服务降级: sessionId={}, cause={}",
|
||||||
|
request.getSessionId(), cause.getMessage());
|
||||||
|
|
||||||
|
ChatResponse response = new ChatResponse();
|
||||||
|
response.setReply("抱歉，我暂时无法回答您的问题，正在为您转接人工客服...");
|
||||||
|
response.setConfidence(0.0);
|
||||||
|
response.setShouldTransfer(true);
|
||||||
|
return response;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.4 错误映射
|
||||||
|
|
||||||
|
| AI 服务错误 | 主框架处理 | 用户感知 |
|
||||||
|
|------------|-----------|---------|
|
||||||
|
| 200 OK | 正常处理 | 返回 AI 回复 |
|
||||||
|
| 400 Bad Request | 记录日志，降级 | 转人工 |
|
||||||
|
| 500 Internal Error | 记录日志，降级 | 转人工 |
|
||||||
|
| 503 Service Unavailable | 记录日志，降级 | 转人工 |
|
||||||
|
| Timeout | 记录日志，降级 | 转人工 |
|
||||||
|
| Connection Refused | 触发熔断，降级 | 转人工 |
|
||||||
|
|
||||||
|
## 7. 消息幂等性设计
|
||||||
|
|
||||||
|
### 7.1 幂等键
|
||||||
|
|
||||||
|
- 使用 `InboundMessage.channelMessageId` 作为幂等键
|
||||||
|
- 微信渠道：使用微信返回的 `msgId`
|
||||||
|
- 其他渠道：使用渠道返回的消息 ID 或生成唯一 ID
|
||||||
|
|
||||||
|
### 7.2 幂等处理流程
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────────────┐
|
||||||
|
│ 收到消息 │
|
||||||
|
│ channelMessageId │
|
||||||
|
└────────┬─────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌──────────────────┐ ┌──────────────────┐
|
||||||
|
│ Redis 检查 │────▶│ Key 不存在 │
|
||||||
|
│ idempotent:{msgId}│ │ 继续处理 │
|
||||||
|
└────────┬─────────┘ └────────┬─────────┘
|
||||||
|
│ │
|
||||||
|
▼ ▼
|
||||||
|
┌──────────────────┐ ┌──────────────────┐
|
||||||
|
│ Key 已存在 │ │ 设置 Key (TTL 1h)│
|
||||||
|
│ 跳过处理 │ │ 处理消息 │
|
||||||
|
└──────────────────┘ └──────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.3 实现代码
|
||||||
|
|
||||||
|
```java
|
||||||
|
public boolean processMessageIdempotent(String channelMessageId, Runnable processor) {
|
||||||
|
String key = "idempotent:" + channelMessageId;
|
||||||
|
Boolean absent = redisTemplate.opsForValue()
|
||||||
|
.setIfAbsent(key, "1", 1, TimeUnit.HOURS);
|
||||||
|
|
||||||
|
if (Boolean.TRUE.equals(absent)) {
|
||||||
|
processor.run();
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("重复消息，跳过处理: channelMessageId={}", channelMessageId);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 8. 配置管理
|
||||||
|
|
||||||
|
### 8.1 新增配置项
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# application.yml 新增配置
|
||||||
|
ai-service:
|
||||||
|
url: http://ai-service:8080
|
||||||
|
timeout: 5000
|
||||||
|
|
||||||
|
resilience4j:
|
||||||
|
circuitbreaker:
|
||||||
|
instances:
|
||||||
|
aiService:
|
||||||
|
failure-rate-threshold: 50
|
||||||
|
sliding-window-size: 10
|
||||||
|
sliding-window-type: COUNT_BASED
|
||||||
|
wait-duration-in-open-state: 30s
|
||||||
|
permitted-number-of-calls-in-half-open-state: 3
|
||||||
|
timelimiter:
|
||||||
|
instances:
|
||||||
|
aiService:
|
||||||
|
timeout-duration: 5s
|
||||||
|
|
||||||
|
channel:
|
||||||
|
default: wechat
|
||||||
|
adapters:
|
||||||
|
wechat:
|
||||||
|
enabled: true
|
||||||
|
douyin:
|
||||||
|
enabled: false
|
||||||
|
jd:
|
||||||
|
enabled: false
|
||||||
|
```
|
||||||
|
|
||||||
|
### 8.2 配置类
|
||||||
|
|
||||||
|
```java
|
||||||
|
@Data
|
||||||
|
@Component
|
||||||
|
@ConfigurationProperties(prefix = "ai-service")
|
||||||
|
public class AiServiceConfig {
|
||||||
|
private String url;
|
||||||
|
private int timeout = 5000;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@Component
|
||||||
|
@ConfigurationProperties(prefix = "channel")
|
||||||
|
public class ChannelConfig {
|
||||||
|
private String default;
|
||||||
|
private Map<String, AdapterConfig> adapters;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class AdapterConfig {
|
||||||
|
private boolean enabled;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 9. 部署架构
|
||||||
|
|
||||||
|
### 9.1 部署拓扑
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────────────────────┐
|
||||||
|
│ 负载均衡器 │
|
||||||
|
└─────────────────────────────┬───────────────────────────────┘
|
||||||
|
│
|
||||||
|
┌───────────────┼───────────────┐
|
||||||
|
▼ ▼ ▼
|
||||||
|
┌──────────┐ ┌──────────┐ ┌──────────┐
|
||||||
|
│ Java 主 │ │ Java 主 │ │ Java 主 │
|
||||||
|
│ 框架实例1│ │ 框架实例2│ │ 框架实例3│
|
||||||
|
└────┬─────┘ └────┬─────┘ └────┬─────┘
|
||||||
|
│ │ │
|
||||||
|
└──────────────┼──────────────┘
|
||||||
|
│
|
||||||
|
┌──────────────────┼──────────────────┐
|
||||||
|
▼ ▼ ▼
|
||||||
|
┌──────────┐ ┌──────────┐ ┌──────────┐
|
||||||
|
│ Redis │ │ MySQL │ │Python AI │
|
||||||
|
│ (Cluster)│ │ (Master) │ │ 服务 │
|
||||||
|
└──────────┘ └──────────┘ └──────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 9.2 服务依赖
|
||||||
|
|
||||||
|
| 服务 | 依赖关系 | 健康检查 |
|
||||||
|
|-----|---------|---------|
|
||||||
|
| Java 主框架 | 依赖 Redis, MySQL, Python AI | `/actuator/health` |
|
||||||
|
| Python AI 服务 | 无外部依赖 | `/ai/health` |
|
||||||
|
|
||||||
|
## 10. 安全设计
|
||||||
|
|
||||||
|
### 10.1 渠道回调鉴权
|
||||||
|
|
||||||
|
| 渠道 | 鉴权方式 | 验证逻辑 |
|
||||||
|
|-----|---------|---------|
|
||||||
|
| 微信 | msg_signature + timestamp + nonce | **沿用现有 WeCom 官方验签/解密方案**（复用现有 `WXBizMsgCrypt` 实现） |
|
||||||
|
| 抖音 | X-Signature + X-Timestamp | 待实现 |
|
||||||
|
| 京东 | signature + timestamp | 待实现 |
|
||||||
|
|
||||||
|
> **说明**：微信回调验签/加解密使用企业微信官方方案，具体算法细节封装在现有 `WXBizMsgCrypt` 类中，不在本设计文档展开。
|
||||||
|
|
||||||
|
### 10.2 内部服务鉴权
|
||||||
|
|
||||||
|
- Java 主框架 → Python AI 服务：内网调用，无需鉴权（可扩展为 mTLS）
|
||||||
|
- WebSocket 连接：路径参数 `{csId}` 标识身份（可扩展为 Token 验证）
|
||||||
|
|
||||||
|
## 11. 监控与告警
|
||||||
|
|
||||||
|
> **说明**：本节为后续演进预留，MVP 阶段可暂不实现。
|
||||||
|
|
||||||
|
### 11.1 关键指标
|
||||||
|
|
||||||
|
| 指标 | 类型 | 说明 |
|
||||||
|
|-----|------|------|
|
||||||
|
| `ai.service.latency` | Histogram | AI 服务调用延迟 |
|
||||||
|
| `ai.service.error.rate` | Counter | AI 服务错误率 |
|
||||||
|
| `ai.service.circuit.breaker.open` | Gauge | 熔断器状态 |
|
||||||
|
| `message.process.count` | Counter | 消息处理数量 |
|
||||||
|
| `message.idempotent.skip` | Counter | 幂等跳过数量 |
|
||||||
|
| `session.active.count` | Gauge | 活跃会话数 |
|
||||||
|
|
||||||
|
### 11.2 告警规则
|
||||||
|
|
||||||
|
| 规则 | 条件 | 级别 |
|
||||||
|
|-----|------|------|
|
||||||
|
| AI 服务不可用 | 连续失败 5 次 | Critical |
|
||||||
|
| AI 服务延迟过高 | P99 > 3s | Warning |
|
||||||
|
| 熔断器触发 | circuit.breaker.open = 1 | Critical |
|
||||||
|
|
@ -0,0 +1,188 @@
|
||||||
|
openapi: 3.0.3
|
||||||
|
info:
|
||||||
|
title: AI Service API
|
||||||
|
description: |
|
||||||
|
Python AI 服务接口契约。
|
||||||
|
|
||||||
|
本文件定义主框架对 AI 服务的接口需求（Consumer-First）。
|
||||||
|
由主框架作为调用方，Python AI 服务作为提供方实现。
|
||||||
|
version: 1.0.0
|
||||||
|
x-contract-level: L0
|
||||||
|
x-consumer: "java-main-framework"
|
||||||
|
x-provider: "python-ai-service"
|
||||||
|
|
||||||
|
servers:
|
||||||
|
- url: http://ai-service:8080
|
||||||
|
description: AI 服务地址
|
||||||
|
|
||||||
|
paths:
|
||||||
|
/ai/chat:
|
||||||
|
post:
|
||||||
|
operationId: generateReply
|
||||||
|
summary: 生成 AI 回复
|
||||||
|
description: |
|
||||||
|
根据用户消息和会话历史生成 AI 回复。
|
||||||
|
|
||||||
|
覆盖验收标准：
|
||||||
|
- AC-MCA-04: 主框架通过 HTTP POST 调用 AI 服务
|
||||||
|
- AC-MCA-05: 响应包含 reply、confidence、shouldTransfer 字段
|
||||||
|
- AC-MCA-06: AI 服务不可用时的降级处理（主框架侧实现）
|
||||||
|
- AC-MCA-07: 超时处理（主框架侧实现）
|
||||||
|
tags:
|
||||||
|
- AI Chat
|
||||||
|
x-requirements:
|
||||||
|
- AC-MCA-04
|
||||||
|
- AC-MCA-04-REQ
|
||||||
|
- AC-MCA-04-OPT
|
||||||
|
- AC-MCA-05
|
||||||
|
- AC-MCA-06
|
||||||
|
- AC-MCA-07
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ChatRequest'
|
||||||
|
example:
|
||||||
|
sessionId: "kf_001_wx123456_1708765432000"
|
||||||
|
currentMessage: "我想了解产品价格"
|
||||||
|
channelType: "wechat"
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 成功生成回复
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ChatResponse'
|
||||||
|
example:
|
||||||
|
reply: "您好，我们的产品价格根据套餐不同有所差异。"
|
||||||
|
confidence: 0.92
|
||||||
|
shouldTransfer: false
|
||||||
|
'400':
|
||||||
|
description: 请求参数错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ErrorResponse'
|
||||||
|
'500':
|
||||||
|
description: 服务内部错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ErrorResponse'
|
||||||
|
'503':
|
||||||
|
description: 服务不可用
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ErrorResponse'
|
||||||
|
|
||||||
|
/ai/health:
|
||||||
|
get:
|
||||||
|
operationId: healthCheck
|
||||||
|
summary: 健康检查
|
||||||
|
description: 检查 AI 服务是否正常运行
|
||||||
|
tags:
|
||||||
|
- Health
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 服务正常
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
status:
|
||||||
|
type: string
|
||||||
|
'503':
|
||||||
|
description: 服务不健康
|
||||||
|
|
||||||
|
components:
|
||||||
|
schemas:
|
||||||
|
ChatRequest:
|
||||||
|
type: object
|
||||||
|
required:
|
||||||
|
- sessionId
|
||||||
|
- currentMessage
|
||||||
|
- channelType
|
||||||
|
properties:
|
||||||
|
sessionId:
|
||||||
|
type: string
|
||||||
|
description: 会话ID（AC-MCA-04-REQ 必填）
|
||||||
|
currentMessage:
|
||||||
|
type: string
|
||||||
|
description: 当前用户消息（AC-MCA-04-REQ 必填）
|
||||||
|
channelType:
|
||||||
|
type: string
|
||||||
|
description: 渠道类型（AC-MCA-04-REQ 必填）
|
||||||
|
enum:
|
||||||
|
- wechat
|
||||||
|
- douyin
|
||||||
|
- jd
|
||||||
|
history:
|
||||||
|
type: array
|
||||||
|
description: 历史消息列表（AC-MCA-04-OPT 可选）
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/ChatMessage'
|
||||||
|
metadata:
|
||||||
|
type: object
|
||||||
|
description: 扩展元数据（AC-MCA-04-OPT 可选）
|
||||||
|
additionalProperties: true
|
||||||
|
|
||||||
|
ChatMessage:
|
||||||
|
type: object
|
||||||
|
required:
|
||||||
|
- role
|
||||||
|
- content
|
||||||
|
properties:
|
||||||
|
role:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- user
|
||||||
|
- assistant
|
||||||
|
content:
|
||||||
|
type: string
|
||||||
|
|
||||||
|
ChatResponse:
|
||||||
|
type: object
|
||||||
|
required:
|
||||||
|
- reply
|
||||||
|
- confidence
|
||||||
|
- shouldTransfer
|
||||||
|
properties:
|
||||||
|
reply:
|
||||||
|
type: string
|
||||||
|
description: AI 回复内容（AC-MCA-05 必填）
|
||||||
|
confidence:
|
||||||
|
type: number
|
||||||
|
format: double
|
||||||
|
description: 置信度评分 0.0-1.0（AC-MCA-05 必填）
|
||||||
|
shouldTransfer:
|
||||||
|
type: boolean
|
||||||
|
description: 是否建议转人工（AC-MCA-05 必填）
|
||||||
|
transferReason:
|
||||||
|
type: string
|
||||||
|
description: 转人工原因（可选）
|
||||||
|
metadata:
|
||||||
|
type: object
|
||||||
|
description: 响应元数据（可选）
|
||||||
|
additionalProperties: true
|
||||||
|
|
||||||
|
ErrorResponse:
|
||||||
|
type: object
|
||||||
|
required:
|
||||||
|
- code
|
||||||
|
- message
|
||||||
|
properties:
|
||||||
|
code:
|
||||||
|
type: string
|
||||||
|
description: 错误代码
|
||||||
|
message:
|
||||||
|
type: string
|
||||||
|
description: 错误消息
|
||||||
|
details:
|
||||||
|
type: array
|
||||||
|
description: 详细错误信息（可选）
|
||||||
|
items:
|
||||||
|
type: object
|
||||||
|
additionalProperties: true
|
||||||
|
|
@ -0,0 +1,894 @@
|
||||||
|
openapi: 3.0.3
|
||||||
|
info:
|
||||||
|
title: Multi-Channel Customer Service API
|
||||||
|
description: |
|
||||||
|
多渠道客服主框架对外提供的 API 契约。
|
||||||
|
|
||||||
|
本文件定义主框架对外提供的能力（Provider）：
|
||||||
|
- 渠道消息回调接口（微信、抖音、京东等）
|
||||||
|
- 人工客服工作台 REST API
|
||||||
|
- WebSocket 实时通信协议说明
|
||||||
|
version: 1.0.0
|
||||||
|
x-contract-level: L2
|
||||||
|
x-consumer: "frontend, wechat-server, douyin-server, jd-server"
|
||||||
|
x-provider: "java-main-framework"
|
||||||
|
|
||||||
|
servers:
|
||||||
|
- url: http://{host}:{port}
|
||||||
|
description: |
|
||||||
|
服务地址占位符，根据环境替换：
|
||||||
|
- 开发环境: http://localhost:8080
|
||||||
|
- 测试环境: http://ai-robot-test:8080
|
||||||
|
- 生产环境: http://ai-robot:8080
|
||||||
|
variables:
|
||||||
|
host:
|
||||||
|
default: localhost
|
||||||
|
description: 服务主机名
|
||||||
|
port:
|
||||||
|
default: "8080"
|
||||||
|
description: 服务端口
|
||||||
|
|
||||||
|
tags:
|
||||||
|
- name: Channel Callback
|
||||||
|
description: 渠道消息回调接口
|
||||||
|
- name: Session Management
|
||||||
|
description: 会话管理接口
|
||||||
|
- name: WebSocket
|
||||||
|
description: WebSocket 实时通信
|
||||||
|
|
||||||
|
paths:
|
||||||
|
/wecom/callback:
|
||||||
|
get:
|
||||||
|
operationId: verifyWecomUrl
|
||||||
|
summary: 微信回调 URL 验证
|
||||||
|
description: |
|
||||||
|
企业微信回调 URL 验证接口。
|
||||||
|
|
||||||
|
用于验证回调 URL 的有效性，企业微信在配置回调时会发送 GET 请求。
|
||||||
|
tags:
|
||||||
|
- Channel Callback
|
||||||
|
parameters:
|
||||||
|
- name: msg_signature
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 128
|
||||||
|
description: 消息签名，用于验证请求来源
|
||||||
|
- name: timestamp
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
pattern: '^\d+$'
|
||||||
|
description: 时间戳（秒级），用于防重放攻击
|
||||||
|
- name: nonce
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 64
|
||||||
|
description: 随机字符串，用于防重放攻击
|
||||||
|
- name: echostr
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
description: 加密的随机字符串，验证成功后需解密返回
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 验证成功，返回解密后的 echostr
|
||||||
|
content:
|
||||||
|
text/plain:
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
example: "1234567890"
|
||||||
|
'400':
|
||||||
|
description: 请求参数错误
|
||||||
|
content:
|
||||||
|
text/plain:
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- error
|
||||||
|
'401':
|
||||||
|
description: 签名验证失败
|
||||||
|
content:
|
||||||
|
text/plain:
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- error
|
||||||
|
'500':
|
||||||
|
description: 服务器内部错误
|
||||||
|
content:
|
||||||
|
text/plain:
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- error
|
||||||
|
|
||||||
|
post:
|
||||||
|
operationId: handleWecomCallback
|
||||||
|
summary: 微信回调消息处理
|
||||||
|
description: |
|
||||||
|
企业微信回调消息处理入口。
|
||||||
|
|
||||||
|
覆盖验收标准：
|
||||||
|
- AC-MCA-08: 根据渠道类型路由到对应的渠道适配器
|
||||||
|
|
||||||
|
消息处理流程：
|
||||||
|
1. 接收加密的 XML 消息
|
||||||
|
2. 解密并解析消息内容
|
||||||
|
3. 根据消息类型路由处理
|
||||||
|
4. 返回 success 确认
|
||||||
|
tags:
|
||||||
|
- Channel Callback
|
||||||
|
x-requirements:
|
||||||
|
- AC-MCA-08
|
||||||
|
parameters:
|
||||||
|
- name: msg_signature
|
||||||
|
in: query
|
||||||
|
required: false
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
maxLength: 128
|
||||||
|
description: 消息签名（用于验签）
|
||||||
|
- name: timestamp
|
||||||
|
in: query
|
||||||
|
required: false
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
pattern: '^\d+$'
|
||||||
|
description: 时间戳（用于防重放）
|
||||||
|
- name: nonce
|
||||||
|
in: query
|
||||||
|
required: false
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
maxLength: 64
|
||||||
|
description: 随机数（用于防重放）
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/xml:
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
description: 加密的 XML 消息
|
||||||
|
example: "<xml><Encrypt>...</Encrypt></xml>"
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 处理成功
|
||||||
|
content:
|
||||||
|
text/plain:
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- success
|
||||||
|
'400':
|
||||||
|
description: 请求格式错误
|
||||||
|
content:
|
||||||
|
text/plain:
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- success
|
||||||
|
'401':
|
||||||
|
description: 签名验证失败
|
||||||
|
content:
|
||||||
|
text/plain:
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- success
|
||||||
|
'500':
|
||||||
|
description: 服务器内部错误（仍返回 success 以避免微信重试）
|
||||||
|
content:
|
||||||
|
text/plain:
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- success
|
||||||
|
|
||||||
|
/channel/{channelType}/callback:
|
||||||
|
post:
|
||||||
|
operationId: handleChannelCallback
|
||||||
|
summary: 通用渠道回调接口（预留）
|
||||||
|
description: |
|
||||||
|
通用渠道消息回调接口，用于接入新渠道。
|
||||||
|
|
||||||
|
当前为预留接口，后续实现抖音、京东等渠道时使用。
|
||||||
|
|
||||||
|
### 鉴权/签名机制（各渠道实现时需补充）
|
||||||
|
不同渠道需要不同的验签方式，建议通过以下方式传递：
|
||||||
|
|
||||||
|
**方式一：Header 传递**
|
||||||
|
- `X-Signature`: 消息签名
|
||||||
|
- `X-Timestamp`: 时间戳（防重放）
|
||||||
|
- `X-Nonce`: 随机数（防重放）
|
||||||
|
|
||||||
|
**方式二：Query 参数传递**
|
||||||
|
- `signature`: 消息签名
|
||||||
|
- `timestamp`: 时间戳
|
||||||
|
- `nonce`: 随机数
|
||||||
|
|
||||||
|
**方式三：Body 内嵌**
|
||||||
|
- requestBody 中包含 `rawPayload` + `signature` 字段
|
||||||
|
|
||||||
|
具体签名算法（HMAC-SHA256、RSA 等）由各渠道适配器实现时确定。
|
||||||
|
tags:
|
||||||
|
- Channel Callback
|
||||||
|
parameters:
|
||||||
|
- name: channelType
|
||||||
|
in: path
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- wechat
|
||||||
|
- douyin
|
||||||
|
- jd
|
||||||
|
description: 渠道类型
|
||||||
|
- name: X-Signature
|
||||||
|
in: header
|
||||||
|
required: false
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
maxLength: 256
|
||||||
|
description: 消息签名（可选，具体由渠道决定）
|
||||||
|
- name: X-Timestamp
|
||||||
|
in: header
|
||||||
|
required: false
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
pattern: '^\d+$'
|
||||||
|
description: 时间戳（可选，用于防重放）
|
||||||
|
- name: X-Nonce
|
||||||
|
in: header
|
||||||
|
required: false
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
maxLength: 64
|
||||||
|
description: 随机数（可选，用于防重放）
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
description: 渠道消息体（格式由各渠道定义）
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 处理成功
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'400':
|
||||||
|
description: 请求格式错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'401':
|
||||||
|
description: 签名验证失败
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'404':
|
||||||
|
description: 不支持的渠道类型
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'500':
|
||||||
|
description: 服务器内部错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
/api/sessions:
|
||||||
|
get:
|
||||||
|
operationId: getSessions
|
||||||
|
summary: 获取会话列表
|
||||||
|
description: |
|
||||||
|
获取客服工作台的会话列表。
|
||||||
|
|
||||||
|
覆盖验收标准：
|
||||||
|
- AC-MCA-12: 支持按渠道类型筛选
|
||||||
|
tags:
|
||||||
|
- Session Management
|
||||||
|
x-requirements:
|
||||||
|
- AC-MCA-12
|
||||||
|
parameters:
|
||||||
|
- name: status
|
||||||
|
in: query
|
||||||
|
required: false
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- ai
|
||||||
|
- pending
|
||||||
|
- manual
|
||||||
|
- closed
|
||||||
|
description: 会话状态筛选
|
||||||
|
- name: csId
|
||||||
|
in: query
|
||||||
|
required: false
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
maxLength: 64
|
||||||
|
description: 客服ID筛选
|
||||||
|
- name: channelType
|
||||||
|
in: query
|
||||||
|
required: false
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- wechat
|
||||||
|
- douyin
|
||||||
|
- jd
|
||||||
|
description: 渠道类型筛选
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 成功
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/SessionListResponse'
|
||||||
|
'400':
|
||||||
|
description: 请求参数错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'500':
|
||||||
|
description: 服务器内部错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
/api/sessions/{sessionId}:
|
||||||
|
get:
|
||||||
|
operationId: getSession
|
||||||
|
summary: 获取会话详情
|
||||||
|
description: |
|
||||||
|
获取指定会话的详细信息。
|
||||||
|
tags:
|
||||||
|
- Session Management
|
||||||
|
parameters:
|
||||||
|
- name: sessionId
|
||||||
|
in: path
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 64
|
||||||
|
description: 会话ID
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 成功
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/SessionResponse'
|
||||||
|
'400':
|
||||||
|
description: 请求参数错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'404':
|
||||||
|
description: 会话不存在
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'500':
|
||||||
|
description: 服务器内部错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
/api/sessions/{sessionId}/history:
|
||||||
|
get:
|
||||||
|
operationId: getSessionHistory
|
||||||
|
summary: 获取会话消息历史
|
||||||
|
description: |
|
||||||
|
获取指定会话的消息历史记录。
|
||||||
|
tags:
|
||||||
|
- Session Management
|
||||||
|
parameters:
|
||||||
|
- name: sessionId
|
||||||
|
in: path
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 64
|
||||||
|
description: 会话ID
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 成功
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/MessageListResponse'
|
||||||
|
'400':
|
||||||
|
description: 请求参数错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'404':
|
||||||
|
description: 会话不存在
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'500':
|
||||||
|
description: 服务器内部错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
/api/sessions/{sessionId}/accept:
|
||||||
|
post:
|
||||||
|
operationId: acceptSession
|
||||||
|
summary: 接入会话
|
||||||
|
description: |
|
||||||
|
客服接入待处理的会话。
|
||||||
|
|
||||||
|
仅状态为 `pending` 的会话可被接入。
|
||||||
|
tags:
|
||||||
|
- Session Management
|
||||||
|
parameters:
|
||||||
|
- name: sessionId
|
||||||
|
in: path
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 64
|
||||||
|
description: 会话ID
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
required:
|
||||||
|
- csId
|
||||||
|
properties:
|
||||||
|
csId:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 64
|
||||||
|
description: 客服ID
|
||||||
|
example:
|
||||||
|
csId: "cs_001"
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 接入成功
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'400':
|
||||||
|
description: 会话状态不正确或参数错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
examples:
|
||||||
|
invalid_status:
|
||||||
|
value:
|
||||||
|
code: 400
|
||||||
|
message: "会话状态不正确"
|
||||||
|
missing_csId:
|
||||||
|
value:
|
||||||
|
code: 400
|
||||||
|
message: "客服ID不能为空"
|
||||||
|
'404':
|
||||||
|
description: 会话不存在
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
example:
|
||||||
|
code: 404
|
||||||
|
message: "会话不存在"
|
||||||
|
'500':
|
||||||
|
description: 服务器内部错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
/api/sessions/{sessionId}/message:
|
||||||
|
post:
|
||||||
|
operationId: sendSessionMessage
|
||||||
|
summary: 发送消息
|
||||||
|
description: |
|
||||||
|
客服向会话发送消息。
|
||||||
|
|
||||||
|
仅状态为 `manual` 的会话可发送消息。
|
||||||
|
tags:
|
||||||
|
- Session Management
|
||||||
|
parameters:
|
||||||
|
- name: sessionId
|
||||||
|
in: path
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 64
|
||||||
|
description: 会话ID
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
required:
|
||||||
|
- content
|
||||||
|
properties:
|
||||||
|
content:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 4096
|
||||||
|
description: 消息内容
|
||||||
|
msgType:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- text
|
||||||
|
- image
|
||||||
|
- file
|
||||||
|
default: text
|
||||||
|
description: 消息类型
|
||||||
|
example:
|
||||||
|
content: "您好，请问有什么可以帮助您的？"
|
||||||
|
msgType: "text"
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 发送成功
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'400':
|
||||||
|
description: 会话状态不正确或参数错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
examples:
|
||||||
|
invalid_status:
|
||||||
|
value:
|
||||||
|
code: 400
|
||||||
|
message: "会话状态不正确"
|
||||||
|
missing_content:
|
||||||
|
value:
|
||||||
|
code: 400
|
||||||
|
message: "消息内容不能为空"
|
||||||
|
'404':
|
||||||
|
description: 会话不存在
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'500':
|
||||||
|
description: 服务器内部错误或消息发送失败
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
/api/sessions/{sessionId}/close:
|
||||||
|
post:
|
||||||
|
operationId: closeSession
|
||||||
|
summary: 关闭会话
|
||||||
|
description: |
|
||||||
|
关闭指定的会话。
|
||||||
|
tags:
|
||||||
|
- Session Management
|
||||||
|
parameters:
|
||||||
|
- name: sessionId
|
||||||
|
in: path
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 64
|
||||||
|
description: 会话ID
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 关闭成功
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'400':
|
||||||
|
description: 请求参数错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'404':
|
||||||
|
description: 会话不存在
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
'500':
|
||||||
|
description: 服务器内部错误
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
components:
|
||||||
|
schemas:
|
||||||
|
ApiResponse:
|
||||||
|
type: object
|
||||||
|
required:
|
||||||
|
- code
|
||||||
|
- message
|
||||||
|
properties:
|
||||||
|
code:
|
||||||
|
type: integer
|
||||||
|
description: 响应码（0=成功，非0=失败）
|
||||||
|
enum:
|
||||||
|
- 0
|
||||||
|
- 400
|
||||||
|
- 404
|
||||||
|
- 500
|
||||||
|
message:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 256
|
||||||
|
description: 响应消息
|
||||||
|
data:
|
||||||
|
type: object
|
||||||
|
description: 响应数据（可选）
|
||||||
|
example:
|
||||||
|
code: 0
|
||||||
|
message: "success"
|
||||||
|
|
||||||
|
SessionListResponse:
|
||||||
|
allOf:
|
||||||
|
- $ref: '#/components/schemas/ApiResponse'
|
||||||
|
- type: object
|
||||||
|
required:
|
||||||
|
- code
|
||||||
|
- message
|
||||||
|
- data
|
||||||
|
properties:
|
||||||
|
code:
|
||||||
|
type: integer
|
||||||
|
enum:
|
||||||
|
- 0
|
||||||
|
message:
|
||||||
|
type: string
|
||||||
|
data:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/SessionInfo'
|
||||||
|
example:
|
||||||
|
code: 0
|
||||||
|
message: "success"
|
||||||
|
data:
|
||||||
|
- sessionId: "session_001"
|
||||||
|
customerId: "customer_001"
|
||||||
|
status: "manual"
|
||||||
|
channelType: "wechat"
|
||||||
|
|
||||||
|
SessionResponse:
|
||||||
|
allOf:
|
||||||
|
- $ref: '#/components/schemas/ApiResponse'
|
||||||
|
- type: object
|
||||||
|
required:
|
||||||
|
- code
|
||||||
|
- message
|
||||||
|
- data
|
||||||
|
properties:
|
||||||
|
code:
|
||||||
|
type: integer
|
||||||
|
enum:
|
||||||
|
- 0
|
||||||
|
message:
|
||||||
|
type: string
|
||||||
|
data:
|
||||||
|
$ref: '#/components/schemas/SessionInfo'
|
||||||
|
|
||||||
|
SessionInfo:
|
||||||
|
type: object
|
||||||
|
required:
|
||||||
|
- sessionId
|
||||||
|
- customerId
|
||||||
|
- status
|
||||||
|
properties:
|
||||||
|
sessionId:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 64
|
||||||
|
description: 会话ID
|
||||||
|
customerId:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 64
|
||||||
|
description: 客户ID
|
||||||
|
kfId:
|
||||||
|
type: string
|
||||||
|
maxLength: 64
|
||||||
|
description: 客服账号ID
|
||||||
|
channelType:
|
||||||
|
type: string
|
||||||
|
description: 渠道类型
|
||||||
|
enum:
|
||||||
|
- wechat
|
||||||
|
- douyin
|
||||||
|
- jd
|
||||||
|
status:
|
||||||
|
type: string
|
||||||
|
description: 会话状态
|
||||||
|
enum:
|
||||||
|
- ai
|
||||||
|
- pending
|
||||||
|
- manual
|
||||||
|
- closed
|
||||||
|
manualCsId:
|
||||||
|
type: string
|
||||||
|
maxLength: 64
|
||||||
|
description: 接待客服ID
|
||||||
|
lastMessage:
|
||||||
|
type: string
|
||||||
|
maxLength: 4096
|
||||||
|
description: 最后一条消息
|
||||||
|
lastMessageTime:
|
||||||
|
type: string
|
||||||
|
format: date-time
|
||||||
|
description: 最后消息时间
|
||||||
|
messageCount:
|
||||||
|
type: integer
|
||||||
|
minimum: 0
|
||||||
|
description: 消息数量
|
||||||
|
createdAt:
|
||||||
|
type: string
|
||||||
|
format: date-time
|
||||||
|
description: 创建时间
|
||||||
|
updatedAt:
|
||||||
|
type: string
|
||||||
|
format: date-time
|
||||||
|
description: 更新时间
|
||||||
|
metadata:
|
||||||
|
type: object
|
||||||
|
description: 扩展元数据
|
||||||
|
|
||||||
|
MessageListResponse:
|
||||||
|
allOf:
|
||||||
|
- $ref: '#/components/schemas/ApiResponse'
|
||||||
|
- type: object
|
||||||
|
required:
|
||||||
|
- code
|
||||||
|
- message
|
||||||
|
- data
|
||||||
|
properties:
|
||||||
|
code:
|
||||||
|
type: integer
|
||||||
|
enum:
|
||||||
|
- 0
|
||||||
|
message:
|
||||||
|
type: string
|
||||||
|
data:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/MessageInfo'
|
||||||
|
|
||||||
|
MessageInfo:
|
||||||
|
type: object
|
||||||
|
required:
|
||||||
|
- msgId
|
||||||
|
- sessionId
|
||||||
|
- senderType
|
||||||
|
- content
|
||||||
|
properties:
|
||||||
|
msgId:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 128
|
||||||
|
description: 消息ID
|
||||||
|
sessionId:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 64
|
||||||
|
description: 会话ID
|
||||||
|
senderType:
|
||||||
|
type: string
|
||||||
|
description: 发送者类型
|
||||||
|
enum:
|
||||||
|
- customer
|
||||||
|
- ai
|
||||||
|
- manual
|
||||||
|
senderId:
|
||||||
|
type: string
|
||||||
|
maxLength: 64
|
||||||
|
description: 发送者ID
|
||||||
|
content:
|
||||||
|
type: string
|
||||||
|
minLength: 1
|
||||||
|
maxLength: 4096
|
||||||
|
description: 消息内容
|
||||||
|
msgType:
|
||||||
|
type: string
|
||||||
|
description: 消息类型
|
||||||
|
enum:
|
||||||
|
- text
|
||||||
|
- image
|
||||||
|
- file
|
||||||
|
- event
|
||||||
|
createdAt:
|
||||||
|
type: string
|
||||||
|
format: date-time
|
||||||
|
description: 创建时间
|
||||||
|
|
||||||
|
x-websocket:
|
||||||
|
path: /ws/cs/{csId}
|
||||||
|
description: |
|
||||||
|
## WebSocket 实时通信协议
|
||||||
|
|
||||||
|
客服工作台通过 WebSocket 接收实时消息推送。
|
||||||
|
|
||||||
|
覆盖验收标准：
|
||||||
|
- AC-MCA-10: 会话状态为 MANUAL 时推送消息到人工客服工作台
|
||||||
|
|
||||||
|
### 连接地址
|
||||||
|
```
|
||||||
|
ws://{host}:{port}/ws/cs/{csId}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 认证/鉴权方式
|
||||||
|
- **路径参数**: `{csId}` 客服ID，用于标识连接身份
|
||||||
|
- **可选增强**: 后续可增加 Token 验证（Query 参数或 Header）
|
||||||
|
- Query: `?token=xxx`
|
||||||
|
- Header: `Authorization: Bearer xxx`
|
||||||
|
|
||||||
|
### 客户端发送消息格式
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"type": "bind_session",
|
||||||
|
"sessionId": "会话ID"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 服务端推送消息格式
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"type": "new_message",
|
||||||
|
"sessionId": "会话ID",
|
||||||
|
"data": {
|
||||||
|
"msgId": "消息ID",
|
||||||
|
"content": "消息内容",
|
||||||
|
"senderType": "customer",
|
||||||
|
"senderId": "客户ID",
|
||||||
|
"msgType": "text",
|
||||||
|
"createdAt": "2026-02-24T10:00:00"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 推送事件类型
|
||||||
|
| type | 说明 |
|
||||||
|
|------|------|
|
||||||
|
| new_message | 新消息通知 |
|
||||||
|
| new_pending_session | 新待接入会话 |
|
||||||
|
| session_accepted | 会话被接入 |
|
||||||
|
| session_closed | 会话已关闭 |
|
||||||
|
|
@ -0,0 +1,189 @@
|
||||||
|
---
|
||||||
|
feature_id: "MCA"
|
||||||
|
title: "多渠道适配主框架架构改造"
|
||||||
|
status: "draft"
|
||||||
|
version: "0.2.0"
|
||||||
|
owners:
|
||||||
|
- "backend"
|
||||||
|
- "architect"
|
||||||
|
last_updated: "2026-02-24"
|
||||||
|
source:
|
||||||
|
type: "conversation"
|
||||||
|
ref: "架构改造需求"
|
||||||
|
---
|
||||||
|
|
||||||
|
# 多渠道适配主框架架构改造（MCA）
|
||||||
|
|
||||||
|
## 1. 背景与目标
|
||||||
|
|
||||||
|
### 1.1 背景
|
||||||
|
|
||||||
|
当前系统为"企业微信智能客服系统"，核心逻辑围绕企业微信客服 API 构建：
|
||||||
|
- 微信消息接收、加解密、同步
|
||||||
|
- AI 回复生成（紧耦合在 Java 主应用中）
|
||||||
|
- 会话状态管理、转人工逻辑
|
||||||
|
- 人工客服工作台（WebSocket）
|
||||||
|
|
||||||
|
随着业务扩展，需要接入更多渠道（抖音、京东等），同时 AI 服务需要独立演进（支持多模型、Prompt 工程、RAG 等）。当前架构存在以下问题：
|
||||||
|
|
||||||
|
1. **渠道耦合**：AI 服务、消息处理与微信 API 紧密耦合，难以扩展新渠道
|
||||||
|
2. **AI 服务受限**：Java 生态对 AI/LLM 支持不如 Python 丰富，迭代效率低
|
||||||
|
3. **职责不清**：消息路由、AI 调用、状态管理混杂在同一服务中
|
||||||
|
|
||||||
|
### 1.2 目标
|
||||||
|
|
||||||
|
1. **多渠道适配**：抽象渠道适配层，支持 WeChat/Douyin/JD 等渠道的快速接入
|
||||||
|
2. **AI 服务剥离**：将 AI 服务剥离为独立 Python 服务，主框架通过 HTTP 调用
|
||||||
|
3. **职责清晰**：主框架负责消息路由、会话管理、渠道适配；AI 服务负责模型推理
|
||||||
|
|
||||||
|
### 1.3 非目标（Out of Scope）
|
||||||
|
|
||||||
|
- 本次改造不涉及前端界面重构
|
||||||
|
- 不涉及数据库迁移或数据模型重大变更
|
||||||
|
- 不涉及 AI 模型训练或微调
|
||||||
|
|
||||||
|
## 2. 模块边界（Scope）
|
||||||
|
|
||||||
|
### 2.1 覆盖
|
||||||
|
|
||||||
|
| 模块 | 说明 |
|
||||||
|
|-----|------|
|
||||||
|
| **渠道适配层** | 抽象 ChannelAdapter 接口，实现 WeChatAdapter，预留 DouyinAdapter/JdAdapter 扩展点 |
|
||||||
|
| **消息路由层** | MessageProcessService 重构，支持多渠道消息分发 |
|
||||||
|
| **会话管理层** | SessionManagerService 保持不变，增加渠道类型字段 |
|
||||||
|
| **AI 服务客户端** | 新增 AiServiceClient，通过 HTTP 调用 Python AI 服务 |
|
||||||
|
| **Python AI 服务** | 独立服务，提供 `/ai/chat` 等接口 |
|
||||||
|
| **配置管理** | 支持多渠道配置、AI 服务配置 |
|
||||||
|
|
||||||
|
### 2.2 不覆盖
|
||||||
|
|
||||||
|
| 模块 | 说明 |
|
||||||
|
|-----|------|
|
||||||
|
| **抖音/京东适配器实现** | 仅预留接口，后续迭代实现 |
|
||||||
|
| **人工客服工作台** | WebSocket 相关逻辑保持不变 |
|
||||||
|
| **数据库表结构** | 仅增加渠道类型字段，不进行大规模迁移 |
|
||||||
|
| **前端界面** | 不涉及 |
|
||||||
|
|
||||||
|
## 3. 依赖盘点（Dependencies）
|
||||||
|
|
||||||
|
### 3.1 本模块依赖的外部服务
|
||||||
|
|
||||||
|
| 依赖 | 用途 | 契约文件 |
|
||||||
|
|-----|------|---------|
|
||||||
|
| **Python AI 服务** | AI 回复生成、置信度评估 | `openapi.deps.yaml` |
|
||||||
|
| **企业微信 API** | 微信消息收发、会话状态管理 | 第三方 API |
|
||||||
|
| **Redis** | 会话状态缓存、Token 缓存 | 基础设施 |
|
||||||
|
| **MySQL** | 会话、消息持久化 | 基础设施 |
|
||||||
|
|
||||||
|
### 3.2 本模块对外提供的能力
|
||||||
|
|
||||||
|
| 能力 | 消费方 | 契约文件 |
|
||||||
|
|-----|-------|---------|
|
||||||
|
| **人工客服工作台 API** | 前端 | `openapi.provider.yaml` |
|
||||||
|
| **WebSocket 消息推送** | 前端 | `openapi.provider.yaml` |
|
||||||
|
|
||||||
|
## 4. 用户故事（User Stories）
|
||||||
|
|
||||||
|
### 4.1 渠道适配
|
||||||
|
|
||||||
|
- [US-MCA-01] 作为系统架构师，我希望主框架支持多渠道适配器接口，以便快速接入新渠道（抖音、京东等）。
|
||||||
|
|
||||||
|
### 4.2 AI 服务剥离
|
||||||
|
|
||||||
|
- [US-MCA-02] 作为 AI 工程师，我希望 AI 服务独立部署为 Python 服务，以便使用 Python 生态的 AI 框架和工具。
|
||||||
|
- [US-MCA-03] 作为后端开发者，我希望主框架通过 HTTP 调用 AI 服务，以便主框架与 AI 服务独立演进。
|
||||||
|
|
||||||
|
### 4.3 消息路由
|
||||||
|
|
||||||
|
- [US-MCA-04] 作为系统运维，我希望消息路由逻辑与渠道适配解耦，以便新增渠道时不影响核心路由逻辑。
|
||||||
|
|
||||||
|
### 4.4 会话管理
|
||||||
|
|
||||||
|
- [US-MCA-05] 作为系统运维，我希望会话管理支持多渠道标识，以便区分不同渠道的会话。
|
||||||
|
|
||||||
|
## 5. 验收标准（Acceptance Criteria, EARS）
|
||||||
|
|
||||||
|
### 5.1 渠道适配层
|
||||||
|
|
||||||
|
#### 5.1.1 核心能力接口（所有渠道必须实现）
|
||||||
|
|
||||||
|
- [AC-MCA-01] WHEN 定义 ChannelAdapter 核心接口 THEN 系统 SHALL 包含 `receiveMessage`（接收消息）、`sendMessage`（发送消息）、`getChannelType`（获取渠道类型）方法签名。
|
||||||
|
|
||||||
|
#### 5.1.2 可选能力接口（按渠道特性实现）
|
||||||
|
|
||||||
|
- [AC-MCA-01-OPT-01] WHEN 渠道支持服务状态管理 THEN 系统 SHALL 实现 `ServiceStateCapable` 接口，包含 `getServiceState`、`transServiceState` 方法。
|
||||||
|
- [AC-MCA-01-OPT-02] WHEN 渠道支持转人工 THEN 系统 SHALL 实现 `TransferCapable` 接口，包含 `transferToManual`、`transferToPool` 方法。
|
||||||
|
- [AC-MCA-01-OPT-03] WHEN 渠道支持消息同步 THEN 系统 SHALL 实现 `MessageSyncCapable` 接口，包含 `syncMessages` 方法。
|
||||||
|
|
||||||
|
> **设计说明**：可选能力接口的具体定义将在 `design.md` 中详细说明。主框架在运行时通过能力检测（如 `instanceof` 或 `Optional.ofNullable`）判断渠道是否支持某能力。
|
||||||
|
|
||||||
|
#### 5.1.3 适配器实现
|
||||||
|
|
||||||
|
- [AC-MCA-02] WHEN 实现 WeChatAdapter THEN 系统 SHALL 实现核心接口及所有可选能力接口，封装现有 WecomApiService 的所有功能。
|
||||||
|
- [AC-MCA-03] WHEN 新增渠道适配器 THEN 系统 SHALL 至少实现核心接口，可选能力按需实现，无需修改核心路由逻辑。
|
||||||
|
|
||||||
|
### 5.2 AI 服务剥离
|
||||||
|
|
||||||
|
#### 5.2.1 请求契约
|
||||||
|
|
||||||
|
- [AC-MCA-04] WHEN 主框架调用 AI 服务 THEN 系统 SHALL 通过 HTTP POST `/ai/chat` 接口获取 AI 回复。
|
||||||
|
- [AC-MCA-04-REQ] WHEN 构造 AI 服务请求 THEN 系统 SHALL 包含以下最小字段：`sessionId`（会话ID）、`currentMessage`（当前消息）、`channelType`（渠道类型）。
|
||||||
|
- [AC-MCA-04-OPT] WHEN 构造 AI 服务请求 THEN 系统 MAY 包含以下可选字段：`history`（历史消息）、`metadata`（扩展元数据）。
|
||||||
|
|
||||||
|
#### 5.2.2 响应契约
|
||||||
|
|
||||||
|
- [AC-MCA-05] WHEN AI 服务返回回复 THEN 系统 SHALL 包含 `reply`（回复内容）、`confidence`（置信度）、`shouldTransfer`（是否建议转人工）字段。
|
||||||
|
|
||||||
|
#### 5.2.3 容错处理
|
||||||
|
|
||||||
|
- [AC-MCA-06] WHEN AI 服务不可用 THEN 系统 SHALL 返回降级回复并记录错误日志，不影响消息接收流程。
|
||||||
|
- [AC-MCA-07] WHEN AI 服务响应超时 THEN 系统 SHALL 在配置的超时时间后返回降级回复。
|
||||||
|
|
||||||
|
### 5.3 消息路由
|
||||||
|
|
||||||
|
- [AC-MCA-08] WHEN 收到消息 THEN 系统 SHALL 根据渠道类型路由到对应的渠道适配器。
|
||||||
|
- [AC-MCA-09] WHEN 会话状态为 AI THEN 系统 SHALL 调用 AI 服务生成回复。
|
||||||
|
- [AC-MCA-10] WHEN 会话状态为 MANUAL THEN 系统 SHALL 推送消息到人工客服工作台。
|
||||||
|
|
||||||
|
### 5.4 消息幂等性
|
||||||
|
|
||||||
|
- [AC-MCA-11-IDEMPOTENT] WHEN 收到重复的 messageId THEN 系统 SHALL 幂等处理，不重复调用 AI 服务、不重复发送回复消息。
|
||||||
|
|
||||||
|
### 5.5 会话管理
|
||||||
|
|
||||||
|
- [AC-MCA-11] WHEN 创建会话 THEN 系统 SHALL 记录渠道类型（channelType）。
|
||||||
|
- [AC-MCA-12] WHEN 查询会话 THEN 系统 SHALL 支持按渠道类型筛选。
|
||||||
|
|
||||||
|
### 5.6 兼容性
|
||||||
|
|
||||||
|
- [AC-MCA-13] WHEN 改造完成后 THEN 系统 SHALL 保持现有微信渠道功能完全兼容，无业务中断。
|
||||||
|
|
||||||
|
## 6. 追踪映射（Traceability）
|
||||||
|
|
||||||
|
| AC ID | Endpoint | 方法 | operationId | 备注 |
|
||||||
|
|-------|----------|------|-------------|------|
|
||||||
|
| AC-MCA-04 | /ai/chat | POST | generateReply | AI 服务接口（deps） |
|
||||||
|
| AC-MCA-04-REQ | /ai/chat | POST | generateReply | AI 请求最小字段 |
|
||||||
|
| AC-MCA-05 | /ai/chat | POST | generateReply | AI 服务响应格式 |
|
||||||
|
| AC-MCA-06 | /ai/chat | POST | generateReply | 降级处理 |
|
||||||
|
| AC-MCA-07 | /ai/chat | POST | generateReply | 超时处理 |
|
||||||
|
| AC-MCA-08 | /wecom/callback | POST | handleWecomCallback | **微信渠道** Provider Endpoint，其它渠道后续补齐 |
|
||||||
|
| AC-MCA-09 | /ai/chat | POST | generateReply | AI 状态路由 |
|
||||||
|
| AC-MCA-10 | WebSocket | - | pushToManualCs | 人工状态路由 |
|
||||||
|
| AC-MCA-11-IDEMPOTENT | - | - | - | 幂等处理（内部逻辑，无对外接口） |
|
||||||
|
|
||||||
|
## 7. 风险与约束
|
||||||
|
|
||||||
|
### 7.1 技术风险
|
||||||
|
|
||||||
|
| 风险 | 影响 | 缓解措施 |
|
||||||
|
|-----|------|---------|
|
||||||
|
| AI 服务调用延迟 | 用户体验下降 | 设置合理超时、异步处理、降级策略 |
|
||||||
|
| 渠道 API 差异 | 适配器实现复杂 | 抽象公共接口、渠道特有能力单独处理 |
|
||||||
|
|
||||||
|
### 7.2 约束
|
||||||
|
|
||||||
|
- Java 版本：1.8（不升级）
|
||||||
|
- Spring Boot 版本：2.7.18（不升级）
|
||||||
|
- AI 服务通信协议：HTTP REST（非 gRPC）
|
||||||
|
- 部署方式：AI 服务独立部署，主框架通过内网调用
|
||||||
|
|
@ -0,0 +1,347 @@
|
||||||
|
---
|
||||||
|
feature_id: "MCA"
|
||||||
|
title: "多渠道适配主框架任务清单"
|
||||||
|
status: "draft"
|
||||||
|
version: "0.1.0"
|
||||||
|
owners:
|
||||||
|
- "backend"
|
||||||
|
last_updated: "2026-02-24"
|
||||||
|
---
|
||||||
|
|
||||||
|
# 多渠道适配主框架任务清单（tasks.md）
|
||||||
|
|
||||||
|
## 任务概览
|
||||||
|
|
||||||
|
| 阶段 | 任务数 | 说明 |
|
||||||
|
|-----|-------|------|
|
||||||
|
| Phase 1: 基础设施 | 5 | 统一消息模型、配置、数据库 |
|
||||||
|
| Phase 2: 渠道适配层 | 4 | ChannelAdapter 接口与 WeChatAdapter 重构 |
|
||||||
|
| Phase 3: 消息路由层 | 4 | MessageRouterService 重构 |
|
||||||
|
| Phase 4: AI 服务客户端 | 4 | AiServiceClient 实现 |
|
||||||
|
| Phase 5: 集成测试 | 3 | 端到端测试 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 1: 基础设施
|
||||||
|
|
||||||
|
### TASK-001: 定义统一消息模型 DTO
|
||||||
|
- **状态**: ✅ 已完成
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-08
|
||||||
|
- **描述**: 创建 `InboundMessage`、`OutboundMessage`、`SignatureInfo` 等 DTO 类
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/dto/InboundMessage.java`
|
||||||
|
- `src/main/java/com/wecom/robot/dto/OutboundMessage.java`
|
||||||
|
- `src/main/java/com/wecom/robot/dto/SignatureInfo.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [x] DTO 类包含 design.md 2.1/2.2 定义的所有字段
|
||||||
|
- [x] 包含 Lombok 注解 (@Data, @Builder)
|
||||||
|
- [x] 单元测试覆盖字段映射
|
||||||
|
|
||||||
|
### TASK-002: 新增配置类
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-04
|
||||||
|
- **描述**: 创建 AI 服务配置类和渠道配置类
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/config/AiServiceConfig.java`
|
||||||
|
- `src/main/java/com/wecom/robot/config/ChannelConfig.java`
|
||||||
|
- `src/main/resources/application.yml` 更新
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 配置类可正确读取 application.yml
|
||||||
|
- [ ] 包含默认值
|
||||||
|
|
||||||
|
### TASK-003: 数据库 Schema 变更
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-11
|
||||||
|
- **描述**: Session 表新增 channel_type 字段
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/resources/db/migration/V1__add_channel_type.sql` (如使用 Flyway)
|
||||||
|
- 或手动 DDL 脚本
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] DDL 可在线执行
|
||||||
|
- [ ] 默认值为 'wechat'
|
||||||
|
- [ ] Session 实体类同步更新
|
||||||
|
|
||||||
|
### TASK-004: 添加 Resilience4j 依赖
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P1
|
||||||
|
- **关联 AC**: AC-MCA-06, AC-MCA-07
|
||||||
|
- **描述**: 在 pom.xml 添加 Resilience4j 依赖
|
||||||
|
- **产出物**:
|
||||||
|
- `pom.xml` 更新
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 依赖正确添加
|
||||||
|
- [ ] 项目可正常构建
|
||||||
|
|
||||||
|
### TASK-005: 消息幂等性工具类
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-11-IDEMPOTENT
|
||||||
|
- **描述**: 实现基于 Redis 的消息幂等性处理
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/util/IdempotentHelper.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 使用 Redis SETNX 实现
|
||||||
|
- [ ] TTL 1 小时
|
||||||
|
- [ ] 单元测试覆盖
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 2: 渠道适配层
|
||||||
|
|
||||||
|
### TASK-010: 定义 ChannelAdapter 接口
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-01
|
||||||
|
- **描述**: 创建核心能力接口和可选能力接口
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/adapter/ChannelAdapter.java`
|
||||||
|
- `src/main/java/com/wecom/robot/adapter/ServiceStateCapable.java`
|
||||||
|
- `src/main/java/com/wecom/robot/adapter/TransferCapable.java`
|
||||||
|
- `src/main/java/com/wecom/robot/adapter/MessageSyncCapable.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 接口定义与 design.md 3.1 一致
|
||||||
|
- [ ] sendMessage 使用 OutboundMessage 参数
|
||||||
|
|
||||||
|
### TASK-011: 实现 WeChatAdapter
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-02
|
||||||
|
- **描述**: 将现有 WecomApiService 重构为 WeChatAdapter
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/adapter/WeChatAdapter.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 实现 ChannelAdapter 核心接口
|
||||||
|
- [ ] 实现 ServiceStateCapable、TransferCapable、MessageSyncCapable
|
||||||
|
- [ ] 现有功能保持兼容
|
||||||
|
|
||||||
|
### TASK-012: 创建 ChannelAdapterFactory
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P1
|
||||||
|
- **关联 AC**: AC-MCA-03
|
||||||
|
- **描述**: 创建渠道适配器工厂，根据 channelType 获取对应适配器
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/adapter/ChannelAdapterFactory.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 支持 wechat 渠道
|
||||||
|
- [ ] 预留 douyin、jd 扩展点
|
||||||
|
|
||||||
|
### TASK-013: 重构 WecomCallbackController
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-08
|
||||||
|
- **描述**: Controller 负责验签/解密/解析，构建 InboundMessage
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/controller/WecomCallbackController.java` 更新
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 验签/解密逻辑保持不变
|
||||||
|
- [ ] 输出 InboundMessage 传递给 MessageRouterService
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 3: 消息路由层
|
||||||
|
|
||||||
|
### TASK-020: 定义 MessageRouterService 接口
|
||||||
|
- **状态**: ✅ 已完成
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-08
|
||||||
|
- **描述**: 创建渠道无关的消息路由服务接口
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/service/MessageRouterService.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [x] 接口定义与 design.md 3.2 一致
|
||||||
|
|
||||||
|
### TASK-021: 实现 MessageRouterServiceImpl
|
||||||
|
- **状态**: ✅ 已完成
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-08, AC-MCA-09, AC-MCA-10
|
||||||
|
- **描述**: 实现消息路由核心逻辑
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/service/impl/MessageRouterServiceImpl.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [x] processInboundMessage 实现完整流程
|
||||||
|
- [x] routeBySessionState 根据状态路由
|
||||||
|
- [x] 幂等性检查
|
||||||
|
|
||||||
|
### TASK-022: 重构 MessageProcessService
|
||||||
|
- **状态**: ✅ 已完成
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-08
|
||||||
|
- **描述**: 将现有 MessageProcessService 逻辑迁移到 MessageRouterServiceImpl
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/service/MessageProcessService.java` 更新或删除
|
||||||
|
- **验收标准**:
|
||||||
|
- [x] 现有功能保持兼容
|
||||||
|
- [x] 微信专属逻辑移至 WeChatAdapter
|
||||||
|
|
||||||
|
### TASK-023: 更新 SessionManagerService
|
||||||
|
- **状态**: ✅ 已完成
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-11, AC-MCA-12
|
||||||
|
- **描述**: 支持渠道类型字段
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/service/SessionManagerService.java` 更新
|
||||||
|
- `src/main/java/com/wecom/robot/entity/Session.java` 更新
|
||||||
|
- **验收标准**:
|
||||||
|
- [x] 创建会话时记录 channelType
|
||||||
|
- [x] 支持按 channelType 筛选
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 4: AI 服务客户端
|
||||||
|
|
||||||
|
### TASK-030: 定义 AI 服务 DTO
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-04-REQ, AC-MCA-05
|
||||||
|
- **描述**: 创建 ChatRequest、ChatResponse DTO
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/dto/ai/ChatRequest.java`
|
||||||
|
- `src/main/java/com/wecom/robot/dto/ai/ChatResponse.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 字段与 openapi.deps.yaml 一致
|
||||||
|
- [ ] 包含映射方法 (InboundMessage → ChatRequest)
|
||||||
|
|
||||||
|
### TASK-031: 实现 AiServiceClient
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-04, AC-MCA-05
|
||||||
|
- **描述**: 实现 HTTP 调用 Python AI 服务
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/service/AiServiceClient.java`
|
||||||
|
- `src/main/java/com/wecom/robot/service/impl/AiServiceClientImpl.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 使用 RestTemplate 调用 /ai/chat
|
||||||
|
- [ ] 超时 5 秒
|
||||||
|
- [ ] 正确映射字段
|
||||||
|
|
||||||
|
### TASK-032: 实现熔断与降级
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P1
|
||||||
|
- **关联 AC**: AC-MCA-06, AC-MCA-07
|
||||||
|
- **描述**: 使用 Resilience4j 实现熔断和降级
|
||||||
|
- **产出物**:
|
||||||
|
- `src/main/java/com/wecom/robot/service/impl/AiServiceClientImpl.java` 更新
|
||||||
|
- `src/main/resources/application.yml` 更新
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] @CircuitBreaker 注解配置
|
||||||
|
- [ ] @TimeLimiter 注解配置
|
||||||
|
- [ ] fallback 方法返回降级回复
|
||||||
|
|
||||||
|
### TASK-033: 删除旧 AiService
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P2
|
||||||
|
- **关联 AC**: -
|
||||||
|
- **描述**: 删除旧的 AiService 类，清理相关配置
|
||||||
|
- **产出物**:
|
||||||
|
- 删除 `src/main/java/com/wecom/robot/service/AiService.java`
|
||||||
|
- 删除 `src/main/java/com/wecom/robot/config/AiConfig.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 无编译错误
|
||||||
|
- [ ] 无运行时错误
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 5: 集成测试
|
||||||
|
|
||||||
|
### TASK-040: 微信回调端到端测试
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-08, AC-MCA-09, AC-MCA-10
|
||||||
|
- **描述**: 测试微信回调完整流程
|
||||||
|
- **产出物**:
|
||||||
|
- `src/test/java/com/wecom/robot/integration/WecomCallbackIntegrationTest.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 消息正确路由到 AI 服务
|
||||||
|
- [ ] 消息正确路由到人工客服
|
||||||
|
- [ ] 幂等性验证
|
||||||
|
|
||||||
|
### TASK-041: AI 服务调用测试
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P0
|
||||||
|
- **关联 AC**: AC-MCA-04, AC-MCA-05, AC-MCA-06, AC-MCA-07
|
||||||
|
- **描述**: 测试 AI 服务调用、超时、降级
|
||||||
|
- **产出物**:
|
||||||
|
- `src/test/java/com/wecom/robot/service/AiServiceClientTest.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 正常调用返回正确响应
|
||||||
|
- [ ] 超时触发降级
|
||||||
|
- [ ] 熔断触发降级
|
||||||
|
|
||||||
|
### TASK-042: 会话管理测试
|
||||||
|
- **状态**: ⏳ 待开始
|
||||||
|
- **优先级**: P1
|
||||||
|
- **关联 AC**: AC-MCA-11, AC-MCA-12
|
||||||
|
- **描述**: 测试会话创建、状态变更、渠道类型
|
||||||
|
- **产出物**:
|
||||||
|
- `src/test/java/com/wecom/robot/service/SessionManagerServiceTest.java`
|
||||||
|
- **验收标准**:
|
||||||
|
- [ ] 会话创建包含 channelType
|
||||||
|
- [ ] 支持按 channelType 筛选
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 待澄清事项
|
||||||
|
|
||||||
|
| ID | 问题 | 状态 | 备注 |
|
||||||
|
|----|------|------|------|
|
||||||
|
| CLARIFY-001 | AI 服务超时时间确认 | ✅ 已确认 | 5 秒 |
|
||||||
|
| CLARIFY-002 | 降级回复策略确认 | ✅ 已确认 | 返回固定回复 + 转人工 |
|
||||||
|
| CLARIFY-003 | 历史消息数量限制 | ✅ 已确认 | 50 条（openapi.deps.yaml） |
|
||||||
|
| CLARIFY-004 | 渠道扩展优先级 | ✅ 已确认 | WeChat → Douyin → JD |
|
||||||
|
| CLARIFY-005 | Python AI 服务部署方式 | ⏳ 待确认 | 独立进程 / Docker / K8s |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 任务依赖关系
|
||||||
|
|
||||||
|
```
|
||||||
|
Phase 1 (基础设施)
|
||||||
|
│
|
||||||
|
├── TASK-001 (DTO) ─────────────────────────────────────────┐
|
||||||
|
├── TASK-002 (配置) ────────────────────────────────────────┤
|
||||||
|
├── TASK-003 (数据库) ──────────────────────────────────────┤
|
||||||
|
├── TASK-004 (Resilience4j) ──┐ │
|
||||||
|
└── TASK-005 (幂等性) ────────┤ │
|
||||||
|
│ │
|
||||||
|
Phase 2 (渠道适配层) │ │
|
||||||
|
│ │ │
|
||||||
|
├── TASK-010 (接口) ◄────────┼─────────────────────────────┤
|
||||||
|
├── TASK-011 (WeChatAdapter) ◄┘ │
|
||||||
|
├── TASK-012 (Factory) │
|
||||||
|
└── TASK-013 (Controller) ◄─────────────────────────────────┘
|
||||||
|
│
|
||||||
|
Phase 3 (消息路由层) │
|
||||||
|
│ │
|
||||||
|
├── TASK-020 (接口) ◄────────┘
|
||||||
|
├── TASK-021 (实现)
|
||||||
|
├── TASK-022 (重构)
|
||||||
|
└── TASK-023 (Session)
|
||||||
|
│
|
||||||
|
Phase 4 (AI 服务客户端) │
|
||||||
|
│ │
|
||||||
|
├── TASK-030 (DTO) ◄─────────┘
|
||||||
|
├── TASK-031 (实现)
|
||||||
|
├── TASK-032 (熔断)
|
||||||
|
└── TASK-033 (清理)
|
||||||
|
│
|
||||||
|
Phase 5 (集成测试) │
|
||||||
|
│ │
|
||||||
|
├── TASK-040 ◄───────────────┘
|
||||||
|
├── TASK-041
|
||||||
|
└── TASK-042
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 进度统计
|
||||||
|
|
||||||
|
| 指标 | 数值 |
|
||||||
|
|-----|------|
|
||||||
|
| 总任务数 | 20 |
|
||||||
|
| 已完成 | 4 |
|
||||||
|
| 进行中 | 0 |
|
||||||
|
| 待开始 | 16 |
|
||||||
|
| 完成率 | 20% |
|
||||||
|
|
@ -0,0 +1,18 @@
|
||||||
|
package com.wecom.robot;
|
||||||
|
|
||||||
|
import org.mybatis.spring.annotation.MapperScan;
|
||||||
|
import org.springframework.boot.SpringApplication;
|
||||||
|
import org.springframework.boot.autoconfigure.SpringBootApplication;
|
||||||
|
import org.springframework.scheduling.annotation.EnableAsync;
|
||||||
|
import org.springframework.scheduling.annotation.EnableScheduling;
|
||||||
|
|
||||||
|
@SpringBootApplication
|
||||||
|
@MapperScan("com.wecom.robot.mapper")
|
||||||
|
@EnableAsync
|
||||||
|
@EnableScheduling
|
||||||
|
public class WecomRobotApplication {
|
||||||
|
|
||||||
|
public static void main(String[] args) {
|
||||||
|
SpringApplication.run(WecomRobotApplication.class, args);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,31 @@
|
||||||
|
package com.wecom.robot.adapter;
|
||||||
|
|
||||||
|
import com.wecom.robot.dto.OutboundMessage;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 渠道适配器核心能力接口
|
||||||
|
* <p>
|
||||||
|
* 所有渠道适配器必须实现此接口，提供渠道类型标识和消息发送能力。
|
||||||
|
* [AC-MCA-01] 渠道适配层核心接口
|
||||||
|
*
|
||||||
|
* @see ServiceStateCapable
|
||||||
|
* @see TransferCapable
|
||||||
|
* @see MessageSyncCapable
|
||||||
|
*/
|
||||||
|
public interface ChannelAdapter {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取渠道类型标识
|
||||||
|
*
|
||||||
|
* @return 渠道类型，如 "wechat", "douyin", "jd"
|
||||||
|
*/
|
||||||
|
String getChannelType();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 发送消息到渠道
|
||||||
|
*
|
||||||
|
* @param message 出站消息对象
|
||||||
|
* @return 发送是否成功
|
||||||
|
*/
|
||||||
|
boolean sendMessage(OutboundMessage message);
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,115 @@
|
||||||
|
package com.wecom.robot.adapter;
|
||||||
|
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.stereotype.Component;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.function.Function;
|
||||||
|
import java.util.stream.Collectors;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 渠道适配器工厂
|
||||||
|
* <p>
|
||||||
|
* 根据渠道类型获取对应的渠道适配器实例。
|
||||||
|
* [AC-MCA-03] 渠道适配器工厂
|
||||||
|
*/
|
||||||
|
@Slf4j
|
||||||
|
@Component
|
||||||
|
public class ChannelAdapterFactory {
|
||||||
|
|
||||||
|
private final Map<String, ChannelAdapter> adapterMap;
|
||||||
|
|
||||||
|
public ChannelAdapterFactory(List<ChannelAdapter> adapters) {
|
||||||
|
this.adapterMap = adapters.stream()
|
||||||
|
.collect(Collectors.toMap(
|
||||||
|
ChannelAdapter::getChannelType,
|
||||||
|
Function.identity(),
|
||||||
|
(existing, replacement) -> existing
|
||||||
|
));
|
||||||
|
|
||||||
|
log.info("[AC-MCA-03] 已注册渠道适配器: {}", adapterMap.keySet());
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据渠道类型获取适配器
|
||||||
|
*
|
||||||
|
* @param channelType 渠道类型 (wechat/douyin/jd)
|
||||||
|
* @return 渠道适配器实例
|
||||||
|
* @throws IllegalArgumentException 如果渠道类型不支持
|
||||||
|
*/
|
||||||
|
public ChannelAdapter getAdapter(String channelType) {
|
||||||
|
ChannelAdapter adapter = adapterMap.get(channelType);
|
||||||
|
if (adapter == null) {
|
||||||
|
log.error("[AC-MCA-03] 不支持的渠道类型: {}", channelType);
|
||||||
|
throw new IllegalArgumentException("不支持的渠道类型: " + channelType);
|
||||||
|
}
|
||||||
|
return adapter;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查渠道类型是否支持
|
||||||
|
*
|
||||||
|
* @param channelType 渠道类型
|
||||||
|
* @return 是否支持
|
||||||
|
*/
|
||||||
|
public boolean isSupported(String channelType) {
|
||||||
|
return adapterMap.containsKey(channelType);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取所有支持的渠道类型
|
||||||
|
*
|
||||||
|
* @return 渠道类型集合
|
||||||
|
*/
|
||||||
|
public java.util.Set<String> getSupportedChannelTypes() {
|
||||||
|
return adapterMap.keySet();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取适配器并检查是否支持指定能力
|
||||||
|
*
|
||||||
|
* @param channelType 渠道类型
|
||||||
|
* @param capabilityClass 能力接口类
|
||||||
|
* @param <T> 能力类型
|
||||||
|
* @return 能力实例，如果不支持则返回 null
|
||||||
|
*/
|
||||||
|
public <T> T getAdapterWithCapability(String channelType, Class<T> capabilityClass) {
|
||||||
|
ChannelAdapter adapter = getAdapter(channelType);
|
||||||
|
if (capabilityClass.isInstance(adapter)) {
|
||||||
|
return capabilityClass.cast(adapter);
|
||||||
|
}
|
||||||
|
log.warn("[AC-MCA-03] 渠道 {} 不支持能力: {}", channelType, capabilityClass.getSimpleName());
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取服务状态管理能力
|
||||||
|
*
|
||||||
|
* @param channelType 渠道类型
|
||||||
|
* @return ServiceStateCapable 实例，如果不支持则返回 null
|
||||||
|
*/
|
||||||
|
public ServiceStateCapable getServiceStateCapable(String channelType) {
|
||||||
|
return getAdapterWithCapability(channelType, ServiceStateCapable.class);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取转人工能力
|
||||||
|
*
|
||||||
|
* @param channelType 渠道类型
|
||||||
|
* @return TransferCapable 实例，如果不支持则返回 null
|
||||||
|
*/
|
||||||
|
public TransferCapable getTransferCapable(String channelType) {
|
||||||
|
return getAdapterWithCapability(channelType, TransferCapable.class);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取消息同步能力
|
||||||
|
*
|
||||||
|
* @param channelType 渠道类型
|
||||||
|
* @return MessageSyncCapable 实例，如果不支持则返回 null
|
||||||
|
*/
|
||||||
|
public MessageSyncCapable getMessageSyncCapable(String channelType) {
|
||||||
|
return getAdapterWithCapability(channelType, MessageSyncCapable.class);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,22 @@
|
||||||
|
package com.wecom.robot.adapter;
|
||||||
|
|
||||||
|
import com.wecom.robot.dto.SyncMsgResponse;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 消息同步能力接口（可选）
|
||||||
|
* <p>
|
||||||
|
* 提供从渠道同步历史消息的能力。
|
||||||
|
* 渠道适配器可选择性实现此接口。
|
||||||
|
* [AC-MCA-01] 渠道适配层可选能力接口
|
||||||
|
*/
|
||||||
|
public interface MessageSyncCapable {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 同步消息
|
||||||
|
*
|
||||||
|
* @param kfId 客服账号ID
|
||||||
|
* @param cursor 游标（用于分页获取）
|
||||||
|
* @return 同步消息响应
|
||||||
|
*/
|
||||||
|
SyncMsgResponse syncMessages(String kfId, String cursor);
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,33 @@
|
||||||
|
package com.wecom.robot.adapter;
|
||||||
|
|
||||||
|
import com.wecom.robot.dto.ServiceStateResponse;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 服务状态管理能力接口（可选）
|
||||||
|
* <p>
|
||||||
|
* 提供渠道服务状态的获取和变更能力。
|
||||||
|
* 渠道适配器可选择性实现此接口。
|
||||||
|
* [AC-MCA-01] 渠道适配层可选能力接口
|
||||||
|
*/
|
||||||
|
public interface ServiceStateCapable {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取服务状态
|
||||||
|
*
|
||||||
|
* @param kfId 客服账号ID
|
||||||
|
* @param customerId 客户ID
|
||||||
|
* @return 服务状态响应
|
||||||
|
*/
|
||||||
|
ServiceStateResponse getServiceState(String kfId, String customerId);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 变更服务状态
|
||||||
|
*
|
||||||
|
* @param kfId 客服账号ID
|
||||||
|
* @param customerId 客户ID
|
||||||
|
* @param newState 新状态值
|
||||||
|
* @param servicerId 人工客服ID（可选）
|
||||||
|
* @return 变更是否成功
|
||||||
|
*/
|
||||||
|
boolean transServiceState(String kfId, String customerId, int newState, String servicerId);
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,30 @@
|
||||||
|
package com.wecom.robot.adapter;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转人工能力接口（可选）
|
||||||
|
* <p>
|
||||||
|
* 提供将客户转入待接入池或转给指定人工客服的能力。
|
||||||
|
* 渠道适配器可选择性实现此接口。
|
||||||
|
* [AC-MCA-01] 渠道适配层可选能力接口
|
||||||
|
*/
|
||||||
|
public interface TransferCapable {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转入待接入池
|
||||||
|
*
|
||||||
|
* @param kfId 客服账号ID
|
||||||
|
* @param customerId 客户ID
|
||||||
|
* @return 转移是否成功
|
||||||
|
*/
|
||||||
|
boolean transferToPool(String kfId, String customerId);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转给指定人工客服
|
||||||
|
*
|
||||||
|
* @param kfId 客服账号ID
|
||||||
|
* @param customerId 客户ID
|
||||||
|
* @param servicerId 人工客服ID
|
||||||
|
* @return 转移是否成功
|
||||||
|
*/
|
||||||
|
boolean transferToManual(String kfId, String customerId, String servicerId);
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,275 @@
|
||||||
|
package com.wecom.robot.adapter;
|
||||||
|
|
||||||
|
import com.alibaba.fastjson.JSON;
|
||||||
|
import com.alibaba.fastjson.JSONObject;
|
||||||
|
import com.wecom.robot.config.WecomConfig;
|
||||||
|
import com.wecom.robot.dto.OutboundMessage;
|
||||||
|
import com.wecom.robot.dto.ServiceStateResponse;
|
||||||
|
import com.wecom.robot.dto.SyncMsgResponse;
|
||||||
|
import com.wecom.robot.dto.WxSendMessageRequest;
|
||||||
|
import com.wecom.robot.dto.InboundMessage;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.data.redis.core.StringRedisTemplate;
|
||||||
|
import org.springframework.http.*;
|
||||||
|
import org.springframework.stereotype.Component;
|
||||||
|
import org.springframework.web.client.RestTemplate;
|
||||||
|
|
||||||
|
import java.util.concurrent.TimeUnit;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 企业微信渠道适配器
|
||||||
|
* <p>
|
||||||
|
* 实现企业微信渠道的消息发送、服务状态管理、转人工、消息同步等能力。
|
||||||
|
* [AC-MCA-02] 企业微信渠道适配器实现
|
||||||
|
*/
|
||||||
|
@Slf4j
|
||||||
|
@Component
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class WeChatAdapter implements ChannelAdapter,
|
||||||
|
ServiceStateCapable, TransferCapable, MessageSyncCapable {
|
||||||
|
|
||||||
|
private static final String CHANNEL_TYPE = "wechat";
|
||||||
|
|
||||||
|
private static final String GET_ACCESS_TOKEN_URL = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={corpId}&corpsecret={secret}";
|
||||||
|
private static final String SEND_MESSAGE_URL = "https://qyapi.weixin.qq.com/cgi-bin/kf/send_msg?access_token={accessToken}";
|
||||||
|
private static final String SYNC_MESSAGE_URL = "https://qyapi.weixin.qq.com/cgi-bin/kf/sync_msg?access_token={accessToken}";
|
||||||
|
private static final String GET_SERVICE_STATE_URL = "https://qyapi.weixin.qq.com/cgi-bin/kf/service_state/get?access_token={accessToken}";
|
||||||
|
private static final String TRANS_SERVICE_STATE_URL = "https://qyapi.weixin.qq.com/cgi-bin/kf/service_state/trans?access_token={accessToken}";
|
||||||
|
private static final String SEND_EVENT_MSG_URL = "https://qyapi.weixin.qq.com/cgi-bin/kf/send_msg_on_event?access_token={accessToken}";
|
||||||
|
|
||||||
|
private static final String REDIS_TOKEN_KEY = "wecom:access_token";
|
||||||
|
private static final String REDIS_TOKEN_LOCK_KEY = "wecom:access_token_lock";
|
||||||
|
private static final String REDIS_CURSOR_KEY_PREFIX = "wecom:cursor:";
|
||||||
|
|
||||||
|
private final WecomConfig wecomConfig;
|
||||||
|
private final StringRedisTemplate redisTemplate;
|
||||||
|
private final RestTemplate restTemplate = new RestTemplate();
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String getChannelType() {
|
||||||
|
return CHANNEL_TYPE;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean sendMessage(OutboundMessage message) {
|
||||||
|
WxSendMessageRequest wxRequest = convertToWxRequest(message);
|
||||||
|
return sendWxMessage(wxRequest);
|
||||||
|
}
|
||||||
|
|
||||||
|
private WxSendMessageRequest convertToWxRequest(OutboundMessage message) {
|
||||||
|
String msgType = message.getMsgType();
|
||||||
|
if (msgType == null || msgType.isEmpty()) {
|
||||||
|
msgType = InboundMessage.MSG_TYPE_TEXT;
|
||||||
|
}
|
||||||
|
|
||||||
|
WxSendMessageRequest wxRequest = new WxSendMessageRequest();
|
||||||
|
wxRequest.setTouser(message.getReceiver());
|
||||||
|
wxRequest.setOpenKfid(message.getKfId());
|
||||||
|
wxRequest.setMsgtype(msgType);
|
||||||
|
|
||||||
|
switch (msgType) {
|
||||||
|
case InboundMessage.MSG_TYPE_TEXT:
|
||||||
|
default:
|
||||||
|
WxSendMessageRequest.TextContent textContent = new WxSendMessageRequest.TextContent();
|
||||||
|
textContent.setContent(message.getContent());
|
||||||
|
wxRequest.setText(textContent);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
|
||||||
|
return wxRequest;
|
||||||
|
}
|
||||||
|
|
||||||
|
private boolean sendWxMessage(WxSendMessageRequest request) {
|
||||||
|
String accessToken = getAccessToken();
|
||||||
|
String url = SEND_MESSAGE_URL.replace("{accessToken}", accessToken);
|
||||||
|
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
|
||||||
|
HttpEntity<String> entity = new HttpEntity<>(JSON.toJSONString(request), headers);
|
||||||
|
ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
|
||||||
|
|
||||||
|
JSONObject json = JSON.parseObject(response.getBody());
|
||||||
|
if (json.getInteger("errcode") != null && json.getInteger("errcode") != 0) {
|
||||||
|
log.error("[AC-MCA-02] 发送消息失败: {}", json);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("[AC-MCA-02] 消息发送成功: msgId={}", json.getString("msgid"));
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean sendTextMessage(String touser, String openKfid, String content) {
|
||||||
|
WxSendMessageRequest request = WxSendMessageRequest.text(touser, openKfid, content);
|
||||||
|
return sendWxMessage(request);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public ServiceStateResponse getServiceState(String kfId, String customerId) {
|
||||||
|
String accessToken = getAccessToken();
|
||||||
|
String url = GET_SERVICE_STATE_URL.replace("{accessToken}", accessToken);
|
||||||
|
|
||||||
|
JSONObject body = new JSONObject();
|
||||||
|
body.put("open_kfid", kfId);
|
||||||
|
body.put("external_userid", customerId);
|
||||||
|
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
|
||||||
|
HttpEntity<String> entity = new HttpEntity<>(body.toJSONString(), headers);
|
||||||
|
ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
|
||||||
|
|
||||||
|
log.info("[AC-MCA-02] 获取会话状态响应: {}", response.getBody());
|
||||||
|
|
||||||
|
return JSON.parseObject(response.getBody(), ServiceStateResponse.class);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean transServiceState(String kfId, String customerId, int newState, String servicerId) {
|
||||||
|
String accessToken = getAccessToken();
|
||||||
|
String url = TRANS_SERVICE_STATE_URL.replace("{accessToken}", accessToken);
|
||||||
|
|
||||||
|
JSONObject body = new JSONObject();
|
||||||
|
body.put("open_kfid", kfId);
|
||||||
|
body.put("external_userid", customerId);
|
||||||
|
body.put("service_state", newState);
|
||||||
|
if (servicerId != null && !servicerId.isEmpty()) {
|
||||||
|
body.put("servicer_userid", servicerId);
|
||||||
|
}
|
||||||
|
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
|
||||||
|
HttpEntity<String> entity = new HttpEntity<>(body.toJSONString(), headers);
|
||||||
|
ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
|
||||||
|
|
||||||
|
log.info("[AC-MCA-02] 变更会话状态响应: {}", response.getBody());
|
||||||
|
|
||||||
|
JSONObject result = JSON.parseObject(response.getBody());
|
||||||
|
return result.getInteger("errcode") == null || result.getInteger("errcode") == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean transferToPool(String kfId, String customerId) {
|
||||||
|
return transServiceState(kfId, customerId, ServiceStateResponse.STATE_POOL, null);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean transferToManual(String kfId, String customerId, String servicerId) {
|
||||||
|
return transServiceState(kfId, customerId, ServiceStateResponse.STATE_MANUAL, servicerId);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public SyncMsgResponse syncMessages(String kfId, String cursor) {
|
||||||
|
String accessToken = getAccessToken();
|
||||||
|
String url = SYNC_MESSAGE_URL.replace("{accessToken}", accessToken);
|
||||||
|
|
||||||
|
String savedCursor = cursor != null ? cursor : getCursor(kfId);
|
||||||
|
|
||||||
|
JSONObject body = new JSONObject();
|
||||||
|
body.put("open_kfid", kfId);
|
||||||
|
if (savedCursor != null && !savedCursor.isEmpty()) {
|
||||||
|
body.put("cursor", savedCursor);
|
||||||
|
}
|
||||||
|
body.put("limit", 1000);
|
||||||
|
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
|
||||||
|
HttpEntity<String> entity = new HttpEntity<>(body.toJSONString(), headers);
|
||||||
|
ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
|
||||||
|
|
||||||
|
log.info("[AC-MCA-02] sync_msg响应: {}", response.getBody());
|
||||||
|
|
||||||
|
SyncMsgResponse syncResponse = JSON.parseObject(response.getBody(), SyncMsgResponse.class);
|
||||||
|
|
||||||
|
if (syncResponse.isSuccess() && syncResponse.getNextCursor() != null) {
|
||||||
|
saveCursor(kfId, syncResponse.getNextCursor());
|
||||||
|
}
|
||||||
|
|
||||||
|
return syncResponse;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean sendWelcomeMsg(String code, String content) {
|
||||||
|
String accessToken = getAccessToken();
|
||||||
|
String url = SEND_EVENT_MSG_URL.replace("{accessToken}", accessToken);
|
||||||
|
|
||||||
|
JSONObject body = new JSONObject();
|
||||||
|
body.put("code", code);
|
||||||
|
body.put("msgtype", "text");
|
||||||
|
JSONObject text = new JSONObject();
|
||||||
|
text.put("content", content);
|
||||||
|
body.put("text", text);
|
||||||
|
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
|
||||||
|
HttpEntity<String> entity = new HttpEntity<>(body.toJSONString(), headers);
|
||||||
|
ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
|
||||||
|
|
||||||
|
JSONObject json = JSON.parseObject(response.getBody());
|
||||||
|
if (json.getInteger("errcode") != null && json.getInteger("errcode") != 0) {
|
||||||
|
log.error("[AC-MCA-02] 发送欢迎语失败: {}", json);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("[AC-MCA-02] 发送欢迎语成功");
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean endSession(String kfId, String customerId) {
|
||||||
|
return transServiceState(kfId, customerId, ServiceStateResponse.STATE_CLOSED, null);
|
||||||
|
}
|
||||||
|
|
||||||
|
private String getAccessToken() {
|
||||||
|
String cachedToken = redisTemplate.opsForValue().get(REDIS_TOKEN_KEY);
|
||||||
|
if (cachedToken != null) {
|
||||||
|
return cachedToken;
|
||||||
|
}
|
||||||
|
|
||||||
|
Boolean locked = redisTemplate.opsForValue().setIfAbsent(REDIS_TOKEN_LOCK_KEY, "1", 10, TimeUnit.SECONDS);
|
||||||
|
if (Boolean.TRUE.equals(locked)) {
|
||||||
|
try {
|
||||||
|
String url = GET_ACCESS_TOKEN_URL
|
||||||
|
.replace("{corpId}", wecomConfig.getCorpId())
|
||||||
|
.replace("{secret}", wecomConfig.getSecret());
|
||||||
|
|
||||||
|
ResponseEntity<String> response = restTemplate.getForEntity(url, String.class);
|
||||||
|
JSONObject json = JSON.parseObject(response.getBody());
|
||||||
|
|
||||||
|
if (json.getInteger("errcode") != null && json.getInteger("errcode") != 0) {
|
||||||
|
log.error("[AC-MCA-02] 获取access_token失败: {}", json);
|
||||||
|
throw new RuntimeException("获取access_token失败: " + json.getString("errmsg"));
|
||||||
|
}
|
||||||
|
|
||||||
|
String accessToken = json.getString("access_token");
|
||||||
|
long expiresIn = json.getLongValue("expires_in");
|
||||||
|
|
||||||
|
redisTemplate.opsForValue().set(REDIS_TOKEN_KEY, accessToken, expiresIn - 300, TimeUnit.SECONDS);
|
||||||
|
return accessToken;
|
||||||
|
} finally {
|
||||||
|
redisTemplate.delete(REDIS_TOKEN_LOCK_KEY);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
try {
|
||||||
|
Thread.sleep(100);
|
||||||
|
} catch (InterruptedException e) {
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
return getAccessToken();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private String getCursor(String openKfid) {
|
||||||
|
return redisTemplate.opsForValue().get(REDIS_CURSOR_KEY_PREFIX + openKfid);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void saveCursor(String openKfid, String cursor) {
|
||||||
|
redisTemplate.opsForValue().set(REDIS_CURSOR_KEY_PREFIX + openKfid, cursor);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void clearCursor(String openKfid) {
|
||||||
|
redisTemplate.delete(REDIS_CURSOR_KEY_PREFIX + openKfid);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,15 @@
|
||||||
|
package com.wecom.robot.config;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
import org.springframework.boot.context.properties.ConfigurationProperties;
|
||||||
|
import org.springframework.stereotype.Component;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@Component
|
||||||
|
@ConfigurationProperties(prefix = "ai-service")
|
||||||
|
public class AiServiceConfig {
|
||||||
|
|
||||||
|
private String url;
|
||||||
|
|
||||||
|
private int timeout = 5000;
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,22 @@
|
||||||
|
package com.wecom.robot.config;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
import org.springframework.boot.context.properties.ConfigurationProperties;
|
||||||
|
import org.springframework.stereotype.Component;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@Component
|
||||||
|
@ConfigurationProperties(prefix = "channel")
|
||||||
|
public class ChannelConfig {
|
||||||
|
|
||||||
|
private String defaultChannel = "wechat";
|
||||||
|
|
||||||
|
private Map<String, AdapterConfig> adapters;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class AdapterConfig {
|
||||||
|
private boolean enabled;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,46 @@
|
||||||
|
package com.wecom.robot.config;
|
||||||
|
|
||||||
|
import com.wecom.robot.dto.ApiResponse;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.http.HttpStatus;
|
||||||
|
import org.springframework.validation.FieldError;
|
||||||
|
import org.springframework.web.bind.MethodArgumentNotValidException;
|
||||||
|
import org.springframework.web.bind.annotation.ExceptionHandler;
|
||||||
|
import org.springframework.web.bind.annotation.ResponseStatus;
|
||||||
|
import org.springframework.web.bind.annotation.RestControllerAdvice;
|
||||||
|
|
||||||
|
import javax.validation.ConstraintViolation;
|
||||||
|
import javax.validation.ConstraintViolationException;
|
||||||
|
import java.util.stream.Collectors;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@RestControllerAdvice
|
||||||
|
public class GlobalExceptionHandler {
|
||||||
|
|
||||||
|
@ExceptionHandler(MethodArgumentNotValidException.class)
|
||||||
|
@ResponseStatus(HttpStatus.BAD_REQUEST)
|
||||||
|
public ApiResponse<Void> handleValidationException(MethodArgumentNotValidException ex) {
|
||||||
|
String message = ex.getBindingResult().getFieldErrors().stream()
|
||||||
|
.map(FieldError::getDefaultMessage)
|
||||||
|
.collect(Collectors.joining("; "));
|
||||||
|
log.warn("参数校验失败: {}", message);
|
||||||
|
return ApiResponse.error(400, message);
|
||||||
|
}
|
||||||
|
|
||||||
|
@ExceptionHandler(ConstraintViolationException.class)
|
||||||
|
@ResponseStatus(HttpStatus.BAD_REQUEST)
|
||||||
|
public ApiResponse<Void> handleConstraintViolationException(ConstraintViolationException ex) {
|
||||||
|
String message = ex.getConstraintViolations().stream()
|
||||||
|
.map(ConstraintViolation::getMessage)
|
||||||
|
.collect(Collectors.joining("; "));
|
||||||
|
log.warn("约束校验失败: {}", message);
|
||||||
|
return ApiResponse.error(400, message);
|
||||||
|
}
|
||||||
|
|
||||||
|
@ExceptionHandler(Exception.class)
|
||||||
|
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
|
||||||
|
public ApiResponse<Void> handleException(Exception ex) {
|
||||||
|
log.error("服务器内部错误", ex);
|
||||||
|
return ApiResponse.error(500, "服务器内部错误");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,18 @@
|
||||||
|
package com.wecom.robot.config;
|
||||||
|
|
||||||
|
import org.springframework.context.annotation.Bean;
|
||||||
|
import org.springframework.context.annotation.Configuration;
|
||||||
|
import org.springframework.http.client.SimpleClientHttpRequestFactory;
|
||||||
|
import org.springframework.web.client.RestTemplate;
|
||||||
|
|
||||||
|
@Configuration
|
||||||
|
public class RestTemplateConfig {
|
||||||
|
|
||||||
|
@Bean
|
||||||
|
public RestTemplate restTemplate() {
|
||||||
|
SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
|
||||||
|
factory.setConnectTimeout(5000);
|
||||||
|
factory.setReadTimeout(5000);
|
||||||
|
return new RestTemplate(factory);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,19 @@
|
||||||
|
package com.wecom.robot.config;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
import org.springframework.boot.context.properties.ConfigurationProperties;
|
||||||
|
import org.springframework.stereotype.Component;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@Component
|
||||||
|
@ConfigurationProperties(prefix = "transfer")
|
||||||
|
public class TransferConfig {
|
||||||
|
|
||||||
|
private List<String> keywords;
|
||||||
|
private double confidenceThreshold;
|
||||||
|
private int maxFailRounds;
|
||||||
|
private long maxSessionDuration;
|
||||||
|
private int maxMessageRounds;
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,24 @@
|
||||||
|
package com.wecom.robot.config;
|
||||||
|
|
||||||
|
import com.wecom.robot.websocket.CsWebSocketHandler;
|
||||||
|
import org.springframework.context.annotation.Configuration;
|
||||||
|
import org.springframework.web.socket.config.annotation.EnableWebSocket;
|
||||||
|
import org.springframework.web.socket.config.annotation.WebSocketConfigurer;
|
||||||
|
import org.springframework.web.socket.config.annotation.WebSocketHandlerRegistry;
|
||||||
|
|
||||||
|
@Configuration
|
||||||
|
@EnableWebSocket
|
||||||
|
public class WebSocketConfig implements WebSocketConfigurer {
|
||||||
|
|
||||||
|
private final CsWebSocketHandler csWebSocketHandler;
|
||||||
|
|
||||||
|
public WebSocketConfig(CsWebSocketHandler csWebSocketHandler) {
|
||||||
|
this.csWebSocketHandler = csWebSocketHandler;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {
|
||||||
|
registry.addHandler(csWebSocketHandler, "/ws/cs/*")
|
||||||
|
.setAllowedOrigins("*");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,25 @@
|
||||||
|
package com.wecom.robot.config;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
import org.springframework.boot.context.properties.ConfigurationProperties;
|
||||||
|
import org.springframework.stereotype.Component;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@Component
|
||||||
|
@ConfigurationProperties(prefix = "wecom")
|
||||||
|
public class WecomConfig {
|
||||||
|
|
||||||
|
private String corpId;
|
||||||
|
private String agentId;
|
||||||
|
private String secret;
|
||||||
|
private String token;
|
||||||
|
private String encodingAesKey;
|
||||||
|
private KfConfig kf;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class KfConfig {
|
||||||
|
private String callbackUrl;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,132 @@
|
||||||
|
package com.wecom.robot.controller;
|
||||||
|
|
||||||
|
import com.alibaba.fastjson.JSONArray;
|
||||||
|
import com.alibaba.fastjson.JSONObject;
|
||||||
|
import com.wecom.robot.dto.ApiResponse;
|
||||||
|
import com.wecom.robot.entity.Message;
|
||||||
|
import com.wecom.robot.entity.Session;
|
||||||
|
import com.wecom.robot.service.SessionManagerService;
|
||||||
|
import com.wecom.robot.service.WecomApiService;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.web.bind.annotation.*;
|
||||||
|
|
||||||
|
import java.util.*;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@RestController
|
||||||
|
@RequestMapping("/chat-history/api")
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class ChatHistoryController {
|
||||||
|
|
||||||
|
private final SessionManagerService sessionManagerService;
|
||||||
|
private final WecomApiService wecomApiService;
|
||||||
|
|
||||||
|
@GetMapping("/kf-accounts")
|
||||||
|
public ApiResponse<List<Map<String, Object>>> getKfAccounts() {
|
||||||
|
try {
|
||||||
|
JSONObject result = wecomApiService.getKfAccountList(0, 100);
|
||||||
|
List<Map<String, Object>> accounts = new ArrayList<>();
|
||||||
|
|
||||||
|
Integer errcode = result.getInteger("errcode");
|
||||||
|
if (errcode == null || errcode == 0) {
|
||||||
|
JSONArray accountList = result.getJSONArray("account_list");
|
||||||
|
if (accountList != null) {
|
||||||
|
for (int i = 0; i < accountList.size(); i++) {
|
||||||
|
JSONObject account = accountList.getJSONObject(i);
|
||||||
|
Map<String, Object> map = new HashMap<>();
|
||||||
|
map.put("openKfId", account.getString("open_kfid"));
|
||||||
|
map.put("name", account.getString("name"));
|
||||||
|
map.put("avatar", account.getString("avatar"));
|
||||||
|
accounts.add(map);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return ApiResponse.success(accounts);
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("获取客服账号列表失败", e);
|
||||||
|
return ApiResponse.error("获取客服账号列表失败: " + e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/sessions")
|
||||||
|
public ApiResponse<List<Map<String, Object>>> getSessions(
|
||||||
|
@RequestParam String openKfId,
|
||||||
|
@RequestParam(required = false) String status,
|
||||||
|
@RequestParam(required = false, defaultValue = "50") int limit) {
|
||||||
|
try {
|
||||||
|
List<Session> sessions = sessionManagerService.getSessionsByKfId(openKfId, status, limit);
|
||||||
|
List<Map<String, Object>> result = new ArrayList<>();
|
||||||
|
|
||||||
|
for (Session session : sessions) {
|
||||||
|
Map<String, Object> map = new HashMap<>();
|
||||||
|
map.put("sessionId", session.getSessionId());
|
||||||
|
map.put("customerId", session.getCustomerId());
|
||||||
|
map.put("kfId", session.getKfId());
|
||||||
|
map.put("status", session.getStatus());
|
||||||
|
map.put("wxServiceState", session.getWxServiceState());
|
||||||
|
map.put("manualCsId", session.getManualCsId());
|
||||||
|
map.put("createdAt", session.getCreatedAt() != null ? session.getCreatedAt().toString() : null);
|
||||||
|
map.put("updatedAt", session.getUpdatedAt() != null ? session.getUpdatedAt().toString() : null);
|
||||||
|
|
||||||
|
int msgCount = sessionManagerService.getMessageCount(session.getSessionId());
|
||||||
|
map.put("messageCount", msgCount);
|
||||||
|
|
||||||
|
result.add(map);
|
||||||
|
}
|
||||||
|
|
||||||
|
return ApiResponse.success(result);
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("获取会话列表失败", e);
|
||||||
|
return ApiResponse.error("获取会话列表失败: " + e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/messages")
|
||||||
|
public ApiResponse<List<Map<String, Object>>> getMessages(@RequestParam String sessionId) {
|
||||||
|
try {
|
||||||
|
List<Message> messages = sessionManagerService.getSessionMessages(sessionId);
|
||||||
|
List<Map<String, Object>> result = new ArrayList<>();
|
||||||
|
|
||||||
|
for (Message msg : messages) {
|
||||||
|
Map<String, Object> map = new HashMap<>();
|
||||||
|
map.put("msgId", msg.getMsgId());
|
||||||
|
map.put("sessionId", msg.getSessionId());
|
||||||
|
map.put("senderType", msg.getSenderType());
|
||||||
|
map.put("senderId", msg.getSenderId());
|
||||||
|
map.put("content", msg.getContent());
|
||||||
|
map.put("msgType", msg.getMsgType());
|
||||||
|
map.put("createdAt", msg.getCreatedAt() != null ? msg.getCreatedAt().toString() : null);
|
||||||
|
result.add(map);
|
||||||
|
}
|
||||||
|
|
||||||
|
return ApiResponse.success(result);
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("获取消息列表失败", e);
|
||||||
|
return ApiResponse.error("获取消息列表失败: " + e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/session/{sessionId}/detail")
|
||||||
|
public ApiResponse<Map<String, Object>> getSessionDetail(@PathVariable String sessionId) {
|
||||||
|
try {
|
||||||
|
Session session = sessionManagerService.getSession(sessionId);
|
||||||
|
if (session == null) {
|
||||||
|
return ApiResponse.error("会话不存在");
|
||||||
|
}
|
||||||
|
|
||||||
|
Map<String, Object> result = new HashMap<>();
|
||||||
|
result.put("session", session);
|
||||||
|
|
||||||
|
List<Message> messages = sessionManagerService.getSessionMessages(sessionId);
|
||||||
|
result.put("messages", messages);
|
||||||
|
result.put("messageCount", messages.size());
|
||||||
|
|
||||||
|
return ApiResponse.success(result);
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("获取会话详情失败", e);
|
||||||
|
return ApiResponse.error("获取会话详情失败: " + e.getMessage());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,141 @@
|
||||||
|
package com.wecom.robot.controller;
|
||||||
|
|
||||||
|
import com.wecom.robot.config.WecomConfig;
|
||||||
|
import com.wecom.robot.dto.ApiResponse;
|
||||||
|
import com.wecom.robot.entity.Message;
|
||||||
|
import com.wecom.robot.service.SessionManagerService;
|
||||||
|
import com.wecom.robot.util.WXBizMsgCrypt;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.web.bind.annotation.*;
|
||||||
|
|
||||||
|
import java.util.Base64;
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@RestController
|
||||||
|
@RequestMapping("/debug")
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class DebugController {
|
||||||
|
|
||||||
|
private final WecomConfig wecomConfig;
|
||||||
|
private final SessionManagerService sessionManagerService;
|
||||||
|
|
||||||
|
@GetMapping("/config")
|
||||||
|
public ApiResponse<Map<String, Object>> getConfig() {
|
||||||
|
Map<String, Object> config = new HashMap<>();
|
||||||
|
config.put("corpId", wecomConfig.getCorpId());
|
||||||
|
config.put("token", wecomConfig.getToken());
|
||||||
|
config.put("encodingAesKey", wecomConfig.getEncodingAesKey());
|
||||||
|
config.put("encodingAesKeyLength", wecomConfig.getEncodingAesKey() != null ? wecomConfig.getEncodingAesKey().length() : 0);
|
||||||
|
|
||||||
|
try {
|
||||||
|
byte[] aesKey = Base64.getDecoder().decode(wecomConfig.getEncodingAesKey() + "=");
|
||||||
|
config.put("aesKeyLength", aesKey.length);
|
||||||
|
config.put("aesKeyHex", bytesToHex(aesKey));
|
||||||
|
} catch (Exception e) {
|
||||||
|
config.put("aesKeyError", e.getMessage());
|
||||||
|
}
|
||||||
|
|
||||||
|
return ApiResponse.success(config);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/decrypt")
|
||||||
|
public ApiResponse<Map<String, Object>> testDecrypt(
|
||||||
|
@RequestParam String msgSignature,
|
||||||
|
@RequestParam String timestamp,
|
||||||
|
@RequestParam String nonce,
|
||||||
|
@RequestBody String encryptedXml) {
|
||||||
|
|
||||||
|
Map<String, Object> result = new HashMap<>();
|
||||||
|
result.put("msgSignature", msgSignature);
|
||||||
|
result.put("timestamp", timestamp);
|
||||||
|
result.put("nonce", nonce);
|
||||||
|
|
||||||
|
try {
|
||||||
|
WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(
|
||||||
|
wecomConfig.getToken(),
|
||||||
|
wecomConfig.getEncodingAesKey(),
|
||||||
|
wecomConfig.getCorpId()
|
||||||
|
);
|
||||||
|
|
||||||
|
String decrypted = wxcpt.DecryptMsg(msgSignature, timestamp, nonce, encryptedXml);
|
||||||
|
result.put("decrypted", decrypted);
|
||||||
|
result.put("success", true);
|
||||||
|
} catch (Exception e) {
|
||||||
|
result.put("error", e.getMessage());
|
||||||
|
result.put("success", false);
|
||||||
|
log.error("解密测试失败", e);
|
||||||
|
}
|
||||||
|
|
||||||
|
return ApiResponse.success(result);
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/verify-url")
|
||||||
|
public ApiResponse<Map<String, Object>> testVerifyUrl(
|
||||||
|
@RequestParam String msgSignature,
|
||||||
|
@RequestParam String timestamp,
|
||||||
|
@RequestParam String nonce,
|
||||||
|
@RequestParam String echostr) {
|
||||||
|
|
||||||
|
Map<String, Object> result = new HashMap<>();
|
||||||
|
result.put("msgSignature", msgSignature);
|
||||||
|
result.put("timestamp", timestamp);
|
||||||
|
result.put("nonce", nonce);
|
||||||
|
result.put("echostr", echostr);
|
||||||
|
|
||||||
|
try {
|
||||||
|
WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(
|
||||||
|
wecomConfig.getToken(),
|
||||||
|
wecomConfig.getEncodingAesKey(),
|
||||||
|
wecomConfig.getCorpId()
|
||||||
|
);
|
||||||
|
|
||||||
|
String decrypted = wxcpt.VerifyURL(msgSignature, timestamp, nonce, echostr);
|
||||||
|
result.put("decrypted", decrypted);
|
||||||
|
result.put("success", true);
|
||||||
|
} catch (Exception e) {
|
||||||
|
result.put("error", e.getMessage());
|
||||||
|
result.put("success", false);
|
||||||
|
log.error("URL验证测试失败", e);
|
||||||
|
}
|
||||||
|
|
||||||
|
return ApiResponse.success(result);
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/ai/session/{sessionId}/context")
|
||||||
|
public ApiResponse<Map<String, Object>> getSessionAiContext(
|
||||||
|
@PathVariable String sessionId) {
|
||||||
|
|
||||||
|
Map<String, Object> result = new HashMap<>();
|
||||||
|
|
||||||
|
result.put("sessionId", sessionId);
|
||||||
|
|
||||||
|
List<Message> history = sessionManagerService.getSessionMessages(sessionId);
|
||||||
|
result.put("historyCount", history.size());
|
||||||
|
|
||||||
|
List<Map<String, Object>> historyList = new java.util.ArrayList<>();
|
||||||
|
for (Message msg : history) {
|
||||||
|
Map<String, Object> msgMap = new HashMap<>();
|
||||||
|
msgMap.put("senderType", msg.getSenderType());
|
||||||
|
msgMap.put("senderId", msg.getSenderId());
|
||||||
|
msgMap.put("content", msg.getContent());
|
||||||
|
msgMap.put("msgType", msg.getMsgType());
|
||||||
|
msgMap.put("createdAt", msg.getCreatedAt() != null ? msg.getCreatedAt().toString() : null);
|
||||||
|
historyList.add(msgMap);
|
||||||
|
}
|
||||||
|
result.put("history", historyList);
|
||||||
|
|
||||||
|
return ApiResponse.success(result);
|
||||||
|
}
|
||||||
|
|
||||||
|
private String bytesToHex(byte[] bytes) {
|
||||||
|
StringBuilder sb = new StringBuilder();
|
||||||
|
for (byte b : bytes) {
|
||||||
|
sb.append(String.format("%02x", b));
|
||||||
|
}
|
||||||
|
return sb.toString();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,197 @@
|
||||||
|
package com.wecom.robot.controller;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
|
||||||
|
import com.wecom.robot.dto.*;
|
||||||
|
import com.wecom.robot.entity.Message;
|
||||||
|
import com.wecom.robot.entity.Session;
|
||||||
|
import com.wecom.robot.mapper.MessageMapper;
|
||||||
|
import com.wecom.robot.mapper.SessionMapper;
|
||||||
|
import com.wecom.robot.service.SessionManagerService;
|
||||||
|
import com.wecom.robot.service.WecomApiService;
|
||||||
|
import com.wecom.robot.service.WebSocketService;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.web.bind.annotation.*;
|
||||||
|
|
||||||
|
import javax.validation.Valid;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.stream.Collectors;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@RestController
|
||||||
|
@RequestMapping("/api/sessions")
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class SessionController {
|
||||||
|
|
||||||
|
private final SessionMapper sessionMapper;
|
||||||
|
private final MessageMapper messageMapper;
|
||||||
|
private final SessionManagerService sessionManagerService;
|
||||||
|
private final WecomApiService wecomApiService;
|
||||||
|
private final WebSocketService webSocketService;
|
||||||
|
|
||||||
|
@GetMapping
|
||||||
|
public ApiResponse<List<SessionInfo>> getSessions(
|
||||||
|
@RequestParam(required = false) String status,
|
||||||
|
@RequestParam(required = false) String csId,
|
||||||
|
@RequestParam(required = false) String channelType) {
|
||||||
|
LambdaQueryWrapper<Session> query = new LambdaQueryWrapper<>();
|
||||||
|
|
||||||
|
if (status != null) {
|
||||||
|
query.eq(Session::getStatus, status);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (csId != null) {
|
||||||
|
query.eq(Session::getManualCsId, csId);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (channelType != null) {
|
||||||
|
query.eq(Session::getChannelType, channelType);
|
||||||
|
}
|
||||||
|
|
||||||
|
query.orderByDesc(Session::getUpdatedAt);
|
||||||
|
|
||||||
|
List<Session> sessions = sessionMapper.selectList(query);
|
||||||
|
|
||||||
|
List<SessionInfo> sessionInfos = sessions.stream().map(session -> {
|
||||||
|
SessionInfo info = new SessionInfo();
|
||||||
|
info.setSessionId(session.getSessionId());
|
||||||
|
info.setCustomerId(session.getCustomerId());
|
||||||
|
info.setKfId(session.getKfId());
|
||||||
|
info.setChannelType(session.getChannelType());
|
||||||
|
info.setStatus(session.getStatus());
|
||||||
|
info.setManualCsId(session.getManualCsId());
|
||||||
|
info.setCreatedAt(session.getCreatedAt());
|
||||||
|
info.setUpdatedAt(session.getUpdatedAt());
|
||||||
|
info.setMetadata(session.getMetadata());
|
||||||
|
|
||||||
|
LambdaQueryWrapper<Message> msgQuery = new LambdaQueryWrapper<>();
|
||||||
|
msgQuery.eq(Message::getSessionId, session.getSessionId())
|
||||||
|
.orderByDesc(Message::getCreatedAt)
|
||||||
|
.last("LIMIT 1");
|
||||||
|
Message lastMsg = messageMapper.selectOne(msgQuery);
|
||||||
|
if (lastMsg != null) {
|
||||||
|
info.setLastMessage(lastMsg.getContent());
|
||||||
|
info.setLastMessageTime(lastMsg.getCreatedAt());
|
||||||
|
}
|
||||||
|
|
||||||
|
int msgCount = sessionManagerService.getMessageCount(session.getSessionId());
|
||||||
|
info.setMessageCount(msgCount);
|
||||||
|
|
||||||
|
return info;
|
||||||
|
}).collect(Collectors.toList());
|
||||||
|
|
||||||
|
return ApiResponse.success(sessionInfos);
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/{sessionId}")
|
||||||
|
public ApiResponse<SessionInfo> getSession(@PathVariable String sessionId) {
|
||||||
|
Session session = sessionMapper.selectById(sessionId);
|
||||||
|
if (session == null) {
|
||||||
|
return ApiResponse.error(404, "会话不存在");
|
||||||
|
}
|
||||||
|
|
||||||
|
SessionInfo info = new SessionInfo();
|
||||||
|
info.setSessionId(session.getSessionId());
|
||||||
|
info.setCustomerId(session.getCustomerId());
|
||||||
|
info.setKfId(session.getKfId());
|
||||||
|
info.setChannelType(session.getChannelType());
|
||||||
|
info.setStatus(session.getStatus());
|
||||||
|
info.setManualCsId(session.getManualCsId());
|
||||||
|
info.setCreatedAt(session.getCreatedAt());
|
||||||
|
info.setUpdatedAt(session.getUpdatedAt());
|
||||||
|
info.setMetadata(session.getMetadata());
|
||||||
|
|
||||||
|
return ApiResponse.success(info);
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/{sessionId}/history")
|
||||||
|
public ApiResponse<List<MessageInfo>> getSessionHistory(@PathVariable String sessionId) {
|
||||||
|
LambdaQueryWrapper<Message> query = new LambdaQueryWrapper<>();
|
||||||
|
query.eq(Message::getSessionId, sessionId)
|
||||||
|
.orderByAsc(Message::getCreatedAt);
|
||||||
|
|
||||||
|
List<Message> messages = messageMapper.selectList(query);
|
||||||
|
|
||||||
|
List<MessageInfo> messageInfos = messages.stream().map(msg -> {
|
||||||
|
MessageInfo info = new MessageInfo();
|
||||||
|
info.setMsgId(msg.getMsgId());
|
||||||
|
info.setSessionId(msg.getSessionId());
|
||||||
|
info.setSenderType(msg.getSenderType());
|
||||||
|
info.setSenderId(msg.getSenderId());
|
||||||
|
info.setContent(msg.getContent());
|
||||||
|
info.setMsgType(msg.getMsgType());
|
||||||
|
info.setCreatedAt(msg.getCreatedAt());
|
||||||
|
return info;
|
||||||
|
}).collect(Collectors.toList());
|
||||||
|
|
||||||
|
return ApiResponse.success(messageInfos);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/{sessionId}/accept")
|
||||||
|
public ApiResponse<Void> acceptSession(
|
||||||
|
@PathVariable String sessionId,
|
||||||
|
@Valid @RequestBody AcceptSessionRequest request) {
|
||||||
|
Session session = sessionMapper.selectById(sessionId);
|
||||||
|
if (session == null) {
|
||||||
|
return ApiResponse.error(404, "会话不存在");
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!Session.STATUS_PENDING.equals(session.getStatus())) {
|
||||||
|
return ApiResponse.error(400, "会话状态不正确");
|
||||||
|
}
|
||||||
|
|
||||||
|
sessionManagerService.acceptTransfer(sessionId, request.getCsId());
|
||||||
|
webSocketService.notifySessionAccepted(sessionId, request.getCsId());
|
||||||
|
|
||||||
|
return ApiResponse.success(null);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/{sessionId}/message")
|
||||||
|
public ApiResponse<Void> sendMessage(
|
||||||
|
@PathVariable String sessionId,
|
||||||
|
@Valid @RequestBody SendMessageRequest request) {
|
||||||
|
Session session = sessionMapper.selectById(sessionId);
|
||||||
|
if (session == null) {
|
||||||
|
return ApiResponse.error(404, "会话不存在");
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!Session.STATUS_MANUAL.equals(session.getStatus())) {
|
||||||
|
return ApiResponse.error(400, "会话状态不正确");
|
||||||
|
}
|
||||||
|
|
||||||
|
boolean success = wecomApiService.sendTextMessage(
|
||||||
|
session.getCustomerId(),
|
||||||
|
session.getKfId(),
|
||||||
|
request.getContent()
|
||||||
|
);
|
||||||
|
|
||||||
|
if (!success) {
|
||||||
|
return ApiResponse.error(500, "消息发送失败");
|
||||||
|
}
|
||||||
|
|
||||||
|
sessionManagerService.saveMessage(
|
||||||
|
"manual_" + System.currentTimeMillis(),
|
||||||
|
sessionId,
|
||||||
|
Message.SENDER_TYPE_MANUAL,
|
||||||
|
session.getManualCsId(),
|
||||||
|
request.getContent(),
|
||||||
|
request.getMsgType() != null ? request.getMsgType() : "text",
|
||||||
|
null
|
||||||
|
);
|
||||||
|
|
||||||
|
return ApiResponse.success(null);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/{sessionId}/close")
|
||||||
|
public ApiResponse<Void> closeSession(@PathVariable String sessionId) {
|
||||||
|
Session session = sessionMapper.selectById(sessionId);
|
||||||
|
if (session == null) {
|
||||||
|
return ApiResponse.error(404, "会话不存在");
|
||||||
|
}
|
||||||
|
|
||||||
|
sessionManagerService.closeSession(sessionId);
|
||||||
|
webSocketService.notifySessionClosed(sessionId);
|
||||||
|
|
||||||
|
return ApiResponse.success(null);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,150 @@
|
||||||
|
package com.wecom.robot.controller;
|
||||||
|
|
||||||
|
import com.alibaba.fastjson.JSON;
|
||||||
|
import com.wecom.robot.dto.ApiResponse;
|
||||||
|
import com.wecom.robot.dto.SyncMsgResponse;
|
||||||
|
import com.wecom.robot.dto.WxCallbackMessage;
|
||||||
|
import com.wecom.robot.service.MessageProcessService;
|
||||||
|
import com.wecom.robot.service.WecomApiService;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.web.bind.annotation.*;
|
||||||
|
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.UUID;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@RestController
|
||||||
|
@RequestMapping("/test")
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class TestController {
|
||||||
|
|
||||||
|
private final MessageProcessService messageProcessService;
|
||||||
|
private final WecomApiService wecomApiService;
|
||||||
|
|
||||||
|
@PostMapping("/send-message")
|
||||||
|
public ApiResponse<Map<String, Object>> sendTestMessage(
|
||||||
|
@RequestParam(required = false, defaultValue = "test_customer_001") String customerId,
|
||||||
|
@RequestParam(required = false, defaultValue = "test_kf_001") String kfId,
|
||||||
|
@RequestParam String content) {
|
||||||
|
|
||||||
|
WxCallbackMessage message = new WxCallbackMessage();
|
||||||
|
message.setToUserName("system");
|
||||||
|
message.setFromUserName(customerId);
|
||||||
|
message.setCreateTime(String.valueOf(System.currentTimeMillis() / 1000));
|
||||||
|
message.setMsgType("text");
|
||||||
|
message.setContent(content);
|
||||||
|
message.setMsgId(UUID.randomUUID().toString());
|
||||||
|
message.setOpenKfId(kfId);
|
||||||
|
message.setExternalUserId(customerId);
|
||||||
|
|
||||||
|
Map<String, String> rawData = new HashMap<>();
|
||||||
|
rawData.put("ToUserName", "system");
|
||||||
|
rawData.put("FromUserName", customerId);
|
||||||
|
rawData.put("MsgType", "text");
|
||||||
|
rawData.put("Content", content);
|
||||||
|
rawData.put("MsgId", message.getMsgId());
|
||||||
|
rawData.put("OpenKfId", kfId);
|
||||||
|
rawData.put("ExternalUserId", customerId);
|
||||||
|
message.setRawData(rawData);
|
||||||
|
|
||||||
|
log.info("模拟发送消息(测试模式): customerId={}, kfId={}, content={}", customerId, kfId, content);
|
||||||
|
|
||||||
|
messageProcessService.processMessage(message);
|
||||||
|
|
||||||
|
Map<String, Object> result = new HashMap<>();
|
||||||
|
result.put("msgId", message.getMsgId());
|
||||||
|
result.put("customerId", customerId);
|
||||||
|
result.put("kfId", kfId);
|
||||||
|
result.put("content", content);
|
||||||
|
result.put("mode", "test_direct");
|
||||||
|
|
||||||
|
return ApiResponse.success(result);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/trigger-transfer")
|
||||||
|
public ApiResponse<Map<String, Object>> triggerTransfer(
|
||||||
|
@RequestParam(required = false, defaultValue = "test_customer_001") String customerId,
|
||||||
|
@RequestParam(required = false, defaultValue = "test_kf_001") String kfId) {
|
||||||
|
|
||||||
|
WxCallbackMessage message = new WxCallbackMessage();
|
||||||
|
message.setToUserName("system");
|
||||||
|
message.setFromUserName(customerId);
|
||||||
|
message.setCreateTime(String.valueOf(System.currentTimeMillis() / 1000));
|
||||||
|
message.setMsgType("text");
|
||||||
|
message.setContent("我要转人工");
|
||||||
|
message.setMsgId(UUID.randomUUID().toString());
|
||||||
|
message.setOpenKfId(kfId);
|
||||||
|
message.setExternalUserId(customerId);
|
||||||
|
|
||||||
|
Map<String, String> rawData = new HashMap<>();
|
||||||
|
rawData.put("ToUserName", "system");
|
||||||
|
rawData.put("FromUserName", customerId);
|
||||||
|
rawData.put("MsgType", "text");
|
||||||
|
rawData.put("Content", "我要转人工");
|
||||||
|
rawData.put("MsgId", message.getMsgId());
|
||||||
|
rawData.put("OpenKfId", kfId);
|
||||||
|
rawData.put("ExternalUserId", customerId);
|
||||||
|
message.setRawData(rawData);
|
||||||
|
|
||||||
|
log.info("模拟触发转人工(测试模式): customerId={}, kfId={}", customerId, kfId);
|
||||||
|
|
||||||
|
messageProcessService.processMessage(message);
|
||||||
|
|
||||||
|
Map<String, Object> result = new HashMap<>();
|
||||||
|
result.put("msgId", message.getMsgId());
|
||||||
|
result.put("customerId", customerId);
|
||||||
|
result.put("kfId", kfId);
|
||||||
|
result.put("trigger", "transfer");
|
||||||
|
result.put("mode", "test_direct");
|
||||||
|
|
||||||
|
return ApiResponse.success(result);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/simulate-event")
|
||||||
|
public ApiResponse<Map<String, Object>> simulateKfMsgEvent(
|
||||||
|
@RequestParam(required = false, defaultValue = "test_kf_001") String kfId,
|
||||||
|
@RequestParam(required = false) String token) {
|
||||||
|
|
||||||
|
WxCallbackMessage event = new WxCallbackMessage();
|
||||||
|
event.setMsgType("event");
|
||||||
|
event.setEvent(WxCallbackMessage.EVENT_KF_MSG_FROM_CUSTOMER);
|
||||||
|
event.setOpenKfId(kfId);
|
||||||
|
event.setToken(token);
|
||||||
|
event.setCreateTime(String.valueOf(System.currentTimeMillis() / 1000));
|
||||||
|
|
||||||
|
log.info("模拟客户消息事件: kfId={}, token={}", kfId, token);
|
||||||
|
|
||||||
|
messageProcessService.processKfMessageEvent(event);
|
||||||
|
|
||||||
|
Map<String, Object> result = new HashMap<>();
|
||||||
|
result.put("kfId", kfId);
|
||||||
|
result.put("token", token);
|
||||||
|
result.put("mode", "event_sync");
|
||||||
|
|
||||||
|
return ApiResponse.success(result);
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/sync-msg")
|
||||||
|
public ApiResponse<SyncMsgResponse> syncMessages(
|
||||||
|
@RequestParam String kfId,
|
||||||
|
@RequestParam(required = false) String token) {
|
||||||
|
|
||||||
|
log.info("手动拉取消息: kfId={}, token={}", kfId, token);
|
||||||
|
|
||||||
|
SyncMsgResponse response = wecomApiService.syncMessagesByToken(kfId, token);
|
||||||
|
|
||||||
|
return ApiResponse.success(response);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/clear-cursor")
|
||||||
|
public ApiResponse<Void> clearCursor(
|
||||||
|
@RequestParam String kfId) {
|
||||||
|
|
||||||
|
log.info("清除cursor: kfId={}", kfId);
|
||||||
|
wecomApiService.clearCursor(kfId);
|
||||||
|
|
||||||
|
return ApiResponse.success(null);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,114 @@
|
||||||
|
package com.wecom.robot.controller;
|
||||||
|
|
||||||
|
import com.wecom.robot.adapter.ChannelAdapter;
|
||||||
|
import com.wecom.robot.adapter.MessageSyncCapable;
|
||||||
|
import com.wecom.robot.config.WecomConfig;
|
||||||
|
import com.wecom.robot.dto.*;
|
||||||
|
import com.wecom.robot.service.MessageProcessService;
|
||||||
|
import com.wecom.robot.service.MessageRouterService;
|
||||||
|
import com.wecom.robot.util.WXBizMsgCrypt;
|
||||||
|
import com.wecom.robot.util.XmlUtil;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.web.bind.annotation.*;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 企业微信回调控制器
|
||||||
|
* <p>
|
||||||
|
* 负责验签/解密/解析，构建 InboundMessage 传递给 MessageRouterService。
|
||||||
|
* [AC-MCA-08] 入口层控制器
|
||||||
|
*/
|
||||||
|
@Slf4j
|
||||||
|
@RestController
|
||||||
|
@RequestMapping("/wecom")
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class WecomCallbackController {
|
||||||
|
|
||||||
|
private static final String CHANNEL_TYPE = "wechat";
|
||||||
|
|
||||||
|
private final WecomConfig wecomConfig;
|
||||||
|
private final MessageProcessService messageProcessService;
|
||||||
|
private final MessageRouterService messageRouterService;
|
||||||
|
private final Map<String, ChannelAdapter> channelAdapters;
|
||||||
|
|
||||||
|
@GetMapping("/callback")
|
||||||
|
public String verifyUrl(
|
||||||
|
@RequestParam("msg_signature") String msgSignature,
|
||||||
|
@RequestParam("timestamp") String timestamp,
|
||||||
|
@RequestParam("nonce") String nonce,
|
||||||
|
@RequestParam("echostr") String echostr) {
|
||||||
|
log.info("收到URL验证请求: msgSignature={}, timestamp={}, nonce={}", msgSignature, timestamp, nonce);
|
||||||
|
|
||||||
|
try {
|
||||||
|
WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(
|
||||||
|
wecomConfig.getToken(),
|
||||||
|
wecomConfig.getEncodingAesKey(),
|
||||||
|
wecomConfig.getCorpId()
|
||||||
|
);
|
||||||
|
String result = wxcpt.VerifyURL(msgSignature, timestamp, nonce, echostr);
|
||||||
|
log.info("URL验证成功，返回: {}", result);
|
||||||
|
return result;
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("URL验证失败", e);
|
||||||
|
return "error";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/callback")
|
||||||
|
public String handleCallback(
|
||||||
|
@RequestParam(value = "msg_signature", required = false) String msgSignature,
|
||||||
|
@RequestParam(value = "timestamp", required = false) String timestamp,
|
||||||
|
@RequestParam(value = "nonce", required = false) String nonce,
|
||||||
|
@RequestBody String requestBody) {
|
||||||
|
log.info("收到回调消息: msgSignature={}, timestamp={}, nonce={}", msgSignature, timestamp, nonce);
|
||||||
|
log.debug("消息内容: {}", requestBody);
|
||||||
|
|
||||||
|
try {
|
||||||
|
WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(
|
||||||
|
wecomConfig.getToken(),
|
||||||
|
wecomConfig.getEncodingAesKey(),
|
||||||
|
wecomConfig.getCorpId()
|
||||||
|
);
|
||||||
|
|
||||||
|
String decryptedXml = wxcpt.DecryptMsg(msgSignature, timestamp, nonce, requestBody);
|
||||||
|
log.info("解密后的XML: {}", decryptedXml);
|
||||||
|
|
||||||
|
Map<String, String> messageMap = XmlUtil.parseXml(decryptedXml);
|
||||||
|
WxCallbackMessage message = WxCallbackMessage.fromMap(messageMap);
|
||||||
|
|
||||||
|
log.info("解析后的消息: msgType={}, event={}, openKfId={}",
|
||||||
|
message.getMsgType(), message.getEvent(), message.getOpenKfId());
|
||||||
|
|
||||||
|
if ("event".equals(message.getMsgType())) {
|
||||||
|
handleEvent(message);
|
||||||
|
} else {
|
||||||
|
log.warn("收到非事件消息: msgType={}", message.getMsgType());
|
||||||
|
}
|
||||||
|
|
||||||
|
return "success";
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("处理回调消息失败", e);
|
||||||
|
return "success";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private void handleEvent(WxCallbackMessage message) {
|
||||||
|
String event = message.getEvent();
|
||||||
|
log.info("处理事件: event={}, openKfId={}, token={}",
|
||||||
|
event, message.getOpenKfId(), message.getToken());
|
||||||
|
|
||||||
|
if (message.isKfMsgEvent()) {
|
||||||
|
log.info("收到客户消息事件通知: openKfId={}, token={}",
|
||||||
|
message.getOpenKfId(), message.getToken());
|
||||||
|
messageProcessService.processKfMessageEvent(message);
|
||||||
|
} else if (message.isAccountOnlineEvent()) {
|
||||||
|
log.info("客服账号上线: openKfId={}", message.getOpenKfId());
|
||||||
|
} else if (message.isAccountOfflineEvent()) {
|
||||||
|
log.info("客服账号下线: openKfId={}", message.getOpenKfId());
|
||||||
|
} else {
|
||||||
|
log.info("其他事件: event={}", event);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,14 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import javax.validation.constraints.NotBlank;
|
||||||
|
import javax.validation.constraints.Size;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class AcceptSessionRequest {
|
||||||
|
|
||||||
|
@NotBlank(message = "客服ID不能为空")
|
||||||
|
@Size(min = 1, max = 64, message = "客服ID长度必须在1-64之间")
|
||||||
|
private String csId;
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,30 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class ApiResponse<T> {
|
||||||
|
|
||||||
|
private int code;
|
||||||
|
private String message;
|
||||||
|
private T data;
|
||||||
|
|
||||||
|
public static <T> ApiResponse<T> success(T data) {
|
||||||
|
ApiResponse<T> response = new ApiResponse<>();
|
||||||
|
response.setCode(0);
|
||||||
|
response.setMessage("success");
|
||||||
|
response.setData(data);
|
||||||
|
return response;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static <T> ApiResponse<T> error(int code, String message) {
|
||||||
|
ApiResponse<T> response = new ApiResponse<>();
|
||||||
|
response.setCode(code);
|
||||||
|
response.setMessage(message);
|
||||||
|
return response;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static <T> ApiResponse<T> error(String message) {
|
||||||
|
return error(500, message);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,34 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class ChatCompletionRequest {
|
||||||
|
|
||||||
|
private String model;
|
||||||
|
private List<Message> messages;
|
||||||
|
private double temperature;
|
||||||
|
private int maxTokens;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class Message {
|
||||||
|
private String role;
|
||||||
|
private String content;
|
||||||
|
|
||||||
|
public Message(String role, String content) {
|
||||||
|
this.role = role;
|
||||||
|
this.content = content;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public static ChatCompletionRequest create(String model, List<Message> messages) {
|
||||||
|
ChatCompletionRequest request = new ChatCompletionRequest();
|
||||||
|
request.setModel(model);
|
||||||
|
request.setMessages(messages);
|
||||||
|
request.setTemperature(0.7);
|
||||||
|
request.setMaxTokens(2000);
|
||||||
|
return request;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,43 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class ChatCompletionResponse {
|
||||||
|
|
||||||
|
private String id;
|
||||||
|
private String object;
|
||||||
|
private long created;
|
||||||
|
private String model;
|
||||||
|
private List<Choice> choices;
|
||||||
|
private Usage usage;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class Choice {
|
||||||
|
private int index;
|
||||||
|
private Message message;
|
||||||
|
private String finishReason;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class Message {
|
||||||
|
private String role;
|
||||||
|
private String content;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class Usage {
|
||||||
|
private int promptTokens;
|
||||||
|
private int completionTokens;
|
||||||
|
private int totalTokens;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getContent() {
|
||||||
|
if (choices != null && !choices.isEmpty()) {
|
||||||
|
return choices.get(0).getMessage().getContent();
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,49 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.AllArgsConstructor;
|
||||||
|
import lombok.Builder;
|
||||||
|
import lombok.Data;
|
||||||
|
import lombok.NoArgsConstructor;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@Builder
|
||||||
|
@NoArgsConstructor
|
||||||
|
@AllArgsConstructor
|
||||||
|
public class InboundMessage {
|
||||||
|
|
||||||
|
private String channelType;
|
||||||
|
|
||||||
|
private String channelMessageId;
|
||||||
|
|
||||||
|
private String sessionKey;
|
||||||
|
|
||||||
|
private String customerId;
|
||||||
|
|
||||||
|
private String kfId;
|
||||||
|
|
||||||
|
private String sender;
|
||||||
|
|
||||||
|
private String content;
|
||||||
|
|
||||||
|
private String msgType;
|
||||||
|
|
||||||
|
private String rawPayload;
|
||||||
|
|
||||||
|
private Long timestamp;
|
||||||
|
|
||||||
|
private SignatureInfo signatureInfo;
|
||||||
|
|
||||||
|
private Map<String, Object> metadata;
|
||||||
|
|
||||||
|
public static final String CHANNEL_WECHAT = "wechat";
|
||||||
|
public static final String CHANNEL_DOUYIN = "douyin";
|
||||||
|
public static final String CHANNEL_JD = "jd";
|
||||||
|
|
||||||
|
public static final String MSG_TYPE_TEXT = "text";
|
||||||
|
public static final String MSG_TYPE_IMAGE = "image";
|
||||||
|
public static final String MSG_TYPE_VOICE = "voice";
|
||||||
|
public static final String MSG_TYPE_VIDEO = "video";
|
||||||
|
public static final String MSG_TYPE_EVENT = "event";
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,32 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import javax.validation.constraints.NotBlank;
|
||||||
|
import javax.validation.constraints.Size;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class MessageInfo {
|
||||||
|
|
||||||
|
@NotBlank
|
||||||
|
@Size(min = 1, max = 128)
|
||||||
|
private String msgId;
|
||||||
|
|
||||||
|
@NotBlank
|
||||||
|
@Size(min = 1, max = 64)
|
||||||
|
private String sessionId;
|
||||||
|
|
||||||
|
@NotBlank
|
||||||
|
private String senderType;
|
||||||
|
|
||||||
|
@Size(max = 64)
|
||||||
|
private String senderId;
|
||||||
|
|
||||||
|
@NotBlank
|
||||||
|
@Size(min = 1, max = 4096)
|
||||||
|
private String content;
|
||||||
|
|
||||||
|
private String msgType;
|
||||||
|
|
||||||
|
private java.time.LocalDateTime createdAt;
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,27 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.AllArgsConstructor;
|
||||||
|
import lombok.Builder;
|
||||||
|
import lombok.Data;
|
||||||
|
import lombok.NoArgsConstructor;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@Builder
|
||||||
|
@NoArgsConstructor
|
||||||
|
@AllArgsConstructor
|
||||||
|
public class OutboundMessage {
|
||||||
|
|
||||||
|
private String channelType;
|
||||||
|
|
||||||
|
private String receiver;
|
||||||
|
|
||||||
|
private String kfId;
|
||||||
|
|
||||||
|
private String content;
|
||||||
|
|
||||||
|
private String msgType;
|
||||||
|
|
||||||
|
private Map<String, Object> metadata;
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,16 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import javax.validation.constraints.NotBlank;
|
||||||
|
import javax.validation.constraints.Size;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class SendMessageRequest {
|
||||||
|
|
||||||
|
@NotBlank(message = "消息内容不能为空")
|
||||||
|
@Size(min = 1, max = 4096, message = "消息内容长度必须在1-4096之间")
|
||||||
|
private String content;
|
||||||
|
|
||||||
|
private String msgType;
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,34 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class ServiceStateResponse {
|
||||||
|
|
||||||
|
private Integer errcode;
|
||||||
|
private String errmsg;
|
||||||
|
private Integer serviceState;
|
||||||
|
private String servicerUserid;
|
||||||
|
|
||||||
|
public boolean isSuccess() {
|
||||||
|
return errcode == null || errcode == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static final int STATE_UNTREATED = 0;
|
||||||
|
public static final int STATE_AI = 1;
|
||||||
|
public static final int STATE_POOL = 2;
|
||||||
|
public static final int STATE_MANUAL = 3;
|
||||||
|
public static final int STATE_CLOSED = 4;
|
||||||
|
|
||||||
|
public String getStateDesc() {
|
||||||
|
if (serviceState == null) return "未知";
|
||||||
|
switch (serviceState) {
|
||||||
|
case STATE_UNTREATED: return "未处理";
|
||||||
|
case STATE_AI: return "智能助手接待";
|
||||||
|
case STATE_POOL: return "待接入池排队";
|
||||||
|
case STATE_MANUAL: return "人工接待";
|
||||||
|
case STATE_CLOSED: return "已结束";
|
||||||
|
default: return "未知(" + serviceState + ")";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,44 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import javax.validation.constraints.NotBlank;
|
||||||
|
import javax.validation.constraints.Size;
|
||||||
|
import java.time.LocalDateTime;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class SessionInfo {
|
||||||
|
|
||||||
|
@NotBlank
|
||||||
|
@Size(min = 1, max = 64)
|
||||||
|
private String sessionId;
|
||||||
|
|
||||||
|
@NotBlank
|
||||||
|
@Size(min = 1, max = 64)
|
||||||
|
private String customerId;
|
||||||
|
|
||||||
|
@Size(max = 64)
|
||||||
|
private String kfId;
|
||||||
|
|
||||||
|
@Size(max = 64)
|
||||||
|
private String channelType;
|
||||||
|
|
||||||
|
@NotBlank
|
||||||
|
private String status;
|
||||||
|
|
||||||
|
@Size(max = 64)
|
||||||
|
private String manualCsId;
|
||||||
|
|
||||||
|
@Size(max = 4096)
|
||||||
|
private String lastMessage;
|
||||||
|
|
||||||
|
private LocalDateTime lastMessageTime;
|
||||||
|
|
||||||
|
private int messageCount;
|
||||||
|
|
||||||
|
private LocalDateTime createdAt;
|
||||||
|
|
||||||
|
private LocalDateTime updatedAt;
|
||||||
|
|
||||||
|
private String metadata;
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,21 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.AllArgsConstructor;
|
||||||
|
import lombok.Builder;
|
||||||
|
import lombok.Data;
|
||||||
|
import lombok.NoArgsConstructor;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@Builder
|
||||||
|
@NoArgsConstructor
|
||||||
|
@AllArgsConstructor
|
||||||
|
public class SignatureInfo {
|
||||||
|
|
||||||
|
private String signature;
|
||||||
|
|
||||||
|
private String timestamp;
|
||||||
|
|
||||||
|
private String nonce;
|
||||||
|
|
||||||
|
private String algorithm;
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,212 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import com.alibaba.fastjson.annotation.JSONField;
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class SyncMsgResponse {
|
||||||
|
|
||||||
|
private Integer errcode;
|
||||||
|
private String errmsg;
|
||||||
|
private String nextCursor;
|
||||||
|
private Boolean hasMore;
|
||||||
|
private List<MsgItem> msgList;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class MsgItem {
|
||||||
|
private String msgId;
|
||||||
|
private Integer origin;
|
||||||
|
private String externalUserId;
|
||||||
|
private String openKfId;
|
||||||
|
private Long sendTime;
|
||||||
|
private String msgType;
|
||||||
|
private String servicerUserid;
|
||||||
|
private String originData;
|
||||||
|
|
||||||
|
private TextContent text;
|
||||||
|
private ImageContent image;
|
||||||
|
private VoiceContent voice;
|
||||||
|
private VideoContent video;
|
||||||
|
private FileContent file;
|
||||||
|
private LocationContent location;
|
||||||
|
private LinkContent link;
|
||||||
|
private BusinessCardContent businessCard;
|
||||||
|
private MiniprogramContent miniprogram;
|
||||||
|
private MsgMenuContent msgmenu;
|
||||||
|
private EventContent event;
|
||||||
|
|
||||||
|
public static final int ORIGIN_CUSTOMER = 3;
|
||||||
|
public static final int ORIGIN_SYSTEM_EVENT = 4;
|
||||||
|
public static final int ORIGIN_SERVICER = 5;
|
||||||
|
|
||||||
|
public String getTextContent() {
|
||||||
|
return text != null ? text.getContent() : null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getImageMediaId() {
|
||||||
|
return image != null ? image.getMediaId() : null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isFromCustomer() {
|
||||||
|
return origin != null && origin == ORIGIN_CUSTOMER;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isSystemEvent() {
|
||||||
|
return origin != null && origin == ORIGIN_SYSTEM_EVENT;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isFromServicer() {
|
||||||
|
return origin != null && origin == ORIGIN_SERVICER;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isEvent() {
|
||||||
|
return "event".equals(msgType);
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getEventType() {
|
||||||
|
return event != null ? event.getEventType() : null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class TextContent {
|
||||||
|
private String content;
|
||||||
|
private String menuId;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class ImageContent {
|
||||||
|
private String mediaId;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class VoiceContent {
|
||||||
|
private String mediaId;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class VideoContent {
|
||||||
|
private String mediaId;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class FileContent {
|
||||||
|
private String mediaId;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class LocationContent {
|
||||||
|
private Double latitude;
|
||||||
|
private Double longitude;
|
||||||
|
private String name;
|
||||||
|
private String address;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class LinkContent {
|
||||||
|
private String title;
|
||||||
|
private String desc;
|
||||||
|
private String url;
|
||||||
|
private String picUrl;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class BusinessCardContent {
|
||||||
|
private String userid;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class MiniprogramContent {
|
||||||
|
private String title;
|
||||||
|
private String appid;
|
||||||
|
private String pagepath;
|
||||||
|
private String thumbMediaId;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class MsgMenuContent {
|
||||||
|
private String headContent;
|
||||||
|
private List<MenuItem> list;
|
||||||
|
private String tailContent;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class MenuItem {
|
||||||
|
private String type;
|
||||||
|
private MenuClick click;
|
||||||
|
private MenuView view;
|
||||||
|
private MenuMiniprogram miniprogram;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class MenuClick {
|
||||||
|
private String id;
|
||||||
|
private String content;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class MenuView {
|
||||||
|
private String url;
|
||||||
|
private String content;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class MenuMiniprogram {
|
||||||
|
private String appid;
|
||||||
|
private String pagepath;
|
||||||
|
private String content;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class EventContent {
|
||||||
|
@JSONField(name = "event_type")
|
||||||
|
private String eventType;
|
||||||
|
private String openKfId;
|
||||||
|
private String externalUserid;
|
||||||
|
private String scene;
|
||||||
|
private String sceneParam;
|
||||||
|
private String welcomeCode;
|
||||||
|
private String failMsgid;
|
||||||
|
private Integer failType;
|
||||||
|
private String servicerUserid;
|
||||||
|
private Integer status;
|
||||||
|
private Integer stopType;
|
||||||
|
private Integer changeType;
|
||||||
|
private String oldServicerUserid;
|
||||||
|
private String newServicerUserid;
|
||||||
|
private String msgCode;
|
||||||
|
private String recallMsgid;
|
||||||
|
private Integer rejectSwitch;
|
||||||
|
private WechatChannels wechatChannels;
|
||||||
|
|
||||||
|
public static final String EVENT_ENTER_SESSION = "enter_session";
|
||||||
|
public static final String EVENT_MSG_SEND_FAIL = "msg_send_fail";
|
||||||
|
public static final String EVENT_SERVICER_STATUS_CHANGE = "servicer_status_change";
|
||||||
|
public static final String EVENT_SESSION_STATUS_CHANGE = "session_status_change";
|
||||||
|
public static final String EVENT_USER_RECALL_MSG = "user_recall_msg";
|
||||||
|
public static final String EVENT_SERVICER_RECALL_MSG = "servicer_recall_msg";
|
||||||
|
public static final String EVENT_REJECT_CUSTOMER_MSG_SWITCH_CHANGE = "reject_customer_msg_switch_change";
|
||||||
|
|
||||||
|
public static final int CHANGE_TYPE_FROM_POOL = 1;
|
||||||
|
public static final int CHANGE_TYPE_TRANSFER = 2;
|
||||||
|
public static final int CHANGE_TYPE_END = 3;
|
||||||
|
public static final int CHANGE_TYPE_REENTER = 4;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class WechatChannels {
|
||||||
|
private String nickname;
|
||||||
|
private String shopNickname;
|
||||||
|
private Integer scene;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isSuccess() {
|
||||||
|
return errcode == null || errcode == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean hasMessages() {
|
||||||
|
return msgList != null && !msgList.isEmpty();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,21 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class WxAccessToken {
|
||||||
|
|
||||||
|
private String accessToken;
|
||||||
|
private long expiresIn;
|
||||||
|
private long createTime;
|
||||||
|
|
||||||
|
public WxAccessToken(String accessToken, long expiresIn) {
|
||||||
|
this.accessToken = accessToken;
|
||||||
|
this.expiresIn = expiresIn;
|
||||||
|
this.createTime = System.currentTimeMillis();
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isExpired() {
|
||||||
|
return System.currentTimeMillis() - createTime > (expiresIn - 300) * 1000;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,65 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class WxCallbackMessage {
|
||||||
|
|
||||||
|
private String toUserName;
|
||||||
|
private String fromUserName;
|
||||||
|
private String createTime;
|
||||||
|
private String msgType;
|
||||||
|
private String content;
|
||||||
|
private String msgId;
|
||||||
|
private String event;
|
||||||
|
private String openKfId;
|
||||||
|
private String externalUserId;
|
||||||
|
private String welcomeCode;
|
||||||
|
private String token;
|
||||||
|
private String origin;
|
||||||
|
private String serviceCorpId;
|
||||||
|
private String changeType;
|
||||||
|
private String servicerUserid;
|
||||||
|
private Map<String, String> rawData;
|
||||||
|
|
||||||
|
public static final String EVENT_KF_MSG_OR_EVENT = "kf_msg_or_event";
|
||||||
|
public static final String EVENT_KF_MSG_FROM_CUSTOMER = "kf_msg_from_customer";
|
||||||
|
public static final String EVENT_KF_ACCOUNT_ONLINE = "kf_account_online";
|
||||||
|
public static final String EVENT_KF_ACCOUNT_OFFLINE = "kf_account_offline";
|
||||||
|
public static final String EVENT_MSG_AUDIT_APPROVED = "msg_audit_approved";
|
||||||
|
|
||||||
|
public static WxCallbackMessage fromMap(Map<String, String> map) {
|
||||||
|
WxCallbackMessage msg = new WxCallbackMessage();
|
||||||
|
msg.setToUserName(map.get("ToUserName"));
|
||||||
|
msg.setFromUserName(map.get("FromUserName"));
|
||||||
|
msg.setCreateTime(map.get("CreateTime"));
|
||||||
|
msg.setMsgType(map.get("MsgType"));
|
||||||
|
msg.setContent(map.get("Content"));
|
||||||
|
msg.setMsgId(map.get("MsgId"));
|
||||||
|
msg.setEvent(map.get("Event"));
|
||||||
|
msg.setOpenKfId(map.get("OpenKfId"));
|
||||||
|
msg.setExternalUserId(map.get("ExternalUserId"));
|
||||||
|
msg.setWelcomeCode(map.get("WelcomeCode"));
|
||||||
|
msg.setToken(map.get("Token"));
|
||||||
|
msg.setOrigin(map.get("Origin"));
|
||||||
|
msg.setServiceCorpId(map.get("ServiceCorpId"));
|
||||||
|
msg.setChangeType(map.get("ChangeType"));
|
||||||
|
msg.setServicerUserid(map.get("ServicerUserid"));
|
||||||
|
msg.setRawData(map);
|
||||||
|
return msg;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isKfMsgEvent() {
|
||||||
|
return EVENT_KF_MSG_OR_EVENT.equals(event) || EVENT_KF_MSG_FROM_CUSTOMER.equals(event);
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isAccountOnlineEvent() {
|
||||||
|
return EVENT_KF_ACCOUNT_ONLINE.equals(event);
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isAccountOfflineEvent() {
|
||||||
|
return EVENT_KF_ACCOUNT_OFFLINE.equals(event);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,58 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import com.alibaba.fastjson.annotation.JSONField;
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public class WxSendMessageRequest {
|
||||||
|
|
||||||
|
private String touser;
|
||||||
|
|
||||||
|
@JSONField(name = "open_kfid")
|
||||||
|
private String openKfid;
|
||||||
|
|
||||||
|
private String msgtype;
|
||||||
|
private TextContent text;
|
||||||
|
private ImageContent image;
|
||||||
|
private LinkContent link;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class TextContent {
|
||||||
|
private String content;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class ImageContent {
|
||||||
|
private String mediaId;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Data
|
||||||
|
public static class LinkContent {
|
||||||
|
private String title;
|
||||||
|
private String desc;
|
||||||
|
private String url;
|
||||||
|
private String thumbMediaId;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static WxSendMessageRequest text(String touser, String openKfid, String content) {
|
||||||
|
WxSendMessageRequest request = new WxSendMessageRequest();
|
||||||
|
request.setTouser(touser);
|
||||||
|
request.setOpenKfid(openKfid);
|
||||||
|
request.setMsgtype("text");
|
||||||
|
TextContent textContent = new TextContent();
|
||||||
|
textContent.setContent(content);
|
||||||
|
request.setText(textContent);
|
||||||
|
return request;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static WxSendMessageRequest image(String touser, String openKfid, String mediaId) {
|
||||||
|
WxSendMessageRequest request = new WxSendMessageRequest();
|
||||||
|
request.setTouser(touser);
|
||||||
|
request.setOpenKfid(openKfid);
|
||||||
|
request.setMsgtype("image");
|
||||||
|
ImageContent imageContent = new ImageContent();
|
||||||
|
imageContent.setMediaId(mediaId);
|
||||||
|
request.setImage(imageContent);
|
||||||
|
return request;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,34 @@
|
||||||
|
package com.wecom.robot.dto.ai;
|
||||||
|
|
||||||
|
import lombok.AllArgsConstructor;
|
||||||
|
import lombok.Builder;
|
||||||
|
import lombok.Data;
|
||||||
|
import lombok.NoArgsConstructor;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@Builder
|
||||||
|
@NoArgsConstructor
|
||||||
|
@AllArgsConstructor
|
||||||
|
public class ChatMessage {
|
||||||
|
|
||||||
|
private String role;
|
||||||
|
|
||||||
|
private String content;
|
||||||
|
|
||||||
|
public static final String ROLE_USER = "user";
|
||||||
|
public static final String ROLE_ASSISTANT = "assistant";
|
||||||
|
|
||||||
|
public static ChatMessage userMessage(String content) {
|
||||||
|
return ChatMessage.builder()
|
||||||
|
.role(ROLE_USER)
|
||||||
|
.content(content)
|
||||||
|
.build();
|
||||||
|
}
|
||||||
|
|
||||||
|
public static ChatMessage assistantMessage(String content) {
|
||||||
|
return ChatMessage.builder()
|
||||||
|
.role(ROLE_ASSISTANT)
|
||||||
|
.content(content)
|
||||||
|
.build();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,48 @@
|
||||||
|
package com.wecom.robot.dto.ai;
|
||||||
|
|
||||||
|
import com.wecom.robot.dto.InboundMessage;
|
||||||
|
import lombok.AllArgsConstructor;
|
||||||
|
import lombok.Builder;
|
||||||
|
import lombok.Data;
|
||||||
|
import lombok.NoArgsConstructor;
|
||||||
|
|
||||||
|
import java.util.ArrayList;
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@Builder
|
||||||
|
@NoArgsConstructor
|
||||||
|
@AllArgsConstructor
|
||||||
|
public class ChatRequest {
|
||||||
|
|
||||||
|
private String sessionId;
|
||||||
|
|
||||||
|
private String currentMessage;
|
||||||
|
|
||||||
|
private String channelType;
|
||||||
|
|
||||||
|
@Builder.Default
|
||||||
|
private List<ChatMessage> history = new ArrayList<>();
|
||||||
|
|
||||||
|
@Builder.Default
|
||||||
|
private Map<String, Object> metadata = new HashMap<>();
|
||||||
|
|
||||||
|
public static ChatRequest fromInboundMessage(InboundMessage msg) {
|
||||||
|
return ChatRequest.builder()
|
||||||
|
.sessionId(msg.getSessionKey())
|
||||||
|
.currentMessage(msg.getContent())
|
||||||
|
.channelType(msg.getChannelType())
|
||||||
|
.build();
|
||||||
|
}
|
||||||
|
|
||||||
|
public static ChatRequest fromInboundMessage(InboundMessage msg, List<ChatMessage> history) {
|
||||||
|
return ChatRequest.builder()
|
||||||
|
.sessionId(msg.getSessionKey())
|
||||||
|
.currentMessage(msg.getContent())
|
||||||
|
.channelType(msg.getChannelType())
|
||||||
|
.history(history)
|
||||||
|
.build();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,44 @@
|
||||||
|
package com.wecom.robot.dto.ai;
|
||||||
|
|
||||||
|
import lombok.AllArgsConstructor;
|
||||||
|
import lombok.Builder;
|
||||||
|
import lombok.Data;
|
||||||
|
import lombok.NoArgsConstructor;
|
||||||
|
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@Builder
|
||||||
|
@NoArgsConstructor
|
||||||
|
@AllArgsConstructor
|
||||||
|
public class ChatResponse {
|
||||||
|
|
||||||
|
private String reply;
|
||||||
|
|
||||||
|
private Double confidence;
|
||||||
|
|
||||||
|
private Boolean shouldTransfer;
|
||||||
|
|
||||||
|
private String transferReason;
|
||||||
|
|
||||||
|
@Builder.Default
|
||||||
|
private Map<String, Object> metadata = new HashMap<>();
|
||||||
|
|
||||||
|
public static ChatResponse fallback(String reply) {
|
||||||
|
return ChatResponse.builder()
|
||||||
|
.reply(reply)
|
||||||
|
.confidence(0.0)
|
||||||
|
.shouldTransfer(true)
|
||||||
|
.build();
|
||||||
|
}
|
||||||
|
|
||||||
|
public static ChatResponse fallbackWithTransfer(String reply, String reason) {
|
||||||
|
return ChatResponse.builder()
|
||||||
|
.reply(reply)
|
||||||
|
.confidence(0.0)
|
||||||
|
.shouldTransfer(true)
|
||||||
|
.transferReason(reason)
|
||||||
|
.build();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,34 @@
|
||||||
|
package com.wecom.robot.entity;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.annotation.IdType;
|
||||||
|
import com.baomidou.mybatisplus.annotation.TableId;
|
||||||
|
import com.baomidou.mybatisplus.annotation.TableName;
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.io.Serializable;
|
||||||
|
import java.time.LocalDateTime;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@TableName("kf_account")
|
||||||
|
public class KfAccount implements Serializable {
|
||||||
|
|
||||||
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
|
@TableId(value = "kf_id", type = IdType.INPUT)
|
||||||
|
private String kfId;
|
||||||
|
|
||||||
|
private String name;
|
||||||
|
|
||||||
|
private String avatar;
|
||||||
|
|
||||||
|
private String status;
|
||||||
|
|
||||||
|
private String bindManualId;
|
||||||
|
|
||||||
|
private LocalDateTime createdAt;
|
||||||
|
|
||||||
|
private LocalDateTime updatedAt;
|
||||||
|
|
||||||
|
public static final String STATUS_ONLINE = "online";
|
||||||
|
public static final String STATUS_OFFLINE = "offline";
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,39 @@
|
||||||
|
package com.wecom.robot.entity;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.annotation.IdType;
|
||||||
|
import com.baomidou.mybatisplus.annotation.TableField;
|
||||||
|
import com.baomidou.mybatisplus.annotation.TableId;
|
||||||
|
import com.baomidou.mybatisplus.annotation.TableName;
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.io.Serializable;
|
||||||
|
import java.time.LocalDateTime;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@TableName("message")
|
||||||
|
public class Message implements Serializable {
|
||||||
|
|
||||||
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
|
@TableId(value = "msg_id", type = IdType.ASSIGN_ID)
|
||||||
|
private String msgId;
|
||||||
|
|
||||||
|
private String sessionId;
|
||||||
|
|
||||||
|
private String senderType;
|
||||||
|
|
||||||
|
private String senderId;
|
||||||
|
|
||||||
|
private String content;
|
||||||
|
|
||||||
|
private String msgType;
|
||||||
|
|
||||||
|
private LocalDateTime createdAt;
|
||||||
|
|
||||||
|
@TableField(typeHandler = com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler.class)
|
||||||
|
private String rawData;
|
||||||
|
|
||||||
|
public static final String SENDER_TYPE_CUSTOMER = "customer";
|
||||||
|
public static final String SENDER_TYPE_AI = "ai";
|
||||||
|
public static final String SENDER_TYPE_MANUAL = "manual";
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,48 @@
|
||||||
|
package com.wecom.robot.entity;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.annotation.IdType;
|
||||||
|
import com.baomidou.mybatisplus.annotation.TableField;
|
||||||
|
import com.baomidou.mybatisplus.annotation.TableId;
|
||||||
|
import com.baomidou.mybatisplus.annotation.TableName;
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.io.Serializable;
|
||||||
|
import java.time.LocalDateTime;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@TableName("session")
|
||||||
|
public class Session implements Serializable {
|
||||||
|
|
||||||
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
|
@TableId(value = "session_id", type = IdType.ASSIGN_ID)
|
||||||
|
private String sessionId;
|
||||||
|
|
||||||
|
private String customerId;
|
||||||
|
|
||||||
|
private String kfId;
|
||||||
|
|
||||||
|
private String channelType;
|
||||||
|
|
||||||
|
private String status;
|
||||||
|
|
||||||
|
private Integer wxServiceState;
|
||||||
|
|
||||||
|
private LocalDateTime createdAt;
|
||||||
|
|
||||||
|
private LocalDateTime updatedAt;
|
||||||
|
|
||||||
|
private String manualCsId;
|
||||||
|
|
||||||
|
@TableField(typeHandler = com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler.class)
|
||||||
|
private String metadata;
|
||||||
|
|
||||||
|
public static final String STATUS_AI = "AI";
|
||||||
|
public static final String STATUS_PENDING = "PENDING";
|
||||||
|
public static final String STATUS_MANUAL = "MANUAL";
|
||||||
|
public static final String STATUS_CLOSED = "CLOSED";
|
||||||
|
|
||||||
|
public static final String CHANNEL_WECHAT = "wechat";
|
||||||
|
public static final String CHANNEL_DOUYIN = "douyin";
|
||||||
|
public static final String CHANNEL_JD = "jd";
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,29 @@
|
||||||
|
package com.wecom.robot.entity;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.annotation.IdType;
|
||||||
|
import com.baomidou.mybatisplus.annotation.TableId;
|
||||||
|
import com.baomidou.mybatisplus.annotation.TableName;
|
||||||
|
import lombok.Data;
|
||||||
|
|
||||||
|
import java.io.Serializable;
|
||||||
|
import java.time.LocalDateTime;
|
||||||
|
|
||||||
|
@Data
|
||||||
|
@TableName("transfer_log")
|
||||||
|
public class TransferLog implements Serializable {
|
||||||
|
|
||||||
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
|
@TableId(value = "id", type = IdType.AUTO)
|
||||||
|
private Long id;
|
||||||
|
|
||||||
|
private String sessionId;
|
||||||
|
|
||||||
|
private String triggerReason;
|
||||||
|
|
||||||
|
private LocalDateTime triggerTime;
|
||||||
|
|
||||||
|
private LocalDateTime acceptedTime;
|
||||||
|
|
||||||
|
private String acceptedCsId;
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,9 @@
|
||||||
|
package com.wecom.robot.mapper;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
|
||||||
|
import com.wecom.robot.entity.KfAccount;
|
||||||
|
import org.apache.ibatis.annotations.Mapper;
|
||||||
|
|
||||||
|
@Mapper
|
||||||
|
public interface KfAccountMapper extends BaseMapper<KfAccount> {
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,9 @@
|
||||||
|
package com.wecom.robot.mapper;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
|
||||||
|
import com.wecom.robot.entity.Message;
|
||||||
|
import org.apache.ibatis.annotations.Mapper;
|
||||||
|
|
||||||
|
@Mapper
|
||||||
|
public interface MessageMapper extends BaseMapper<Message> {
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,9 @@
|
||||||
|
package com.wecom.robot.mapper;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
|
||||||
|
import com.wecom.robot.entity.Session;
|
||||||
|
import org.apache.ibatis.annotations.Mapper;
|
||||||
|
|
||||||
|
@Mapper
|
||||||
|
public interface SessionMapper extends BaseMapper<Session> {
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,9 @@
|
||||||
|
package com.wecom.robot.mapper;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
|
||||||
|
import com.wecom.robot.entity.TransferLog;
|
||||||
|
import org.apache.ibatis.annotations.Mapper;
|
||||||
|
|
||||||
|
@Mapper
|
||||||
|
public interface TransferLogMapper extends BaseMapper<TransferLog> {
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,13 @@
|
||||||
|
package com.wecom.robot.service;
|
||||||
|
|
||||||
|
import com.wecom.robot.dto.ai.ChatRequest;
|
||||||
|
import com.wecom.robot.dto.ai.ChatResponse;
|
||||||
|
|
||||||
|
import java.util.concurrent.CompletableFuture;
|
||||||
|
|
||||||
|
public interface AiServiceClient {
|
||||||
|
|
||||||
|
CompletableFuture<ChatResponse> generateReply(ChatRequest request);
|
||||||
|
|
||||||
|
boolean healthCheck();
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,304 @@
|
||||||
|
package com.wecom.robot.service;
|
||||||
|
|
||||||
|
import com.alibaba.fastjson.JSON;
|
||||||
|
import com.wecom.robot.adapter.ChannelAdapter;
|
||||||
|
import com.wecom.robot.adapter.MessageSyncCapable;
|
||||||
|
import com.wecom.robot.dto.InboundMessage;
|
||||||
|
import com.wecom.robot.dto.ServiceStateResponse;
|
||||||
|
import com.wecom.robot.dto.SyncMsgResponse;
|
||||||
|
import com.wecom.robot.dto.WxCallbackMessage;
|
||||||
|
import com.wecom.robot.entity.Message;
|
||||||
|
import com.wecom.robot.entity.Session;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.scheduling.annotation.Async;
|
||||||
|
import org.springframework.stereotype.Service;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 消息处理服务
|
||||||
|
* <p>
|
||||||
|
* 负责从微信拉取消息并转换为 InboundMessage 传递给 MessageRouterService。
|
||||||
|
* [AC-MCA-08] 消息处理服务
|
||||||
|
*/
|
||||||
|
@Slf4j
|
||||||
|
@Service
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class MessageProcessService {
|
||||||
|
|
||||||
|
private static final String CHANNEL_TYPE = "wechat";
|
||||||
|
|
||||||
|
private final SessionManagerService sessionManagerService;
|
||||||
|
private final TransferService transferService;
|
||||||
|
private final WecomApiService wecomApiService;
|
||||||
|
private final WebSocketService webSocketService;
|
||||||
|
private final MessageRouterService messageRouterService;
|
||||||
|
private final Map<String, ChannelAdapter> channelAdapters;
|
||||||
|
|
||||||
|
@Async
|
||||||
|
public void processKfMessageEvent(WxCallbackMessage event) {
|
||||||
|
String openKfId = event.getOpenKfId();
|
||||||
|
String token = event.getToken();
|
||||||
|
|
||||||
|
log.info("[AC-MCA-08] 处理客户消息事件: openKfId={}, token={}", openKfId, token);
|
||||||
|
|
||||||
|
if (openKfId == null) {
|
||||||
|
log.warn("事件缺少openKfId");
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
SyncMsgResponse syncResponse = wecomApiService.syncMessagesByToken(openKfId, token);
|
||||||
|
|
||||||
|
if (!syncResponse.isSuccess()) {
|
||||||
|
log.error("拉取消息失败: errcode={}, errmsg={}",
|
||||||
|
syncResponse.getErrcode(), syncResponse.getErrmsg());
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!syncResponse.hasMessages()) {
|
||||||
|
log.info("没有新消息");
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("拉取到{}条消息", syncResponse.getMsgList().size());
|
||||||
|
|
||||||
|
for (SyncMsgResponse.MsgItem msgItem : syncResponse.getMsgList()) {
|
||||||
|
try {
|
||||||
|
processSyncedItem(msgItem);
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("处理消息失败: msgId={}", msgItem.getMsgId(), e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
while (Boolean.TRUE.equals(syncResponse.getHasMore())) {
|
||||||
|
log.info("还有更多消息，继续拉取...");
|
||||||
|
syncResponse = wecomApiService.syncMessages(openKfId, null);
|
||||||
|
|
||||||
|
if (!syncResponse.isSuccess() || !syncResponse.hasMessages()) {
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
|
||||||
|
for (SyncMsgResponse.MsgItem msgItem : syncResponse.getMsgList()) {
|
||||||
|
try {
|
||||||
|
processSyncedItem(msgItem);
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("处理消息失败: msgId={}", msgItem.getMsgId(), e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private void processSyncedItem(SyncMsgResponse.MsgItem msgItem) {
|
||||||
|
String customerId = msgItem.getExternalUserId();
|
||||||
|
String kfId = msgItem.getOpenKfId();
|
||||||
|
|
||||||
|
log.info("[AC-MCA-08] 处理消息项: msgId={}, origin={}, msgType={}, customerId={}",
|
||||||
|
msgItem.getMsgId(), msgItem.getOrigin(), msgItem.getMsgType(), customerId);
|
||||||
|
|
||||||
|
if (msgItem.isEvent()) {
|
||||||
|
processEventMessage(msgItem);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!msgItem.isFromCustomer()) {
|
||||||
|
log.debug("非客户消息，跳过处理: origin={}", msgItem.getOrigin());
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (customerId == null || kfId == null) {
|
||||||
|
log.warn("消息缺少必要字段: customerId={}, kfId={}", customerId, kfId);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
ServiceStateResponse wxState = wecomApiService.getServiceState(kfId, customerId);
|
||||||
|
if (!wxState.isSuccess()) {
|
||||||
|
log.warn("获取微信会话状态失败: errcode={}, errmsg={}",
|
||||||
|
wxState.getErrcode(), wxState.getErrmsg());
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("微信会话状态: {} ({})", wxState.getStateDesc(), wxState.getServiceState());
|
||||||
|
|
||||||
|
Session session = sessionManagerService.getOrCreateSession(customerId, kfId);
|
||||||
|
sessionManagerService.updateWxServiceState(session.getSessionId(), wxState.getServiceState());
|
||||||
|
|
||||||
|
InboundMessage inboundMessage = buildInboundMessage(msgItem, customerId, kfId);
|
||||||
|
|
||||||
|
messageRouterService.processInboundMessage(inboundMessage);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void processEventMessage(SyncMsgResponse.MsgItem msgItem) {
|
||||||
|
SyncMsgResponse.EventContent event = msgItem.getEvent();
|
||||||
|
if (event == null) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
String eventType = event.getEventType();
|
||||||
|
String customerId = event.getExternalUserid();
|
||||||
|
String kfId = event.getOpenKfId();
|
||||||
|
|
||||||
|
log.info("处理事件消息: eventType={}, customerId={}, kfId={}", eventType, customerId, kfId);
|
||||||
|
|
||||||
|
switch (eventType) {
|
||||||
|
case SyncMsgResponse.EventContent.EVENT_ENTER_SESSION:
|
||||||
|
handleEnterSessionEvent(event, customerId, kfId);
|
||||||
|
break;
|
||||||
|
case SyncMsgResponse.EventContent.EVENT_SESSION_STATUS_CHANGE:
|
||||||
|
handleSessionStatusChangeEvent(event, customerId, kfId);
|
||||||
|
break;
|
||||||
|
case SyncMsgResponse.EventContent.EVENT_MSG_SEND_FAIL:
|
||||||
|
log.warn("消息发送失败: failMsgid={}, failType={}",
|
||||||
|
event.getFailMsgid(), event.getFailType());
|
||||||
|
break;
|
||||||
|
case SyncMsgResponse.EventContent.EVENT_USER_RECALL_MSG:
|
||||||
|
log.info("用户撤回消息: recallMsgid={}", event.getRecallMsgid());
|
||||||
|
break;
|
||||||
|
default:
|
||||||
|
log.info("其他事件类型: {}", eventType);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private void handleEnterSessionEvent(SyncMsgResponse.EventContent event,
|
||||||
|
String customerId, String kfId) {
|
||||||
|
log.info("用户进入会话: customerId={}, scene={}, sceneParam={}",
|
||||||
|
customerId, event.getScene(), event.getSceneParam());
|
||||||
|
|
||||||
|
Session session = sessionManagerService.getOrCreateSession(customerId, kfId);
|
||||||
|
|
||||||
|
String welcomeCode = event.getWelcomeCode();
|
||||||
|
if (welcomeCode != null && !welcomeCode.isEmpty()) {
|
||||||
|
String welcomeMsg = "您好，欢迎咨询！请问有什么可以帮您？";
|
||||||
|
wecomApiService.sendWelcomeMsg(welcomeCode, welcomeMsg);
|
||||||
|
|
||||||
|
sessionManagerService.saveMessage(
|
||||||
|
"welcome_" + System.currentTimeMillis(),
|
||||||
|
session.getSessionId(),
|
||||||
|
Message.SENDER_TYPE_AI,
|
||||||
|
"AI",
|
||||||
|
welcomeMsg,
|
||||||
|
"text",
|
||||||
|
null
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private void handleSessionStatusChangeEvent(SyncMsgResponse.EventContent event,
|
||||||
|
String customerId, String kfId) {
|
||||||
|
Integer changeType = event.getChangeType();
|
||||||
|
String newServicerUserid = event.getNewServicerUserid();
|
||||||
|
String oldServicerUserid = event.getOldServicerUserid();
|
||||||
|
|
||||||
|
log.info("会话状态变更: changeType={}, oldServicer={}, newServicer={}",
|
||||||
|
changeType, oldServicerUserid, newServicerUserid);
|
||||||
|
|
||||||
|
Session session = sessionManagerService.getOrCreateSession(customerId, kfId);
|
||||||
|
|
||||||
|
switch (changeType) {
|
||||||
|
case SyncMsgResponse.EventContent.CHANGE_TYPE_FROM_POOL:
|
||||||
|
log.info("从接待池接入会话: servicer={}", newServicerUserid);
|
||||||
|
sessionManagerService.updateSessionStatus(session.getSessionId(), Session.STATUS_MANUAL);
|
||||||
|
sessionManagerService.updateServicer(session.getSessionId(), newServicerUserid);
|
||||||
|
break;
|
||||||
|
case SyncMsgResponse.EventContent.CHANGE_TYPE_TRANSFER:
|
||||||
|
log.info("转接会话: oldServicer={}, newServicer={}", oldServicerUserid, newServicerUserid);
|
||||||
|
sessionManagerService.updateServicer(session.getSessionId(), newServicerUserid);
|
||||||
|
break;
|
||||||
|
case SyncMsgResponse.EventContent.CHANGE_TYPE_END:
|
||||||
|
log.info("结束会话");
|
||||||
|
sessionManagerService.updateSessionStatus(session.getSessionId(), Session.STATUS_CLOSED);
|
||||||
|
break;
|
||||||
|
case SyncMsgResponse.EventContent.CHANGE_TYPE_REENTER:
|
||||||
|
log.info("重新接入已结束会话: servicer={}", newServicerUserid);
|
||||||
|
sessionManagerService.updateSessionStatus(session.getSessionId(), Session.STATUS_MANUAL);
|
||||||
|
sessionManagerService.updateServicer(session.getSessionId(), newServicerUserid);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private InboundMessage buildInboundMessage(SyncMsgResponse.MsgItem msgItem,
|
||||||
|
String customerId, String kfId) {
|
||||||
|
String content = extractContent(msgItem);
|
||||||
|
String sessionKey = kfId + "_" + customerId;
|
||||||
|
|
||||||
|
return InboundMessage.builder()
|
||||||
|
.channelType(InboundMessage.CHANNEL_WECHAT)
|
||||||
|
.channelMessageId(msgItem.getMsgId())
|
||||||
|
.sessionKey(sessionKey)
|
||||||
|
.customerId(customerId)
|
||||||
|
.kfId(kfId)
|
||||||
|
.sender(customerId)
|
||||||
|
.content(content)
|
||||||
|
.msgType(msgItem.getMsgType())
|
||||||
|
.rawPayload(msgItem.getOriginData())
|
||||||
|
.timestamp(System.currentTimeMillis())
|
||||||
|
.build();
|
||||||
|
}
|
||||||
|
|
||||||
|
private String extractContent(SyncMsgResponse.MsgItem msgItem) {
|
||||||
|
String msgType = msgItem.getMsgType();
|
||||||
|
|
||||||
|
switch (msgType) {
|
||||||
|
case "text":
|
||||||
|
return msgItem.getTextContent();
|
||||||
|
case "image":
|
||||||
|
return "[图片]";
|
||||||
|
case "voice":
|
||||||
|
return "[语音]";
|
||||||
|
case "video":
|
||||||
|
return "[视频]";
|
||||||
|
case "file":
|
||||||
|
return "[文件]";
|
||||||
|
case "location":
|
||||||
|
SyncMsgResponse.LocationContent loc = msgItem.getLocation();
|
||||||
|
if (loc != null) {
|
||||||
|
return "[位置] " + loc.getName() + " " + loc.getAddress();
|
||||||
|
}
|
||||||
|
return "[位置]";
|
||||||
|
case "link":
|
||||||
|
SyncMsgResponse.LinkContent link = msgItem.getLink();
|
||||||
|
if (link != null) {
|
||||||
|
return "[链接] " + link.getTitle();
|
||||||
|
}
|
||||||
|
return "[链接]";
|
||||||
|
case "business_card":
|
||||||
|
return "[名片]";
|
||||||
|
case "miniprogram":
|
||||||
|
return "[小程序]";
|
||||||
|
case "msgmenu":
|
||||||
|
return "[菜单消息]";
|
||||||
|
default:
|
||||||
|
return "[" + msgType + "]";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Async
|
||||||
|
public void processMessage(WxCallbackMessage message) {
|
||||||
|
log.info("[AC-MCA-08] 直接处理消息(测试用): msgType={}", message.getMsgType());
|
||||||
|
|
||||||
|
String customerId = message.getExternalUserId();
|
||||||
|
String kfId = message.getOpenKfId();
|
||||||
|
|
||||||
|
if (customerId == null || kfId == null) {
|
||||||
|
log.warn("消息缺少必要字段: customerId={}, kfId={}", customerId, kfId);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
String sessionKey = kfId + "_" + customerId;
|
||||||
|
|
||||||
|
InboundMessage inboundMessage = InboundMessage.builder()
|
||||||
|
.channelType(InboundMessage.CHANNEL_WECHAT)
|
||||||
|
.channelMessageId(message.getMsgId() != null ? message.getMsgId() : "test_" + System.currentTimeMillis())
|
||||||
|
.sessionKey(sessionKey)
|
||||||
|
.customerId(customerId)
|
||||||
|
.kfId(kfId)
|
||||||
|
.sender(customerId)
|
||||||
|
.content(message.getContent())
|
||||||
|
.msgType(message.getMsgType() != null ? message.getMsgType() : "text")
|
||||||
|
.rawPayload(JSON.toJSONString(message.getRawData()))
|
||||||
|
.timestamp(System.currentTimeMillis())
|
||||||
|
.build();
|
||||||
|
|
||||||
|
messageRouterService.processInboundMessage(inboundMessage);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,81 @@
|
||||||
|
package com.wecom.robot.service;
|
||||||
|
|
||||||
|
import com.wecom.robot.dto.InboundMessage;
|
||||||
|
import com.wecom.robot.entity.Session;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 消息路由服务接口 - 渠道无关的消息路由核心服务
|
||||||
|
*
|
||||||
|
* <p>职责：
|
||||||
|
* <ul>
|
||||||
|
* <li>处理入站消息的统一路由</li>
|
||||||
|
* <li>根据会话状态分发到 AI 服务或人工客服</li>
|
||||||
|
* <li>协调消息处理流程中的各组件</li>
|
||||||
|
* </ul>
|
||||||
|
*
|
||||||
|
* <p>关联 AC: [AC-MCA-08] 统一消息路由
|
||||||
|
*
|
||||||
|
* @see InboundMessage
|
||||||
|
* @see Session
|
||||||
|
*/
|
||||||
|
public interface MessageRouterService {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 处理入站消息 - 主入口方法
|
||||||
|
*
|
||||||
|
* <p>执行流程：
|
||||||
|
* <ol>
|
||||||
|
* <li>幂等性检查（基于 channelMessageId）</li>
|
||||||
|
* <li>获取或创建会话</li>
|
||||||
|
* <li>根据会话状态路由消息</li>
|
||||||
|
* </ol>
|
||||||
|
*
|
||||||
|
* @param message 入站消息，包含渠道类型、消息内容等信息
|
||||||
|
*/
|
||||||
|
void processInboundMessage(InboundMessage message);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据会话状态路由消息
|
||||||
|
*
|
||||||
|
* <p>路由规则：
|
||||||
|
* <ul>
|
||||||
|
* <li>AI 状态 → dispatchToAiService</li>
|
||||||
|
* <li>PENDING 状态 → dispatchToPendingPool</li>
|
||||||
|
* <li>MANUAL 状态 → dispatchToManualCs</li>
|
||||||
|
* </ul>
|
||||||
|
*
|
||||||
|
* @param session 当前会话
|
||||||
|
* @param message 入站消息
|
||||||
|
*/
|
||||||
|
void routeBySessionState(Session session, InboundMessage message);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 分发到 AI 服务处理
|
||||||
|
*
|
||||||
|
* <p>调用 AI 服务生成回复，并根据返回结果判断是否需要转人工
|
||||||
|
*
|
||||||
|
* @param session 当前会话
|
||||||
|
* @param message 入站消息
|
||||||
|
*/
|
||||||
|
void dispatchToAiService(Session session, InboundMessage message);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 分发到人工客服处理
|
||||||
|
*
|
||||||
|
* <p>将消息推送给在线的人工客服（通过 WebSocket）
|
||||||
|
*
|
||||||
|
* @param session 当前会话
|
||||||
|
* @param message 入站消息
|
||||||
|
*/
|
||||||
|
void dispatchToManualCs(Session session, InboundMessage message);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 分发到待接入池
|
||||||
|
*
|
||||||
|
* <p>将消息暂存，等待人工客服接入
|
||||||
|
*
|
||||||
|
* @param session 当前会话
|
||||||
|
* @param message 入站消息
|
||||||
|
*/
|
||||||
|
void dispatchToPendingPool(Session session, InboundMessage message);
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,243 @@
|
||||||
|
package com.wecom.robot.service;
|
||||||
|
|
||||||
|
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
|
||||||
|
import com.wecom.robot.entity.Message;
|
||||||
|
import com.wecom.robot.entity.Session;
|
||||||
|
import com.wecom.robot.entity.TransferLog;
|
||||||
|
import com.wecom.robot.mapper.MessageMapper;
|
||||||
|
import com.wecom.robot.mapper.SessionMapper;
|
||||||
|
import com.wecom.robot.mapper.TransferLogMapper;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.data.redis.core.StringRedisTemplate;
|
||||||
|
import org.springframework.stereotype.Service;
|
||||||
|
import org.springframework.transaction.annotation.Transactional;
|
||||||
|
|
||||||
|
import java.time.LocalDateTime;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.concurrent.TimeUnit;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 会话管理服务
|
||||||
|
*
|
||||||
|
* <p>关联 AC: [AC-MCA-11] 会话管理, [AC-MCA-12] 渠道类型支持
|
||||||
|
*/
|
||||||
|
@Slf4j
|
||||||
|
@Service
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class SessionManagerService {
|
||||||
|
|
||||||
|
private static final String SESSION_STATUS_KEY_PREFIX = "session:status:";
|
||||||
|
private static final String SESSION_MESSAGE_COUNT_KEY_PREFIX = "session:msg_count:";
|
||||||
|
|
||||||
|
private final SessionMapper sessionMapper;
|
||||||
|
private final MessageMapper messageMapper;
|
||||||
|
private final TransferLogMapper transferLogMapper;
|
||||||
|
private final StringRedisTemplate redisTemplate;
|
||||||
|
|
||||||
|
public Session getOrCreateSession(String customerId, String kfId) {
|
||||||
|
return getOrCreateSession(customerId, kfId, Session.CHANNEL_WECHAT);
|
||||||
|
}
|
||||||
|
|
||||||
|
public Session getOrCreateSession(String customerId, String kfId, String channelType) {
|
||||||
|
LambdaQueryWrapper<Session> query = new LambdaQueryWrapper<>();
|
||||||
|
query.eq(Session::getCustomerId, customerId)
|
||||||
|
.eq(Session::getKfId, kfId)
|
||||||
|
.ne(Session::getStatus, Session.STATUS_CLOSED)
|
||||||
|
.orderByDesc(Session::getCreatedAt)
|
||||||
|
.last("LIMIT 1");
|
||||||
|
|
||||||
|
Session session = sessionMapper.selectOne(query);
|
||||||
|
if (session == null) {
|
||||||
|
session = new Session();
|
||||||
|
session.setSessionId(generateSessionId(customerId, kfId));
|
||||||
|
session.setCustomerId(customerId);
|
||||||
|
session.setKfId(kfId);
|
||||||
|
session.setChannelType(channelType != null ? channelType : Session.CHANNEL_WECHAT);
|
||||||
|
session.setStatus(Session.STATUS_AI);
|
||||||
|
session.setWxServiceState(0);
|
||||||
|
session.setCreatedAt(LocalDateTime.now());
|
||||||
|
session.setUpdatedAt(LocalDateTime.now());
|
||||||
|
sessionMapper.insert(session);
|
||||||
|
|
||||||
|
cacheSessionStatus(session.getSessionId(), Session.STATUS_AI);
|
||||||
|
log.info("[AC-MCA-11] 创建新会话: sessionId={}, channelType={}",
|
||||||
|
session.getSessionId(), session.getChannelType());
|
||||||
|
}
|
||||||
|
|
||||||
|
return session;
|
||||||
|
}
|
||||||
|
|
||||||
|
public Session getSession(String sessionId) {
|
||||||
|
return sessionMapper.selectById(sessionId);
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getSessionStatus(String sessionId) {
|
||||||
|
String cachedStatus = redisTemplate.opsForValue().get(SESSION_STATUS_KEY_PREFIX + sessionId);
|
||||||
|
if (cachedStatus != null) {
|
||||||
|
return cachedStatus;
|
||||||
|
}
|
||||||
|
|
||||||
|
Session session = sessionMapper.selectById(sessionId);
|
||||||
|
if (session != null) {
|
||||||
|
cacheSessionStatus(sessionId, session.getStatus());
|
||||||
|
return session.getStatus();
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void updateSessionStatus(String sessionId, String status) {
|
||||||
|
Session session = new Session();
|
||||||
|
session.setSessionId(sessionId);
|
||||||
|
session.setStatus(status);
|
||||||
|
session.setUpdatedAt(LocalDateTime.now());
|
||||||
|
sessionMapper.updateById(session);
|
||||||
|
|
||||||
|
cacheSessionStatus(sessionId, status);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void updateWxServiceState(String sessionId, Integer wxServiceState) {
|
||||||
|
Session session = new Session();
|
||||||
|
session.setSessionId(sessionId);
|
||||||
|
session.setWxServiceState(wxServiceState);
|
||||||
|
session.setUpdatedAt(LocalDateTime.now());
|
||||||
|
sessionMapper.updateById(session);
|
||||||
|
log.info("更新微信会话状态: sessionId={}, wxServiceState={}", sessionId, wxServiceState);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void updateServicer(String sessionId, String servicerUserid) {
|
||||||
|
Session session = new Session();
|
||||||
|
session.setSessionId(sessionId);
|
||||||
|
session.setManualCsId(servicerUserid);
|
||||||
|
session.setUpdatedAt(LocalDateTime.now());
|
||||||
|
sessionMapper.updateById(session);
|
||||||
|
log.info("更新接待人员: sessionId={}, servicerUserid={}", sessionId, servicerUserid);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void assignManualCs(String sessionId, String csId) {
|
||||||
|
Session session = new Session();
|
||||||
|
session.setSessionId(sessionId);
|
||||||
|
session.setStatus(Session.STATUS_MANUAL);
|
||||||
|
session.setManualCsId(csId);
|
||||||
|
session.setUpdatedAt(LocalDateTime.now());
|
||||||
|
sessionMapper.updateById(session);
|
||||||
|
|
||||||
|
cacheSessionStatus(sessionId, Session.STATUS_MANUAL);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Transactional
|
||||||
|
public void transferToManual(String sessionId, String reason) {
|
||||||
|
updateSessionStatus(sessionId, Session.STATUS_PENDING);
|
||||||
|
|
||||||
|
TransferLog transferLog = new TransferLog();
|
||||||
|
transferLog.setSessionId(sessionId);
|
||||||
|
transferLog.setTriggerReason(reason);
|
||||||
|
transferLog.setTriggerTime(LocalDateTime.now());
|
||||||
|
transferLogMapper.insert(transferLog);
|
||||||
|
|
||||||
|
log.info("会话转人工: sessionId={}, reason={}", sessionId, reason);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void acceptTransfer(String sessionId, String csId) {
|
||||||
|
assignManualCs(sessionId, csId);
|
||||||
|
|
||||||
|
LambdaQueryWrapper<TransferLog> query = new LambdaQueryWrapper<>();
|
||||||
|
query.eq(TransferLog::getSessionId, sessionId)
|
||||||
|
.isNull(TransferLog::getAcceptedTime)
|
||||||
|
.orderByDesc(TransferLog::getTriggerTime)
|
||||||
|
.last("LIMIT 1");
|
||||||
|
|
||||||
|
TransferLog transferLog = transferLogMapper.selectOne(query);
|
||||||
|
if (transferLog != null) {
|
||||||
|
transferLog.setAcceptedTime(LocalDateTime.now());
|
||||||
|
transferLog.setAcceptedCsId(csId);
|
||||||
|
transferLogMapper.updateById(transferLog);
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("客服接入会话: sessionId={}, csId={}", sessionId, csId);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void closeSession(String sessionId) {
|
||||||
|
updateSessionStatus(sessionId, Session.STATUS_CLOSED);
|
||||||
|
redisTemplate.delete(SESSION_STATUS_KEY_PREFIX + sessionId);
|
||||||
|
redisTemplate.delete(SESSION_MESSAGE_COUNT_KEY_PREFIX + sessionId);
|
||||||
|
log.info("会话已关闭: sessionId={}", sessionId);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void saveMessage(String msgId, String sessionId, String senderType, String senderId,
|
||||||
|
String content, String msgType, String rawData) {
|
||||||
|
Message message = new Message();
|
||||||
|
message.setMsgId(msgId);
|
||||||
|
message.setSessionId(sessionId);
|
||||||
|
message.setSenderType(senderType);
|
||||||
|
message.setSenderId(senderId);
|
||||||
|
message.setContent(content);
|
||||||
|
message.setMsgType(msgType);
|
||||||
|
message.setCreatedAt(LocalDateTime.now());
|
||||||
|
message.setRawData(rawData);
|
||||||
|
messageMapper.insert(message);
|
||||||
|
|
||||||
|
incrementMessageCount(sessionId);
|
||||||
|
}
|
||||||
|
|
||||||
|
public List<Message> getSessionMessages(String sessionId) {
|
||||||
|
LambdaQueryWrapper<Message> query = new LambdaQueryWrapper<>();
|
||||||
|
query.eq(Message::getSessionId, sessionId)
|
||||||
|
.orderByAsc(Message::getCreatedAt);
|
||||||
|
return messageMapper.selectList(query);
|
||||||
|
}
|
||||||
|
|
||||||
|
public int getMessageCount(String sessionId) {
|
||||||
|
String count = redisTemplate.opsForValue().get(SESSION_MESSAGE_COUNT_KEY_PREFIX + sessionId);
|
||||||
|
if (count != null) {
|
||||||
|
return Integer.parseInt(count);
|
||||||
|
}
|
||||||
|
|
||||||
|
LambdaQueryWrapper<Message> query = new LambdaQueryWrapper<>();
|
||||||
|
query.eq(Message::getSessionId, sessionId);
|
||||||
|
long dbCount = messageMapper.selectCount(query);
|
||||||
|
redisTemplate.opsForValue().set(SESSION_MESSAGE_COUNT_KEY_PREFIX + sessionId, String.valueOf(dbCount));
|
||||||
|
return (int) dbCount;
|
||||||
|
}
|
||||||
|
|
||||||
|
public List<Session> getSessionsByKfId(String kfId, String status, int limit) {
|
||||||
|
LambdaQueryWrapper<Session> query = new LambdaQueryWrapper<>();
|
||||||
|
query.eq(Session::getKfId, kfId);
|
||||||
|
if (status != null && !status.isEmpty() && !"all".equals(status)) {
|
||||||
|
query.eq(Session::getStatus, status);
|
||||||
|
}
|
||||||
|
query.orderByDesc(Session::getUpdatedAt);
|
||||||
|
query.last("LIMIT " + limit);
|
||||||
|
return sessionMapper.selectList(query);
|
||||||
|
}
|
||||||
|
|
||||||
|
public List<Session> getSessionsByChannelType(String channelType, String status, int limit) {
|
||||||
|
LambdaQueryWrapper<Session> query = new LambdaQueryWrapper<>();
|
||||||
|
query.eq(Session::getChannelType, channelType);
|
||||||
|
if (status != null && !status.isEmpty() && !"all".equals(status)) {
|
||||||
|
query.eq(Session::getStatus, status);
|
||||||
|
}
|
||||||
|
query.orderByDesc(Session::getUpdatedAt);
|
||||||
|
query.last("LIMIT " + limit);
|
||||||
|
return sessionMapper.selectList(query);
|
||||||
|
}
|
||||||
|
|
||||||
|
public List<Session> getAllSessions(int limit) {
|
||||||
|
LambdaQueryWrapper<Session> query = new LambdaQueryWrapper<>();
|
||||||
|
query.orderByDesc(Session::getUpdatedAt);
|
||||||
|
query.last("LIMIT " + limit);
|
||||||
|
return sessionMapper.selectList(query);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void cacheSessionStatus(String sessionId, String status) {
|
||||||
|
redisTemplate.opsForValue().set(SESSION_STATUS_KEY_PREFIX + sessionId, status, 24, TimeUnit.HOURS);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void incrementMessageCount(String sessionId) {
|
||||||
|
redisTemplate.opsForValue().increment(SESSION_MESSAGE_COUNT_KEY_PREFIX + sessionId);
|
||||||
|
}
|
||||||
|
|
||||||
|
private String generateSessionId(String customerId, String kfId) {
|
||||||
|
return kfId + "_" + customerId + "_" + System.currentTimeMillis();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,87 @@
|
||||||
|
package com.wecom.robot.service;
|
||||||
|
|
||||||
|
import com.wecom.robot.config.TransferConfig;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.stereotype.Service;
|
||||||
|
|
||||||
|
import java.time.LocalDateTime;
|
||||||
|
import java.time.ZoneId;
|
||||||
|
import java.util.Date;
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@Service
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class TransferService {
|
||||||
|
|
||||||
|
private final TransferConfig transferConfig;
|
||||||
|
|
||||||
|
public boolean shouldTransferToManual(String message, double confidence, int messageCount, LocalDateTime sessionCreatedAt) {
|
||||||
|
if (containsKeywords(message)) {
|
||||||
|
log.info("触发转人工: 关键词匹配");
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (confidence < transferConfig.getConfidenceThreshold()) {
|
||||||
|
log.info("触发转人工: AI置信度过低 confidence={}", confidence);
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (messageCount >= transferConfig.getMaxMessageRounds()) {
|
||||||
|
log.info("触发转人工: 消息轮次过多 count={}", messageCount);
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (sessionCreatedAt != null) {
|
||||||
|
long duration = System.currentTimeMillis() -
|
||||||
|
sessionCreatedAt.atZone(ZoneId.systemDefault()).toInstant().toEpochMilli();
|
||||||
|
if (duration >= transferConfig.getMaxSessionDuration()) {
|
||||||
|
log.info("触发转人工: 会话时长超限 duration={}ms", duration);
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getTransferReason(String message, double confidence, int messageCount) {
|
||||||
|
List<String> keywords = transferConfig.getKeywords();
|
||||||
|
if (keywords != null) {
|
||||||
|
for (String keyword : keywords) {
|
||||||
|
if (message != null && message.contains(keyword)) {
|
||||||
|
return "关键词触发: " + keyword;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (confidence < transferConfig.getConfidenceThreshold()) {
|
||||||
|
return "AI置信度过低: " + confidence;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (messageCount >= transferConfig.getMaxMessageRounds()) {
|
||||||
|
return "消息轮次过多: " + messageCount;
|
||||||
|
}
|
||||||
|
|
||||||
|
return "其他原因";
|
||||||
|
}
|
||||||
|
|
||||||
|
private boolean containsKeywords(String message) {
|
||||||
|
if (message == null) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
List<String> keywords = transferConfig.getKeywords();
|
||||||
|
if (keywords == null) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
for (String keyword : keywords) {
|
||||||
|
if (message.contains(keyword)) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,71 @@
|
||||||
|
package com.wecom.robot.service;
|
||||||
|
|
||||||
|
import com.wecom.robot.dto.WxCallbackMessage;
|
||||||
|
import com.wecom.robot.websocket.CsWebSocketHandler;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.stereotype.Service;
|
||||||
|
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@Service
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class WebSocketService {
|
||||||
|
|
||||||
|
private final CsWebSocketHandler webSocketHandler;
|
||||||
|
|
||||||
|
public void notifyNewPendingSession(String sessionId) {
|
||||||
|
Map<String, Object> message = new HashMap<>();
|
||||||
|
message.put("type", "new_pending_session");
|
||||||
|
message.put("sessionId", sessionId);
|
||||||
|
message.put("timestamp", System.currentTimeMillis());
|
||||||
|
|
||||||
|
webSocketHandler.broadcastToAll(message);
|
||||||
|
log.info("通知新待接入会话: sessionId={}", sessionId);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void notifyNewMessage(String sessionId, WxCallbackMessage wxMessage) {
|
||||||
|
Map<String, Object> message = new HashMap<>();
|
||||||
|
message.put("type", "new_message");
|
||||||
|
message.put("sessionId", sessionId);
|
||||||
|
message.put("content", wxMessage.getContent());
|
||||||
|
message.put("msgType", wxMessage.getMsgType());
|
||||||
|
message.put("timestamp", System.currentTimeMillis());
|
||||||
|
|
||||||
|
webSocketHandler.sendMessageToSession(sessionId, message);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void pushMessageToCs(String sessionId, WxCallbackMessage wxMessage) {
|
||||||
|
Map<String, Object> message = new HashMap<>();
|
||||||
|
message.put("type", "customer_message");
|
||||||
|
message.put("sessionId", sessionId);
|
||||||
|
message.put("content", wxMessage.getContent());
|
||||||
|
message.put("msgType", wxMessage.getMsgType());
|
||||||
|
message.put("customerId", wxMessage.getExternalUserId());
|
||||||
|
message.put("timestamp", System.currentTimeMillis());
|
||||||
|
|
||||||
|
webSocketHandler.sendMessageToSession(sessionId, message);
|
||||||
|
log.info("推送客户消息给客服: sessionId={}", sessionId);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void notifySessionAccepted(String sessionId, String csId) {
|
||||||
|
Map<String, Object> message = new HashMap<>();
|
||||||
|
message.put("type", "session_accepted");
|
||||||
|
message.put("sessionId", sessionId);
|
||||||
|
message.put("csId", csId);
|
||||||
|
message.put("timestamp", System.currentTimeMillis());
|
||||||
|
|
||||||
|
webSocketHandler.sendMessageToCs(csId, message);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void notifySessionClosed(String sessionId) {
|
||||||
|
Map<String, Object> message = new HashMap<>();
|
||||||
|
message.put("type", "session_closed");
|
||||||
|
message.put("sessionId", sessionId);
|
||||||
|
message.put("timestamp", System.currentTimeMillis());
|
||||||
|
|
||||||
|
webSocketHandler.sendMessageToSession(sessionId, message);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,256 @@
|
||||||
|
package com.wecom.robot.service;
|
||||||
|
|
||||||
|
import com.alibaba.fastjson.JSON;
|
||||||
|
import com.alibaba.fastjson.JSONObject;
|
||||||
|
import com.wecom.robot.config.WecomConfig;
|
||||||
|
import com.wecom.robot.dto.ServiceStateResponse;
|
||||||
|
import com.wecom.robot.dto.SyncMsgResponse;
|
||||||
|
import com.wecom.robot.dto.WxSendMessageRequest;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.data.redis.core.StringRedisTemplate;
|
||||||
|
import org.springframework.http.*;
|
||||||
|
import org.springframework.stereotype.Service;
|
||||||
|
import org.springframework.web.client.RestTemplate;
|
||||||
|
|
||||||
|
import java.util.concurrent.TimeUnit;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@Service
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class WecomApiService {
|
||||||
|
|
||||||
|
private static final String GET_ACCESS_TOKEN_URL = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={corpId}&corpsecret={secret}";
|
||||||
|
private static final String SEND_MESSAGE_URL = "https://qyapi.weixin.qq.com/cgi-bin/kf/send_msg?access_token={accessToken}";
|
||||||
|
private static final String GET_KF_LIST_URL = "https://qyapi.weixin.qq.com/cgi-bin/kf/account/list?access_token={accessToken}";
|
||||||
|
private static final String SYNC_MESSAGE_URL = "https://qyapi.weixin.qq.com/cgi-bin/kf/sync_msg?access_token={accessToken}";
|
||||||
|
private static final String GET_SERVICE_STATE_URL = "https://qyapi.weixin.qq.com/cgi-bin/kf/service_state/get?access_token={accessToken}";
|
||||||
|
private static final String TRANS_SERVICE_STATE_URL = "https://qyapi.weixin.qq.com/cgi-bin/kf/service_state/trans?access_token={accessToken}";
|
||||||
|
private static final String SEND_EVENT_MSG_URL = "https://qyapi.weixin.qq.com/cgi-bin/kf/send_msg_on_event?access_token={accessToken}";
|
||||||
|
|
||||||
|
private static final String REDIS_TOKEN_KEY = "wecom:access_token";
|
||||||
|
private static final String REDIS_TOKEN_LOCK_KEY = "wecom:access_token_lock";
|
||||||
|
private static final String REDIS_CURSOR_KEY_PREFIX = "wecom:cursor:";
|
||||||
|
|
||||||
|
private final WecomConfig wecomConfig;
|
||||||
|
private final StringRedisTemplate redisTemplate;
|
||||||
|
private final RestTemplate restTemplate = new RestTemplate();
|
||||||
|
|
||||||
|
public String getAccessToken() {
|
||||||
|
String cachedToken = redisTemplate.opsForValue().get(REDIS_TOKEN_KEY);
|
||||||
|
if (cachedToken != null) {
|
||||||
|
return cachedToken;
|
||||||
|
}
|
||||||
|
|
||||||
|
Boolean locked = redisTemplate.opsForValue().setIfAbsent(REDIS_TOKEN_LOCK_KEY, "1", 10, TimeUnit.SECONDS);
|
||||||
|
if (Boolean.TRUE.equals(locked)) {
|
||||||
|
try {
|
||||||
|
String url = GET_ACCESS_TOKEN_URL
|
||||||
|
.replace("{corpId}", wecomConfig.getCorpId())
|
||||||
|
.replace("{secret}", wecomConfig.getSecret());
|
||||||
|
|
||||||
|
ResponseEntity<String> response = restTemplate.getForEntity(url, String.class);
|
||||||
|
JSONObject json = JSON.parseObject(response.getBody());
|
||||||
|
|
||||||
|
if (json.getInteger("errcode") != null && json.getInteger("errcode") != 0) {
|
||||||
|
log.error("获取access_token失败: {}", json);
|
||||||
|
throw new RuntimeException("获取access_token失败: " + json.getString("errmsg"));
|
||||||
|
}
|
||||||
|
|
||||||
|
String accessToken = json.getString("access_token");
|
||||||
|
long expiresIn = json.getLongValue("expires_in");
|
||||||
|
|
||||||
|
redisTemplate.opsForValue().set(REDIS_TOKEN_KEY, accessToken, expiresIn - 300, TimeUnit.SECONDS);
|
||||||
|
return accessToken;
|
||||||
|
} finally {
|
||||||
|
redisTemplate.delete(REDIS_TOKEN_LOCK_KEY);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
try {
|
||||||
|
Thread.sleep(100);
|
||||||
|
} catch (InterruptedException e) {
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
return getAccessToken();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean sendMessage(WxSendMessageRequest request) {
|
||||||
|
String accessToken = getAccessToken();
|
||||||
|
String url = SEND_MESSAGE_URL.replace("{accessToken}", accessToken);
|
||||||
|
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
|
||||||
|
HttpEntity<String> entity = new HttpEntity<>(JSON.toJSONString(request), headers);
|
||||||
|
ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
|
||||||
|
|
||||||
|
JSONObject json = JSON.parseObject(response.getBody());
|
||||||
|
if (json.getInteger("errcode") != null && json.getInteger("errcode") != 0) {
|
||||||
|
log.error("发送消息失败: {}", json);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("消息发送成功: msgId={}", json.getString("msgid"));
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean sendTextMessage(String touser, String openKfid, String content) {
|
||||||
|
WxSendMessageRequest request = WxSendMessageRequest.text(touser, openKfid, content);
|
||||||
|
return sendMessage(request);
|
||||||
|
}
|
||||||
|
|
||||||
|
public JSONObject getKfAccountList(int offset, int limit) {
|
||||||
|
String accessToken = getAccessToken();
|
||||||
|
String url = GET_KF_LIST_URL.replace("{accessToken}", accessToken);
|
||||||
|
|
||||||
|
JSONObject body = new JSONObject();
|
||||||
|
body.put("offset", offset);
|
||||||
|
body.put("limit", limit);
|
||||||
|
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
|
||||||
|
HttpEntity<String> entity = new HttpEntity<>(body.toJSONString(), headers);
|
||||||
|
ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
|
||||||
|
|
||||||
|
return JSON.parseObject(response.getBody());
|
||||||
|
}
|
||||||
|
|
||||||
|
public SyncMsgResponse syncMessages(String openKfid, String token) {
|
||||||
|
String accessToken = getAccessToken();
|
||||||
|
String url = SYNC_MESSAGE_URL.replace("{accessToken}", accessToken);
|
||||||
|
|
||||||
|
String cursor = getCursor(openKfid);
|
||||||
|
|
||||||
|
JSONObject body = new JSONObject();
|
||||||
|
body.put("open_kfid", openKfid);
|
||||||
|
if (cursor != null && !cursor.isEmpty()) {
|
||||||
|
body.put("cursor", cursor);
|
||||||
|
}
|
||||||
|
if (token != null && !token.isEmpty()) {
|
||||||
|
body.put("token", token);
|
||||||
|
}
|
||||||
|
body.put("limit", 1000);
|
||||||
|
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
|
||||||
|
HttpEntity<String> entity = new HttpEntity<>(body.toJSONString(), headers);
|
||||||
|
ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
|
||||||
|
|
||||||
|
log.info("sync_msg响应: {}", response.getBody());
|
||||||
|
|
||||||
|
SyncMsgResponse syncResponse = JSON.parseObject(response.getBody(), SyncMsgResponse.class);
|
||||||
|
|
||||||
|
if (syncResponse.isSuccess() && syncResponse.getNextCursor() != null) {
|
||||||
|
saveCursor(openKfid, syncResponse.getNextCursor());
|
||||||
|
}
|
||||||
|
|
||||||
|
return syncResponse;
|
||||||
|
}
|
||||||
|
|
||||||
|
public SyncMsgResponse syncMessagesByToken(String openKfid, String token) {
|
||||||
|
return syncMessages(openKfid, token);
|
||||||
|
}
|
||||||
|
|
||||||
|
public ServiceStateResponse getServiceState(String openKfid, String externalUserid) {
|
||||||
|
String accessToken = getAccessToken();
|
||||||
|
String url = GET_SERVICE_STATE_URL.replace("{accessToken}", accessToken);
|
||||||
|
|
||||||
|
JSONObject body = new JSONObject();
|
||||||
|
body.put("open_kfid", openKfid);
|
||||||
|
body.put("external_userid", externalUserid);
|
||||||
|
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
|
||||||
|
HttpEntity<String> entity = new HttpEntity<>(body.toJSONString(), headers);
|
||||||
|
ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
|
||||||
|
|
||||||
|
log.info("获取会话状态响应: {}", response.getBody());
|
||||||
|
|
||||||
|
return JSON.parseObject(response.getBody(), ServiceStateResponse.class);
|
||||||
|
}
|
||||||
|
|
||||||
|
public JSONObject transServiceState(String openKfid, String externalUserid,
|
||||||
|
int serviceState, String servicerUserid) {
|
||||||
|
String accessToken = getAccessToken();
|
||||||
|
String url = TRANS_SERVICE_STATE_URL.replace("{accessToken}", accessToken);
|
||||||
|
|
||||||
|
JSONObject body = new JSONObject();
|
||||||
|
body.put("open_kfid", openKfid);
|
||||||
|
body.put("external_userid", externalUserid);
|
||||||
|
body.put("service_state", serviceState);
|
||||||
|
if (servicerUserid != null && !servicerUserid.isEmpty()) {
|
||||||
|
body.put("servicer_userid", servicerUserid);
|
||||||
|
}
|
||||||
|
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
|
||||||
|
HttpEntity<String> entity = new HttpEntity<>(body.toJSONString(), headers);
|
||||||
|
ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
|
||||||
|
|
||||||
|
log.info("变更会话状态响应: {}", response.getBody());
|
||||||
|
|
||||||
|
return JSON.parseObject(response.getBody());
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean transferToPool(String openKfid, String externalUserid) {
|
||||||
|
JSONObject result = transServiceState(openKfid, externalUserid,
|
||||||
|
ServiceStateResponse.STATE_POOL, null);
|
||||||
|
return result.getInteger("errcode") == null || result.getInteger("errcode") == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean transferToManual(String openKfid, String externalUserid, String servicerUserid) {
|
||||||
|
JSONObject result = transServiceState(openKfid, externalUserid,
|
||||||
|
ServiceStateResponse.STATE_MANUAL, servicerUserid);
|
||||||
|
return result.getInteger("errcode") == null || result.getInteger("errcode") == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean endSession(String openKfid, String externalUserid) {
|
||||||
|
JSONObject result = transServiceState(openKfid, externalUserid,
|
||||||
|
ServiceStateResponse.STATE_CLOSED, null);
|
||||||
|
return result.getInteger("errcode") == null || result.getInteger("errcode") == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean sendWelcomeMsg(String code, String content) {
|
||||||
|
String accessToken = getAccessToken();
|
||||||
|
String url = SEND_EVENT_MSG_URL.replace("{accessToken}", accessToken);
|
||||||
|
|
||||||
|
JSONObject body = new JSONObject();
|
||||||
|
body.put("code", code);
|
||||||
|
body.put("msgtype", "text");
|
||||||
|
JSONObject text = new JSONObject();
|
||||||
|
text.put("content", content);
|
||||||
|
body.put("text", text);
|
||||||
|
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
|
||||||
|
HttpEntity<String> entity = new HttpEntity<>(body.toJSONString(), headers);
|
||||||
|
ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
|
||||||
|
|
||||||
|
JSONObject json = JSON.parseObject(response.getBody());
|
||||||
|
if (json.getInteger("errcode") != null && json.getInteger("errcode") != 0) {
|
||||||
|
log.error("发送欢迎语失败: {}", json);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("发送欢迎语成功");
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
private String getCursor(String openKfid) {
|
||||||
|
return redisTemplate.opsForValue().get(REDIS_CURSOR_KEY_PREFIX + openKfid);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void saveCursor(String openKfid, String cursor) {
|
||||||
|
redisTemplate.opsForValue().set(REDIS_CURSOR_KEY_PREFIX + openKfid, cursor);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void clearCursor(String openKfid) {
|
||||||
|
redisTemplate.delete(REDIS_CURSOR_KEY_PREFIX + openKfid);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,75 @@
|
||||||
|
package com.wecom.robot.service.impl;
|
||||||
|
|
||||||
|
import com.wecom.robot.config.AiServiceConfig;
|
||||||
|
import com.wecom.robot.dto.ai.ChatRequest;
|
||||||
|
import com.wecom.robot.dto.ai.ChatResponse;
|
||||||
|
import com.wecom.robot.service.AiServiceClient;
|
||||||
|
import io.github.resilience4j.circuitbreaker.annotation.CircuitBreaker;
|
||||||
|
import io.github.resilience4j.timelimiter.annotation.TimeLimiter;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.http.HttpEntity;
|
||||||
|
import org.springframework.http.HttpHeaders;
|
||||||
|
import org.springframework.http.MediaType;
|
||||||
|
import org.springframework.http.ResponseEntity;
|
||||||
|
import org.springframework.stereotype.Service;
|
||||||
|
import org.springframework.web.client.RestTemplate;
|
||||||
|
|
||||||
|
import java.util.concurrent.CompletableFuture;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@Service
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class AiServiceClientImpl implements AiServiceClient {
|
||||||
|
|
||||||
|
private static final String CHAT_ENDPOINT = "/ai/chat";
|
||||||
|
private static final String HEALTH_ENDPOINT = "/ai/health";
|
||||||
|
|
||||||
|
private final AiServiceConfig aiServiceConfig;
|
||||||
|
private final RestTemplate restTemplate;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
@CircuitBreaker(name = "aiService", fallbackMethod = "generateReplyFallback")
|
||||||
|
@TimeLimiter(name = "aiService")
|
||||||
|
public CompletableFuture<ChatResponse> generateReply(ChatRequest request) {
|
||||||
|
log.info("[AC-MCA-04] 调用 AI 服务: sessionId={}", request.getSessionId());
|
||||||
|
|
||||||
|
String url = aiServiceConfig.getUrl() + CHAT_ENDPOINT;
|
||||||
|
HttpHeaders headers = new HttpHeaders();
|
||||||
|
headers.setContentType(MediaType.APPLICATION_JSON);
|
||||||
|
HttpEntity<ChatRequest> entity = new HttpEntity<>(request, headers);
|
||||||
|
|
||||||
|
ResponseEntity<ChatResponse> response = restTemplate.postForEntity(
|
||||||
|
url, entity, ChatResponse.class);
|
||||||
|
|
||||||
|
log.info("[AC-MCA-05] AI 服务响应: sessionId={}, shouldTransfer={}",
|
||||||
|
request.getSessionId(),
|
||||||
|
response.getBody() != null ? response.getBody().getShouldTransfer() : null);
|
||||||
|
|
||||||
|
return CompletableFuture.completedFuture(response.getBody());
|
||||||
|
}
|
||||||
|
|
||||||
|
public CompletableFuture<ChatResponse> generateReplyFallback(ChatRequest request, Throwable cause) {
|
||||||
|
log.warn("[AC-MCA-06][AC-MCA-07] AI 服务降级: sessionId={}, cause={}",
|
||||||
|
request.getSessionId(), cause.getMessage());
|
||||||
|
|
||||||
|
ChatResponse fallbackResponse = ChatResponse.fallbackWithTransfer(
|
||||||
|
"抱歉，我暂时无法回答您的问题，正在为您转接人工客服...",
|
||||||
|
cause.getMessage()
|
||||||
|
);
|
||||||
|
|
||||||
|
return CompletableFuture.completedFuture(fallbackResponse);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean healthCheck() {
|
||||||
|
try {
|
||||||
|
String url = aiServiceConfig.getUrl() + HEALTH_ENDPOINT;
|
||||||
|
ResponseEntity<String> response = restTemplate.getForEntity(url, String.class);
|
||||||
|
return response.getStatusCode().is2xxSuccessful();
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("[AC-MCA-04] AI 服务健康检查失败: {}", e.getMessage());
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,263 @@
|
||||||
|
package com.wecom.robot.service.impl;
|
||||||
|
|
||||||
|
import com.wecom.robot.adapter.ChannelAdapter;
|
||||||
|
import com.wecom.robot.adapter.TransferCapable;
|
||||||
|
import com.wecom.robot.dto.InboundMessage;
|
||||||
|
import com.wecom.robot.dto.OutboundMessage;
|
||||||
|
import com.wecom.robot.dto.ai.ChatRequest;
|
||||||
|
import com.wecom.robot.dto.ai.ChatResponse;
|
||||||
|
import com.wecom.robot.entity.Message;
|
||||||
|
import com.wecom.robot.entity.Session;
|
||||||
|
import com.wecom.robot.service.*;
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.data.redis.core.StringRedisTemplate;
|
||||||
|
import org.springframework.scheduling.annotation.Async;
|
||||||
|
import org.springframework.stereotype.Service;
|
||||||
|
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.concurrent.TimeUnit;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@Service
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class MessageRouterServiceImpl implements MessageRouterService {
|
||||||
|
|
||||||
|
private static final String IDEMPOTENT_KEY_PREFIX = "idempotent:";
|
||||||
|
private static final long IDEMPOTENT_TTL_HOURS = 1;
|
||||||
|
|
||||||
|
private final SessionManagerService sessionManagerService;
|
||||||
|
private final AiServiceClient aiServiceClient;
|
||||||
|
private final TransferService transferService;
|
||||||
|
private final WebSocketService webSocketService;
|
||||||
|
private final Map<String, ChannelAdapter> channelAdapters;
|
||||||
|
private final StringRedisTemplate redisTemplate;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
@Async
|
||||||
|
public void processInboundMessage(InboundMessage message) {
|
||||||
|
log.info("[AC-MCA-08] 处理入站消息: channelType={}, channelMessageId={}, sessionKey={}",
|
||||||
|
message.getChannelType(), message.getChannelMessageId(), message.getSessionKey());
|
||||||
|
|
||||||
|
if (!checkIdempotent(message.getChannelMessageId())) {
|
||||||
|
log.info("重复消息，跳过处理: channelMessageId={}", message.getChannelMessageId());
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
Session session = getOrCreateSession(message);
|
||||||
|
|
||||||
|
saveInboundMessage(session, message);
|
||||||
|
|
||||||
|
routeBySessionState(session, message);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void routeBySessionState(Session session, InboundMessage message) {
|
||||||
|
log.info("[AC-MCA-09] 根据会话状态路由: sessionId={}, status={}",
|
||||||
|
session.getSessionId(), session.getStatus());
|
||||||
|
|
||||||
|
String status = session.getStatus();
|
||||||
|
if (status == null) {
|
||||||
|
status = Session.STATUS_AI;
|
||||||
|
}
|
||||||
|
|
||||||
|
switch (status) {
|
||||||
|
case Session.STATUS_AI:
|
||||||
|
dispatchToAiService(session, message);
|
||||||
|
break;
|
||||||
|
case Session.STATUS_PENDING:
|
||||||
|
dispatchToPendingPool(session, message);
|
||||||
|
break;
|
||||||
|
case Session.STATUS_MANUAL:
|
||||||
|
dispatchToManualCs(session, message);
|
||||||
|
break;
|
||||||
|
case Session.STATUS_CLOSED:
|
||||||
|
Session newSession = sessionManagerService.getOrCreateSession(
|
||||||
|
message.getCustomerId(), message.getKfId());
|
||||||
|
dispatchToAiService(newSession, message);
|
||||||
|
break;
|
||||||
|
default:
|
||||||
|
log.warn("未知的会话状态: {}, 默认路由到AI服务", status);
|
||||||
|
dispatchToAiService(session, message);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void dispatchToAiService(Session session, InboundMessage message) {
|
||||||
|
log.info("[AC-MCA-08] 分发到AI服务: sessionId={}, content={}",
|
||||||
|
session.getSessionId(), truncateContent(message.getContent()));
|
||||||
|
|
||||||
|
List<Message> history = sessionManagerService.getSessionMessages(session.getSessionId());
|
||||||
|
|
||||||
|
ChatRequest chatRequest = ChatRequest.fromInboundMessage(message);
|
||||||
|
ChatResponse chatResponse;
|
||||||
|
try {
|
||||||
|
chatResponse = aiServiceClient.generateReply(chatRequest).get();
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.error("[AC-MCA-06] AI服务调用失败: {}", e.getMessage());
|
||||||
|
chatResponse = ChatResponse.fallbackWithTransfer(
|
||||||
|
"抱歉，我暂时无法回答您的问题，正在为您转接人工客服...",
|
||||||
|
e.getMessage()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
String reply = chatResponse.getReply();
|
||||||
|
double confidence = chatResponse.getConfidence() != null ? chatResponse.getConfidence() : 0.0;
|
||||||
|
int messageCount = sessionManagerService.getMessageCount(session.getSessionId());
|
||||||
|
|
||||||
|
boolean shouldTransfer = chatResponse.getShouldTransfer() != null && chatResponse.getShouldTransfer();
|
||||||
|
|
||||||
|
if (!shouldTransfer) {
|
||||||
|
shouldTransfer = transferService.shouldTransferToManual(
|
||||||
|
message.getContent(),
|
||||||
|
confidence,
|
||||||
|
messageCount,
|
||||||
|
session.getCreatedAt()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (shouldTransfer) {
|
||||||
|
handleTransferToManual(session, message, reply, chatResponse.getTransferReason());
|
||||||
|
} else {
|
||||||
|
sendReplyToUser(session, message, reply);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void dispatchToManualCs(Session session, InboundMessage message) {
|
||||||
|
log.info("[AC-MCA-10] 分发到人工客服: sessionId={}, manualCsId={}",
|
||||||
|
session.getSessionId(), session.getManualCsId());
|
||||||
|
|
||||||
|
Map<String, Object> wsMessage = new HashMap<>();
|
||||||
|
wsMessage.put("type", "customer_message");
|
||||||
|
wsMessage.put("sessionId", session.getSessionId());
|
||||||
|
wsMessage.put("content", message.getContent());
|
||||||
|
wsMessage.put("msgType", message.getMsgType());
|
||||||
|
wsMessage.put("customerId", message.getCustomerId());
|
||||||
|
wsMessage.put("channelType", message.getChannelType());
|
||||||
|
wsMessage.put("timestamp", System.currentTimeMillis());
|
||||||
|
|
||||||
|
webSocketService.notifyNewMessage(session.getSessionId(),
|
||||||
|
createWxCallbackMessage(message));
|
||||||
|
|
||||||
|
log.info("消息已推送给人工客服: sessionId={}", session.getSessionId());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void dispatchToPendingPool(Session session, InboundMessage message) {
|
||||||
|
log.info("[AC-MCA-10] 分发到待接入池: sessionId={}", session.getSessionId());
|
||||||
|
|
||||||
|
webSocketService.notifyNewPendingSession(session.getSessionId());
|
||||||
|
|
||||||
|
log.info("已通知待接入池有新消息: sessionId={}", session.getSessionId());
|
||||||
|
}
|
||||||
|
|
||||||
|
private boolean checkIdempotent(String channelMessageId) {
|
||||||
|
if (channelMessageId == null || channelMessageId.isEmpty()) {
|
||||||
|
log.warn("channelMessageId 为空，跳过幂等检查");
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
String key = IDEMPOTENT_KEY_PREFIX + channelMessageId;
|
||||||
|
Boolean absent = redisTemplate.opsForValue()
|
||||||
|
.setIfAbsent(key, "1", IDEMPOTENT_TTL_HOURS, TimeUnit.HOURS);
|
||||||
|
|
||||||
|
return Boolean.TRUE.equals(absent);
|
||||||
|
}
|
||||||
|
|
||||||
|
private Session getOrCreateSession(InboundMessage message) {
|
||||||
|
return sessionManagerService.getOrCreateSession(
|
||||||
|
message.getCustomerId(),
|
||||||
|
message.getKfId(),
|
||||||
|
message.getChannelType()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void saveInboundMessage(Session session, InboundMessage message) {
|
||||||
|
sessionManagerService.saveMessage(
|
||||||
|
message.getChannelMessageId(),
|
||||||
|
session.getSessionId(),
|
||||||
|
Message.SENDER_TYPE_CUSTOMER,
|
||||||
|
message.getCustomerId(),
|
||||||
|
message.getContent(),
|
||||||
|
message.getMsgType(),
|
||||||
|
message.getRawPayload()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void handleTransferToManual(Session session, InboundMessage message, String reply, String transferReason) {
|
||||||
|
String reason = transferReason != null ? transferReason : transferService.getTransferReason(
|
||||||
|
message.getContent(),
|
||||||
|
0.0,
|
||||||
|
sessionManagerService.getMessageCount(session.getSessionId())
|
||||||
|
);
|
||||||
|
|
||||||
|
sessionManagerService.transferToManual(session.getSessionId(), reason);
|
||||||
|
|
||||||
|
String transferReply = reply + "\n\n正在为您转接人工客服，请稍候...";
|
||||||
|
|
||||||
|
ChannelAdapter adapter = channelAdapters.get(message.getChannelType());
|
||||||
|
if (adapter != null) {
|
||||||
|
OutboundMessage outbound = OutboundMessage.builder()
|
||||||
|
.channelType(message.getChannelType())
|
||||||
|
.receiver(message.getCustomerId())
|
||||||
|
.kfId(message.getKfId())
|
||||||
|
.content(transferReply)
|
||||||
|
.msgType("text")
|
||||||
|
.build();
|
||||||
|
adapter.sendMessage(outbound);
|
||||||
|
|
||||||
|
if (adapter instanceof TransferCapable) {
|
||||||
|
boolean transferred = ((TransferCapable) adapter)
|
||||||
|
.transferToPool(message.getKfId(), message.getCustomerId());
|
||||||
|
if (transferred) {
|
||||||
|
log.info("已将会话转入待接入池: sessionId={}", session.getSessionId());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
webSocketService.notifyNewPendingSession(session.getSessionId());
|
||||||
|
}
|
||||||
|
|
||||||
|
private void sendReplyToUser(Session session, InboundMessage message, String reply) {
|
||||||
|
ChannelAdapter adapter = channelAdapters.get(message.getChannelType());
|
||||||
|
if (adapter != null) {
|
||||||
|
OutboundMessage outbound = OutboundMessage.builder()
|
||||||
|
.channelType(message.getChannelType())
|
||||||
|
.receiver(message.getCustomerId())
|
||||||
|
.kfId(message.getKfId())
|
||||||
|
.content(reply)
|
||||||
|
.msgType("text")
|
||||||
|
.build();
|
||||||
|
adapter.sendMessage(outbound);
|
||||||
|
}
|
||||||
|
|
||||||
|
sessionManagerService.saveMessage(
|
||||||
|
"ai_" + System.currentTimeMillis(),
|
||||||
|
session.getSessionId(),
|
||||||
|
Message.SENDER_TYPE_AI,
|
||||||
|
"AI",
|
||||||
|
reply,
|
||||||
|
"text",
|
||||||
|
null
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
private com.wecom.robot.dto.WxCallbackMessage createWxCallbackMessage(InboundMessage message) {
|
||||||
|
com.wecom.robot.dto.WxCallbackMessage wxMessage = new com.wecom.robot.dto.WxCallbackMessage();
|
||||||
|
wxMessage.setExternalUserId(message.getCustomerId());
|
||||||
|
wxMessage.setOpenKfId(message.getKfId());
|
||||||
|
wxMessage.setContent(message.getContent());
|
||||||
|
wxMessage.setMsgType(message.getMsgType());
|
||||||
|
return wxMessage;
|
||||||
|
}
|
||||||
|
|
||||||
|
private String truncateContent(String content) {
|
||||||
|
if (content == null) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
return content.length() > 50 ? content.substring(0, 50) + "..." : content;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,50 @@
|
||||||
|
package com.wecom.robot.util;
|
||||||
|
|
||||||
|
@SuppressWarnings("serial")
|
||||||
|
public class AesException extends Exception {
|
||||||
|
|
||||||
|
public final static int OK = 0;
|
||||||
|
public final static int ValidateSignatureError = -40001;
|
||||||
|
public final static int ParseXmlError = -40002;
|
||||||
|
public final static int ComputeSignatureError = -40003;
|
||||||
|
public final static int IllegalAesKey = -40004;
|
||||||
|
public final static int ValidateCorpidError = -40005;
|
||||||
|
public final static int EncryptAESError = -40006;
|
||||||
|
public final static int DecryptAESError = -40007;
|
||||||
|
public final static int IllegalBuffer = -40008;
|
||||||
|
|
||||||
|
private int code;
|
||||||
|
|
||||||
|
private static String getMessage(int code) {
|
||||||
|
switch (code) {
|
||||||
|
case ValidateSignatureError:
|
||||||
|
return "签名验证错误";
|
||||||
|
case ParseXmlError:
|
||||||
|
return "xml解析失败";
|
||||||
|
case ComputeSignatureError:
|
||||||
|
return "sha加密生成签名失败";
|
||||||
|
case IllegalAesKey:
|
||||||
|
return "SymmetricKey非法";
|
||||||
|
case ValidateCorpidError:
|
||||||
|
return "corpid校验失败";
|
||||||
|
case EncryptAESError:
|
||||||
|
return "aes加密失败";
|
||||||
|
case DecryptAESError:
|
||||||
|
return "aes解密失败";
|
||||||
|
case IllegalBuffer:
|
||||||
|
return "解密后得到的buffer非法";
|
||||||
|
default:
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public int getCode() {
|
||||||
|
return code;
|
||||||
|
}
|
||||||
|
|
||||||
|
AesException(int code) {
|
||||||
|
super(getMessage(code));
|
||||||
|
this.code = code;
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,26 @@
|
||||||
|
package com.wecom.robot.util;
|
||||||
|
|
||||||
|
import java.util.ArrayList;
|
||||||
|
|
||||||
|
class ByteGroup {
|
||||||
|
ArrayList<Byte> byteContainer = new ArrayList<Byte>();
|
||||||
|
|
||||||
|
public byte[] toBytes() {
|
||||||
|
byte[] bytes = new byte[byteContainer.size()];
|
||||||
|
for (int i = 0; i < byteContainer.size(); i++) {
|
||||||
|
bytes[i] = byteContainer.get(i);
|
||||||
|
}
|
||||||
|
return bytes;
|
||||||
|
}
|
||||||
|
|
||||||
|
public ByteGroup addBytes(byte[] bytes) {
|
||||||
|
for (byte b : bytes) {
|
||||||
|
byteContainer.add(b);
|
||||||
|
}
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
public int size() {
|
||||||
|
return byteContainer.size();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,56 @@
|
||||||
|
package com.wecom.robot.util;
|
||||||
|
|
||||||
|
import lombok.RequiredArgsConstructor;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.data.redis.core.StringRedisTemplate;
|
||||||
|
import org.springframework.stereotype.Component;
|
||||||
|
|
||||||
|
import java.util.concurrent.TimeUnit;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@Component
|
||||||
|
@RequiredArgsConstructor
|
||||||
|
public class IdempotentHelper {
|
||||||
|
|
||||||
|
private static final String KEY_PREFIX = "idempotent:";
|
||||||
|
private static final long DEFAULT_TTL_HOURS = 1;
|
||||||
|
|
||||||
|
private final StringRedisTemplate redisTemplate;
|
||||||
|
|
||||||
|
public boolean processMessageIdempotent(String channelMessageId, Runnable processor) {
|
||||||
|
String key = KEY_PREFIX + channelMessageId;
|
||||||
|
Boolean absent = redisTemplate.opsForValue()
|
||||||
|
.setIfAbsent(key, "1", DEFAULT_TTL_HOURS, TimeUnit.HOURS);
|
||||||
|
|
||||||
|
if (Boolean.TRUE.equals(absent)) {
|
||||||
|
processor.run();
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("[AC-MCA-11-IDEMPOTENT] 重复消息，跳过处理: channelMessageId={}", channelMessageId);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean checkAndSet(String channelMessageId) {
|
||||||
|
String key = KEY_PREFIX + channelMessageId;
|
||||||
|
Boolean absent = redisTemplate.opsForValue()
|
||||||
|
.setIfAbsent(key, "1", DEFAULT_TTL_HOURS, TimeUnit.HOURS);
|
||||||
|
|
||||||
|
if (Boolean.TRUE.equals(absent)) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("[AC-MCA-11-IDEMPOTENT] 重复消息检测: channelMessageId={}", channelMessageId);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean exists(String channelMessageId) {
|
||||||
|
String key = KEY_PREFIX + channelMessageId;
|
||||||
|
return Boolean.TRUE.equals(redisTemplate.hasKey(key));
|
||||||
|
}
|
||||||
|
|
||||||
|
public void remove(String channelMessageId) {
|
||||||
|
String key = KEY_PREFIX + channelMessageId;
|
||||||
|
redisTemplate.delete(key);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,67 @@
|
||||||
|
/**
|
||||||
|
* 对企业微信发送给企业后台的消息加解密示例代码.
|
||||||
|
*
|
||||||
|
* @copyright Copyright (c) 1998-2014 Tencent Inc.
|
||||||
|
*/
|
||||||
|
|
||||||
|
// ------------------------------------------------------------------------
|
||||||
|
|
||||||
|
package com.wecom.robot.util;
|
||||||
|
|
||||||
|
import java.nio.charset.Charset;
|
||||||
|
import java.util.Arrays;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供基于PKCS7算法的加解密接口.
|
||||||
|
*/
|
||||||
|
class PKCS7Encoder {
|
||||||
|
static Charset CHARSET = Charset.forName("utf-8");
|
||||||
|
static int BLOCK_SIZE = 32;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获得对明文进行补位填充的字节.
|
||||||
|
*
|
||||||
|
* @param count 需要进行填充补位操作的明文字节个数
|
||||||
|
* @return 补齐用的字节数组
|
||||||
|
*/
|
||||||
|
static byte[] encode(int count) {
|
||||||
|
// 计算需要填充的位数
|
||||||
|
int amountToPad = BLOCK_SIZE - (count % BLOCK_SIZE);
|
||||||
|
if (amountToPad == 0) {
|
||||||
|
amountToPad = BLOCK_SIZE;
|
||||||
|
}
|
||||||
|
// 获得补位所用的字符
|
||||||
|
char padChr = chr(amountToPad);
|
||||||
|
String tmp = new String();
|
||||||
|
for (int index = 0; index < amountToPad; index++) {
|
||||||
|
tmp += padChr;
|
||||||
|
}
|
||||||
|
return tmp.getBytes(CHARSET);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 删除解密后明文的补位字符
|
||||||
|
*
|
||||||
|
* @param decrypted 解密后的明文
|
||||||
|
* @return 删除补位字符后的明文
|
||||||
|
*/
|
||||||
|
static byte[] decode(byte[] decrypted) {
|
||||||
|
int pad = (int) decrypted[decrypted.length - 1];
|
||||||
|
if (pad < 1 || pad > 32) {
|
||||||
|
pad = 0;
|
||||||
|
}
|
||||||
|
return Arrays.copyOfRange(decrypted, 0, decrypted.length - pad);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将数字转化成ASCII码对应的字符，用于对明文进行补码
|
||||||
|
*
|
||||||
|
* @param a 需要转化的数字
|
||||||
|
* @return 转化得到的字符
|
||||||
|
*/
|
||||||
|
static char chr(int a) {
|
||||||
|
byte target = (byte) (a & 0xFF);
|
||||||
|
return (char) target;
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,61 @@
|
||||||
|
/**
|
||||||
|
* 对企业微信发送给企业后台的消息加解密示例代码.
|
||||||
|
*
|
||||||
|
* @copyright Copyright (c) 1998-2014 Tencent Inc.
|
||||||
|
*/
|
||||||
|
|
||||||
|
// ------------------------------------------------------------------------
|
||||||
|
|
||||||
|
package com.wecom.robot.util;
|
||||||
|
|
||||||
|
import java.security.MessageDigest;
|
||||||
|
import java.util.Arrays;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* SHA1 class
|
||||||
|
*
|
||||||
|
* 计算消息签名接口.
|
||||||
|
*/
|
||||||
|
class SHA1 {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 用SHA1算法生成安全签名
|
||||||
|
* @param token 票据
|
||||||
|
* @param timestamp 时间戳
|
||||||
|
* @param nonce 随机字符串
|
||||||
|
* @param encrypt 密文
|
||||||
|
* @return 安全签名
|
||||||
|
* @throws AesException
|
||||||
|
*/
|
||||||
|
public static String getSHA1(String token, String timestamp, String nonce, String encrypt) throws AesException
|
||||||
|
{
|
||||||
|
try {
|
||||||
|
String[] array = new String[] { token, timestamp, nonce, encrypt };
|
||||||
|
StringBuffer sb = new StringBuffer();
|
||||||
|
// 字符串排序
|
||||||
|
Arrays.sort(array);
|
||||||
|
for (int i = 0; i < 4; i++) {
|
||||||
|
sb.append(array[i]);
|
||||||
|
}
|
||||||
|
String str = sb.toString();
|
||||||
|
// SHA1签名生成
|
||||||
|
MessageDigest md = MessageDigest.getInstance("SHA-1");
|
||||||
|
md.update(str.getBytes());
|
||||||
|
byte[] digest = md.digest();
|
||||||
|
|
||||||
|
StringBuffer hexstr = new StringBuffer();
|
||||||
|
String shaHex = "";
|
||||||
|
for (int i = 0; i < digest.length; i++) {
|
||||||
|
shaHex = Integer.toHexString(digest[i] & 0xFF);
|
||||||
|
if (shaHex.length() < 2) {
|
||||||
|
hexstr.append(0);
|
||||||
|
}
|
||||||
|
hexstr.append(shaHex);
|
||||||
|
}
|
||||||
|
return hexstr.toString();
|
||||||
|
} catch (Exception e) {
|
||||||
|
e.printStackTrace();
|
||||||
|
throw new AesException(AesException.ComputeSignatureError);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,70 @@
|
||||||
|
package com.wecom.robot.util;
|
||||||
|
|
||||||
|
import java.io.StringReader;
|
||||||
|
|
||||||
|
import javax.xml.parsers.DocumentBuilder;
|
||||||
|
import javax.xml.parsers.DocumentBuilderFactory;
|
||||||
|
|
||||||
|
import com.wecom.robot.util.WXBizMsgCrypt;
|
||||||
|
import org.w3c.dom.Document;
|
||||||
|
import org.w3c.dom.Element;
|
||||||
|
import org.w3c.dom.NodeList;
|
||||||
|
import org.xml.sax.InputSource;
|
||||||
|
import javax.xml.parsers.DocumentBuilderFactory;
|
||||||
|
|
||||||
|
public class Sample {
|
||||||
|
|
||||||
|
public static void main(String[] args) throws Exception {
|
||||||
|
String sToken = "QDG6eK";
|
||||||
|
String sCorpID = "wx5823bf96d3bd56c7";
|
||||||
|
String sEncodingAESKey = "jWmYm7qr5nMoAUwZRjGtBxmz3KA1tkAj3ykkR6q2B2C";
|
||||||
|
|
||||||
|
WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sCorpID);
|
||||||
|
String sVerifyMsgSig = "5c45ff5e21c57e6ad56bac8758b79b1d9ac89fd3";
|
||||||
|
String sVerifyTimeStamp = "1409659589";
|
||||||
|
String sVerifyNonce = "263014780";
|
||||||
|
String sVerifyEchoStr = "P9nAzCzyDtyTWESHep1vC5X9xho/qYX3Zpb4yKa9SKld1DsH3Iyt3tP3zNdtp+4RPcs8TgAE7OaBO+FZXvnaqQ==";
|
||||||
|
String sEchoStr;
|
||||||
|
try {
|
||||||
|
sEchoStr = wxcpt.VerifyURL(sVerifyMsgSig, sVerifyTimeStamp,
|
||||||
|
sVerifyNonce, sVerifyEchoStr);
|
||||||
|
System.out.println("verifyurl echostr: " + sEchoStr);
|
||||||
|
} catch (Exception e) {
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
|
||||||
|
String sReqMsgSig = "477715d11cdb4164915debcba66cb864d751f3e6";
|
||||||
|
String sReqTimeStamp = "1409659813";
|
||||||
|
String sReqNonce = "1372623149";
|
||||||
|
String sReqData = "<xml><ToUserName><![CDATA[wx5823bf96d3bd56c7]]></ToUserName><Encrypt><![CDATA[RypEvHKD8QQKFhvQ6QleEB4J58tiPdvo+rtK1I9qca6aM/wvqnLSV5zEPeusUiX5L5X/0lWfrf0QADHHhGd3QczcdCUpj911L3vg3W/sYYvuJTs3TUUkSUXxaccAS0qhxchrRYt66wiSpGLYL42aM6A8dTT+6k4aSknmPj48kzJs8qLjvd4Xgpue06DOdnLxAUHzM6+kDZ+HMZfJYuR+LtwGc2hgf5gsijff0ekUNXZiqATP7PF5mZxZ3Izoun1s4zG4LUMnvw2r+KqCKIw+3IQH03v+BCA9nMELNqbSf6tiWSrXJB3LAVGUcallcrw8V2t9EL4EhzJWrQUax5wLVMNS0+rUPA3k22Ncx4XXZS9o0MBH27Bo6BpNelZpS+/uh9KsNlY6bHCmJU9p8g7m3fVKn28H3KDYA5Pl/T8Z1ptDAVe0lXdQ2YoyyH2uyPIGHBZZIs2pDBS8R07+qN+E7Q==]]></Encrypt><AgentID><![CDATA[218]]></AgentID></xml>";
|
||||||
|
|
||||||
|
try {
|
||||||
|
String sMsg = wxcpt.DecryptMsg(sReqMsgSig, sReqTimeStamp, sReqNonce, sReqData);
|
||||||
|
System.out.println("after decrypt msg: " + sMsg);
|
||||||
|
DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
|
||||||
|
DocumentBuilder db = dbf.newDocumentBuilder();
|
||||||
|
StringReader sr = new StringReader(sMsg);
|
||||||
|
InputSource is = new InputSource(sr);
|
||||||
|
Document document = db.parse(is);
|
||||||
|
|
||||||
|
Element root = document.getDocumentElement();
|
||||||
|
NodeList nodelist1 = root.getElementsByTagName("Content");
|
||||||
|
String Content = nodelist1.item(0).getTextContent();
|
||||||
|
System.out.println("Content：" + Content);
|
||||||
|
|
||||||
|
} catch (Exception e) {
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
|
||||||
|
String sRespData = "<xml><ToUserName><![CDATA[mycreate]]></ToUserName><FromUserName><![CDATA[wx5823bf96d3bd56c7]]></FromUserName><CreateTime>1348831860</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[this is a test]]></Content><MsgId>1234567890123456</MsgId><AgentID>128</AgentID></xml>";
|
||||||
|
try{
|
||||||
|
String sEncryptMsg = wxcpt.EncryptMsg(sRespData, sReqTimeStamp, sReqNonce);
|
||||||
|
System.out.println("after encrypt sEncrytMsg: " + sEncryptMsg);
|
||||||
|
}
|
||||||
|
catch(Exception e)
|
||||||
|
{
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,289 @@
|
||||||
|
/**
|
||||||
|
* 对企业微信发送给企业后台的消息加解密示例代码.
|
||||||
|
*
|
||||||
|
* @copyright Copyright (c) 1998-2014 Tencent Inc.
|
||||||
|
*/
|
||||||
|
|
||||||
|
// ------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 针对org.apache.commons.codec.binary.Base64，
|
||||||
|
* 需要导入架包commons-codec-1.9（或commons-codec-1.8等其他版本）
|
||||||
|
* 官方下载地址：http://commons.apache.org/proper/commons-codec/download_codec.cgi
|
||||||
|
*/
|
||||||
|
package com.wecom.robot.util;
|
||||||
|
|
||||||
|
import java.nio.charset.Charset;
|
||||||
|
import java.util.Arrays;
|
||||||
|
import java.util.Random;
|
||||||
|
|
||||||
|
import javax.crypto.Cipher;
|
||||||
|
import javax.crypto.spec.IvParameterSpec;
|
||||||
|
import javax.crypto.spec.SecretKeySpec;
|
||||||
|
|
||||||
|
import org.apache.commons.codec.binary.Base64;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供接收和推送给企业微信消息的加解密接口(UTF8编码的字符串).
|
||||||
|
* <ol>
|
||||||
|
* <li>第三方回复加密消息给企业微信</li>
|
||||||
|
* <li>第三方收到企业微信发送的消息，验证消息的安全性，并对消息进行解密。</li>
|
||||||
|
* </ol>
|
||||||
|
* 说明：异常java.security.InvalidKeyException:illegal Key Size的解决方案
|
||||||
|
* <ol>
|
||||||
|
* <li>在官方网站下载JCE无限制权限策略文件（JDK7的下载地址：
|
||||||
|
* http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html</li>
|
||||||
|
* <li>下载后解压，可以看到local_policy.jar和US_export_policy.jar以及readme.txt</li>
|
||||||
|
* <li>如果安装了JRE，将两个jar文件放到%JRE_HOME%\lib\security目录下覆盖原来的文件</li>
|
||||||
|
* <li>如果安装了JDK，将两个jar文件放到%JDK_HOME%\jre\lib\security目录下覆盖原来文件</li>
|
||||||
|
* </ol>
|
||||||
|
*/
|
||||||
|
public class WXBizMsgCrypt {
|
||||||
|
static Charset CHARSET = Charset.forName("utf-8");
|
||||||
|
Base64 base64 = new Base64();
|
||||||
|
byte[] aesKey;
|
||||||
|
String token;
|
||||||
|
String receiveid;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 构造函数
|
||||||
|
* @param token 企业微信后台，开发者设置的token
|
||||||
|
* @param encodingAesKey 企业微信后台，开发者设置的EncodingAESKey
|
||||||
|
* @param receiveid, 不同场景含义不同，详见文档
|
||||||
|
*
|
||||||
|
* @throws AesException 执行失败，请查看该异常的错误码和具体的错误信息
|
||||||
|
*/
|
||||||
|
public WXBizMsgCrypt(String token, String encodingAesKey, String receiveid) throws AesException {
|
||||||
|
if (encodingAesKey.length() != 43) {
|
||||||
|
throw new AesException(AesException.IllegalAesKey);
|
||||||
|
}
|
||||||
|
|
||||||
|
this.token = token;
|
||||||
|
this.receiveid = receiveid;
|
||||||
|
aesKey = Base64.decodeBase64(encodingAesKey + "=");
|
||||||
|
}
|
||||||
|
|
||||||
|
// 生成4个字节的网络字节序
|
||||||
|
byte[] getNetworkBytesOrder(int sourceNumber) {
|
||||||
|
byte[] orderBytes = new byte[4];
|
||||||
|
orderBytes[3] = (byte) (sourceNumber & 0xFF);
|
||||||
|
orderBytes[2] = (byte) (sourceNumber >> 8 & 0xFF);
|
||||||
|
orderBytes[1] = (byte) (sourceNumber >> 16 & 0xFF);
|
||||||
|
orderBytes[0] = (byte) (sourceNumber >> 24 & 0xFF);
|
||||||
|
return orderBytes;
|
||||||
|
}
|
||||||
|
|
||||||
|
// 还原4个字节的网络字节序
|
||||||
|
int recoverNetworkBytesOrder(byte[] orderBytes) {
|
||||||
|
int sourceNumber = 0;
|
||||||
|
for (int i = 0; i < 4; i++) {
|
||||||
|
sourceNumber <<= 8;
|
||||||
|
sourceNumber |= orderBytes[i] & 0xff;
|
||||||
|
}
|
||||||
|
return sourceNumber;
|
||||||
|
}
|
||||||
|
|
||||||
|
// 随机生成16位字符串
|
||||||
|
String getRandomStr() {
|
||||||
|
String base = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
|
||||||
|
Random random = new Random();
|
||||||
|
StringBuffer sb = new StringBuffer();
|
||||||
|
for (int i = 0; i < 16; i++) {
|
||||||
|
int number = random.nextInt(base.length());
|
||||||
|
sb.append(base.charAt(number));
|
||||||
|
}
|
||||||
|
return sb.toString();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对明文进行加密.
|
||||||
|
*
|
||||||
|
* @param text 需要加密的明文
|
||||||
|
* @return 加密后base64编码的字符串
|
||||||
|
* @throws AesException aes加密失败
|
||||||
|
*/
|
||||||
|
String encrypt(String randomStr, String text) throws AesException {
|
||||||
|
ByteGroup byteCollector = new ByteGroup();
|
||||||
|
byte[] randomStrBytes = randomStr.getBytes(CHARSET);
|
||||||
|
byte[] textBytes = text.getBytes(CHARSET);
|
||||||
|
byte[] networkBytesOrder = getNetworkBytesOrder(textBytes.length);
|
||||||
|
byte[] receiveidBytes = receiveid.getBytes(CHARSET);
|
||||||
|
|
||||||
|
// randomStr + networkBytesOrder + text + receiveid
|
||||||
|
byteCollector.addBytes(randomStrBytes);
|
||||||
|
byteCollector.addBytes(networkBytesOrder);
|
||||||
|
byteCollector.addBytes(textBytes);
|
||||||
|
byteCollector.addBytes(receiveidBytes);
|
||||||
|
|
||||||
|
// ... + pad: 使用自定义的填充方式对明文进行补位填充
|
||||||
|
byte[] padBytes = PKCS7Encoder.encode(byteCollector.size());
|
||||||
|
byteCollector.addBytes(padBytes);
|
||||||
|
|
||||||
|
// 获得最终的字节流, 未加密
|
||||||
|
byte[] unencrypted = byteCollector.toBytes();
|
||||||
|
|
||||||
|
try {
|
||||||
|
// 设置加密模式为AES的CBC模式
|
||||||
|
Cipher cipher = Cipher.getInstance("AES/CBC/NoPadding");
|
||||||
|
SecretKeySpec keySpec = new SecretKeySpec(aesKey, "AES");
|
||||||
|
IvParameterSpec iv = new IvParameterSpec(aesKey, 0, 16);
|
||||||
|
cipher.init(Cipher.ENCRYPT_MODE, keySpec, iv);
|
||||||
|
|
||||||
|
// 加密
|
||||||
|
byte[] encrypted = cipher.doFinal(unencrypted);
|
||||||
|
|
||||||
|
// 使用BASE64对加密后的字符串进行编码
|
||||||
|
String base64Encrypted = base64.encodeToString(encrypted);
|
||||||
|
|
||||||
|
return base64Encrypted;
|
||||||
|
} catch (Exception e) {
|
||||||
|
e.printStackTrace();
|
||||||
|
throw new AesException(AesException.EncryptAESError);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对密文进行解密.
|
||||||
|
*
|
||||||
|
* @param text 需要解密的密文
|
||||||
|
* @return 解密得到的明文
|
||||||
|
* @throws AesException aes解密失败
|
||||||
|
*/
|
||||||
|
String decrypt(String text) throws AesException {
|
||||||
|
byte[] original;
|
||||||
|
try {
|
||||||
|
// 设置解密模式为AES的CBC模式
|
||||||
|
Cipher cipher = Cipher.getInstance("AES/CBC/NoPadding");
|
||||||
|
SecretKeySpec key_spec = new SecretKeySpec(aesKey, "AES");
|
||||||
|
IvParameterSpec iv = new IvParameterSpec(Arrays.copyOfRange(aesKey, 0, 16));
|
||||||
|
cipher.init(Cipher.DECRYPT_MODE, key_spec, iv);
|
||||||
|
|
||||||
|
// 使用BASE64对密文进行解码
|
||||||
|
byte[] encrypted = Base64.decodeBase64(text);
|
||||||
|
|
||||||
|
// 解密
|
||||||
|
original = cipher.doFinal(encrypted);
|
||||||
|
} catch (Exception e) {
|
||||||
|
e.printStackTrace();
|
||||||
|
throw new AesException(AesException.DecryptAESError);
|
||||||
|
}
|
||||||
|
|
||||||
|
String xmlContent, from_receiveid;
|
||||||
|
try {
|
||||||
|
// 去除补位字符
|
||||||
|
byte[] bytes = PKCS7Encoder.decode(original);
|
||||||
|
|
||||||
|
// 分离16位随机字符串,网络字节序和receiveid
|
||||||
|
byte[] networkOrder = Arrays.copyOfRange(bytes, 16, 20);
|
||||||
|
|
||||||
|
int xmlLength = recoverNetworkBytesOrder(networkOrder);
|
||||||
|
|
||||||
|
xmlContent = new String(Arrays.copyOfRange(bytes, 20, 20 + xmlLength), CHARSET);
|
||||||
|
from_receiveid = new String(Arrays.copyOfRange(bytes, 20 + xmlLength, bytes.length),
|
||||||
|
CHARSET);
|
||||||
|
} catch (Exception e) {
|
||||||
|
e.printStackTrace();
|
||||||
|
throw new AesException(AesException.IllegalBuffer);
|
||||||
|
}
|
||||||
|
|
||||||
|
// receiveid不相同的情况
|
||||||
|
if (!from_receiveid.equals(receiveid)) {
|
||||||
|
throw new AesException(AesException.ValidateCorpidError);
|
||||||
|
}
|
||||||
|
return xmlContent;
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将企业微信回复用户的消息加密打包.
|
||||||
|
* <ol>
|
||||||
|
* <li>对要发送的消息进行AES-CBC加密</li>
|
||||||
|
* <li>生成安全签名</li>
|
||||||
|
* <li>将消息密文和安全签名打包成xml格式</li>
|
||||||
|
* </ol>
|
||||||
|
*
|
||||||
|
* @param replyMsg 企业微信待回复用户的消息，xml格式的字符串
|
||||||
|
* @param timeStamp 时间戳，可以自己生成，也可以用URL参数的timestamp
|
||||||
|
* @param nonce 随机串，可以自己生成，也可以用URL参数的nonce
|
||||||
|
*
|
||||||
|
* @return 加密后的可以直接回复用户的密文，包括msg_signature, timestamp, nonce, encrypt的xml格式的字符串
|
||||||
|
* @throws AesException 执行失败，请查看该异常的错误码和具体的错误信息
|
||||||
|
*/
|
||||||
|
public String EncryptMsg(String replyMsg, String timeStamp, String nonce) throws AesException {
|
||||||
|
// 加密
|
||||||
|
String encrypt = encrypt(getRandomStr(), replyMsg);
|
||||||
|
|
||||||
|
// 生成安全签名
|
||||||
|
if (timeStamp == "") {
|
||||||
|
timeStamp = Long.toString(System.currentTimeMillis());
|
||||||
|
}
|
||||||
|
|
||||||
|
String signature = SHA1.getSHA1(token, timeStamp, nonce, encrypt);
|
||||||
|
|
||||||
|
// System.out.println("发送给平台的签名是: " + signature[1].toString());
|
||||||
|
// 生成发送的xml
|
||||||
|
String result = XMLParse.generate(encrypt, signature, timeStamp, nonce);
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检验消息的真实性，并且获取解密后的明文.
|
||||||
|
* <ol>
|
||||||
|
* <li>利用收到的密文生成安全签名，进行签名验证</li>
|
||||||
|
* <li>若验证通过，则提取xml中的加密消息</li>
|
||||||
|
* <li>对消息进行解密</li>
|
||||||
|
* </ol>
|
||||||
|
*
|
||||||
|
* @param msgSignature 签名串，对应URL参数的msg_signature
|
||||||
|
* @param timeStamp 时间戳，对应URL参数的timestamp
|
||||||
|
* @param nonce 随机串，对应URL参数的nonce
|
||||||
|
* @param postData 密文，对应POST请求的数据
|
||||||
|
*
|
||||||
|
* @return 解密后的原文
|
||||||
|
* @throws AesException 执行失败，请查看该异常的错误码和具体的错误信息
|
||||||
|
*/
|
||||||
|
public String DecryptMsg(String msgSignature, String timeStamp, String nonce, String postData)
|
||||||
|
throws AesException {
|
||||||
|
|
||||||
|
// 密钥，公众账号的app secret
|
||||||
|
// 提取密文
|
||||||
|
Object[] encrypt = XMLParse.extract(postData);
|
||||||
|
|
||||||
|
// 验证安全签名
|
||||||
|
String signature = SHA1.getSHA1(token, timeStamp, nonce, encrypt[1].toString());
|
||||||
|
|
||||||
|
// 和URL中的签名比较是否相等
|
||||||
|
// System.out.println("第三方收到URL中的签名：" + msg_sign);
|
||||||
|
// System.out.println("第三方校验签名：" + signature);
|
||||||
|
if (!signature.equals(msgSignature)) {
|
||||||
|
throw new AesException(AesException.ValidateSignatureError);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 解密
|
||||||
|
String result = decrypt(encrypt[1].toString());
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 验证URL
|
||||||
|
* @param msgSignature 签名串，对应URL参数的msg_signature
|
||||||
|
* @param timeStamp 时间戳，对应URL参数的timestamp
|
||||||
|
* @param nonce 随机串，对应URL参数的nonce
|
||||||
|
* @param echoStr 随机串，对应URL参数的echostr
|
||||||
|
*
|
||||||
|
* @return 解密之后的echostr
|
||||||
|
* @throws AesException 执行失败，请查看该异常的错误码和具体的错误信息
|
||||||
|
*/
|
||||||
|
public String VerifyURL(String msgSignature, String timeStamp, String nonce, String echoStr)
|
||||||
|
throws AesException {
|
||||||
|
String signature = SHA1.getSHA1(token, timeStamp, nonce, echoStr);
|
||||||
|
|
||||||
|
if (!signature.equals(msgSignature)) {
|
||||||
|
throw new AesException(AesException.ValidateSignatureError);
|
||||||
|
}
|
||||||
|
|
||||||
|
String result = decrypt(echoStr);
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,104 @@
|
||||||
|
/**
|
||||||
|
* 对企业微信发送给企业后台的消息加解密示例代码.
|
||||||
|
*
|
||||||
|
* @copyright Copyright (c) 1998-2014 Tencent Inc.
|
||||||
|
*/
|
||||||
|
|
||||||
|
// ------------------------------------------------------------------------
|
||||||
|
|
||||||
|
package com.wecom.robot.util;
|
||||||
|
|
||||||
|
import java.io.StringReader;
|
||||||
|
|
||||||
|
import javax.xml.parsers.DocumentBuilder;
|
||||||
|
import javax.xml.parsers.DocumentBuilderFactory;
|
||||||
|
|
||||||
|
import org.w3c.dom.Document;
|
||||||
|
import org.w3c.dom.Element;
|
||||||
|
import org.w3c.dom.NodeList;
|
||||||
|
import org.xml.sax.InputSource;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* XMLParse class
|
||||||
|
*
|
||||||
|
* 提供提取消息格式中的密文及生成回复消息格式的接口.
|
||||||
|
*/
|
||||||
|
class XMLParse {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提取出xml数据包中的加密消息
|
||||||
|
* @param xmltext 待提取的xml字符串
|
||||||
|
* @return 提取出的加密消息字符串
|
||||||
|
* @throws AesException
|
||||||
|
*/
|
||||||
|
public static Object[] extract(String xmltext) throws AesException {
|
||||||
|
Object[] result = new Object[3];
|
||||||
|
try {
|
||||||
|
DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
|
||||||
|
|
||||||
|
String FEATURE = null;
|
||||||
|
// This is the PRIMARY defense. If DTDs (doctypes) are disallowed, almost all XML entity attacks are prevented
|
||||||
|
// Xerces 2 only - http://xerces.apache.org/xerces2-j/features.html#disallow-doctype-decl
|
||||||
|
FEATURE = "http://apache.org/xml/features/disallow-doctype-decl";
|
||||||
|
dbf.setFeature(FEATURE, true);
|
||||||
|
|
||||||
|
// If you can't completely disable DTDs, then at least do the following:
|
||||||
|
// Xerces 1 - http://xerces.apache.org/xerces-j/features.html#external-general-entities
|
||||||
|
// Xerces 2 - http://xerces.apache.org/xerces2-j/features.html#external-general-entities
|
||||||
|
// JDK7+ - http://xml.org/sax/features/external-general-entities
|
||||||
|
FEATURE = "http://xml.org/sax/features/external-general-entities";
|
||||||
|
dbf.setFeature(FEATURE, false);
|
||||||
|
|
||||||
|
// Xerces 1 - http://xerces.apache.org/xerces-j/features.html#external-parameter-entities
|
||||||
|
// Xerces 2 - http://xerces.apache.org/xerces2-j/features.html#external-parameter-entities
|
||||||
|
// JDK7+ - http://xml.org/sax/features/external-parameter-entities
|
||||||
|
FEATURE = "http://xml.org/sax/features/external-parameter-entities";
|
||||||
|
dbf.setFeature(FEATURE, false);
|
||||||
|
|
||||||
|
// Disable external DTDs as well
|
||||||
|
FEATURE = "http://apache.org/xml/features/nonvalidating/load-external-dtd";
|
||||||
|
dbf.setFeature(FEATURE, false);
|
||||||
|
|
||||||
|
// and these as well, per Timothy Morgan's 2014 paper: "XML Schema, DTD, and Entity Attacks"
|
||||||
|
dbf.setXIncludeAware(false);
|
||||||
|
dbf.setExpandEntityReferences(false);
|
||||||
|
|
||||||
|
// And, per Timothy Morgan: "If for some reason support for inline DOCTYPEs are a requirement, then
|
||||||
|
// ensure the entity settings are disabled (as shown above) and beware that SSRF attacks
|
||||||
|
// (http://cwe.mitre.org/data/definitions/918.html) and denial
|
||||||
|
// of service attacks (such as billion laughs or decompression bombs via "jar:") are a risk."
|
||||||
|
|
||||||
|
// remaining parser logic
|
||||||
|
DocumentBuilder db = dbf.newDocumentBuilder();
|
||||||
|
StringReader sr = new StringReader(xmltext);
|
||||||
|
InputSource is = new InputSource(sr);
|
||||||
|
Document document = db.parse(is);
|
||||||
|
|
||||||
|
Element root = document.getDocumentElement();
|
||||||
|
NodeList nodelist1 = root.getElementsByTagName("Encrypt");
|
||||||
|
result[0] = 0;
|
||||||
|
result[1] = nodelist1.item(0).getTextContent();
|
||||||
|
return result;
|
||||||
|
} catch (Exception e) {
|
||||||
|
e.printStackTrace();
|
||||||
|
throw new AesException(AesException.ParseXmlError);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 生成xml消息
|
||||||
|
* @param encrypt 加密后的消息密文
|
||||||
|
* @param signature 安全签名
|
||||||
|
* @param timestamp 时间戳
|
||||||
|
* @param nonce 随机字符串
|
||||||
|
* @return 生成的xml字符串
|
||||||
|
*/
|
||||||
|
public static String generate(String encrypt, String signature, String timestamp, String nonce) {
|
||||||
|
|
||||||
|
String format = "<xml>\n" + "<Encrypt><![CDATA[%1$s]]></Encrypt>\n"
|
||||||
|
+ "<MsgSignature><![CDATA[%2$s]]></MsgSignature>\n"
|
||||||
|
+ "<TimeStamp>%3$s</TimeStamp>\n" + "<Nonce><![CDATA[%4$s]]></Nonce>\n" + "</xml>";
|
||||||
|
return String.format(format, encrypt, signature, timestamp, nonce);
|
||||||
|
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,65 @@
|
||||||
|
package com.wecom.robot.util;
|
||||||
|
|
||||||
|
import org.w3c.dom.Document;
|
||||||
|
import org.w3c.dom.Element;
|
||||||
|
import org.w3c.dom.NodeList;
|
||||||
|
|
||||||
|
import javax.xml.parsers.DocumentBuilder;
|
||||||
|
import javax.xml.parsers.DocumentBuilderFactory;
|
||||||
|
import java.io.ByteArrayInputStream;
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
public class XmlUtil {
|
||||||
|
|
||||||
|
public static Map<String, String> parseXml(String xmlStr) {
|
||||||
|
Map<String, String> map = new HashMap<>();
|
||||||
|
try {
|
||||||
|
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
|
||||||
|
factory.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true);
|
||||||
|
factory.setFeature("http://xml.org/sax/features/external-general-entities", false);
|
||||||
|
factory.setFeature("http://xml.org/sax/features/external-parameter-entities", false);
|
||||||
|
DocumentBuilder builder = factory.newDocumentBuilder();
|
||||||
|
Document document = builder.parse(new ByteArrayInputStream(xmlStr.getBytes("UTF-8")));
|
||||||
|
Element root = document.getDocumentElement();
|
||||||
|
NodeList nodeList = root.getChildNodes();
|
||||||
|
for (int i = 0; i < nodeList.getLength(); i++) {
|
||||||
|
org.w3c.dom.Node node = nodeList.item(i);
|
||||||
|
if (node.getNodeType() == org.w3c.dom.Node.ELEMENT_NODE) {
|
||||||
|
map.put(node.getNodeName(), node.getTextContent());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (Exception e) {
|
||||||
|
throw new RuntimeException("XML解析失败", e);
|
||||||
|
}
|
||||||
|
return map;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String mapToXml(Map<String, String> map) {
|
||||||
|
StringBuilder sb = new StringBuilder();
|
||||||
|
sb.append("<xml>");
|
||||||
|
for (Map.Entry<String, String> entry : map.entrySet()) {
|
||||||
|
String key = entry.getKey();
|
||||||
|
String value = entry.getValue();
|
||||||
|
if (isNumeric(value)) {
|
||||||
|
sb.append("<").append(key).append(">").append(value).append("</").append(key).append(">");
|
||||||
|
} else {
|
||||||
|
sb.append("<").append(key).append("><![CDATA[").append(value).append("]]></").append(key).append(">");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
sb.append("</xml>");
|
||||||
|
return sb.toString();
|
||||||
|
}
|
||||||
|
|
||||||
|
private static boolean isNumeric(String str) {
|
||||||
|
if (str == null || str.isEmpty()) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
for (char c : str.toCharArray()) {
|
||||||
|
if (!Character.isDigit(c)) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,115 @@
|
||||||
|
package com.wecom.robot.websocket;
|
||||||
|
|
||||||
|
import com.alibaba.fastjson.JSON;
|
||||||
|
import lombok.extern.slf4j.Slf4j;
|
||||||
|
import org.springframework.stereotype.Component;
|
||||||
|
import org.springframework.web.socket.*;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.concurrent.ConcurrentHashMap;
|
||||||
|
|
||||||
|
@Slf4j
|
||||||
|
@Component
|
||||||
|
public class CsWebSocketHandler implements WebSocketHandler {
|
||||||
|
|
||||||
|
private static final Map<String, WebSocketSession> csSessions = new ConcurrentHashMap<>();
|
||||||
|
private static final Map<String, String> sessionToCsMap = new ConcurrentHashMap<>();
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void afterConnectionEstablished(WebSocketSession session) throws Exception {
|
||||||
|
String csId = extractCsId(session);
|
||||||
|
if (csId != null) {
|
||||||
|
csSessions.put(csId, session);
|
||||||
|
log.info("客服WebSocket连接建立: csId={}, sessionId={}", csId, session.getId());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void handleMessage(WebSocketSession session, WebSocketMessage<?> message) throws Exception {
|
||||||
|
if (message instanceof TextMessage) {
|
||||||
|
String payload = ((TextMessage) message).getPayload();
|
||||||
|
log.debug("收到WebSocket消息: {}", payload);
|
||||||
|
|
||||||
|
Map<String, Object> msgMap = JSON.parseObject(payload, Map.class);
|
||||||
|
String type = (String) msgMap.get("type");
|
||||||
|
|
||||||
|
if ("bind_session".equals(type)) {
|
||||||
|
String sessionId = (String) msgMap.get("sessionId");
|
||||||
|
String csId = extractCsId(session);
|
||||||
|
if (sessionId != null && csId != null) {
|
||||||
|
sessionToCsMap.put(sessionId, csId);
|
||||||
|
log.info("绑定会话: sessionId={}, csId={}", sessionId, csId);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void handleTransportError(WebSocketSession session, Throwable exception) throws Exception {
|
||||||
|
log.error("WebSocket传输错误: sessionId={}", session.getId(), exception);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void afterConnectionClosed(WebSocketSession session, CloseStatus status) throws Exception {
|
||||||
|
String csId = extractCsId(session);
|
||||||
|
if (csId != null) {
|
||||||
|
csSessions.remove(csId);
|
||||||
|
sessionToCsMap.entrySet().removeIf(entry -> csId.equals(entry.getValue()));
|
||||||
|
log.info("客服WebSocket连接关闭: csId={}, status={}", csId, status);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean supportsPartialMessages() {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void sendMessageToCs(String csId, Object message) {
|
||||||
|
WebSocketSession session = csSessions.get(csId);
|
||||||
|
if (session != null && session.isOpen()) {
|
||||||
|
try {
|
||||||
|
String json = JSON.toJSONString(message);
|
||||||
|
session.sendMessage(new TextMessage(json));
|
||||||
|
log.debug("发送消息给客服: csId={}, message={}", csId, json);
|
||||||
|
} catch (IOException e) {
|
||||||
|
log.error("发送WebSocket消息失败: csId={}", csId, e);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
log.warn("客服不在线: csId={}", csId);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public void broadcastToAll(Object message) {
|
||||||
|
String json = JSON.toJSONString(message);
|
||||||
|
TextMessage textMessage = new TextMessage(json);
|
||||||
|
|
||||||
|
csSessions.values().forEach(session -> {
|
||||||
|
if (session.isOpen()) {
|
||||||
|
try {
|
||||||
|
session.sendMessage(textMessage);
|
||||||
|
} catch (IOException e) {
|
||||||
|
log.error("广播消息失败: sessionId={}", session.getId(), e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
public void sendMessageToSession(String sessionId, Object message) {
|
||||||
|
String csId = sessionToCsMap.get(sessionId);
|
||||||
|
if (csId != null) {
|
||||||
|
sendMessageToCs(csId, message);
|
||||||
|
} else {
|
||||||
|
log.warn("会话未绑定客服: sessionId={}", sessionId);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private String extractCsId(WebSocketSession session) {
|
||||||
|
String path = session.getUri().getPath();
|
||||||
|
String[] parts = path.split("/");
|
||||||
|
if (parts.length >= 4) {
|
||||||
|
return parts[3];
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,49 @@
|
||||||
|
server:
|
||||||
|
port: 8080
|
||||||
|
|
||||||
|
spring:
|
||||||
|
datasource:
|
||||||
|
driver-class-name: com.mysql.cj.jdbc.Driver
|
||||||
|
url: jdbc:mysql://localhost:3306/wecom_robot?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
|
||||||
|
username: root
|
||||||
|
password: jiong1114
|
||||||
|
redis:
|
||||||
|
host: localhost
|
||||||
|
port: 6379
|
||||||
|
password:
|
||||||
|
database: 0
|
||||||
|
timeout: 10000
|
||||||
|
lettuce:
|
||||||
|
pool:
|
||||||
|
max-active: 8
|
||||||
|
max-wait: -1
|
||||||
|
max-idle: 8
|
||||||
|
min-idle: 0
|
||||||
|
|
||||||
|
mybatis-plus:
|
||||||
|
configuration:
|
||||||
|
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
|
||||||
|
|
||||||
|
wecom:
|
||||||
|
corp-id: ww29e81e73b1f4c6fd
|
||||||
|
agent-id: 1000006
|
||||||
|
secret: vltAfKVAH1bqo6WjB99rJaH6iQSXDyx3uf3hbbA8F-M
|
||||||
|
token: 2wuT6pE
|
||||||
|
encoding-aes-key: l0boKM2eqcGT3xV2O03y6VXx9U5l25u0tWQsgF3aNPT
|
||||||
|
|
||||||
|
ai:
|
||||||
|
enabled: true
|
||||||
|
provider: deepseek
|
||||||
|
deepseek:
|
||||||
|
api-key: sk-6cdd32d6d49d4d399b479d99e02d1672
|
||||||
|
base-url: https://api.deepseek.com/v1
|
||||||
|
model: deepseek-chat
|
||||||
|
openai:
|
||||||
|
api-key: your_openai_api_key
|
||||||
|
base-url: https://api.openai.com/v1
|
||||||
|
model: gpt-3.5-turbo
|
||||||
|
|
||||||
|
logging:
|
||||||
|
level:
|
||||||
|
com.wecom.robot: debug
|
||||||
|
org.springframework.web: info
|
||||||
|
|
@ -0,0 +1,49 @@
|
||||||
|
server:
|
||||||
|
port: 8080
|
||||||
|
|
||||||
|
spring:
|
||||||
|
datasource:
|
||||||
|
driver-class-name: com.mysql.cj.jdbc.Driver
|
||||||
|
url: jdbc:mysql://host.docker.internal:3316/wecom_robot?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
|
||||||
|
username: root
|
||||||
|
password: jiong1114
|
||||||
|
redis:
|
||||||
|
host: host.docker.internal
|
||||||
|
port: 6379
|
||||||
|
password: jiong1114
|
||||||
|
database: 0
|
||||||
|
timeout: 10000
|
||||||
|
lettuce:
|
||||||
|
pool:
|
||||||
|
max-active: 16
|
||||||
|
max-wait: -1
|
||||||
|
max-idle: 8
|
||||||
|
min-idle: 2
|
||||||
|
|
||||||
|
mybatis-plus:
|
||||||
|
configuration:
|
||||||
|
log-impl: org.apache.ibatis.logging.nologging.NoLoggingImpl
|
||||||
|
|
||||||
|
wecom:
|
||||||
|
corp-id: ww29e81e73b1f4c6fd
|
||||||
|
agent-id: 1000006
|
||||||
|
secret: vltAfKVAH1bqo6WjB99rJaH6iQSXDyx3uf3hbbA8F-M
|
||||||
|
token: 2wuT6pE
|
||||||
|
encoding-aes-key: l0boKM2eqcGT3xV2O03y6VXx9U5l25u0tWQsgF3aNPT
|
||||||
|
|
||||||
|
ai:
|
||||||
|
enabled: true
|
||||||
|
provider: deepseek
|
||||||
|
deepseek:
|
||||||
|
api-key: sk-6cdd32d6d49d4d399b479d99e02d1672
|
||||||
|
base-url: https://api.deepseek.com/v1
|
||||||
|
model: deepseek-chat
|
||||||
|
openai:
|
||||||
|
api-key: your_openai_api_key
|
||||||
|
base-url: https://api.openai.com/v1
|
||||||
|
model: gpt-3.5-turbo
|
||||||
|
|
||||||
|
logging:
|
||||||
|
level:
|
||||||
|
com.wecom.robot: info
|
||||||
|
org.springframework.web: warn
|
||||||
|
|
@ -0,0 +1,64 @@
|
||||||
|
server:
|
||||||
|
port: 8080
|
||||||
|
|
||||||
|
spring:
|
||||||
|
application:
|
||||||
|
name: wecom-robot
|
||||||
|
profiles:
|
||||||
|
active: dev
|
||||||
|
flyway:
|
||||||
|
enabled: true
|
||||||
|
locations: classpath:db/migration
|
||||||
|
baseline-on-migrate: true
|
||||||
|
baseline-version: 0
|
||||||
|
validate-on-migrate: true
|
||||||
|
|
||||||
|
mybatis-plus:
|
||||||
|
mapper-locations: classpath:mapper/*.xml
|
||||||
|
type-aliases-package: com.wecom.robot.entity
|
||||||
|
configuration:
|
||||||
|
map-underscore-to-camel-case: true
|
||||||
|
|
||||||
|
wecom:
|
||||||
|
kf:
|
||||||
|
callback-url: /wecom/callback
|
||||||
|
|
||||||
|
transfer:
|
||||||
|
keywords:
|
||||||
|
- 人工
|
||||||
|
- 转人工
|
||||||
|
- 投诉
|
||||||
|
- 客服
|
||||||
|
- 人工客服
|
||||||
|
confidence-threshold: 0.6
|
||||||
|
max-fail-rounds: 3
|
||||||
|
max-session-duration: 1800000
|
||||||
|
max-message-rounds: 50
|
||||||
|
|
||||||
|
ai-service:
|
||||||
|
url: http://localhost:8000
|
||||||
|
timeout: 5000
|
||||||
|
|
||||||
|
channel:
|
||||||
|
default-channel: wechat
|
||||||
|
adapters:
|
||||||
|
wechat:
|
||||||
|
enabled: true
|
||||||
|
douyin:
|
||||||
|
enabled: false
|
||||||
|
jd:
|
||||||
|
enabled: false
|
||||||
|
|
||||||
|
resilience4j:
|
||||||
|
circuitbreaker:
|
||||||
|
instances:
|
||||||
|
aiService:
|
||||||
|
failure-rate-threshold: 50
|
||||||
|
sliding-window-size: 10
|
||||||
|
sliding-window-type: COUNT_BASED
|
||||||
|
wait-duration-in-open-state: 30s
|
||||||
|
permitted-number-of-calls-in-half-open-state: 3
|
||||||
|
timelimiter:
|
||||||
|
instances:
|
||||||
|
aiService:
|
||||||
|
timeout-duration: 5s
|
||||||
|
|
@ -0,0 +1,74 @@
|
||||||
|
-- V1__init.sql - 初始化数据库表结构
|
||||||
|
-- Flyway 迁移脚本
|
||||||
|
|
||||||
|
-- 会话表
|
||||||
|
CREATE TABLE IF NOT EXISTS `session` (
|
||||||
|
`session_id` VARCHAR(128) NOT NULL COMMENT '会话ID',
|
||||||
|
`customer_id` VARCHAR(64) NOT NULL COMMENT '客户ID (external_userid)',
|
||||||
|
`kf_id` VARCHAR(64) NOT NULL COMMENT '客服账号ID (open_kfid)',
|
||||||
|
`channel_type` VARCHAR(20) NOT NULL DEFAULT 'wechat' COMMENT '渠道类型: wechat/douyin/jd',
|
||||||
|
`status` VARCHAR(20) NOT NULL DEFAULT 'AI' COMMENT '状态: AI/PENDING/MANUAL/CLOSED',
|
||||||
|
`wx_service_state` INT DEFAULT 0 COMMENT '微信会话状态: 0-未处理/1-智能助手/2-待接入池/3-人工接待/4-已结束',
|
||||||
|
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||||
|
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
||||||
|
`manual_cs_id` VARCHAR(64) DEFAULT NULL COMMENT '人工客服ID',
|
||||||
|
`metadata` TEXT DEFAULT NULL COMMENT '扩展信息JSON',
|
||||||
|
PRIMARY KEY (`session_id`),
|
||||||
|
INDEX `idx_customer_id` (`customer_id`),
|
||||||
|
INDEX `idx_kf_id` (`kf_id`),
|
||||||
|
INDEX `idx_status` (`status`),
|
||||||
|
INDEX `idx_channel_type` (`channel_type`),
|
||||||
|
INDEX `idx_updated_at` (`updated_at`)
|
||||||
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='会话表';
|
||||||
|
|
||||||
|
-- 消息表
|
||||||
|
CREATE TABLE IF NOT EXISTS `message` (
|
||||||
|
`msg_id` VARCHAR(128) NOT NULL COMMENT '消息ID',
|
||||||
|
`session_id` VARCHAR(128) NOT NULL COMMENT '会话ID',
|
||||||
|
`sender_type` VARCHAR(20) NOT NULL COMMENT '发送者类型: customer/ai/manual',
|
||||||
|
`sender_id` VARCHAR(64) NOT NULL COMMENT '发送者标识',
|
||||||
|
`content` TEXT NOT NULL COMMENT '消息内容',
|
||||||
|
`msg_type` VARCHAR(20) NOT NULL DEFAULT 'text' COMMENT '消息类型: text/image/link等',
|
||||||
|
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||||
|
`raw_data` TEXT DEFAULT NULL COMMENT '原始消息数据JSON',
|
||||||
|
PRIMARY KEY (`msg_id`),
|
||||||
|
INDEX `idx_session_id` (`session_id`),
|
||||||
|
INDEX `idx_created_at` (`created_at`)
|
||||||
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='消息表';
|
||||||
|
|
||||||
|
-- 客服账号表
|
||||||
|
CREATE TABLE IF NOT EXISTS `kf_account` (
|
||||||
|
`kf_id` VARCHAR(64) NOT NULL COMMENT '客服账号ID',
|
||||||
|
`name` VARCHAR(100) DEFAULT NULL COMMENT '客服昵称',
|
||||||
|
`avatar` VARCHAR(500) DEFAULT NULL COMMENT '头像URL',
|
||||||
|
`status` VARCHAR(20) NOT NULL DEFAULT 'offline' COMMENT '状态: online/offline',
|
||||||
|
`bind_manual_id` VARCHAR(64) DEFAULT NULL COMMENT '绑定的企业微信员工ID',
|
||||||
|
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||||
|
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
||||||
|
PRIMARY KEY (`kf_id`)
|
||||||
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='客服账号表';
|
||||||
|
|
||||||
|
-- 转人工记录表
|
||||||
|
CREATE TABLE IF NOT EXISTS `transfer_log` (
|
||||||
|
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '自增ID',
|
||||||
|
`session_id` VARCHAR(128) NOT NULL COMMENT '会话ID',
|
||||||
|
`trigger_reason` VARCHAR(200) DEFAULT NULL COMMENT '触发原因',
|
||||||
|
`trigger_time` DATETIME NOT NULL COMMENT '触发时间',
|
||||||
|
`accepted_time` DATETIME DEFAULT NULL COMMENT '客服接入时间',
|
||||||
|
`accepted_cs_id` VARCHAR(64) DEFAULT NULL COMMENT '接入的客服ID',
|
||||||
|
PRIMARY KEY (`id`),
|
||||||
|
INDEX `idx_session_id` (`session_id`),
|
||||||
|
INDEX `idx_trigger_time` (`trigger_time`)
|
||||||
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='转人工记录表';
|
||||||
|
|
||||||
|
-- 快捷回复表
|
||||||
|
CREATE TABLE IF NOT EXISTS `quick_reply` (
|
||||||
|
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '自增ID',
|
||||||
|
`cs_id` VARCHAR(64) DEFAULT NULL COMMENT '客服ID，为空表示公共',
|
||||||
|
`category` VARCHAR(50) DEFAULT NULL COMMENT '分类',
|
||||||
|
`content` VARCHAR(500) NOT NULL COMMENT '回复内容',
|
||||||
|
`sort_order` INT DEFAULT 0 COMMENT '排序',
|
||||||
|
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||||
|
PRIMARY KEY (`id`),
|
||||||
|
INDEX `idx_cs_id` (`cs_id`)
|
||||||
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='快捷回复表';
|
||||||
|
|
@ -0,0 +1,455 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="zh-CN">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
|
<title>聊天记录查询</title>
|
||||||
|
<style>
|
||||||
|
* {
|
||||||
|
margin: 0;
|
||||||
|
padding: 0;
|
||||||
|
box-sizing: border-box;
|
||||||
|
}
|
||||||
|
body {
|
||||||
|
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
|
||||||
|
background: #f5f5f5;
|
||||||
|
min-height: 100vh;
|
||||||
|
}
|
||||||
|
.container {
|
||||||
|
max-width: 1400px;
|
||||||
|
margin: 0 auto;
|
||||||
|
padding: 20px;
|
||||||
|
}
|
||||||
|
.header {
|
||||||
|
background: #1890ff;
|
||||||
|
color: white;
|
||||||
|
padding: 20px;
|
||||||
|
border-radius: 8px;
|
||||||
|
margin-bottom: 20px;
|
||||||
|
}
|
||||||
|
.header h1 {
|
||||||
|
font-size: 24px;
|
||||||
|
margin-bottom: 8px;
|
||||||
|
}
|
||||||
|
.header p {
|
||||||
|
opacity: 0.8;
|
||||||
|
font-size: 14px;
|
||||||
|
}
|
||||||
|
.filters {
|
||||||
|
background: white;
|
||||||
|
padding: 20px;
|
||||||
|
border-radius: 8px;
|
||||||
|
margin-bottom: 20px;
|
||||||
|
display: flex;
|
||||||
|
gap: 20px;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
align-items: center;
|
||||||
|
}
|
||||||
|
.filter-group {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: 8px;
|
||||||
|
}
|
||||||
|
.filter-group label {
|
||||||
|
font-weight: 500;
|
||||||
|
color: #333;
|
||||||
|
}
|
||||||
|
select, input {
|
||||||
|
padding: 8px 12px;
|
||||||
|
border: 1px solid #d9d9d9;
|
||||||
|
border-radius: 4px;
|
||||||
|
font-size: 14px;
|
||||||
|
min-width: 200px;
|
||||||
|
}
|
||||||
|
select:focus, input:focus {
|
||||||
|
outline: none;
|
||||||
|
border-color: #1890ff;
|
||||||
|
}
|
||||||
|
.btn {
|
||||||
|
padding: 8px 20px;
|
||||||
|
border: none;
|
||||||
|
border-radius: 4px;
|
||||||
|
cursor: pointer;
|
||||||
|
font-size: 14px;
|
||||||
|
transition: all 0.3s;
|
||||||
|
}
|
||||||
|
.btn-primary {
|
||||||
|
background: #1890ff;
|
||||||
|
color: white;
|
||||||
|
}
|
||||||
|
.btn-primary:hover {
|
||||||
|
background: #40a9ff;
|
||||||
|
}
|
||||||
|
.btn-secondary {
|
||||||
|
background: #f0f0f0;
|
||||||
|
color: #333;
|
||||||
|
}
|
||||||
|
.btn-secondary:hover {
|
||||||
|
background: #d9d9d9;
|
||||||
|
}
|
||||||
|
.main-content {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: 350px 1fr;
|
||||||
|
gap: 20px;
|
||||||
|
}
|
||||||
|
.session-list {
|
||||||
|
background: white;
|
||||||
|
border-radius: 8px;
|
||||||
|
overflow: hidden;
|
||||||
|
}
|
||||||
|
.session-list-header {
|
||||||
|
padding: 15px 20px;
|
||||||
|
background: #fafafa;
|
||||||
|
border-bottom: 1px solid #f0f0f0;
|
||||||
|
font-weight: 600;
|
||||||
|
}
|
||||||
|
.session-item {
|
||||||
|
padding: 15px 20px;
|
||||||
|
border-bottom: 1px solid #f0f0f0;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: background 0.2s;
|
||||||
|
}
|
||||||
|
.session-item:hover {
|
||||||
|
background: #f5f5f5;
|
||||||
|
}
|
||||||
|
.session-item.active {
|
||||||
|
background: #e6f7ff;
|
||||||
|
border-left: 3px solid #1890ff;
|
||||||
|
}
|
||||||
|
.session-item-header {
|
||||||
|
display: flex;
|
||||||
|
justify-content: space-between;
|
||||||
|
align-items: center;
|
||||||
|
margin-bottom: 8px;
|
||||||
|
}
|
||||||
|
.session-customer-id {
|
||||||
|
font-weight: 500;
|
||||||
|
color: #333;
|
||||||
|
font-size: 14px;
|
||||||
|
}
|
||||||
|
.session-status {
|
||||||
|
font-size: 12px;
|
||||||
|
padding: 2px 8px;
|
||||||
|
border-radius: 10px;
|
||||||
|
}
|
||||||
|
.status-AI { background: #e6f7ff; color: #1890ff; }
|
||||||
|
.status-PENDING { background: #fff7e6; color: #fa8c16; }
|
||||||
|
.status-MANUAL { background: #f6ffed; color: #52c41a; }
|
||||||
|
.status-CLOSED { background: #f5f5f5; color: #999; }
|
||||||
|
.session-meta {
|
||||||
|
font-size: 12px;
|
||||||
|
color: #999;
|
||||||
|
}
|
||||||
|
.chat-panel {
|
||||||
|
background: white;
|
||||||
|
border-radius: 8px;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
min-height: 600px;
|
||||||
|
}
|
||||||
|
.chat-header {
|
||||||
|
padding: 15px 20px;
|
||||||
|
background: #fafafa;
|
||||||
|
border-bottom: 1px solid #f0f0f0;
|
||||||
|
display: flex;
|
||||||
|
justify-content: space-between;
|
||||||
|
align-items: center;
|
||||||
|
}
|
||||||
|
.chat-header-info {
|
||||||
|
font-size: 14px;
|
||||||
|
color: #666;
|
||||||
|
}
|
||||||
|
.chat-messages {
|
||||||
|
flex: 1;
|
||||||
|
padding: 20px;
|
||||||
|
overflow-y: auto;
|
||||||
|
background: #fafafa;
|
||||||
|
}
|
||||||
|
.message {
|
||||||
|
margin-bottom: 16px;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
}
|
||||||
|
.message.customer {
|
||||||
|
align-items: flex-start;
|
||||||
|
}
|
||||||
|
.message.ai, .message.manual {
|
||||||
|
align-items: flex-end;
|
||||||
|
}
|
||||||
|
.message-sender {
|
||||||
|
font-size: 12px;
|
||||||
|
color: #999;
|
||||||
|
margin-bottom: 4px;
|
||||||
|
}
|
||||||
|
.message-content {
|
||||||
|
max-width: 70%;
|
||||||
|
padding: 10px 15px;
|
||||||
|
border-radius: 8px;
|
||||||
|
font-size: 14px;
|
||||||
|
line-height: 1.5;
|
||||||
|
}
|
||||||
|
.message.customer .message-content {
|
||||||
|
background: white;
|
||||||
|
border: 1px solid #e8e8e8;
|
||||||
|
}
|
||||||
|
.message.ai .message-content {
|
||||||
|
background: #e6f7ff;
|
||||||
|
border: 1px solid #91d5ff;
|
||||||
|
}
|
||||||
|
.message.manual .message-content {
|
||||||
|
background: #f6ffed;
|
||||||
|
border: 1px solid #b7eb8f;
|
||||||
|
}
|
||||||
|
.message-time {
|
||||||
|
font-size: 11px;
|
||||||
|
color: #bbb;
|
||||||
|
margin-top: 4px;
|
||||||
|
}
|
||||||
|
.empty-state {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
height: 100%;
|
||||||
|
color: #999;
|
||||||
|
}
|
||||||
|
.empty-state svg {
|
||||||
|
width: 80px;
|
||||||
|
height: 80px;
|
||||||
|
margin-bottom: 16px;
|
||||||
|
opacity: 0.5;
|
||||||
|
}
|
||||||
|
.loading {
|
||||||
|
text-align: center;
|
||||||
|
padding: 20px;
|
||||||
|
color: #999;
|
||||||
|
}
|
||||||
|
.no-sessions {
|
||||||
|
text-align: center;
|
||||||
|
padding: 40px;
|
||||||
|
color: #999;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div class="container">
|
||||||
|
<div class="header">
|
||||||
|
<h1>聊天记录查询</h1>
|
||||||
|
<p>查看各客服账号的历史聊天记录</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="filters">
|
||||||
|
<div class="filter-group">
|
||||||
|
<label>客服账号:</label>
|
||||||
|
<select id="kfAccountSelect">
|
||||||
|
<option value="">请选择客服账号</option>
|
||||||
|
</select>
|
||||||
|
</div>
|
||||||
|
<div class="filter-group">
|
||||||
|
<label>会话状态:</label>
|
||||||
|
<select id="statusSelect">
|
||||||
|
<option value="all">全部</option>
|
||||||
|
<option value="AI">AI接待中</option>
|
||||||
|
<option value="PENDING">待接入</option>
|
||||||
|
<option value="MANUAL">人工接待中</option>
|
||||||
|
<option value="CLOSED">已结束</option>
|
||||||
|
</select>
|
||||||
|
</div>
|
||||||
|
<button class="btn btn-primary" onclick="loadSessions()">查询会话</button>
|
||||||
|
<button class="btn btn-secondary" onclick="refreshKfAccounts()">刷新账号</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="main-content">
|
||||||
|
<div class="session-list">
|
||||||
|
<div class="session-list-header">
|
||||||
|
会话列表 (<span id="sessionCount">0</span>)
|
||||||
|
</div>
|
||||||
|
<div id="sessionListContainer">
|
||||||
|
<div class="no-sessions">请选择客服账号并查询</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="chat-panel">
|
||||||
|
<div class="chat-header">
|
||||||
|
<div class="chat-header-info" id="chatHeaderInfo">请选择会话查看聊天记录</div>
|
||||||
|
</div>
|
||||||
|
<div class="chat-messages" id="chatMessagesContainer">
|
||||||
|
<div class="empty-state">
|
||||||
|
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5">
|
||||||
|
<path d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z"/>
|
||||||
|
</svg>
|
||||||
|
<p>选择左侧会话查看聊天记录</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<script>
|
||||||
|
let currentSessionId = null;
|
||||||
|
|
||||||
|
async function refreshKfAccounts() {
|
||||||
|
try {
|
||||||
|
const response = await fetch('/chat-history/api/kf-accounts');
|
||||||
|
const result = await response.json();
|
||||||
|
|
||||||
|
if (result.code === 0) {
|
||||||
|
const select = document.getElementById('kfAccountSelect');
|
||||||
|
select.innerHTML = '<option value="">请选择客服账号</option>';
|
||||||
|
|
||||||
|
result.data.forEach(account => {
|
||||||
|
const option = document.createElement('option');
|
||||||
|
option.value = account.openKfId;
|
||||||
|
option.textContent = account.name || account.openKfId;
|
||||||
|
select.appendChild(option);
|
||||||
|
});
|
||||||
|
|
||||||
|
if (result.data.length === 0) {
|
||||||
|
alert('未获取到客服账号，请检查配置');
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
alert('获取客服账号失败: ' + result.message);
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('获取客服账号失败:', error);
|
||||||
|
alert('获取客服账号失败，请检查网络连接');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function loadSessions() {
|
||||||
|
const kfId = document.getElementById('kfAccountSelect').value;
|
||||||
|
const status = document.getElementById('statusSelect').value;
|
||||||
|
|
||||||
|
if (!kfId) {
|
||||||
|
alert('请选择客服账号');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const container = document.getElementById('sessionListContainer');
|
||||||
|
container.innerHTML = '<div class="loading">加载中...</div>';
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(`/chat-history/api/sessions?openKfId=${encodeURIComponent(kfId)}&status=${status}`);
|
||||||
|
const result = await response.json();
|
||||||
|
|
||||||
|
if (result.code === 0) {
|
||||||
|
document.getElementById('sessionCount').textContent = result.data.length;
|
||||||
|
renderSessionList(result.data);
|
||||||
|
} else {
|
||||||
|
container.innerHTML = `<div class="no-sessions">查询失败: ${result.message}</div>`;
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('加载会话列表失败:', error);
|
||||||
|
container.innerHTML = '<div class="no-sessions">加载失败，请重试</div>';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function renderSessionList(sessions) {
|
||||||
|
const container = document.getElementById('sessionListContainer');
|
||||||
|
|
||||||
|
if (sessions.length === 0) {
|
||||||
|
container.innerHTML = '<div class="no-sessions">暂无会话记录</div>';
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
container.innerHTML = sessions.map(session => `
|
||||||
|
<div class="session-item" data-session-id="${session.sessionId}" onclick="selectSession('${session.sessionId}')">
|
||||||
|
<div class="session-item-header">
|
||||||
|
<span class="session-customer-id">${session.customerId.substring(0, 15)}...</span>
|
||||||
|
<span class="session-status status-${session.status}">${getStatusText(session.status)}</span>
|
||||||
|
</div>
|
||||||
|
<div class="session-meta">
|
||||||
|
消息: ${session.messageCount} 条 | ${formatTime(session.updatedAt)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
`).join('');
|
||||||
|
}
|
||||||
|
|
||||||
|
function getStatusText(status) {
|
||||||
|
const map = {
|
||||||
|
'AI': 'AI接待',
|
||||||
|
'PENDING': '待接入',
|
||||||
|
'MANUAL': '人工接待',
|
||||||
|
'CLOSED': '已结束'
|
||||||
|
};
|
||||||
|
return map[status] || status;
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatTime(timeStr) {
|
||||||
|
if (!timeStr) return '-';
|
||||||
|
const date = new Date(timeStr);
|
||||||
|
return `${date.getMonth() + 1}/${date.getDate()} ${date.getHours()}:${String(date.getMinutes()).padStart(2, '0')}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function selectSession(sessionId) {
|
||||||
|
currentSessionId = sessionId;
|
||||||
|
|
||||||
|
document.querySelectorAll('.session-item').forEach(item => {
|
||||||
|
item.classList.remove('active');
|
||||||
|
});
|
||||||
|
document.querySelector(`[data-session-id="${sessionId}"]`).classList.add('active');
|
||||||
|
|
||||||
|
const container = document.getElementById('chatMessagesContainer');
|
||||||
|
container.innerHTML = '<div class="loading">加载中...</div>';
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(`/chat-history/api/messages?sessionId=${encodeURIComponent(sessionId)}`);
|
||||||
|
const result = await response.json();
|
||||||
|
|
||||||
|
if (result.code === 0) {
|
||||||
|
document.getElementById('chatHeaderInfo').textContent =
|
||||||
|
`会话ID: ${sessionId} | 消息数: ${result.data.length}`;
|
||||||
|
renderMessages(result.data);
|
||||||
|
} else {
|
||||||
|
container.innerHTML = `<div class="no-sessions">加载失败: ${result.message}</div>`;
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('加载消息失败:', error);
|
||||||
|
container.innerHTML = '<div class="no-sessions">加载失败，请重试</div>';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function renderMessages(messages) {
|
||||||
|
const container = document.getElementById('chatMessagesContainer');
|
||||||
|
|
||||||
|
if (messages.length === 0) {
|
||||||
|
container.innerHTML = '<div class="empty-state"><p>暂无消息记录</p></div>';
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
container.innerHTML = messages.map(msg => {
|
||||||
|
const senderName = getSenderName(msg.senderType, msg.senderId);
|
||||||
|
return `
|
||||||
|
<div class="message ${msg.senderType}">
|
||||||
|
<div class="message-sender">${senderName}</div>
|
||||||
|
<div class="message-content">${escapeHtml(msg.content)}</div>
|
||||||
|
<div class="message-time">${formatTime(msg.createdAt)}</div>
|
||||||
|
</div>
|
||||||
|
`;
|
||||||
|
}).join('');
|
||||||
|
|
||||||
|
container.scrollTop = container.scrollHeight;
|
||||||
|
}
|
||||||
|
|
||||||
|
function getSenderName(senderType, senderId) {
|
||||||
|
switch (senderType) {
|
||||||
|
case 'customer': return '客户';
|
||||||
|
case 'ai': return 'AI助手';
|
||||||
|
case 'manual': return `客服(${senderId || '未知'})`;
|
||||||
|
default: return senderType;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function escapeHtml(text) {
|
||||||
|
if (!text) return '';
|
||||||
|
const div = document.createElement('div');
|
||||||
|
div.textContent = text;
|
||||||
|
return div.innerHTML.replace(/\n/g, '<br>');
|
||||||
|
}
|
||||||
|
|
||||||
|
document.addEventListener('DOMContentLoaded', function() {
|
||||||
|
refreshKfAccounts();
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
|
|
@ -0,0 +1,458 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="zh-CN">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
|
<title>客户模拟端</title>
|
||||||
|
<style>
|
||||||
|
* {
|
||||||
|
margin: 0;
|
||||||
|
padding: 0;
|
||||||
|
box-sizing: border-box;
|
||||||
|
}
|
||||||
|
body {
|
||||||
|
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
|
||||||
|
background: #f5f5f5;
|
||||||
|
height: 100vh;
|
||||||
|
display: flex;
|
||||||
|
justify-content: center;
|
||||||
|
align-items: center;
|
||||||
|
}
|
||||||
|
.phone-frame {
|
||||||
|
width: 375px;
|
||||||
|
height: 700px;
|
||||||
|
background: #fff;
|
||||||
|
border-radius: 30px;
|
||||||
|
box-shadow: 0 10px 40px rgba(0,0,0,0.2);
|
||||||
|
overflow: hidden;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
border: 8px solid #333;
|
||||||
|
}
|
||||||
|
.phone-header {
|
||||||
|
background: #ededed;
|
||||||
|
padding: 15px;
|
||||||
|
text-align: center;
|
||||||
|
border-bottom: 1px solid #d9d9d9;
|
||||||
|
position: relative;
|
||||||
|
}
|
||||||
|
.phone-header .status-bar {
|
||||||
|
position: absolute;
|
||||||
|
top: 5px;
|
||||||
|
left: 15px;
|
||||||
|
right: 15px;
|
||||||
|
display: flex;
|
||||||
|
justify-content: space-between;
|
||||||
|
font-size: 11px;
|
||||||
|
color: #333;
|
||||||
|
}
|
||||||
|
.phone-header .title {
|
||||||
|
margin-top: 15px;
|
||||||
|
font-size: 16px;
|
||||||
|
font-weight: 500;
|
||||||
|
}
|
||||||
|
.phone-header .subtitle {
|
||||||
|
font-size: 11px;
|
||||||
|
color: #999;
|
||||||
|
margin-top: 2px;
|
||||||
|
}
|
||||||
|
.chat-area {
|
||||||
|
flex: 1;
|
||||||
|
overflow-y: auto;
|
||||||
|
padding: 15px;
|
||||||
|
background: #f5f5f5;
|
||||||
|
}
|
||||||
|
.message {
|
||||||
|
margin-bottom: 15px;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
}
|
||||||
|
.message.sent {
|
||||||
|
align-items: flex-end;
|
||||||
|
}
|
||||||
|
.message.received {
|
||||||
|
align-items: flex-start;
|
||||||
|
}
|
||||||
|
.message-bubble {
|
||||||
|
max-width: 75%;
|
||||||
|
padding: 10px 14px;
|
||||||
|
border-radius: 8px;
|
||||||
|
font-size: 14px;
|
||||||
|
line-height: 1.4;
|
||||||
|
position: relative;
|
||||||
|
}
|
||||||
|
.message.sent .message-bubble {
|
||||||
|
background: #95ec69;
|
||||||
|
border-radius: 8px 0 8px 8px;
|
||||||
|
}
|
||||||
|
.message.received .message-bubble {
|
||||||
|
background: #fff;
|
||||||
|
border-radius: 0 8px 8px 8px;
|
||||||
|
box-shadow: 0 1px 2px rgba(0,0,0,0.1);
|
||||||
|
}
|
||||||
|
.message-time {
|
||||||
|
font-size: 10px;
|
||||||
|
color: #999;
|
||||||
|
margin-top: 4px;
|
||||||
|
}
|
||||||
|
.sender-name {
|
||||||
|
font-size: 11px;
|
||||||
|
color: #999;
|
||||||
|
margin-bottom: 3px;
|
||||||
|
}
|
||||||
|
.typing-indicator {
|
||||||
|
display: none;
|
||||||
|
align-items: center;
|
||||||
|
padding: 10px 14px;
|
||||||
|
background: #fff;
|
||||||
|
border-radius: 0 8px 8px 8px;
|
||||||
|
box-shadow: 0 1px 2px rgba(0,0,0,0.1);
|
||||||
|
width: fit-content;
|
||||||
|
}
|
||||||
|
.typing-indicator.show {
|
||||||
|
display: flex;
|
||||||
|
}
|
||||||
|
.typing-indicator span {
|
||||||
|
width: 6px;
|
||||||
|
height: 6px;
|
||||||
|
background: #999;
|
||||||
|
border-radius: 50%;
|
||||||
|
margin: 0 2px;
|
||||||
|
animation: typing 1.4s infinite;
|
||||||
|
}
|
||||||
|
.typing-indicator span:nth-child(2) {
|
||||||
|
animation-delay: 0.2s;
|
||||||
|
}
|
||||||
|
.typing-indicator span:nth-child(3) {
|
||||||
|
animation-delay: 0.4s;
|
||||||
|
}
|
||||||
|
@keyframes typing {
|
||||||
|
0%, 60%, 100% { transform: translateY(0); }
|
||||||
|
30% { transform: translateY(-4px); }
|
||||||
|
}
|
||||||
|
.input-area {
|
||||||
|
background: #f7f7f7;
|
||||||
|
padding: 10px;
|
||||||
|
border-top: 1px solid #e0e0e0;
|
||||||
|
}
|
||||||
|
.input-row {
|
||||||
|
display: flex;
|
||||||
|
align-items: flex-end;
|
||||||
|
gap: 8px;
|
||||||
|
}
|
||||||
|
.input-row textarea {
|
||||||
|
flex: 1;
|
||||||
|
padding: 10px;
|
||||||
|
border: none;
|
||||||
|
border-radius: 20px;
|
||||||
|
background: #fff;
|
||||||
|
resize: none;
|
||||||
|
height: 40px;
|
||||||
|
max-height: 100px;
|
||||||
|
font-size: 14px;
|
||||||
|
outline: none;
|
||||||
|
}
|
||||||
|
.input-row button {
|
||||||
|
width: 40px;
|
||||||
|
height: 40px;
|
||||||
|
border-radius: 50%;
|
||||||
|
border: none;
|
||||||
|
background: #07c160;
|
||||||
|
color: white;
|
||||||
|
font-size: 18px;
|
||||||
|
cursor: pointer;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
}
|
||||||
|
.input-row button:hover {
|
||||||
|
background: #06ad56;
|
||||||
|
}
|
||||||
|
.input-row button:disabled {
|
||||||
|
background: #ccc;
|
||||||
|
}
|
||||||
|
.quick-actions {
|
||||||
|
display: flex;
|
||||||
|
gap: 8px;
|
||||||
|
margin-top: 8px;
|
||||||
|
}
|
||||||
|
.quick-action {
|
||||||
|
padding: 6px 12px;
|
||||||
|
background: #fff;
|
||||||
|
border: 1px solid #e0e0e0;
|
||||||
|
border-radius: 15px;
|
||||||
|
font-size: 12px;
|
||||||
|
cursor: pointer;
|
||||||
|
}
|
||||||
|
.quick-action:hover {
|
||||||
|
background: #f5f5f5;
|
||||||
|
}
|
||||||
|
.settings-panel {
|
||||||
|
position: absolute;
|
||||||
|
top: 10px;
|
||||||
|
right: 10px;
|
||||||
|
background: #fff;
|
||||||
|
border-radius: 8px;
|
||||||
|
padding: 15px;
|
||||||
|
box-shadow: 0 2px 10px rgba(0,0,0,0.1);
|
||||||
|
z-index: 100;
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
.settings-panel.show {
|
||||||
|
display: block;
|
||||||
|
}
|
||||||
|
.settings-panel h4 {
|
||||||
|
margin-bottom: 10px;
|
||||||
|
font-size: 14px;
|
||||||
|
}
|
||||||
|
.settings-panel input {
|
||||||
|
width: 100%;
|
||||||
|
padding: 8px;
|
||||||
|
margin-bottom: 8px;
|
||||||
|
border: 1px solid #d9d9d9;
|
||||||
|
border-radius: 4px;
|
||||||
|
font-size: 12px;
|
||||||
|
}
|
||||||
|
.settings-panel button {
|
||||||
|
width: 100%;
|
||||||
|
padding: 8px;
|
||||||
|
background: #07c160;
|
||||||
|
color: white;
|
||||||
|
border: none;
|
||||||
|
border-radius: 4px;
|
||||||
|
cursor: pointer;
|
||||||
|
}
|
||||||
|
.settings-btn {
|
||||||
|
position: absolute;
|
||||||
|
top: 10px;
|
||||||
|
right: 10px;
|
||||||
|
background: #fff;
|
||||||
|
border: 1px solid #d9d9d9;
|
||||||
|
border-radius: 50%;
|
||||||
|
width: 30px;
|
||||||
|
height: 30px;
|
||||||
|
cursor: pointer;
|
||||||
|
font-size: 14px;
|
||||||
|
}
|
||||||
|
.transfer-notice {
|
||||||
|
background: #fff3cd;
|
||||||
|
border: 1px solid #ffc107;
|
||||||
|
border-radius: 8px;
|
||||||
|
padding: 10px;
|
||||||
|
margin: 10px 0;
|
||||||
|
font-size: 12px;
|
||||||
|
color: #856404;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
.system-message {
|
||||||
|
text-align: center;
|
||||||
|
font-size: 11px;
|
||||||
|
color: #999;
|
||||||
|
margin: 10px 0;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div class="phone-frame">
|
||||||
|
<div class="phone-header">
|
||||||
|
<div class="status-bar">
|
||||||
|
<span id="currentTime">12:00</span>
|
||||||
|
<span>📶 🔋</span>
|
||||||
|
</div>
|
||||||
|
<div class="title">智能客服</div>
|
||||||
|
<div class="subtitle" id="statusText">AI在线</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="chat-area" id="chatArea">
|
||||||
|
<div class="system-message">会话已开始</div>
|
||||||
|
<div class="message received">
|
||||||
|
<div class="sender-name">客服</div>
|
||||||
|
<div class="message-bubble">您好！我是智能客服，有什么可以帮您的吗？</div>
|
||||||
|
<div class="message-time">刚刚</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="input-area">
|
||||||
|
<div class="input-row">
|
||||||
|
<textarea id="messageInput" placeholder="输入消息..." rows="1"></textarea>
|
||||||
|
<button onclick="sendMessage()" id="sendBtn">➤</button>
|
||||||
|
</div>
|
||||||
|
<div class="quick-actions">
|
||||||
|
<button class="quick-action" onclick="quickSend('你好')">你好</button>
|
||||||
|
<button class="quick-action" onclick="quickSend('转人工')">转人工</button>
|
||||||
|
<button class="quick-action" onclick="quickSend('投诉')">投诉</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<button class="settings-btn" onclick="toggleSettings()">⚙️</button>
|
||||||
|
|
||||||
|
<div class="settings-panel" id="settingsPanel">
|
||||||
|
<h4>测试设置</h4>
|
||||||
|
<input type="text" id="customerId" placeholder="客户ID" value="customer_001">
|
||||||
|
<input type="text" id="kfId" placeholder="客服账号ID" value="kf_001">
|
||||||
|
<button onclick="saveSettings()">保存设置</button>
|
||||||
|
<button onclick="clearChat()" style="margin-top: 8px; background: #ff4d4f;">清空聊天</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<script>
|
||||||
|
const baseUrl = window.location.origin;
|
||||||
|
let customerId = 'customer_001';
|
||||||
|
let kfId = 'kf_001';
|
||||||
|
let sessionStatus = 'AI';
|
||||||
|
|
||||||
|
function updateTime() {
|
||||||
|
const now = new Date();
|
||||||
|
document.getElementById('currentTime').textContent =
|
||||||
|
now.toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' });
|
||||||
|
}
|
||||||
|
setInterval(updateTime, 1000);
|
||||||
|
updateTime();
|
||||||
|
|
||||||
|
function toggleSettings() {
|
||||||
|
document.getElementById('settingsPanel').classList.toggle('show');
|
||||||
|
}
|
||||||
|
|
||||||
|
function saveSettings() {
|
||||||
|
customerId = document.getElementById('customerId').value || 'customer_001';
|
||||||
|
kfId = document.getElementById('kfId').value || 'kf_001';
|
||||||
|
toggleSettings();
|
||||||
|
addSystemMessage('设置已更新');
|
||||||
|
}
|
||||||
|
|
||||||
|
function clearChat() {
|
||||||
|
document.getElementById('chatArea').innerHTML = '<div class="system-message">会话已重置</div>';
|
||||||
|
sessionStatus = 'AI';
|
||||||
|
document.getElementById('statusText').textContent = 'AI在线';
|
||||||
|
toggleSettings();
|
||||||
|
}
|
||||||
|
|
||||||
|
function addSystemMessage(text) {
|
||||||
|
const chatArea = document.getElementById('chatArea');
|
||||||
|
const msg = document.createElement('div');
|
||||||
|
msg.className = 'system-message';
|
||||||
|
msg.textContent = text;
|
||||||
|
chatArea.appendChild(msg);
|
||||||
|
chatArea.scrollTop = chatArea.scrollHeight;
|
||||||
|
}
|
||||||
|
|
||||||
|
function addMessage(content, isSent, senderName = '') {
|
||||||
|
const chatArea = document.getElementById('chatArea');
|
||||||
|
const msg = document.createElement('div');
|
||||||
|
msg.className = 'message ' + (isSent ? 'sent' : 'received');
|
||||||
|
|
||||||
|
const time = new Date().toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' });
|
||||||
|
|
||||||
|
msg.innerHTML = `
|
||||||
|
${senderName ? '<div class="sender-name">' + senderName + '</div>' : ''}
|
||||||
|
<div class="message-bubble">${content}</div>
|
||||||
|
<div class="message-time">${time}</div>
|
||||||
|
`;
|
||||||
|
|
||||||
|
chatArea.appendChild(msg);
|
||||||
|
chatArea.scrollTop = chatArea.scrollHeight;
|
||||||
|
}
|
||||||
|
|
||||||
|
function showTyping() {
|
||||||
|
const chatArea = document.getElementById('chatArea');
|
||||||
|
const typing = document.createElement('div');
|
||||||
|
typing.className = 'message received';
|
||||||
|
typing.id = 'typingIndicator';
|
||||||
|
typing.innerHTML = `
|
||||||
|
<div class="typing-indicator show">
|
||||||
|
<span></span><span></span><span></span>
|
||||||
|
</div>
|
||||||
|
`;
|
||||||
|
chatArea.appendChild(typing);
|
||||||
|
chatArea.scrollTop = chatArea.scrollHeight;
|
||||||
|
}
|
||||||
|
|
||||||
|
function hideTyping() {
|
||||||
|
const typing = document.getElementById('typingIndicator');
|
||||||
|
if (typing) typing.remove();
|
||||||
|
}
|
||||||
|
|
||||||
|
async function sendMessage() {
|
||||||
|
const input = document.getElementById('messageInput');
|
||||||
|
const content = input.value.trim();
|
||||||
|
if (!content) return;
|
||||||
|
|
||||||
|
addMessage(content, true);
|
||||||
|
input.value = '';
|
||||||
|
|
||||||
|
showTyping();
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(baseUrl + '/test/send-message?' +
|
||||||
|
'customerId=' + encodeURIComponent(customerId) +
|
||||||
|
'&kfId=' + encodeURIComponent(kfId) +
|
||||||
|
'&content=' + encodeURIComponent(content), {
|
||||||
|
method: 'POST'
|
||||||
|
});
|
||||||
|
|
||||||
|
const result = await response.json();
|
||||||
|
|
||||||
|
setTimeout(() => {
|
||||||
|
hideTyping();
|
||||||
|
|
||||||
|
if (result.code === 200) {
|
||||||
|
if (content.includes('人工') || content.includes('转人工') || content.includes('投诉')) {
|
||||||
|
sessionStatus = 'PENDING';
|
||||||
|
document.getElementById('statusText').textContent = '等待人工接入...';
|
||||||
|
addTransferNotice();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}, 1000 + Math.random() * 1000);
|
||||||
|
|
||||||
|
} catch (error) {
|
||||||
|
hideTyping();
|
||||||
|
console.error('发送失败:', error);
|
||||||
|
addMessage('消息发送失败，请重试', false, '系统');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function addTransferNotice() {
|
||||||
|
const chatArea = document.getElementById('chatArea');
|
||||||
|
const notice = document.createElement('div');
|
||||||
|
notice.className = 'transfer-notice';
|
||||||
|
notice.textContent = '正在为您转接人工客服，请稍候...';
|
||||||
|
chatArea.appendChild(notice);
|
||||||
|
chatArea.scrollTop = chatArea.scrollHeight;
|
||||||
|
}
|
||||||
|
|
||||||
|
function quickSend(text) {
|
||||||
|
document.getElementById('messageInput').value = text;
|
||||||
|
sendMessage();
|
||||||
|
}
|
||||||
|
|
||||||
|
document.getElementById('messageInput').addEventListener('keypress', function(e) {
|
||||||
|
if (e.key === 'Enter' && !e.shiftKey) {
|
||||||
|
e.preventDefault();
|
||||||
|
sendMessage();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
document.getElementById('messageInput').addEventListener('input', function() {
|
||||||
|
this.style.height = 'auto';
|
||||||
|
this.style.height = Math.min(this.scrollHeight, 100) + 'px';
|
||||||
|
});
|
||||||
|
|
||||||
|
setInterval(async () => {
|
||||||
|
try {
|
||||||
|
const response = await fetch(baseUrl + '/api/sessions?status=MANUAL');
|
||||||
|
const result = await response.json();
|
||||||
|
if (result.code === 200) {
|
||||||
|
const mySession = result.data.find(s =>
|
||||||
|
s.customerId === customerId && s.status === 'MANUAL'
|
||||||
|
);
|
||||||
|
if (mySession && sessionStatus !== 'MANUAL') {
|
||||||
|
sessionStatus = 'MANUAL';
|
||||||
|
document.getElementById('statusText').textContent = '人工客服接待中';
|
||||||
|
addSystemMessage('人工客服已接入');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e) {}
|
||||||
|
}, 3000);
|
||||||
|
</script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
|
|
@ -0,0 +1,638 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="zh-CN">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
|
<title>人工客服工作台</title>
|
||||||
|
<style>
|
||||||
|
* {
|
||||||
|
margin: 0;
|
||||||
|
padding: 0;
|
||||||
|
box-sizing: border-box;
|
||||||
|
}
|
||||||
|
body {
|
||||||
|
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
|
||||||
|
background: #f5f5f5;
|
||||||
|
height: 100vh;
|
||||||
|
display: flex;
|
||||||
|
}
|
||||||
|
.sidebar {
|
||||||
|
width: 300px;
|
||||||
|
background: #fff;
|
||||||
|
border-right: 1px solid #e0e0e0;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
}
|
||||||
|
.sidebar-header {
|
||||||
|
padding: 15px;
|
||||||
|
background: #1890ff;
|
||||||
|
color: white;
|
||||||
|
font-size: 16px;
|
||||||
|
font-weight: bold;
|
||||||
|
}
|
||||||
|
.session-tabs {
|
||||||
|
display: flex;
|
||||||
|
border-bottom: 1px solid #e0e0e0;
|
||||||
|
}
|
||||||
|
.session-tab {
|
||||||
|
flex: 1;
|
||||||
|
padding: 10px;
|
||||||
|
text-align: center;
|
||||||
|
cursor: pointer;
|
||||||
|
border-bottom: 2px solid transparent;
|
||||||
|
}
|
||||||
|
.session-tab.active {
|
||||||
|
border-bottom-color: #1890ff;
|
||||||
|
color: #1890ff;
|
||||||
|
}
|
||||||
|
.session-list {
|
||||||
|
flex: 1;
|
||||||
|
overflow-y: auto;
|
||||||
|
}
|
||||||
|
.session-item {
|
||||||
|
padding: 12px 15px;
|
||||||
|
border-bottom: 1px solid #f0f0f0;
|
||||||
|
cursor: pointer;
|
||||||
|
}
|
||||||
|
.session-item:hover {
|
||||||
|
background: #f5f5f5;
|
||||||
|
}
|
||||||
|
.session-item.active {
|
||||||
|
background: #e6f7ff;
|
||||||
|
}
|
||||||
|
.session-item .customer-id {
|
||||||
|
font-weight: bold;
|
||||||
|
margin-bottom: 5px;
|
||||||
|
}
|
||||||
|
.session-item .last-msg {
|
||||||
|
font-size: 12px;
|
||||||
|
color: #666;
|
||||||
|
white-space: nowrap;
|
||||||
|
overflow: hidden;
|
||||||
|
text-overflow: ellipsis;
|
||||||
|
}
|
||||||
|
.session-item .time {
|
||||||
|
font-size: 11px;
|
||||||
|
color: #999;
|
||||||
|
margin-top: 3px;
|
||||||
|
}
|
||||||
|
.status-badge {
|
||||||
|
display: inline-block;
|
||||||
|
padding: 2px 6px;
|
||||||
|
border-radius: 3px;
|
||||||
|
font-size: 11px;
|
||||||
|
margin-left: 5px;
|
||||||
|
}
|
||||||
|
.status-pending {
|
||||||
|
background: #fff7e6;
|
||||||
|
color: #fa8c16;
|
||||||
|
}
|
||||||
|
.status-manual {
|
||||||
|
background: #e6f7ff;
|
||||||
|
color: #1890ff;
|
||||||
|
}
|
||||||
|
.main-content {
|
||||||
|
flex: 1;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
}
|
||||||
|
.chat-header {
|
||||||
|
padding: 15px;
|
||||||
|
background: #fff;
|
||||||
|
border-bottom: 1px solid #e0e0e0;
|
||||||
|
display: flex;
|
||||||
|
justify-content: space-between;
|
||||||
|
align-items: center;
|
||||||
|
}
|
||||||
|
.chat-messages {
|
||||||
|
flex: 1;
|
||||||
|
padding: 20px;
|
||||||
|
overflow-y: auto;
|
||||||
|
background: #f9f9f9;
|
||||||
|
}
|
||||||
|
.message {
|
||||||
|
margin-bottom: 15px;
|
||||||
|
display: flex;
|
||||||
|
}
|
||||||
|
.message.customer {
|
||||||
|
justify-content: flex-start;
|
||||||
|
}
|
||||||
|
.message.ai, .message.manual {
|
||||||
|
justify-content: flex-end;
|
||||||
|
}
|
||||||
|
.message-content {
|
||||||
|
max-width: 60%;
|
||||||
|
padding: 10px 15px;
|
||||||
|
border-radius: 8px;
|
||||||
|
position: relative;
|
||||||
|
}
|
||||||
|
.message.customer .message-content {
|
||||||
|
background: #fff;
|
||||||
|
border: 1px solid #e0e0e0;
|
||||||
|
}
|
||||||
|
.message.ai .message-content {
|
||||||
|
background: #e6f7ff;
|
||||||
|
border: 1px solid #91d5ff;
|
||||||
|
}
|
||||||
|
.message.manual .message-content {
|
||||||
|
background: #f6ffed;
|
||||||
|
border: 1px solid #b7eb8f;
|
||||||
|
}
|
||||||
|
.message-sender {
|
||||||
|
font-size: 11px;
|
||||||
|
color: #999;
|
||||||
|
margin-bottom: 3px;
|
||||||
|
}
|
||||||
|
.message-time {
|
||||||
|
font-size: 10px;
|
||||||
|
color: #bbb;
|
||||||
|
margin-top: 3px;
|
||||||
|
}
|
||||||
|
.chat-input {
|
||||||
|
padding: 15px;
|
||||||
|
background: #fff;
|
||||||
|
border-top: 1px solid #e0e0e0;
|
||||||
|
display: flex;
|
||||||
|
gap: 10px;
|
||||||
|
}
|
||||||
|
.chat-input textarea {
|
||||||
|
flex: 1;
|
||||||
|
padding: 10px;
|
||||||
|
border: 1px solid #d9d9d9;
|
||||||
|
border-radius: 4px;
|
||||||
|
resize: none;
|
||||||
|
height: 60px;
|
||||||
|
}
|
||||||
|
.chat-input button {
|
||||||
|
padding: 10px 20px;
|
||||||
|
background: #1890ff;
|
||||||
|
color: white;
|
||||||
|
border: none;
|
||||||
|
border-radius: 4px;
|
||||||
|
cursor: pointer;
|
||||||
|
}
|
||||||
|
.chat-input button:hover {
|
||||||
|
background: #40a9ff;
|
||||||
|
}
|
||||||
|
.chat-input button:disabled {
|
||||||
|
background: #d9d9d9;
|
||||||
|
cursor: not-allowed;
|
||||||
|
}
|
||||||
|
.empty-state {
|
||||||
|
flex: 1;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
color: #999;
|
||||||
|
}
|
||||||
|
.connection-status {
|
||||||
|
padding: 5px 10px;
|
||||||
|
font-size: 12px;
|
||||||
|
border-radius: 4px;
|
||||||
|
}
|
||||||
|
.connected {
|
||||||
|
background: #f6ffed;
|
||||||
|
color: #52c41a;
|
||||||
|
}
|
||||||
|
.disconnected {
|
||||||
|
background: #fff2f0;
|
||||||
|
color: #ff4d4f;
|
||||||
|
}
|
||||||
|
.actions {
|
||||||
|
display: flex;
|
||||||
|
gap: 10px;
|
||||||
|
}
|
||||||
|
.actions button {
|
||||||
|
padding: 5px 10px;
|
||||||
|
border: 1px solid #d9d9d9;
|
||||||
|
background: #fff;
|
||||||
|
border-radius: 4px;
|
||||||
|
cursor: pointer;
|
||||||
|
}
|
||||||
|
.actions button:hover {
|
||||||
|
border-color: #1890ff;
|
||||||
|
color: #1890ff;
|
||||||
|
}
|
||||||
|
.test-panel {
|
||||||
|
position: fixed;
|
||||||
|
right: 20px;
|
||||||
|
bottom: 20px;
|
||||||
|
background: #fff;
|
||||||
|
border: 1px solid #d9d9d9;
|
||||||
|
border-radius: 8px;
|
||||||
|
padding: 15px;
|
||||||
|
width: 300px;
|
||||||
|
box-shadow: 0 2px 8px rgba(0,0,0,0.1);
|
||||||
|
}
|
||||||
|
.test-panel h4 {
|
||||||
|
margin-bottom: 10px;
|
||||||
|
padding-bottom: 10px;
|
||||||
|
border-bottom: 1px solid #f0f0f0;
|
||||||
|
}
|
||||||
|
.test-panel input, .test-panel textarea {
|
||||||
|
width: 100%;
|
||||||
|
padding: 8px;
|
||||||
|
margin-bottom: 10px;
|
||||||
|
border: 1px solid #d9d9d9;
|
||||||
|
border-radius: 4px;
|
||||||
|
}
|
||||||
|
.test-panel button {
|
||||||
|
width: 100%;
|
||||||
|
padding: 8px;
|
||||||
|
background: #52c41a;
|
||||||
|
color: white;
|
||||||
|
border: none;
|
||||||
|
border-radius: 4px;
|
||||||
|
cursor: pointer;
|
||||||
|
}
|
||||||
|
.test-panel button:hover {
|
||||||
|
background: #73d13d;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div class="sidebar">
|
||||||
|
<div class="sidebar-header">
|
||||||
|
客服工作台 <span id="csId">CS_001</span>
|
||||||
|
</div>
|
||||||
|
<div class="session-tabs">
|
||||||
|
<div class="session-tab active" data-status="PENDING" onclick="switchTab('PENDING')">
|
||||||
|
待接入 (<span id="pendingCount">0</span>)
|
||||||
|
</div>
|
||||||
|
<div class="session-tab" data-status="MANUAL" onclick="switchTab('MANUAL')">
|
||||||
|
进行中 (<span id="manualCount">0</span>)
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="session-list" id="sessionList">
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="main-content">
|
||||||
|
<div id="chatArea" style="display: none; height: 100%; flex-direction: column;">
|
||||||
|
<div class="chat-header">
|
||||||
|
<div>
|
||||||
|
<strong id="currentCustomer">-</strong>
|
||||||
|
<span class="status-badge" id="currentStatus">-</span>
|
||||||
|
</div>
|
||||||
|
<div class="actions">
|
||||||
|
<button onclick="acceptSession()" id="acceptBtn">接入会话</button>
|
||||||
|
<button onclick="closeSession()" id="closeBtn">结束会话</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="chat-messages" id="chatMessages">
|
||||||
|
</div>
|
||||||
|
<div class="chat-input">
|
||||||
|
<textarea id="messageInput" placeholder="输入消息..."></textarea>
|
||||||
|
<button onclick="sendMessage()" id="sendBtn" disabled>发送</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div id="emptyState" class="empty-state">
|
||||||
|
<div style="text-align: center;">
|
||||||
|
<p>请从左侧选择一个会话</p>
|
||||||
|
<p style="margin-top: 10px; font-size: 12px;">WebSocket: <span id="wsStatus" class="connection-status disconnected">未连接</span></p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="test-panel">
|
||||||
|
<h4>🧪 模拟客户消息</h4>
|
||||||
|
<input type="text" id="testCustomerId" placeholder="客户ID" value="test_customer_001">
|
||||||
|
<input type="text" id="testKfId" placeholder="客服账号ID" value="test_kf_001">
|
||||||
|
<textarea id="testContent" placeholder="消息内容"></textarea>
|
||||||
|
<button onclick="sendTestMessage()">发送测试消息</button>
|
||||||
|
<button onclick="triggerTransfer()" style="margin-top: 5px; background: #fa8c16;">触发转人工</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<script>
|
||||||
|
let ws = null;
|
||||||
|
let currentSessionId = null;
|
||||||
|
let currentStatus = null;
|
||||||
|
let csId = 'CS_001';
|
||||||
|
const baseUrl = window.location.origin;
|
||||||
|
|
||||||
|
function connectWebSocket() {
|
||||||
|
const wsUrl = baseUrl.replace('http', 'ws') + '/ws/cs/' + csId;
|
||||||
|
ws = new WebSocket(wsUrl);
|
||||||
|
|
||||||
|
ws.onopen = function() {
|
||||||
|
document.getElementById('wsStatus').className = 'connection-status connected';
|
||||||
|
document.getElementById('wsStatus').textContent = '已连接';
|
||||||
|
console.log('WebSocket已连接');
|
||||||
|
};
|
||||||
|
|
||||||
|
ws.onclose = function() {
|
||||||
|
document.getElementById('wsStatus').className = 'connection-status disconnected';
|
||||||
|
document.getElementById('wsStatus').textContent = '已断开';
|
||||||
|
console.log('WebSocket已断开');
|
||||||
|
setTimeout(connectWebSocket, 3000);
|
||||||
|
};
|
||||||
|
|
||||||
|
ws.onmessage = function(event) {
|
||||||
|
const data = JSON.parse(event.data);
|
||||||
|
console.log('收到消息:', data);
|
||||||
|
handleWebSocketMessage(data);
|
||||||
|
};
|
||||||
|
|
||||||
|
ws.onerror = function(error) {
|
||||||
|
console.error('WebSocket错误:', error);
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function handleWebSocketMessage(data) {
|
||||||
|
switch(data.type) {
|
||||||
|
case 'new_pending_session':
|
||||||
|
alert('有新的待接入会话！');
|
||||||
|
loadSessions();
|
||||||
|
break;
|
||||||
|
case 'new_message':
|
||||||
|
case 'customer_message':
|
||||||
|
if (currentSessionId === data.sessionId) {
|
||||||
|
addMessage('customer', data.content, data.timestamp);
|
||||||
|
}
|
||||||
|
loadSessions();
|
||||||
|
break;
|
||||||
|
case 'session_accepted':
|
||||||
|
if (currentSessionId === data.sessionId) {
|
||||||
|
currentStatus = 'MANUAL';
|
||||||
|
updateChatHeader();
|
||||||
|
document.getElementById('sendBtn').disabled = false;
|
||||||
|
document.getElementById('acceptBtn').disabled = true;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
case 'session_closed':
|
||||||
|
if (currentSessionId === data.sessionId) {
|
||||||
|
alert('会话已结束');
|
||||||
|
currentSessionId = null;
|
||||||
|
showEmptyState();
|
||||||
|
}
|
||||||
|
loadSessions();
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function switchTab(status) {
|
||||||
|
document.querySelectorAll('.session-tab').forEach(tab => {
|
||||||
|
tab.classList.remove('active');
|
||||||
|
if (tab.dataset.status === status) {
|
||||||
|
tab.classList.add('active');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
loadSessions(status);
|
||||||
|
}
|
||||||
|
|
||||||
|
async function loadSessions(status = 'PENDING') {
|
||||||
|
try {
|
||||||
|
const response = await fetch(baseUrl + '/api/sessions?status=' + status);
|
||||||
|
const result = await response.json();
|
||||||
|
|
||||||
|
if (result.code === 200) {
|
||||||
|
renderSessionList(result.data, status);
|
||||||
|
|
||||||
|
if (status === 'PENDING') {
|
||||||
|
document.getElementById('pendingCount').textContent = result.data.length;
|
||||||
|
} else {
|
||||||
|
document.getElementById('manualCount').textContent = result.data.length;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('加载会话列表失败:', error);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function renderSessionList(sessions, status) {
|
||||||
|
const list = document.getElementById('sessionList');
|
||||||
|
list.innerHTML = '';
|
||||||
|
|
||||||
|
sessions.forEach(session => {
|
||||||
|
const item = document.createElement('div');
|
||||||
|
item.className = 'session-item' + (currentSessionId === session.sessionId ? ' active' : '');
|
||||||
|
item.onclick = () => selectSession(session);
|
||||||
|
|
||||||
|
const time = session.lastMessageTime ? new Date(session.lastMessageTime).toLocaleString() : '-';
|
||||||
|
|
||||||
|
item.innerHTML = `
|
||||||
|
<div class="customer-id">
|
||||||
|
${session.customerId}
|
||||||
|
<span class="status-badge status-${session.status.toLowerCase()}">${session.status}</span>
|
||||||
|
</div>
|
||||||
|
<div class="last-msg">${session.lastMessage || '暂无消息'}</div>
|
||||||
|
<div class="time">${time}</div>
|
||||||
|
`;
|
||||||
|
|
||||||
|
list.appendChild(item);
|
||||||
|
});
|
||||||
|
|
||||||
|
if (sessions.length === 0) {
|
||||||
|
list.innerHTML = '<div style="padding: 20px; text-align: center; color: #999;">暂无会话</div>';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function selectSession(session) {
|
||||||
|
currentSessionId = session.sessionId;
|
||||||
|
currentStatus = session.status;
|
||||||
|
|
||||||
|
document.querySelectorAll('.session-item').forEach(item => {
|
||||||
|
item.classList.remove('active');
|
||||||
|
});
|
||||||
|
event.currentTarget.classList.add('active');
|
||||||
|
|
||||||
|
document.getElementById('emptyState').style.display = 'none';
|
||||||
|
document.getElementById('chatArea').style.display = 'flex';
|
||||||
|
|
||||||
|
updateChatHeader();
|
||||||
|
await loadHistory();
|
||||||
|
|
||||||
|
if (ws && ws.readyState === WebSocket.OPEN) {
|
||||||
|
ws.send(JSON.stringify({
|
||||||
|
type: 'bind_session',
|
||||||
|
sessionId: currentSessionId
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function updateChatHeader() {
|
||||||
|
document.getElementById('currentCustomer').textContent = currentSessionId;
|
||||||
|
|
||||||
|
const statusBadge = document.getElementById('currentStatus');
|
||||||
|
statusBadge.textContent = currentStatus;
|
||||||
|
statusBadge.className = 'status-badge status-' + currentStatus.toLowerCase();
|
||||||
|
|
||||||
|
document.getElementById('acceptBtn').disabled = currentStatus !== 'PENDING';
|
||||||
|
document.getElementById('sendBtn').disabled = currentStatus !== 'MANUAL';
|
||||||
|
document.getElementById('closeBtn').disabled = currentStatus !== 'MANUAL';
|
||||||
|
}
|
||||||
|
|
||||||
|
async function loadHistory() {
|
||||||
|
try {
|
||||||
|
const response = await fetch(baseUrl + '/api/sessions/' + currentSessionId + '/history');
|
||||||
|
const result = await response.json();
|
||||||
|
|
||||||
|
if (result.code === 200) {
|
||||||
|
const container = document.getElementById('chatMessages');
|
||||||
|
container.innerHTML = '';
|
||||||
|
|
||||||
|
result.data.forEach(msg => {
|
||||||
|
addMessage(msg.senderType, msg.content, msg.createdAt);
|
||||||
|
});
|
||||||
|
|
||||||
|
container.scrollTop = container.scrollHeight;
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('加载历史消息失败:', error);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function addMessage(senderType, content, timestamp) {
|
||||||
|
const container = document.getElementById('chatMessages');
|
||||||
|
const msg = document.createElement('div');
|
||||||
|
msg.className = 'message ' + senderType;
|
||||||
|
|
||||||
|
const senderName = senderType === 'customer' ? '客户' :
|
||||||
|
senderType === 'ai' ? 'AI客服' : '人工客服';
|
||||||
|
const time = timestamp ? new Date(timestamp).toLocaleString() : new Date().toLocaleString();
|
||||||
|
|
||||||
|
msg.innerHTML = `
|
||||||
|
<div class="message-content">
|
||||||
|
<div class="message-sender">${senderName}</div>
|
||||||
|
<div>${content}</div>
|
||||||
|
<div class="message-time">${time}</div>
|
||||||
|
</div>
|
||||||
|
`;
|
||||||
|
|
||||||
|
container.appendChild(msg);
|
||||||
|
container.scrollTop = container.scrollHeight;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function acceptSession() {
|
||||||
|
if (!currentSessionId) return;
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(baseUrl + '/api/sessions/' + currentSessionId + '/accept', {
|
||||||
|
method: 'POST',
|
||||||
|
headers: { 'Content-Type': 'application/json' },
|
||||||
|
body: JSON.stringify({ csId: csId })
|
||||||
|
});
|
||||||
|
|
||||||
|
const result = await response.json();
|
||||||
|
if (result.code === 200) {
|
||||||
|
currentStatus = 'MANUAL';
|
||||||
|
updateChatHeader();
|
||||||
|
loadSessions('PENDING');
|
||||||
|
loadSessions('MANUAL');
|
||||||
|
} else {
|
||||||
|
alert('接入失败: ' + result.message);
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('接入会话失败:', error);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function sendMessage() {
|
||||||
|
if (!currentSessionId || currentStatus !== 'MANUAL') return;
|
||||||
|
|
||||||
|
const content = document.getElementById('messageInput').value.trim();
|
||||||
|
if (!content) return;
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(baseUrl + '/api/sessions/' + currentSessionId + '/message', {
|
||||||
|
method: 'POST',
|
||||||
|
headers: { 'Content-Type': 'application/json' },
|
||||||
|
body: JSON.stringify({ content: content, msgType: 'text' })
|
||||||
|
});
|
||||||
|
|
||||||
|
const result = await response.json();
|
||||||
|
if (result.code === 200) {
|
||||||
|
addMessage('manual', content);
|
||||||
|
document.getElementById('messageInput').value = '';
|
||||||
|
} else {
|
||||||
|
alert('发送失败: ' + result.message);
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('发送消息失败:', error);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function closeSession() {
|
||||||
|
if (!currentSessionId) return;
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(baseUrl + '/api/sessions/' + currentSessionId + '/close', {
|
||||||
|
method: 'POST'
|
||||||
|
});
|
||||||
|
|
||||||
|
const result = await response.json();
|
||||||
|
if (result.code === 200) {
|
||||||
|
currentSessionId = null;
|
||||||
|
showEmptyState();
|
||||||
|
loadSessions('PENDING');
|
||||||
|
loadSessions('MANUAL');
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('结束会话失败:', error);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function showEmptyState() {
|
||||||
|
document.getElementById('emptyState').style.display = 'flex';
|
||||||
|
document.getElementById('chatArea').style.display = 'none';
|
||||||
|
}
|
||||||
|
|
||||||
|
async function sendTestMessage() {
|
||||||
|
const customerId = document.getElementById('testCustomerId').value;
|
||||||
|
const kfId = document.getElementById('testKfId').value;
|
||||||
|
const content = document.getElementById('testContent').value;
|
||||||
|
|
||||||
|
if (!content) {
|
||||||
|
alert('请输入消息内容');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(baseUrl + '/test/send-message?customerId=' + customerId + '&kfId=' + kfId + '&content=' + encodeURIComponent(content), {
|
||||||
|
method: 'POST'
|
||||||
|
});
|
||||||
|
|
||||||
|
const result = await response.json();
|
||||||
|
if (result.code === 200) {
|
||||||
|
alert('消息已发送！');
|
||||||
|
document.getElementById('testContent').value = '';
|
||||||
|
setTimeout(() => loadSessions('PENDING'), 500);
|
||||||
|
setTimeout(() => loadSessions('MANUAL'), 500);
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('发送测试消息失败:', error);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function triggerTransfer() {
|
||||||
|
const customerId = document.getElementById('testCustomerId').value;
|
||||||
|
const kfId = document.getElementById('testKfId').value;
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(baseUrl + '/test/trigger-transfer?customerId=' + customerId + '&kfId=' + kfId, {
|
||||||
|
method: 'POST'
|
||||||
|
});
|
||||||
|
|
||||||
|
const result = await response.json();
|
||||||
|
if (result.code === 200) {
|
||||||
|
alert('已触发转人工！');
|
||||||
|
setTimeout(() => loadSessions('PENDING'), 500);
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('触发转人工失败:', error);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
document.getElementById('messageInput').addEventListener('keypress', function(e) {
|
||||||
|
if (e.key === 'Enter' && !e.shiftKey) {
|
||||||
|
e.preventDefault();
|
||||||
|
sendMessage();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
connectWebSocket();
|
||||||
|
loadSessions('PENDING');
|
||||||
|
loadSessions('MANUAL');
|
||||||
|
</script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
|
|
@ -0,0 +1,84 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.*;
|
||||||
|
|
||||||
|
class InboundMessageTest {
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testInboundMessageBuilder() {
|
||||||
|
SignatureInfo signatureInfo = SignatureInfo.builder()
|
||||||
|
.signature("test-signature")
|
||||||
|
.timestamp("1234567890")
|
||||||
|
.nonce("test-nonce")
|
||||||
|
.algorithm("sha256")
|
||||||
|
.build();
|
||||||
|
|
||||||
|
Map<String, Object> metadata = new HashMap<>();
|
||||||
|
metadata.put("key1", "value1");
|
||||||
|
|
||||||
|
InboundMessage message = InboundMessage.builder()
|
||||||
|
.channelType(InboundMessage.CHANNEL_WECHAT)
|
||||||
|
.channelMessageId("msg-123")
|
||||||
|
.sessionKey("session-key-001")
|
||||||
|
.customerId("customer-001")
|
||||||
|
.kfId("kf-001")
|
||||||
|
.sender("user-001")
|
||||||
|
.content("Hello World")
|
||||||
|
.msgType(InboundMessage.MSG_TYPE_TEXT)
|
||||||
|
.rawPayload("{\"raw\":\"data\"}")
|
||||||
|
.timestamp(1234567890L)
|
||||||
|
.signatureInfo(signatureInfo)
|
||||||
|
.metadata(metadata)
|
||||||
|
.build();
|
||||||
|
|
||||||
|
assertEquals(InboundMessage.CHANNEL_WECHAT, message.getChannelType());
|
||||||
|
assertEquals("msg-123", message.getChannelMessageId());
|
||||||
|
assertEquals("session-key-001", message.getSessionKey());
|
||||||
|
assertEquals("customer-001", message.getCustomerId());
|
||||||
|
assertEquals("kf-001", message.getKfId());
|
||||||
|
assertEquals("user-001", message.getSender());
|
||||||
|
assertEquals("Hello World", message.getContent());
|
||||||
|
assertEquals(InboundMessage.MSG_TYPE_TEXT, message.getMsgType());
|
||||||
|
assertEquals("{\"raw\":\"data\"}", message.getRawPayload());
|
||||||
|
assertEquals(1234567890L, message.getTimestamp());
|
||||||
|
assertNotNull(message.getSignatureInfo());
|
||||||
|
assertEquals("test-signature", message.getSignatureInfo().getSignature());
|
||||||
|
assertNotNull(message.getMetadata());
|
||||||
|
assertEquals("value1", message.getMetadata().get("key1"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testInboundMessageSetters() {
|
||||||
|
InboundMessage message = new InboundMessage();
|
||||||
|
message.setChannelType(InboundMessage.CHANNEL_DOUYIN);
|
||||||
|
message.setChannelMessageId("msg-456");
|
||||||
|
message.setSessionKey("session-key-002");
|
||||||
|
message.setContent("Test message");
|
||||||
|
|
||||||
|
assertEquals(InboundMessage.CHANNEL_DOUYIN, message.getChannelType());
|
||||||
|
assertEquals("msg-456", message.getChannelMessageId());
|
||||||
|
assertEquals("session-key-002", message.getSessionKey());
|
||||||
|
assertEquals("Test message", message.getContent());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testChannelTypeConstants() {
|
||||||
|
assertEquals("wechat", InboundMessage.CHANNEL_WECHAT);
|
||||||
|
assertEquals("douyin", InboundMessage.CHANNEL_DOUYIN);
|
||||||
|
assertEquals("jd", InboundMessage.CHANNEL_JD);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testMsgTypeConstants() {
|
||||||
|
assertEquals("text", InboundMessage.MSG_TYPE_TEXT);
|
||||||
|
assertEquals("image", InboundMessage.MSG_TYPE_IMAGE);
|
||||||
|
assertEquals("voice", InboundMessage.MSG_TYPE_VOICE);
|
||||||
|
assertEquals("video", InboundMessage.MSG_TYPE_VIDEO);
|
||||||
|
assertEquals("event", InboundMessage.MSG_TYPE_EVENT);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,50 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.*;
|
||||||
|
|
||||||
|
class OutboundMessageTest {
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testOutboundMessageBuilder() {
|
||||||
|
Map<String, Object> metadata = new HashMap<>();
|
||||||
|
metadata.put("priority", "high");
|
||||||
|
|
||||||
|
OutboundMessage message = OutboundMessage.builder()
|
||||||
|
.channelType(InboundMessage.CHANNEL_WECHAT)
|
||||||
|
.receiver("customer-001")
|
||||||
|
.kfId("kf-001")
|
||||||
|
.content("Reply message")
|
||||||
|
.msgType("text")
|
||||||
|
.metadata(metadata)
|
||||||
|
.build();
|
||||||
|
|
||||||
|
assertEquals(InboundMessage.CHANNEL_WECHAT, message.getChannelType());
|
||||||
|
assertEquals("customer-001", message.getReceiver());
|
||||||
|
assertEquals("kf-001", message.getKfId());
|
||||||
|
assertEquals("Reply message", message.getContent());
|
||||||
|
assertEquals("text", message.getMsgType());
|
||||||
|
assertNotNull(message.getMetadata());
|
||||||
|
assertEquals("high", message.getMetadata().get("priority"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testOutboundMessageSetters() {
|
||||||
|
OutboundMessage message = new OutboundMessage();
|
||||||
|
message.setChannelType(InboundMessage.CHANNEL_JD);
|
||||||
|
message.setReceiver("jd-customer-001");
|
||||||
|
message.setKfId("jd-kf-001");
|
||||||
|
message.setContent("JD reply");
|
||||||
|
message.setMsgType("text");
|
||||||
|
|
||||||
|
assertEquals(InboundMessage.CHANNEL_JD, message.getChannelType());
|
||||||
|
assertEquals("jd-customer-001", message.getReceiver());
|
||||||
|
assertEquals("jd-kf-001", message.getKfId());
|
||||||
|
assertEquals("JD reply", message.getContent());
|
||||||
|
assertEquals("text", message.getMsgType());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,61 @@
|
||||||
|
package com.wecom.robot.dto;
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.*;
|
||||||
|
|
||||||
|
class SignatureInfoTest {
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testSignatureInfoBuilder() {
|
||||||
|
SignatureInfo signatureInfo = SignatureInfo.builder()
|
||||||
|
.signature("abc123signature")
|
||||||
|
.timestamp("1708700000")
|
||||||
|
.nonce("random-nonce-value")
|
||||||
|
.algorithm("hmac-sha256")
|
||||||
|
.build();
|
||||||
|
|
||||||
|
assertEquals("abc123signature", signatureInfo.getSignature());
|
||||||
|
assertEquals("1708700000", signatureInfo.getTimestamp());
|
||||||
|
assertEquals("random-nonce-value", signatureInfo.getNonce());
|
||||||
|
assertEquals("hmac-sha256", signatureInfo.getAlgorithm());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testSignatureInfoSetters() {
|
||||||
|
SignatureInfo signatureInfo = new SignatureInfo();
|
||||||
|
signatureInfo.setSignature("test-sig");
|
||||||
|
signatureInfo.setTimestamp("12345");
|
||||||
|
signatureInfo.setNonce("test-nonce");
|
||||||
|
signatureInfo.setAlgorithm("md5");
|
||||||
|
|
||||||
|
assertEquals("test-sig", signatureInfo.getSignature());
|
||||||
|
assertEquals("12345", signatureInfo.getTimestamp());
|
||||||
|
assertEquals("test-nonce", signatureInfo.getNonce());
|
||||||
|
assertEquals("md5", signatureInfo.getAlgorithm());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testSignatureInfoNoArgsConstructor() {
|
||||||
|
SignatureInfo signatureInfo = new SignatureInfo();
|
||||||
|
assertNull(signatureInfo.getSignature());
|
||||||
|
assertNull(signatureInfo.getTimestamp());
|
||||||
|
assertNull(signatureInfo.getNonce());
|
||||||
|
assertNull(signatureInfo.getAlgorithm());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testSignatureInfoAllArgsConstructor() {
|
||||||
|
SignatureInfo signatureInfo = new SignatureInfo(
|
||||||
|
"full-sig",
|
||||||
|
"9999",
|
||||||
|
"full-nonce",
|
||||||
|
"sha1"
|
||||||
|
);
|
||||||
|
|
||||||
|
assertEquals("full-sig", signatureInfo.getSignature());
|
||||||
|
assertEquals("9999", signatureInfo.getTimestamp());
|
||||||
|
assertEquals("full-nonce", signatureInfo.getNonce());
|
||||||
|
assertEquals("sha1", signatureInfo.getAlgorithm());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,74 @@
|
||||||
|
package com.wecom.robot.dto.ai;
|
||||||
|
|
||||||
|
import com.wecom.robot.dto.InboundMessage;
|
||||||
|
import com.wecom.robot.dto.SignatureInfo;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
import java.util.Arrays;
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.*;
|
||||||
|
|
||||||
|
class ChatRequestTest {
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testChatRequestBuilder() {
|
||||||
|
ChatMessage msg1 = ChatMessage.userMessage("Hello");
|
||||||
|
ChatMessage msg2 = ChatMessage.assistantMessage("Hi there!");
|
||||||
|
|
||||||
|
Map<String, Object> metadata = new HashMap<>();
|
||||||
|
metadata.put("key", "value");
|
||||||
|
|
||||||
|
ChatRequest request = ChatRequest.builder()
|
||||||
|
.sessionId("session-123")
|
||||||
|
.currentMessage("How are you?")
|
||||||
|
.channelType(InboundMessage.CHANNEL_WECHAT)
|
||||||
|
.history(Arrays.asList(msg1, msg2))
|
||||||
|
.metadata(metadata)
|
||||||
|
.build();
|
||||||
|
|
||||||
|
assertEquals("session-123", request.getSessionId());
|
||||||
|
assertEquals("How are you?", request.getCurrentMessage());
|
||||||
|
assertEquals(InboundMessage.CHANNEL_WECHAT, request.getChannelType());
|
||||||
|
assertEquals(2, request.getHistory().size());
|
||||||
|
assertEquals("value", request.getMetadata().get("key"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testFromInboundMessage() {
|
||||||
|
InboundMessage inbound = InboundMessage.builder()
|
||||||
|
.channelType(InboundMessage.CHANNEL_WECHAT)
|
||||||
|
.channelMessageId("msg-123")
|
||||||
|
.sessionKey("session-key-001")
|
||||||
|
.customerId("customer-001")
|
||||||
|
.kfId("kf-001")
|
||||||
|
.content("Hello AI")
|
||||||
|
.build();
|
||||||
|
|
||||||
|
ChatRequest request = ChatRequest.fromInboundMessage(inbound);
|
||||||
|
|
||||||
|
assertEquals("session-key-001", request.getSessionId());
|
||||||
|
assertEquals("Hello AI", request.getCurrentMessage());
|
||||||
|
assertEquals(InboundMessage.CHANNEL_WECHAT, request.getChannelType());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testFromInboundMessageWithHistory() {
|
||||||
|
InboundMessage inbound = InboundMessage.builder()
|
||||||
|
.sessionKey("session-002")
|
||||||
|
.content("New message")
|
||||||
|
.channelType(InboundMessage.CHANNEL_DOUYIN)
|
||||||
|
.build();
|
||||||
|
|
||||||
|
ChatMessage history1 = ChatMessage.userMessage("Previous");
|
||||||
|
ChatMessage history2 = ChatMessage.assistantMessage("Response");
|
||||||
|
|
||||||
|
ChatRequest request = ChatRequest.fromInboundMessage(inbound, Arrays.asList(history1, history2));
|
||||||
|
|
||||||
|
assertEquals("session-002", request.getSessionId());
|
||||||
|
assertEquals("New message", request.getCurrentMessage());
|
||||||
|
assertEquals(InboundMessage.CHANNEL_DOUYIN, request.getChannelType());
|
||||||
|
assertEquals(2, request.getHistory().size());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,45 @@
|
||||||
|
package com.wecom.robot.dto.ai;
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.*;
|
||||||
|
|
||||||
|
class ChatResponseTest {
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testChatResponseBuilder() {
|
||||||
|
ChatResponse response = ChatResponse.builder()
|
||||||
|
.reply("This is a reply")
|
||||||
|
.confidence(0.95)
|
||||||
|
.shouldTransfer(false)
|
||||||
|
.transferReason(null)
|
||||||
|
.build();
|
||||||
|
|
||||||
|
assertEquals("This is a reply", response.getReply());
|
||||||
|
assertEquals(0.95, response.getConfidence());
|
||||||
|
assertFalse(response.getShouldTransfer());
|
||||||
|
assertNull(response.getTransferReason());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testFallback() {
|
||||||
|
ChatResponse response = ChatResponse.fallback("Service unavailable");
|
||||||
|
|
||||||
|
assertEquals("Service unavailable", response.getReply());
|
||||||
|
assertEquals(0.0, response.getConfidence());
|
||||||
|
assertTrue(response.getShouldTransfer());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testFallbackWithTransfer() {
|
||||||
|
ChatResponse response = ChatResponse.fallbackWithTransfer(
|
||||||
|
"Transferring to human agent",
|
||||||
|
"AI service timeout"
|
||||||
|
);
|
||||||
|
|
||||||
|
assertEquals("Transferring to human agent", response.getReply());
|
||||||
|
assertEquals(0.0, response.getConfidence());
|
||||||
|
assertTrue(response.getShouldTransfer());
|
||||||
|
assertEquals("AI service timeout", response.getTransferReason());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,112 @@
|
||||||
|
package com.wecom.robot.util;
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.BeforeEach;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
import org.junit.jupiter.api.extension.ExtendWith;
|
||||||
|
import org.mockito.Mock;
|
||||||
|
import org.mockito.junit.jupiter.MockitoExtension;
|
||||||
|
import org.springframework.data.redis.core.StringRedisTemplate;
|
||||||
|
import org.springframework.data.redis.core.ValueOperations;
|
||||||
|
|
||||||
|
import java.util.concurrent.TimeUnit;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.*;
|
||||||
|
import static org.mockito.ArgumentMatchers.*;
|
||||||
|
import static org.mockito.Mockito.*;
|
||||||
|
|
||||||
|
@ExtendWith(MockitoExtension.class)
|
||||||
|
class IdempotentHelperTest {
|
||||||
|
|
||||||
|
@Mock
|
||||||
|
private StringRedisTemplate redisTemplate;
|
||||||
|
|
||||||
|
@Mock
|
||||||
|
private ValueOperations<String, String> valueOperations;
|
||||||
|
|
||||||
|
private IdempotentHelper idempotentHelper;
|
||||||
|
|
||||||
|
@BeforeEach
|
||||||
|
void setUp() {
|
||||||
|
lenient().when(redisTemplate.opsForValue()).thenReturn(valueOperations);
|
||||||
|
idempotentHelper = new IdempotentHelper(redisTemplate);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testProcessMessageIdempotent_FirstTime_ShouldProcess() {
|
||||||
|
String messageId = "msg-123";
|
||||||
|
when(valueOperations.setIfAbsent(anyString(), anyString(), anyLong(), any(TimeUnit.class)))
|
||||||
|
.thenReturn(true);
|
||||||
|
|
||||||
|
boolean[] processed = {false};
|
||||||
|
boolean result = idempotentHelper.processMessageIdempotent(messageId, () -> processed[0] = true);
|
||||||
|
|
||||||
|
assertTrue(result);
|
||||||
|
assertTrue(processed[0]);
|
||||||
|
verify(valueOperations).setIfAbsent(eq("idempotent:msg-123"), eq("1"), eq(1L), eq(TimeUnit.HOURS));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testProcessMessageIdempotent_Duplicate_ShouldSkip() {
|
||||||
|
String messageId = "msg-456";
|
||||||
|
when(valueOperations.setIfAbsent(anyString(), anyString(), anyLong(), any(TimeUnit.class)))
|
||||||
|
.thenReturn(false);
|
||||||
|
|
||||||
|
boolean[] processed = {false};
|
||||||
|
boolean result = idempotentHelper.processMessageIdempotent(messageId, () -> processed[0] = true);
|
||||||
|
|
||||||
|
assertFalse(result);
|
||||||
|
assertFalse(processed[0]);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testCheckAndSet_FirstTime_ShouldReturnTrue() {
|
||||||
|
String messageId = "msg-789";
|
||||||
|
when(valueOperations.setIfAbsent(anyString(), anyString(), anyLong(), any(TimeUnit.class)))
|
||||||
|
.thenReturn(true);
|
||||||
|
|
||||||
|
boolean result = idempotentHelper.checkAndSet(messageId);
|
||||||
|
|
||||||
|
assertTrue(result);
|
||||||
|
verify(valueOperations).setIfAbsent(eq("idempotent:msg-789"), eq("1"), eq(1L), eq(TimeUnit.HOURS));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testCheckAndSet_Duplicate_ShouldReturnFalse() {
|
||||||
|
String messageId = "msg-duplicate";
|
||||||
|
when(valueOperations.setIfAbsent(anyString(), anyString(), anyLong(), any(TimeUnit.class)))
|
||||||
|
.thenReturn(false);
|
||||||
|
|
||||||
|
boolean result = idempotentHelper.checkAndSet(messageId);
|
||||||
|
|
||||||
|
assertFalse(result);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testExists_KeyExists_ShouldReturnTrue() {
|
||||||
|
String messageId = "msg-exists";
|
||||||
|
when(redisTemplate.hasKey("idempotent:msg-exists")).thenReturn(true);
|
||||||
|
|
||||||
|
boolean result = idempotentHelper.exists(messageId);
|
||||||
|
|
||||||
|
assertTrue(result);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testExists_KeyNotExists_ShouldReturnFalse() {
|
||||||
|
String messageId = "msg-notexists";
|
||||||
|
when(redisTemplate.hasKey("idempotent:msg-notexists")).thenReturn(false);
|
||||||
|
|
||||||
|
boolean result = idempotentHelper.exists(messageId);
|
||||||
|
|
||||||
|
assertFalse(result);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void testRemove_ShouldDeleteKey() {
|
||||||
|
String messageId = "msg-remove";
|
||||||
|
|
||||||
|
idempotentHelper.remove(messageId);
|
||||||
|
|
||||||
|
verify(redisTemplate).delete("idempotent:msg-remove");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,329 @@
|
||||||
|
1. 项目背景与目标
|
||||||
|
1.1 背景
|
||||||
|
随着企业服务量的增长，传统人工客服面临响应慢、人力成本高、无法7×24小时服务的问题。同时，企业微信已成为企业与客户沟通的主要渠道。为了提升客户体验、降低客服成本，需要构建一套AI优先、人机协同的智能客服系统，使每个客服账号既能由AI自动接待，又能在必要时无缝切换至人工服务。
|
||||||
|
|
||||||
|
1.2 目标
|
||||||
|
AI自动接待：客户向指定客服账号发送消息时，由AI大模型结合企业知识库自动生成回复。
|
||||||
|
|
||||||
|
人工无缝接管：在特定条件下（如AI无法回答、客户要求转人工），系统自动将会话转给真人客服，且客户无感知（同一客服身份、聊天记录连续）。
|
||||||
|
|
||||||
|
统一客服身份：所有消息（AI或人工）均以同一个客服账号的身份发出，客户始终感觉与同一位“客服”对话。
|
||||||
|
|
||||||
|
提升效率：减少人工重复劳动，缩短客户等待时间，提高问题解决率。
|
||||||
|
|
||||||
|
2. 用户角色
|
||||||
|
角色 描述 核心需求
|
||||||
|
客户 通过企业微信与客服沟通的终端用户 快速获得准确答复；需要人工时能自然转接，不重复描述问题。
|
||||||
|
AI 服务 系统后端自动处理消息的模块 理解客户意图，调用知识库，生成合规回复；识别转人工场景。
|
||||||
|
人工客服 企业微信中的真人客服 查看AI对话历史，快速介入会话，使用工作台回复客户。
|
||||||
|
系统管理员 负责系统配置与维护 配置转人工规则、知识库、客服账号；监控会话质量和AI效果。
|
||||||
|
3. 功能需求
|
||||||
|
3.1 客服账号管理
|
||||||
|
支持在企业微信后台创建多个客服账号（通过“微信客服”功能）。
|
||||||
|
|
||||||
|
系统能够获取所有客服账号列表及在线状态。
|
||||||
|
|
||||||
|
支持将客服账号与人工客服账号绑定（可选，用于后续绩效统计）。
|
||||||
|
|
||||||
|
3.2 消息接收与处理
|
||||||
|
系统需暴露一个公网可访问的回调接口，用于接收企业微信推送的客户消息。
|
||||||
|
|
||||||
|
对接收到的消息进行解密和验签（使用企业微信提供的加解密库）。
|
||||||
|
|
||||||
|
解析消息内容、客户ID、客服账号ID、消息ID、时间戳等字段。
|
||||||
|
|
||||||
|
将消息存入数据库，并触发后续处理流程。
|
||||||
|
|
||||||
|
3.3 AI 自动回复
|
||||||
|
根据会话当前状态（AI处理中）调用AI大模型生成回复。
|
||||||
|
|
||||||
|
若开启了企业知识库，需先通过RAG检索相关文档，作为上下文补充给大模型。
|
||||||
|
|
||||||
|
支持多种回复格式：文本、图片、图文链接等（根据业务需要）。
|
||||||
|
|
||||||
|
生成的回复内容需经过安全合规检查（如敏感词过滤）。
|
||||||
|
|
||||||
|
通过企业微信API，以当前客服账号的身份发送消息给客户。
|
||||||
|
|
||||||
|
3.4 转人工策略
|
||||||
|
支持配置多种转人工触发条件（可组合）：
|
||||||
|
|
||||||
|
关键词触发：客户消息包含“人工”、“转人工”、“投诉”等预设词。
|
||||||
|
|
||||||
|
AI置信度阈值：AI生成的回复置信度低于设定值（如0.6）。
|
||||||
|
|
||||||
|
多轮失败：连续N轮对话AI未能解决问题（如客户重复提问）。
|
||||||
|
|
||||||
|
会话时长/轮次：超过设定时长或消息轮次后自动转人工。
|
||||||
|
|
||||||
|
手动触发：客户在菜单点击“联系人工客服”（需企业微信菜单支持）。
|
||||||
|
|
||||||
|
触发转人工后，系统立即停止AI自动回复，将会话状态置为“待人工接入”，并将会话推送到人工客服队列。
|
||||||
|
|
||||||
|
3.5 人工客服工作台
|
||||||
|
会话列表：显示待接入、进行中的会话，包含客户昵称、最新消息时间、转人工原因等。
|
||||||
|
|
||||||
|
聊天窗口：
|
||||||
|
|
||||||
|
展示当前客户与AI的完整历史聊天记录（客户消息+AI回复）。
|
||||||
|
|
||||||
|
支持人工输入文本、选择快捷回复、发送图片/图文。
|
||||||
|
|
||||||
|
发送的消息仍以同一客服账号身份发出，客户无感知。
|
||||||
|
|
||||||
|
支持查看客户资料（如姓名、企业、标签），可从企业微信或CRM同步。
|
||||||
|
|
||||||
|
转接/结束会话：人工客服可将会话转给其他同事，或主动结束会话。
|
||||||
|
|
||||||
|
辅助功能：快捷回复库、知识库搜索、订单查询工具（可选）。
|
||||||
|
|
||||||
|
3.6 会话状态管理
|
||||||
|
会话的生命周期由以下状态机管理：
|
||||||
|
|
||||||
|
text
|
||||||
|
[初始] -> AI处理中
|
||||||
|
| 触发转人工条件
|
||||||
|
v
|
||||||
|
待人工接入
|
||||||
|
| 客服点击接入
|
||||||
|
v
|
||||||
|
人工处理中
|
||||||
|
| 客服结束会话/客户超时
|
||||||
|
v
|
||||||
|
已结束
|
||||||
|
系统需维护每个会话的当前状态，并根据状态决定消息路由：
|
||||||
|
|
||||||
|
AI处理中：消息进入AI处理模块。
|
||||||
|
|
||||||
|
待人工接入：消息不处理，仅推送到工作台待接入列表，或暂存等待人工。
|
||||||
|
|
||||||
|
人工处理中：消息直接推送到工作台，由人工回复。
|
||||||
|
|
||||||
|
3.7 上下文传递
|
||||||
|
转人工时，需将完整的对话历史（包括客户消息、AI回复、AI检索到的知识片段）传递给人工客服工作台。
|
||||||
|
|
||||||
|
人工客服接入后，工作台默认展示全部历史，确保人工快速了解前情。
|
||||||
|
|
||||||
|
若客户在人工处理期间继续发消息，工作台实时刷新显示新消息。
|
||||||
|
|
||||||
|
3.8 数据统计与监控
|
||||||
|
记录关键指标：AI回复率、转人工率、人工平均响应时间、会话满意度等。
|
||||||
|
|
||||||
|
支持管理员查看每个客服账号的接待量、AI处理占比。
|
||||||
|
|
||||||
|
支持导出报表。
|
||||||
|
|
||||||
|
4. 非功能需求
|
||||||
|
需求分类 具体要求
|
||||||
|
性能 - AI回复平均耗时 < 2秒（不含网络延迟）
|
||||||
|
- 人工消息推送延迟 < 1秒
|
||||||
|
- 系统支持并发会话数 ≥ 1000
|
||||||
|
可用性 - 系统可用性 ≥ 99.9%
|
||||||
|
- 关键模块（消息接收、发送）支持多副本部署，无单点故障
|
||||||
|
安全性 - 企业微信消息加密传输，需正确实现加解密规范
|
||||||
|
- API调用需携带合法Token，防止重放攻击
|
||||||
|
- 敏感数据（如客户手机号）在数据库加密存储
|
||||||
|
可扩展性 - AI模型可替换（如支持不同大模型API）
|
||||||
|
- 知识库支持动态更新，无需重启服务
|
||||||
|
- 人工工作台可对接企业现有CRM系统
|
||||||
|
合规性 - 符合企业微信开发者协议
|
||||||
|
- 消息内容需过滤违法违规信息
|
||||||
|
5. 技术架构
|
||||||
|
5.1 整体架构图
|
||||||
|
text
|
||||||
|
+-------------------+ +-------------------+ +-------------------+
|
||||||
|
| | | | | |
|
||||||
|
| 企业微信客户端 | <------> | 企业微信服务端 | <------> | 自建 AI 客服系统 |
|
||||||
|
| （客户/客服） | | (API & 回调) | | (核心后端) |
|
||||||
|
| | | | | |
|
||||||
|
+-------------------+ +-------------------+ +-------------------+
|
||||||
|
|
|
||||||
|
v
|
||||||
|
+------------------------+
|
||||||
|
| AI 服务模块 |
|
||||||
|
| - 大模型 API |
|
||||||
|
| - 知识库 (RAG) |
|
||||||
|
| - 转人工判断逻辑 |
|
||||||
|
+------------------------+
|
||||||
|
|
|
||||||
|
v
|
||||||
|
+------------------------+
|
||||||
|
| 人工客服工作台 |
|
||||||
|
| - Web 界面 |
|
||||||
|
| - 消息推送 (WebSocket) |
|
||||||
|
| - 快捷回复库 |
|
||||||
|
+------------------------+
|
||||||
|
5.2 核心模块说明
|
||||||
|
模块 职责 关键技术
|
||||||
|
消息接收服务 接收企业微信回调请求，验签解密，将消息写入消息队列 HTTP Server (Spring Boot/Node.js)，企业微信加解密库
|
||||||
|
会话管理器 维护会话状态，根据状态将消息路由给AI或推送到人工工作台 Redis (存储会话状态)，消息队列 (Kafka/RabbitMQ)
|
||||||
|
AI 处理器 调用大模型生成回复，集成知识库检索，判断是否转人工 大模型 API (OpenAI/DeepSeek)，向量数据库 (Milvus)，LangChain
|
||||||
|
消息发送服务 通过企业微信 API 发送消息给客户 HTTP Client，企业微信 Access Token 管理
|
||||||
|
人工工作台后端 提供 WebSocket 推送，API 供工作台调用 WebSocket，RESTful API
|
||||||
|
人工工作台前端 客服使用的界面，实时接收消息，发送回复 React/Vue，WebSocket 客户端
|
||||||
|
5.3 数据流转示例
|
||||||
|
客户发消息 → 企业微信回调 → 消息接收服务 → 存入数据库 → 消息放入队列。
|
||||||
|
|
||||||
|
会话管理器从队列消费消息，查询 Redis 中会话状态：
|
||||||
|
|
||||||
|
若为 AI 处理中，将消息发给 AI 处理器。
|
||||||
|
|
||||||
|
若为人工处理中，通过 WebSocket 推送给对应客服的工作台。
|
||||||
|
|
||||||
|
AI 处理器生成回复 → 判断是否转人工：
|
||||||
|
|
||||||
|
若不转，将回复内容发给消息发送服务，并最终发给客户。
|
||||||
|
|
||||||
|
若转，更新会话状态为待人工接入，并将会话信息存入人工队列，同时将本次回复发给客户（AI 完成最后一句话）。
|
||||||
|
|
||||||
|
人工客服登录工作台，看到待接入列表，点击接入 → 会话状态变为人工处理中，后续消息直接推送。
|
||||||
|
|
||||||
|
6. 接口定义
|
||||||
|
6.1 企业微信回调接口
|
||||||
|
URL: POST /wecom/callback
|
||||||
|
|
||||||
|
请求参数 (URL Query): msg_signature, timestamp, nonce, echostr (仅验证时)
|
||||||
|
|
||||||
|
请求体: 加密的 XML 格式消息
|
||||||
|
|
||||||
|
处理逻辑:
|
||||||
|
|
||||||
|
验证签名，解密消息体。
|
||||||
|
|
||||||
|
如果是普通消息，解析后存入数据库并推送到消息队列。
|
||||||
|
|
||||||
|
如果是事件（如客服接入），更新会话状态。
|
||||||
|
|
||||||
|
响应: 成功返回 "ok" 明文（需加密？实际上回调需返回明文 "ok" 或加密后的 "ok"？根据文档，接收消息时需返回加密后的 success 字符串。但简化起见，我们返回明文 "ok" 即可，但必须正确处理加解密。实际应使用官方 SDK 统一处理。）
|
||||||
|
|
||||||
|
6.2 发送消息接口（调用企业微信 API）
|
||||||
|
企业微信 API: POST https://qyapi.weixin.qq.com/cgi-bin/kf/send_msg?access_token=ACCESS_TOKEN
|
||||||
|
|
||||||
|
请求体示例:
|
||||||
|
|
||||||
|
json
|
||||||
|
{
|
||||||
|
"touser": "客户ID",
|
||||||
|
"open_kfid": "客服账号ID",
|
||||||
|
"msgtype": "text",
|
||||||
|
"text": {
|
||||||
|
"content": "AI 生成的回复内容"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
注意事项：需要管理 Access Token 的获取与刷新，支持多客服账号。
|
||||||
|
|
||||||
|
6.3 人工工作台 API
|
||||||
|
WebSocket 连接: ws://your-domain/ws/cs/{客服ID}，用于实时接收新消息和状态更新。
|
||||||
|
|
||||||
|
REST API:
|
||||||
|
|
||||||
|
GET /api/sessions?status=pending 获取待接入会话列表
|
||||||
|
|
||||||
|
POST /api/sessions/{sessionId}/accept 客服接入会话
|
||||||
|
|
||||||
|
POST /api/sessions/{sessionId}/message 人工发送消息
|
||||||
|
|
||||||
|
GET /api/sessions/{sessionId}/history 获取完整聊天记录
|
||||||
|
|
||||||
|
7. 数据模型
|
||||||
|
7.1 会话表 (session)
|
||||||
|
字段 类型 说明
|
||||||
|
session_id string 唯一会话ID，通常由企业微信客服API生成
|
||||||
|
customer_id string 客户ID (企业微信的 external_userid)
|
||||||
|
kf_id string 客服账号ID ( open_kfid )
|
||||||
|
status enum 'AI' / 'PENDING' / 'MANUAL' / 'CLOSED'
|
||||||
|
created_at datetime 会话创建时间
|
||||||
|
updated_at datetime 最后更新时间
|
||||||
|
manual_cs_id string 当前处理的人工客服ID（如果状态为MANUAL）
|
||||||
|
metadata json 扩展信息，如转人工原因、客户标签等
|
||||||
|
7.2 消息表 (message)
|
||||||
|
字段 类型 说明
|
||||||
|
msg_id string 企业微信消息ID（唯一）
|
||||||
|
session_id string 所属会话ID
|
||||||
|
sender_type enum 'customer' / 'ai' / 'manual'
|
||||||
|
sender_id string 发送者标识（客户ID、AI标识、客服ID）
|
||||||
|
content text 消息内容
|
||||||
|
msg_type string 'text' / 'image' / 'link' 等
|
||||||
|
created_at datetime 消息时间
|
||||||
|
raw_data json 原始消息数据（用于调试）
|
||||||
|
7.3 客服账号表 (kf_account)
|
||||||
|
字段 类型 说明
|
||||||
|
kf_id string 客服账号ID
|
||||||
|
name string 客服昵称
|
||||||
|
avatar string 头像URL
|
||||||
|
status enum 'online' / 'offline'（人工客服在线状态）
|
||||||
|
bind_manual_id string 绑定的企业微信员工ID（可选）
|
||||||
|
7.4 转人工记录表 (transfer_log)
|
||||||
|
字段 类型 说明
|
||||||
|
id int 自增ID
|
||||||
|
session_id string 会话ID
|
||||||
|
trigger_reason string 触发原因（关键词/AI置信度/多轮失败等）
|
||||||
|
trigger_time datetime 触发时间
|
||||||
|
accepted_time datetime 客服接入时间（可选）
|
||||||
|
accepted_cs_id string 接入的客服ID（可选）
|
||||||
|
8. 人机切换流程（详细）
|
||||||
|
8.1 触发转人工
|
||||||
|
当满足任一转人工条件时，系统执行以下操作：
|
||||||
|
|
||||||
|
将会话状态从 AI 更新为 PENDING（待接入）。
|
||||||
|
记录转人工原因到数据库。
|
||||||
|
如果此时 AI 正在生成回复，等待其完成并发送（保证回复连贯），然后禁止后续 AI 调用。
|
||||||
|
将会话信息推送到人工客服队列（可通过 WebSocket 通知所有在线客服有新会话待接入）。
|
||||||
|
8.2 人工客服接入
|
||||||
|
客服在工作台看到待接入会话，点击“接入”：
|
||||||
|
|
||||||
|
后端校验该会话状态仍为 PENDING，将其更新为 MANUAL，并记录接入的客服ID。
|
||||||
|
通过 WebSocket 通知该客服的工作台，打开聊天窗口并显示历史消息。
|
||||||
|
如有必要，可向客户发送一条欢迎语（但建议不发送，保持无感），或让客服主动发送第一条消息。
|
||||||
|
8.3 消息路由
|
||||||
|
会话状态为 MANUAL 后，所有客户新消息通过回调进入系统，会话管理器根据状态直接推送到对应客服的 WebSocket 连接上，不再经过 AI。
|
||||||
|
|
||||||
|
客服在工作台发送的消息，调用发送消息接口以客服账号身份发出。
|
||||||
|
|
||||||
|
8.4 会话结束
|
||||||
|
客服手动结束会话，或客户超过一定时间未回复（可配置），系统将会话状态置为 CLOSED。
|
||||||
|
|
||||||
|
结束后的会话不再接收消息（客户新消息将开启新会话）。
|
||||||
|
|
||||||
|
9. 验收标准
|
||||||
|
9.1 功能验收
|
||||||
|
客户发送消息，AI 能在 3 秒内回复。
|
||||||
|
|
||||||
|
当客户输入“人工”时，会话自动转为待人工，并出现在客服工作台。
|
||||||
|
|
||||||
|
客服接入后，能看到完整聊天记录，发送消息客户能收到且显示为同一客服身份。
|
||||||
|
|
||||||
|
人工回复后，客户继续发消息，消息能正确推送到该客服的工作台。
|
||||||
|
|
||||||
|
支持图片消息接收与发送（至少可转发图片）。
|
||||||
|
|
||||||
|
转人工条件可在后台配置并实时生效。
|
||||||
|
|
||||||
|
9.2 性能验收
|
||||||
|
并发 500 个会话同时进行 AI 处理，系统 CPU 负载 < 70%。
|
||||||
|
|
||||||
|
消息从客户发出到 AI 回复平均耗时 < 2.5 秒（包含企业微信 API 延迟）。
|
||||||
|
|
||||||
|
WebSocket 推送延迟 < 500ms。
|
||||||
|
|
||||||
|
9.3 安全性验收
|
||||||
|
所有回调接口正确验签，非法请求被拒绝。
|
||||||
|
|
||||||
|
Access Token 不泄露，定期刷新。
|
||||||
|
|
||||||
|
数据库敏感信息加密。
|
||||||
|
|
||||||
|
10. 附录
|
||||||
|
10.1 参考文档
|
||||||
|
企业微信微信客服 API 文档
|
||||||
|
|
||||||
|
企业微信回调消息加解密
|
||||||
|
|
||||||
|
MCP 协议介绍（可选，供参考）
|
||||||
|
|
||||||
|
10.2 术语表
|
||||||
|
术语 解释
|
||||||
|
微信客服 企业微信提供的一种客服功能，支持通过 API 收发消息，身份为客服账号。
|
||||||
|
open_kfid 客服账号的唯一标识。
|
||||||
|
external_userid 企业微信客户的唯一标识。
|
||||||
|
RAG 检索增强生成，一种结合检索和大模型生成的技术。
|
||||||
Loading…
Reference in New Issue