NodeJS集成Facebook Messenger机器人：Quick Replies动态Payload无法识别响应的问题咨询

首先要明确：这不是你的操作失误！对于user_phone_number、user_email这类Messenger平台预设的Quick Reply内容类型，平台会自动忽略你设置的payload值，转而把用户实际提供的联系方式（比如电话号码、邮箱地址）作为payload返回给你——这是平台的既定规则，这类Quick Reply的核心作用就是快速获取用户的隐私联系方式，所以直接返回实际值而非自定义payload。

那怎么识别这类响应对应的是哪个收集步骤呢？这里有两个可靠的解决方案：

方案1：利用会话状态追踪（推荐） #

因为你是按流程收集用户信息的（比如先收集邮箱，再收集电话），可以在你的Node.js应用中维护每个用户的会话状态（比如用数据库、Redis或者内存对象存储），记录当前需要用户提供的信息类型。

示例代码： #

1. 发送Quick Reply时，标记用户的会话状态：

// 假设你用对象存储用户会话状态（生产环境建议用数据库/Redis）
const userSessions = {};

// 发送请求收集电话号码时，更新用户状态
userSessions[sender_psid] = { currentStep: 'waiting_for_phone' };

const response = { 
  "text": "We need your phone number to match you with our records", 
  "quick_replies":[ 
    { 
      "content_type":"user_phone_number", 
      "payload":"PHONE_NUMBER" // 这个值仅作代码可读性标记，平台会忽略
    } 
  ] 
};
callSendAPI(sender_psid, response);

2. 接收用户响应时，根据会话状态判断：

// 处理Messenger webhook事件
function handleMessage(sender_psid, received_message) {
  // 检查是否是Quick Reply响应
  if (received_message.quick_reply) {
    const userSession = userSessions[sender_psid];
    if (!userSession) return;

    // 根据会话状态区分当前处理的信息类型
    if (userSession.currentStep === 'waiting_for_phone') {
      const userPhone = received_message.quick_reply.payload;
      // 处理用户的电话号码逻辑...
      console.log(`Received user phone: ${userPhone}`);
      // 完成后更新会话状态
      userSession.currentStep = 'completed';
    } else if (userSession.currentStep === 'waiting_for_email') {
      const userEmail = received_message.quick_reply.payload;
      // 处理用户的邮箱逻辑...
      console.log(`Received user email: ${userEmail}`);
      userSession.currentStep = 'completed';
    }
  }
}

方案2：改用自定义文本类型Quick Reply（权衡选择） #

如果你一定要用固定payload来识别，可以放弃平台预设的user_phone_number/user_email类型，改用text类型的Quick Reply，自己设置固定payload，同时提示用户输入联系方式。但这样会失去平台自动唤起用户通讯录的便捷性，需要用户手动输入。

示例代码： #

// 发送自定义文本类型的Quick Reply
const response = { 
  "text": "Please enter your phone number:", 
  "quick_replies":[ 
    { 
      "content_type":"text", 
      "title":"Enter Phone",
      "payload":"PHONE_NUMBER" // 这个固定payload会被原封不动返回
    } 
  ] 
};
callSendAPI(sender_psid, response);

// 接收时判断payload
function handleMessage(sender_psid, received_message) {
  if (received_message.quick_reply) {
    const payload = received_message.quick_reply.payload;
    if (payload === 'PHONE_NUMBER') {
      const userPhone = received_message.text;
      // 处理用户输入的电话号码逻辑...
    }
  }
}

总结 #

• 平台预设的user_phone_number/user_email类型Quick Reply会直接返回用户的联系方式作为payload，这是正常行为；
• 推荐用会话状态追踪的方式来识别对应的收集步骤，既保留平台的便捷性，又能准确处理响应；
• 若必须依赖固定payload，可改用自定义文本类型的Quick Reply，但会牺牲部分用户体验。

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