Feeds de productos

Programar carga de productos por archivo

Crea un product feed: Meta descarga periódicamente un archivo con productos desde una URL y lo procesa según la programación que indiques.

• Con schedule, el archivo reemplaza el contenido del catálogo: se crean o actualizan los productos del archivo y se eliminan los que no aparecen en él.
• Con update_schedule, solo se crean o actualizan los productos del archivo.
• Con override_type, el archivo contiene información localizada (idioma, país o ambos) de productos que ya existen en el catálogo.

Petición

Petición de Programar carga de productos por archivo:

Encabezados

Encabezados de Programar carga de productos por archivo:

Parámetros

Parámetros de Programar carga de productos por archivo:

Cuerpo

Campos del cuerpo de Programar carga de productos por archivo:

Objeto schedule

Se usa tanto en schedule como en update_schedule.

Ejemplo

Ejemplo completo de Programar carga de productos por archivo:

Reemplazar el contenido del catálogo una vez al día:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/product_feeds' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{admin-token}}' \
--data '{
    "name": "Productos_reemplazo_diario",
    "schedule": {
        "interval": "DAILY",
        "url": "https://www.example.com/feeds/productos.csv",
        "hour": "13",
        "minute": "5",
        "timezone": "America/Mexico_City"
    }
}'

Crear o actualizar productos cada hora:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/product_feeds' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{admin-token}}' \
--data '{
    "name": "Productos_actualizacion_cada_hora",
    "update_schedule": {
        "interval": "HOURLY",
        "url": "https://www.example.com/feeds/productos-actualizados.csv",
        "minute": "10",
        "timezone": "America/Mexico_City"
    }
}'

Cargar información localizada por idioma y país:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/product_feeds' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{admin-token}}' \
--data '{
    "name": "Productos_localizados_diario",
    "override_type": "language_and_country",
    "schedule": {
        "interval": "DAILY",
        "url": "https://www.example.com/feeds/productos-localizados.csv",
        "hour": "14",
        "timezone": "America/Mexico_City"
    }
}'

Respuesta

Respuesta de Programar carga de productos por archivo:

💾
{
    "id": "987654321098765"
}

Listar cargas de un product feed

Devuelve las cargas (upload sessions) de un product feed, ordenadas por fecha de inicio.

Petición

Petición de Listar cargas de un product feed:

Encabezados

Encabezados de Listar cargas de un product feed:

Parámetros

Parámetros de Listar cargas de un product feed:

Ejemplo

Ejemplo completo de Listar cargas de un product feed:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/{{product_feed_id}}/uploads' \
--header 'Authorization: Bearer {{admin-token}}'

Respuesta

Respuesta de Listar cargas de un product feed:

El servicio responde con una lista de cargas.

💾
[
    {
        "id": "112233445566778",
        "startTime": "2026-11-02T18:53:25+0000",
        "endTime": "2026-11-02T19:00:34+0000"
    },
    {
        "id": "112233445566779",
        "startTime": "2026-11-03T18:50:48+0000",
        "endTime": "2026-11-03T19:00:24+0000"
    }
]

Consultar errores de una carga

Devuelve los errores que Meta encontró al procesar una carga de un product feed.

Petición

Petición de Consultar errores de una carga:

Encabezados

Encabezados de Consultar errores de una carga:

Parámetros

Parámetros de Consultar errores de una carga:

Ejemplo

Ejemplo completo de Consultar errores de una carga:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/{{product_feed_id}}/{{upload_session_id}}/errors' \
--header 'Authorization: Bearer {{admin-token}}'

Respuesta

Respuesta de Consultar errores de una carga:

Objeto upload error

Objeto samples

Objeto sample

Objeto paging

💾
{
    "data": [
        {
            "id": "556677889900112",
            "summary": "Falta el precio",
            "description": "Agrega un precio a tus productos.",
            "severity": "fatal",
            "affected_surfaces": [
                "Dynamic Ads",
                "Shops"
            ],
            "samples": {
                "data": [
                    {
                        "id": "556677889900113",
                        "row_number": 3,
                        "retailer_id": "CURSO_INGLES_004"
                    }
                ]
            }
        }
    ],
    "paging": {
        "cursors": {
            "before": "QVFIUjExampleBefore",
            "after": "QVFIUjExampleAfter"
        }
    }
}

Solicitar reporte de errores

Pide a Meta que genere un archivo con los errores de una carga. Cuando esté listo, descárgalo con el servicio Descargar reporte de errores.

Petición

Petición de Solicitar reporte de errores:

Encabezados

Encabezados de Solicitar reporte de errores:

Parámetros

Parámetros de Solicitar reporte de errores:

Ejemplo

Ejemplo completo de Solicitar reporte de errores:

💾
curl --location --request POST 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/{{product_feed_id}}/{{upload_session_id}}/error_report' \
--header 'Authorization: Bearer {{admin-token}}'

Respuesta

Respuesta de Solicitar reporte de errores:

💾
{
    "success": true
}

Descargar reporte de errores

Devuelve el estatus del reporte de errores de una carga y, cuando ya está generado, la URL para descargarlo.

Petición

Petición de Descargar reporte de errores:

Encabezados

Encabezados de Descargar reporte de errores:

Parámetros

Parámetros de Descargar reporte de errores:

Ejemplo

Ejemplo completo de Descargar reporte de errores:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/{{product_feed_id}}/{{upload_session_id}}/errors/download' \
--header 'Authorization: Bearer {{admin-token}}'

Respuesta

Respuesta de Descargar reporte de errores:

Objeto error report

Reporte listo:

💾
{
    "id": "112233445566778",
    "errorReport": {
        "reportStatus": "WRITE_FINISHED",
        "fileHandle": "https://www.example.com/reports/errores-carga-112233445566778.csv"
    }
}

Reporte no solicitado:

💾
{
    "id": "112233445566779",
    "errorReport": {
        "reportStatus": "NOT_REQUESTED"
    }
}