模块化排查指南

1. 网络连接不稳定或中断

网络问题是导致Zalo客服自动化任务中断的最常见原因，特别是使用API接口时。

  1. 1. 检查你的Wi-Fi或移动数据是否正常开启
  2. 2. 尝试访问其他网站确认网络连通性
  3. 3. 如果使用代理/VPN，请暂时关闭测试
  4. 4. 重启路由器或切换网络环境
提示：使用住宅代理IP可提高API调用的稳定性

2. API配置错误或权限不足

错误的API配置或权限设置会导致Zalo客服自动化任务被系统拒绝。

  1. 1. 检查你的API密钥是否有效且未过期
  2. 2. 确认API调用频率未超过限制
  3. 3. 验证应用权限是否包含客服自动化所需权限
  4. 4. 重新生成API密钥并更新到你的系统中
提示：如需API配置支持，可联系LIKE.TG技术团队

3. 任务队列积压或超时

大量待处理任务可能导致系统响应延迟或中断。

  1. 1. 登录Zalo开发者后台检查任务队列状态
  2. 2. 清理失败或超时的历史任务
  3. 3. 调整任务调度间隔，避免集中发送
  4. 4. 考虑使用分布式任务处理方案

常见错误提示及针对性解决方案

错误："API Rate Limit Exceeded"

表示API调用频率超过限制。

  1. 1. 降低API调用频率至官方限制范围内
  2. 2. 实现指数退避重试机制
  3. 3. 考虑申请更高的API调用配额

错误："Invalid Access Token"

访问令牌无效或已过期。

  1. 1. 重新获取有效的访问令牌
  2. 2. 检查令牌有效期并设置自动刷新机制
  3. 3. 确认令牌生成流程正确无误

错误："Message Sending Failed"

消息发送失败，可能由多种原因导致。

  1. 1. 检查接收方账号状态是否正常
  2. 2. 确认消息内容符合平台规范
  3. 3. 尝试简化消息内容重新发送