VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
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

Resposta

200Enfileirado

Campos da resposta

queuedboolean
Sempre true.

Erros

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

A resposta não espera o envio. Acompanhe por Consultar a situação do catálogo.

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

Resposta

200Enfileirado

Campos da resposta

queuedboolean
true.

Erros

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

Um UUID que não está no catálogo também responde 200: nenhuma linha é alterada. Confira em Listar os itens.

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

Resposta

200Itens

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

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

A resposta não traz o total; use as contagens de GET /catalog/status.

Veja também

  • Ligar o catálogo
  • Vender na conversa
Anterior
Ligar o catálogo
Próxima
Produtos e templates
Nesta página
  • Ressincronizar tudo
  • Exemplo de requisição
  • Resposta
  • Erros
  • Ressincronizar um produto
  • Exemplo de requisição
  • Resposta
  • Erros
  • Listar os itens
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também
bash
curl -X POST "$BASE_URL/api/v1/admin/whatsapp-confluence/catalog/resync" \
  -H "Authorization: Bearer $TOKEN"
bash
curl -X POST "$BASE_URL/api/v1/admin/whatsapp-confluence/catalog/resync/0b6f9d52-8a7e-4b1c-9d3a-52e1f4a7c610" \
  -H "Authorization: Bearer $TOKEN"
bash
curl "$BASE_URL/api/v1/admin/whatsapp-confluence/catalog/items?status=E" \
  -H "Authorization: Bearer $TOKEN"
json
{
  "queued": true
}
json
{
  "queued": true
}
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"
    }
  ]
}