模块化排查指南

1. 账号API权限未开通或异常

Zalo官方API对开发者账号有严格权限控制,未正确配置会导致轮询请求失败。

  1. 登录Zalo开发者平台检查账号状态
  2. 确认已开通消息API权限
  3. 检查App ID和密钥是否正确配置
  4. 重新生成密钥测试连接状态
提示:Zalo企业账号比个人账号享有更高API调用频率

2. IP请求频率限制触发

单IP高频请求会被Zalo服务器临时封禁,导致后续轮询失败。

  1. 检查当前代理IP是否被限制
  2. 降低请求频率至每分钟3次以下
  3. 更换住宅代理IP规避限制
  4. 添加随机延迟(建议1-3秒)
推荐使用LIKE.TG动态住宅代理自动切换优质IP

3. 轮询请求参数错误

过期或错误的access_token是最常见的技术原因。

  1. 确保access_token未过期(有效期通常1小时)
  2. 检查请求URL包含正确version参数(如/v2.0/)
  3. 验证消息格式符合官方文档标准
  4. 使用Postman测试基础请求是否成功

常见错误代码专项

错误:-124 访问被拒绝

通常由无效access_token或未授权API请求引起。

  1. 通过oauth接口重新获取access_token
  2. 检查请求header是否携带Authorization
  3. 确认服务端时间与网络时间同步

错误:-304 请求太频繁

触发了Zalo API的rate limit保护机制。

  1. 立即停止当前所有请求
  2. 等待1小时冷却期自动解除
  3. 后续添加随机延迟降低频率