Files
wecom-ai-assistant/docs/phase5.md
2026-02-05 16:36:32 +08:00

19 lines
965 B
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Phase 5会话入库 + 后台可看
## 新增内容
- **回调入库**WeCom POST 回调解析到客户消息后,`get_or_create_session` + `add_message`user/assistant写入 DB。
- **会话列表**`GET /api/sessions``chat_sessions` 表读取,需 Bearer token。
- **消息列表**`GET /api/sessions/{session_id}/messages``messages` 表读取,需 Bearer token。
## 验证
1. 配置好 WeCom 回调 URL、Token、EncodingAESKey并确保回调可访问公网或 ngrok
2. 在企微侧给应用发一条文本消息,触发 POST 回调。
3. 管理后台登录后打开「会话列表」,应出现一条会话;点「查看消息」应看到用户消息与机器人 echo 回复。
## 关键点
- 外部客户仅使用 public 知识;回调中只存消息内容与 external_user_id不落内部配置。
- 会话以 `external_user_id`(企微 FromUserName唯一同一客户多条消息归同一会话。