Skip to content

收发日志 ​

收发日志记录机器人收到的消息和发出的回复,是排查“为什么没反应”的第一入口。

日志字段 ​

字段说明
时间消息发生时间
机器人哪个机器人
方向收到 / 发出
场景群聊 / 私聊
会话群 openid 或用户 openid
内容文本或媒体占位
事件类型群消息、@消息、成员事件等

排查流程 ​

完全没收到消息 ​

  1. 日志里没有入站记录
  2. 检查 QQ 开放平台事件订阅
  3. 检查 Webhook 地址是否可达
  4. 检查机器人是否被移出群
  5. 检查服务器防火墙/域名证书

收到消息但没有回复 ​

  1. 日志有入站记录
  2. 检查机器人是否被禁言
  3. 检查插件开关
  4. 检查触发词是否精确匹配
  5. 检查是否超过被动回复 5 条上限
  6. 检查工作流/关键词是否短路

发出失败 ​

看服务端日志中的错误码:

  • 40034105:主动消息无权限/额度不足
  • 40093013:语音时长超限
  • 50035006:消息发送异常
  • 被动回复上限:同一条消息最多 5 条

日志保留 ​

平台按自身策略保留日志;需要长期留存请定期导出或接入外部日志系统。

隐私 ​

日志可能包含用户 openid、昵称、消息内容。不要公开分享含隐私的日志截图;排查时对 openid 打码。

薇薇官机平台 · ZL 系列插件