无法通过WhatsApp Cloud API发送多产品消息，报错#131009

问题详情 #

无法向用户发送产品列表消息，每次请求均返回参数无效错误，当前使用的目录已绑定到发送号码。

请求体 #

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "###########",
  "type": "interactive",
  "interactive": {
    "type": "product_list",
    "header": {
      "type": "text",
      "text": "text-header-content"
    },
    "body": {
      "text": "text-body-content"
    },
    "footer": {
      "text": "text-footer-content"
    },
    "action": {
      "catalog_id": "673529427462715",
      "sections": [
        {
          "title": "the-section-title",
          "product_items": [
            {
              "product_retailer_id": "K456653445"
            }
          ]
        }
      ]
    }
  }
}

错误响应 #

{
  "error": {
    "message": "(#131009) Parameter value is not valid",
    "type": "OAuthException",
    "code": 131009,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "None of the products provided could be sent. Please check your catalog."
    },
    "error_subcode": 2494010,
    "fbtrace_id": "A4YbEq8SQ7rMIisuc4M2HiX"
  }
}

排查与解决步骤 #

• 核对product_retailer_id：确保请求中的K456653445与Meta商务管理平台目录内对应产品的商家ID完全匹配，注意大小写、特殊字符及空格，不能有拼写错误。
• 检查产品状态：确认目标产品处于已发布状态，草稿、下架或审核中的产品无法被发送。
• 验证目录绑定：确认catalog_id: 673529427462715已正确绑定到当前发送消息的WhatsApp号码，可在商务平台的WhatsApp账号设置中查看绑定关系。
• 检查产品合规性：产品需符合WhatsApp商务内容规范，包括完整的价格信息、合规的产品图片、无违规内容等。
• 单产品测试：先尝试发送一个确认有效的产品，排除格式或批量请求的潜在问题。

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