API atual/Referência completa/WhatsApp: catálogo na Meta

Sincronização do catálogo

Pede nova sincronização de todos os produtos ou de um, e lista os itens com a situação de cada um.

Ressincronizar tudo

Marca todos os itens como pendentes (P). O ciclo de sincronização em segundo plano envia tudo de novo. Use depois de uma mudança em massa de preços ou estoque.

POST/api/v1/admin/whatsapp-confluence/catalog/resyncAdmin

Ressincroniza todo o catálogo

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/v1/admin/whatsapp-confluence/catalog/resync" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Enfileirado

json

{
  "queued": true
}

Campos da resposta

queuedboolean

Sempre true.

Erros

Status	Quando	Corpo de exemplo
500	Falha ao gravar.	`{"error":"..."}`
401	Sem token, token inválido ou expirado.	`{"error":"missing authorization header"}`
403	O usuário não tem papel de administrador.	`{"error":"insufficient permissions"}`

Ressincronizar um produto

Marca um único produto como pendente. Use quando você corrigiu um item que estava em erro.

POST/api/v1/admin/whatsapp-confluence/catalog/resync/{productID}Admin

Ressincroniza um produto

Parâmetros de caminho

productIDuuidobrigatório

Id do produto na plataforma.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/v1/admin/whatsapp-confluence/catalog/resync/0b6f9d52-8a7e-4b1c-9d3a-52e1f4a7c610" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Enfileirado

json

{
  "queued": true
}

Campos da resposta

queuedboolean

true.

Erros

Status	Quando	Corpo de exemplo
500	Falha ao gravar, por exemplo id que não é UUID.	`{"error":"..."}`
401	Sem token, token inválido ou expirado.	`{"error":"missing authorization header"}`
403	O usuário não tem papel de administrador.	`{"error":"insufficient permissions"}`

Listar os itens

Lista os produtos espelhados com a situação de cada um, do mais novo para o mais antigo. Filtre por status=E para ver o que falhou e por quê.

GET/api/v1/admin/whatsapp-confluence/catalog/itemsAdmin

Lista os itens do catálogo

Parâmetros de consulta

statusstring

PSED

Filtra por situação.

pageintegerpadrão: 1

Página, a partir de 1.

per_pageintegerpadrão: 50

Itens por página, de 1 a 200 (fora disso, 50).

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/whatsapp-confluence/catalog/items?status=E" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Itens

json

{
  "items": [
    {
      "product_id": "0b6f9d52-8a7e-4b1c-9d3a-52e1f4a7c610",
      "retailer_id": "wacoex-0b6f9d52-8a7e-4b1c-9d3a-52e1f4a7c610",
      "sync_status": "E",
      "last_error": "Image URL not reachable",
      "last_synced_at": "2026-10-10T03:00:00Z"
    }
  ]
}

Campos da resposta

itemsarray

Itens da página. Lista vazia se nada combina.

items[].product_iduuid

Produto na plataforma.

items[].retailer_idstring

Id do produto no catálogo da Meta.

items[].sync_statusstring

PSED

Situação.

items[].last_errorstring

Motivo do último erro. Vazio se não houve.

items[].last_synced_atstring

Último envio (RFC 3339). Ausente se nunca enviado.

Erros

Status	Quando	Corpo de exemplo
500	Falha ao consultar.	`{"error":"..."}`
401	Sem token, token inválido ou expirado.	`{"error":"missing authorization header"}`
403	O usuário não tem papel de administrador.	`{"error":"insufficient permissions"}`

Veja também

API atual/Referência completa/WhatsApp: catálogo na Meta

Sincronização do catálogo

Pede nova sincronização de todos os produtos ou de um, e lista os itens com a situação de cada um.

Ressincronizar tudo

Marca todos os itens como pendentes (P). O ciclo de sincronização em segundo plano envia tudo de novo. Use depois de uma mudança em massa de preços ou estoque.

POST/api/v1/admin/whatsapp-confluence/catalog/resyncAdmin

Ressincroniza todo o catálogo

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/v1/admin/whatsapp-confluence/catalog/resync" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Enfileirado

json

{
  "queued": true
}

Campos da resposta

queuedboolean

Sempre true.

Erros

Status	Quando	Corpo de exemplo
500	Falha ao gravar.	`{"error":"..."}`
401	Sem token, token inválido ou expirado.	`{"error":"missing authorization header"}`
403	O usuário não tem papel de administrador.	`{"error":"insufficient permissions"}`

Ressincronizar um produto

Marca um único produto como pendente. Use quando você corrigiu um item que estava em erro.

POST/api/v1/admin/whatsapp-confluence/catalog/resync/{productID}Admin

Ressincroniza um produto

Parâmetros de caminho

productIDuuidobrigatório

Id do produto na plataforma.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/v1/admin/whatsapp-confluence/catalog/resync/0b6f9d52-8a7e-4b1c-9d3a-52e1f4a7c610" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Enfileirado

json

{
  "queued": true
}

Campos da resposta

queuedboolean

true.

Erros

Status	Quando	Corpo de exemplo
500	Falha ao gravar, por exemplo id que não é UUID.	`{"error":"..."}`
401	Sem token, token inválido ou expirado.	`{"error":"missing authorization header"}`
403	O usuário não tem papel de administrador.	`{"error":"insufficient permissions"}`

Listar os itens

Lista os produtos espelhados com a situação de cada um, do mais novo para o mais antigo. Filtre por status=E para ver o que falhou e por quê.

GET/api/v1/admin/whatsapp-confluence/catalog/itemsAdmin

Lista os itens do catálogo

Parâmetros de consulta

statusstring

PSED

Filtra por situação.

pageintegerpadrão: 1

Página, a partir de 1.

per_pageintegerpadrão: 50

Itens por página, de 1 a 200 (fora disso, 50).

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/whatsapp-confluence/catalog/items?status=E" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Itens

json

{
  "items": [
    {
      "product_id": "0b6f9d52-8a7e-4b1c-9d3a-52e1f4a7c610",
      "retailer_id": "wacoex-0b6f9d52-8a7e-4b1c-9d3a-52e1f4a7c610",
      "sync_status": "E",
      "last_error": "Image URL not reachable",
      "last_synced_at": "2026-10-10T03:00:00Z"
    }
  ]
}

Campos da resposta

itemsarray

Itens da página. Lista vazia se nada combina.

items[].product_iduuid

Produto na plataforma.

items[].retailer_idstring

Id do produto no catálogo da Meta.

items[].sync_statusstring

PSED

Situação.

items[].last_errorstring

Motivo do último erro. Vazio se não houve.

items[].last_synced_atstring

Último envio (RFC 3339). Ausente se nunca enviado.

Erros

Status	Quando	Corpo de exemplo
500	Falha ao consultar.	`{"error":"..."}`
401	Sem token, token inválido ou expirado.	`{"error":"missing authorization header"}`
403	O usuário não tem papel de administrador.	`{"error":"insufficient permissions"}`