常见问题

安装部署

安装页面空白怎么办？

检查以下几点：

1. PHP 版本是否 >= 8.0
2. 必要的 PHP 扩展是否已安装（mbstring、pdo、gd、redis 等）
3. 目录权限是否正确（storage、runtime 等目录需可写）
4. 查看 runtime/logs/ 下的错误日志

安装后页面 404？

主要是 URL 重写未配置：

• Nginx：检查 location / 下的 rewrite 规则
• Apache：确保 .htaccess 文件存在且 AllowOverride All

数据库连接失败？

1. 检查数据库地址、端口、用户名、密码是否正确
2. 确认数据库已创建
3. 确认数据库用户有足够权限
4. 检查防火墙是否允许数据库连接

企微对接

回调验证失败怎么办？

1. 确认回调 URL 可以从公网访问
2. 确认 Token 和 EncodingAESKey 与企微后台一致
3. 检查服务器防火墙是否放行 80/443 端口
4. 查看系统日志中的回调错误信息

客户/员工不同步？

1. 检查企微应用的可见范围是否包含员工
2. 确认通讯录和客户联系 Secret 正确
3. 检查事件订阅是否配置正确
4. 尝试手动触发同步
5. 查看同步日志中的错误信息

侧边栏不显示？

1. 确认企业微信已配置侧边栏应用
2. 确认应用可见范围包含该员工
3. 确认侧边栏 URL 可以从企微客户端访问
4. 清空企微客户端缓存重试

群发消息发送失败？

1. 检查企业微信应用是否有群发权限
2. 检查群发频率是否超限
3. 确认客户未被员工删除
4. 查看群发任务的失败原因

功能使用

客户数据不准确？

1. 检查企微数据同步是否正常
2. 确认事件回调配置正确
3. 尝试手动同步一次
4. 检查是否有数据延迟（正常延迟 1-5 分钟）

SOP 不执行怎么办？

1. 确认 SOP 已启用
2. 检查触发条件是否满足
3. 确认客户已进入 SOP
4. 查看 SOP 执行日志
5. 检查队列服务是否正常运行

AI 功能无法使用？

1. 检查计费账户余额是否充足
2. 确认 AI 模型 API 配置正确
3. 检查 AI 功能开关是否开启
4. 确认当前套餐包含 AI 功能
5. 查看 AI 调用日志

标签不生效？

1. 确认打标签的规则条件是否满足
2. 检查规则是否已启用
3. 确认规则优先级是否正确
4. 查看规则执行日志

性能问题

系统运行慢？

1. 检查服务器资源（CPU、内存、磁盘 IO）
2. 确认 Redis 已配置并正常运行
3. 检查数据库索引是否正常
4. 查看慢查询日志
5. 清理不必要的数据

群发速度慢？

1. 检查队列配置
2. 确认企微接口限速（企微本身有限制）
3. 调整发送并发数（不建议过高）
4. 拆分群发任务，分批发送

报表加载慢？

1. 减少查询时间范围
2. 检查数据库索引
3. 考虑数据归档
4. 使用缓存加速

安全问题

如何保障数据安全？

1. 定期备份数据库
2. 开启操作日志审计
3. 配置合理的权限
4. 使用 HTTPS
5. 敏感数据加密存储

员工离职怎么办？

1. 将员工状态改为离职
2. 其名下客户自动转入公海或分配给其他员工
3. 禁用员工账号
4. 交接跟进任务

计费相关

如何充值？

1. 进入 系统设置 → 计费中心 → 账户充值
2. 选择充值金额或套餐
3. 选择支付方式
4. 完成支付
5. 余额实时到账

扣费规则是什么？

• 按实际使用量计费
• AI 功能按 Token 消耗量扣费
• 短信/电话等按条/分钟计费
• 详细扣费记录可在交易流水中查看

发票怎么开？

1. 进入 计费中心 → 交易流水
2. 找到需要开票的充值记录
3. 点击"申请发票"
4. 填写发票信息
5. 提交申请，一般 3-5 个工作日开出

其他问题

如何升级系统？

1. 备份数据库和代码
2. 获取新版本安装包
3. 平台管理后台 → 应用 → 升级
4. 等待升级完成
5. 验证功能正常

支持哪些浏览器？

推荐使用：

• Chrome（推荐）
• Edge
• Firefox
• Safari

不支持 IE 浏览器。

移动端可以用吗？

系统提供移动端能力：

• 企微侧边栏（主要使用方式）
• H5 移动端页面
• 部分功能支持手机浏览器访问

可以定制开发吗？

可以。系统基于插件架构，支持：

• 功能插件扩展
• 页面定制
• 接口定制
• 与第三方系统集成

如有定制需求，请联系商务。