# 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. 尝试使用其他账号测试是否为特定账号问题