WhatsApp Business API Webhook自动触发异常问题求助

核心问题定位 #

你的问题是Webhook在无用户消息触发时自动执行，导致Firebase Function重复发送回复，本质是代码逻辑未做必要过滤，形成自循环。无需删除重建应用，可通过以下步骤排查修复：

1. 检查Webhook订阅事件类型 #

登录Facebook开发者后台，进入WhatsApp应用的配置→Webhook页面：

• 确认仅订阅messages事件，避免误订阅message_delivered、message_read等消息状态类事件——这类事件会在消息发送成功/被读取时触发，若代码未判断事件类型，会误触发回复逻辑。
• 若必须订阅其他事件，需在Firebase Function中先判断事件字段：

  const changeField = req.body.entry[0].changes[0].field;
  if (changeField !== 'messages') {
    return res.status(200).send('OK');
  }
  

2. 过滤自身发送的消息 #

WhatsApp Business API会将你的业务号码发送的消息也推送到Webhook，若代码未过滤发送方，会触发自循环：

• 在Function中获取消息发送方from字段，与你的业务号码对比，若为自身号码则直接返回：

  const businessPhone = '你的业务号码（带国家码，如+123456789）';
  const incomingMsg = req.body.entry[0].changes[0].value.messages?.[0];
  if (!incomingMsg || incomingMsg.from === businessPhone) {
    return res.status(200).send('OK');
  }
  

3. 隔离Webhook验证逻辑 #

确保Webhook的GET验证请求与POST消息处理逻辑完全隔离，避免验证阶段误触发回复：

exports.whatsappWebhook = functions.https.onRequest((req, res) => {
  // 处理Webhook验证请求
  if (req.method === 'GET') {
    const verifyToken = '你的验证Token';
    const mode = req.query['hub.mode'];
    const token = req.query['hub.verify_token'];
    const challenge = req.query['hub.challenge'];
    
    if (mode && token === verifyToken) {
      return res.status(200).send(challenge);
    }
    return res.status(403).send('Invalid token');
  }

  // 仅处理POST类型的消息请求
  if (req.method === 'POST') {
    // 你的消息回复逻辑
    return res.status(200).send('OK');
  }

  return res.status(405).send('Method not allowed');
});

4. 临时终止循环的快速方法 #

无需重建应用，可临时阻断循环：

• 在Facebook开发者后台的Webhook配置中，暂时取消所有事件订阅，或直接关闭Webhook；
• 在Firebase控制台停止对应的Cloud Function，待代码修复后重新启用。

内容的提问来源于stack exchange，提问作者Shajeel Afzal