WhatsApp Cloud API发送商品列表报#131009错误求助排查

我们已在Meta商务平台创建商品目录并关联WhatsApp Business API账号，目录可成功从服务器拉取.csv文件并正确上传商品。但调用WhatsApp Cloud API发送商品列表消息时，系统提示无法找到对应ID的商品。

调用信息 #

• 接口地址：https://graph.facebook.com/v16.0/<phoneid>/messages
• 请求体：

{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "<mynumber>",
    "type": "interactive",
    "interactive": {
        "type": "product_list",
        "header": {
            "type": "TEXT",
            "text": "Tester"
        },
        "body": {
            "text": "test catagloue"
        },
        "action": {
            "catalog_id": "739765567592966",
            "sections": [
                {
                    "title": "Category 1",
                    "product_items": [
                        {
                            "product_retailer_id": "8275a-mwnje--"
                        }
                    ]
                },
                {
                    "title": "Category 2",
                    "product_items": [
                        {
                            "product_retailer_id": "puy84-bnlzx--"
                        },
                        {
                            "product_retailer_id": "1mdqj-d0xyl--"
                        }
                    ]
                }
            ]
        }
    }
}

• 错误响应：

{"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."},"fbtrace_id":"AVOhyUrgCCiy-6xbYFCVzX7"}}

已确认事项 #

• token、号码ID、目录ID等信息均正确
• 上传商品的Content ID与请求中的product_retailer_id完全匹配
• 当前目录类型为「本地商务与配送 -> 菜单及门店商品」，此前使用电商类型目录可正常发送
• 已尝试调整上传计划、更换商品ID等操作，问题未解决

排查方案 #

• 检查目录类型功能限制：Meta对不同目录类型的WhatsApp消息支持有差异，「本地商务与配送」类型可能不支持product_list消息推送。临时切换回电商类型目录测试，确认是否为类型限制导致。
• 验证商品状态：进入Meta商务平台，确认商品未被标记为下架、审核中或违规；检查商品是否完整填写WhatsApp展示所需的必填字段（名称、价格、图片等），字段缺失可能导致无法被API识别。
• 核对product_retailer_id细节：再次检查请求中的ID与目录中商品的Content ID是否完全一致，包括大小写、特殊字符（连字符、下划线等），避免全角/半角差异或隐形字符导致匹配失败。
• 测试单商品发送：修改请求体仅保留一个product_retailer_id发送，排除多商品或分组导致的问题。若单商品发送成功，再逐步添加其他商品排查个别异常。
• 确认目录与账号关联权限：进入Meta商务平台目录设置，查看关联的WhatsApp账号是否为当前调用API的账号；确认账号拥有目录的编辑或管理权限，避免权限不足导致商品无法读取。
• 用Graph API验证商品存在性：调用GET https://graph.facebook.com/v16.0/<catalog_id>/products接口，传入有效access token，检查返回列表中是否包含目标product_retailer_id，确认商品已同步到目录。

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