如何关联Facebook商品目录至WhatsApp Business API账号并解决显示问题？

一、商品目录关联后未在号码资料显示的排查与解决 #

• 确认关联流程合规：必须在Meta Business Manager内，将WhatsApp号码与商品目录归属同一业务账户，且通过「WhatsApp账户→号码→关联目录」路径完成绑定，跨账户关联会导致显示异常。
• 验证目录合规性：检查餐厅商品是否符合Meta政策——所有商品需有明确名称、真实定价、清晰实物图，无违规品类（如禁售食品），违规目录会被Meta隐藏。
• 刷新缓存触发同步：用户端需退出WhatsApp账号或清除App缓存后重新查看；商家端可在WhatsApp Manager中重新保存号码资料，强制触发Meta服务器同步（同步周期通常30分钟至1小时）。
• 检查号码状态：确保号码已完成正式商业验证（沙箱测试号部分功能受限），且无违规限制状态。
• 重新执行关联操作：先解除现有目录关联，等待10分钟后重新绑定，避免因临时服务器延迟导致的关联失效。

二、目录响应API调用及下单信息获取 #

目录消息调用 #

可通过WhatsApp Business API的messages端点发送目录交互消息，示例请求结构核心部分：

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<用户号码>",
  "type": "interactive",
  "interactive": {
    "type": "catalog_message",
    "catalog_message": {
      "catalog_id": "<你的目录ID>",
      "section_id": "<可选：商品集合ID>"
    }
  }
}

用户交互与下单信息获取 #

• 监听Webhook事件：当用户查看目录商品、发起下单时，Meta会推送catalog_interaction事件，包含用户ID、商品ID、操作类型；下单完成后会推送order事件，携带订单明细（商品清单、数量、用户联系方式）。
• 主动查询订单：可使用orders端点，通过用户ID或订单ID主动获取订单详情，或更新订单状态（如确认、配送）。

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