Initial commit: 浼佷笟寰俊 AI 鏈哄櫒浜哄姪鐞?MVP

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
bujie9527
2026-02-05 16:36:32 +08:00
commit 59275ed4dc
126 changed files with 9120 additions and 0 deletions

17
docs/phase6.md Normal file
View File

@@ -0,0 +1,17 @@
# Phase 6转人工工单 + 手动回复(企业微信发消息)
## 新增内容
- **创建工单**`POST /api/tickets`body `session_id``reason`;插入 `tickets` 表并将对应会话 `status` 置为 `transferred`
- **手动回复**`POST /api/tickets/reply`body `session_id``content`;根据会话查 `external_user_id`调用企业微信「发送消息给外部联系人」API 下发文本。
- **WeCom API 封装**`app/services/wecom_api.py``get_access_token``send_text_to_external`,带超时与重试。
## 验证
1. 在管理后台进入某会话详情,点击「转人工/创建工单」→ 应提示工单已创建。
2. 在输入框输入内容点「发送」→ 客户端(企微侧)应收到该条消息(需配置好 `WECOM_CORP_ID``WECOM_SECRET``WECOM_AGENT_ID`)。
## 配置与接口说明
- 发消息接口以当前实现为准(如 `externalcontact/message/send``externalcontact/send_message_to_user`);若企微返回 4xx/5xx请对照官方文档调整 URL 与参数。
- `sender` 当前使用 `WECOM_AGENT_ID`;若需指定客服成员,可后续增加 `WECOM_SENDER_USERID` 配置。