m.me链接传参时Webhook未接收事件：原因排查及解决方法

我来帮你梳理下这个m.me链接传参后Webhook收不到事件的问题，结合你描述的场景和代码，整理了几个常见原因和对应的解决思路：

一、参数传递格式不符合官方要求 #

Facebook的m.me链接仅支持通过ref参数来传递自定义信息，格式是m.me/你的页面名称?ref=你的参数内容。如果你用了其他自定义参数名（比如data、id之类的），平台不会把这些参数传递到Webhook中。先确认你的链接是不是用了正确的ref键名。

二、测试账号的权限或关联配置有问题 #

• 检查你的测试/开发者账号是否已经被添加为目标页面的测试用户，或者拥有页面的管理员/编辑权限。如果账号没有正确关联到页面，即使点击m.me链接，平台也不会触发对应的Webhook事件。
• 确认Webhook的订阅字段是否勾选了messaging_referrals——通过m.me链接进入对话时，触发的是referral事件，要是没订阅这个字段，Webhook自然收不到相关数据。你可以在开发者后台的Webhook设置里，找到对应的订阅对象，补选这个字段并重新订阅。

三、「开始使用」按钮的交互冲突 #

你提到机器人配置了「开始使用」按钮，这个按钮触发的是postback事件。而m.me链接的ref参数只有在用户首次和页面互动时才会触发referral事件。如果你的测试账号之前已经点击过「开始使用」按钮、和页面有过互动，再次通过m.me链接进入时，可能会直接进入已有的对话流程，不会再触发referral事件。

解决办法：用一个从未和你的页面互动过的新测试账号来测试，或者让现有测试账号先取消关注页面，清除对话记录后再重新通过m.me链接进入。

四、Webhook接收端的逻辑遗漏 #

你提供的代码是发送通用模板消息的逻辑，和接收Webhook事件无关。要确认你的Webhook接收代码是否正确处理了referral事件——很多开发者会只处理message或postback事件，漏掉了referral的处理。

这里给你一个简单的接收示例，供参考：

// 假设用Express框架处理Webhook
app.post('/webhook', (req, res) => {
  const body = req.body;
  if (body.object === 'page') {
    body.entry.forEach(entry => {
      entry.messaging.forEach(event => {
        // 处理来自m.me链接的referral事件
        if (event.referral) {
          const receivedRef = event.referral.ref;
          console.log('收到的参数:', receivedRef);
          // 在这里添加你的业务处理逻辑
        }
        // 处理其他事件（比如postback、message等）
        if (event.postback) {
          // ...你的postback处理逻辑
        }
      });
    });
    res.status(200).send('EVENT_RECEIVED');
  } else {
    res.sendStatus(404);
  }
});

五、平台缓存或延迟导致的问题 #

有时候Facebook测试环境会有缓存，或者Webhook事件存在短暂延迟。可以尝试这些操作：

• 重新发布你的页面和机器人配置，确保所有修改都同步生效。
• 用开发者后台的Webhook测试工具，手动发送一个referral事件，验证你的接收端是否能正常收到数据，以此排除代码本身的问题。

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