237c7802e5
Some checks failed
Deploy / deploy (push) Has been cancelled
Full-stack web application for Telegram management - Frontend: Vue 3 + Vben Admin - Backend: NestJS - Features: User management, group broadcast, statistics 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
93 lines
2.4 KiB
Markdown
93 lines
2.4 KiB
Markdown
# Telegram 聊天功能故障排除指南
|
||
|
||
## 常见问题及解决方案
|
||
|
||
### 1. "账号连接失败"错误
|
||
|
||
#### 可能原因：
|
||
- 账号未上线
|
||
- Session 已过期
|
||
- API 配置问题
|
||
- 账号被封禁
|
||
|
||
#### 解决步骤：
|
||
|
||
1. **手动上线账号**
|
||
- 在聊天界面点击"上线"按钮
|
||
- 或返回账号列表，点击账号的"上线"按钮
|
||
- 等待上线成功提示
|
||
|
||
2. **检查 Session 状态**
|
||
- 如果提示"账号session已失效"，需要重新登录
|
||
- 返回账号列表，使用扫码或验证码重新登录
|
||
|
||
3. **检查 API 配置**
|
||
- 确保系统中有可用的 API 配置
|
||
- 在"API数据管理"中检查是否有激活的 API
|
||
|
||
### 2. "获取对话列表失败"错误
|
||
|
||
#### 解决方法：
|
||
1. 先确保账号已成功连接（显示"账号已连接"提示）
|
||
2. 点击"刷新"按钮重试
|
||
3. 如果仍然失败，尝试重新上线账号
|
||
|
||
### 3. 账号无法上线
|
||
|
||
#### 可能原因：
|
||
- Session 已失效
|
||
- 账号被封禁
|
||
- 网络连接问题
|
||
|
||
#### 解决方法：
|
||
1. 返回账号列表
|
||
2. 使用扫码或验证码重新登录账号
|
||
3. 确保网络连接正常
|
||
|
||
## 使用建议
|
||
|
||
### 最佳实践
|
||
|
||
1. **定期检查账号状态**
|
||
- 使用账号列表的"批量检查"功能
|
||
- 及时处理被封或失效的账号
|
||
|
||
2. **合理设置上线时间**
|
||
- 聊天功能默认上线时间为 1 小时
|
||
- 可根据需要调整上线时间
|
||
|
||
3. **使用内置聊天 vs 官方 Web**
|
||
- **内置聊天**：适合快速查看消息和简单对话
|
||
- **官方 Web**：适合需要完整功能的场景（发送文件、语音等）
|
||
|
||
### 功能限制
|
||
|
||
内置聊天目前支持：
|
||
- ✅ 查看对话列表
|
||
- ✅ 查看聊天记录
|
||
- ✅ 发送文字消息
|
||
- ✅ 搜索对话
|
||
- ❌ 发送图片/文件（建议使用官方 Web）
|
||
- ❌ 语音/视频通话（建议使用官方 Web）
|
||
|
||
## 技术细节
|
||
|
||
### 连接流程
|
||
1. 检查账号是否在线
|
||
2. 如未在线，使用 API 配置创建客户端
|
||
3. 连接到 Telegram 服务器
|
||
4. 获取用户信息验证连接
|
||
5. 加载对话列表
|
||
|
||
### 错误代码说明
|
||
- `AUTH_KEY_UNREGISTERED`: Session 已失效，需重新登录
|
||
- `PHONE_NUMBER_BANNED`: 手机号被封禁
|
||
- `SESSION_REVOKED`: 会话被撤销，需重新登录
|
||
- `没有可用的API配置`: 需要添加有效的 API 配置
|
||
|
||
## 需要帮助？
|
||
|
||
如果问题仍未解决，请检查：
|
||
1. 后端控制台日志，查看详细错误信息
|
||
2. 确认账号在账号列表中显示"在线"状态
|
||
3. 尝试使用其他账号测试是否为特定账号问题 |