API atual/Referência completa/WhatsApp: resultados

Catálogo da Meta

Mostra se o catálogo de produtos da loja está sincronizado com a Meta e o estado de cada item.

Para enviar cartões de produto nativos no WhatsApp, a Meta precisa de um catálogo com os produtos da loja. A plataforma mantém essa cópia em dia: cada produto vira um item que passa por pendente, sincronizado, erro ou removido. Estas duas rotas só leem esse estado; vincular o catálogo e forçar nova sincronização é tarefa do administrador.

Status do catálogo

GET/api/v1/vendor/whatsapp-confluence/catalog/statusSeller

Resume a sincronização do catálogo

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário seller (lojista). Veja Tokens.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/whatsapp-confluence/catalog/status" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Status

json

{
  "enabled": true,
  "meta_catalog_id": "1234567890123456",
  "last_full_sync_at": "2026-10-10T03:00:00Z",
  "items_pending": 2,
  "items_synced": 318,
  "items_error": 1,
  "items_deleted": 4
}

Campos da resposta

enabledboolean

true quando a sincronização está ligada. false e zeros quando a loja não vinculou catálogo.

meta_catalog_idstring

Id do catálogo na Meta. Vazio se não vinculado.

last_full_sync_atstring

Última sincronização completa (RFC 3339). Omitido se nunca houve.

last_errorstring

Último erro de sincronização. Omitido se não há.

items_pendinginteger

Itens aguardando envio.

items_syncedinteger

Itens sincronizados.

items_errorinteger

Itens com erro.

items_deletedinteger

Itens removidos do catálogo.

Erros

Status	Quando	Corpo de exemplo
401	Sem token ou token inválido.	`{"error":"missing authorization header"}`
403	O usuário não é um seller, ou o seller ainda está em análise de cadastro.	`{"error":"vendor_pending_review"}`
500	Falha interna ao calcular.	`{"error":"..."}`

Itens do catálogo

GET/api/v1/vendor/whatsapp-confluence/catalog/itemsSeller

Lista os itens e o estado de sincronização

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário seller (lojista). Veja Tokens.

Parâmetros de consulta

statusstring

PSED

Só itens neste estado. Omitido traz todos. Valor desconhecido devolve lista vazia.

pageintegerpadrão: 1

Página, a partir de 1.

per_pageintegerpadrão: 50

1 a 200. Fora disso vale 50.

Exemplo de requisição

bash

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

Resposta

200Itens

json

{
  "items": [
    {
      "product_id": "5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c",
      "retailer_id": "wacoex-5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c",
      "sync_status": "E",
      "last_error": "Imagem inválida",
      "last_synced_at": "2026-10-10T03:00:00Z"
    }
  ]
}

Campos da resposta

itemsarray

Itens, do mais novo para o mais antigo.

product_iduuid

Id do produto na plataforma.

retailer_idstring

Id do item na Meta (wacoex- mais o id do produto).

sync_statusstring

PSED

P pendente, S sincronizado, E erro, D removido.

last_errorstring

Motivo do último erro. Vazio se não há.

last_synced_atstring

Última sincronização do item (RFC 3339). Omitido se nunca.

Erros

Status	Quando	Corpo de exemplo
401	Sem token ou token inválido.	`{"error":"missing authorization header"}`
403	O usuário não é um seller, ou o seller ainda está em análise de cadastro.	`{"error":"vendor_pending_review"}`
500	Falha interna ao calcular.	`{"error":"..."}`

Veja também

Catálogo da Meta

Mostra se o catálogo de produtos da loja está sincronizado com a Meta e o estado de cada item.

Status do catálogo

GET/api/v1/vendor/whatsapp-confluence/catalog/statusSeller

Resume a sincronização do catálogo

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário seller (lojista). Veja Tokens.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/whatsapp-confluence/catalog/status" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Status

json

{
  "enabled": true,
  "meta_catalog_id": "1234567890123456",
  "last_full_sync_at": "2026-10-10T03:00:00Z",
  "items_pending": 2,
  "items_synced": 318,
  "items_error": 1,
  "items_deleted": 4
}

Campos da resposta

enabledboolean

true quando a sincronização está ligada. false e zeros quando a loja não vinculou catálogo.

meta_catalog_idstring

Id do catálogo na Meta. Vazio se não vinculado.

last_full_sync_atstring

Última sincronização completa (RFC 3339). Omitido se nunca houve.

last_errorstring

Último erro de sincronização. Omitido se não há.

items_pendinginteger

Itens aguardando envio.

items_syncedinteger

Itens sincronizados.

items_errorinteger

Itens com erro.

items_deletedinteger

Itens removidos do catálogo.

Erros

Status	Quando	Corpo de exemplo
401	Sem token ou token inválido.	`{"error":"missing authorization header"}`
403	O usuário não é um seller, ou o seller ainda está em análise de cadastro.	`{"error":"vendor_pending_review"}`
500	Falha interna ao calcular.	`{"error":"..."}`

Itens do catálogo

GET/api/v1/vendor/whatsapp-confluence/catalog/itemsSeller

Lista os itens e o estado de sincronização

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um usuário seller (lojista). Veja Tokens.

Parâmetros de consulta

statusstring

PSED

Só itens neste estado. Omitido traz todos. Valor desconhecido devolve lista vazia.

pageintegerpadrão: 1

Página, a partir de 1.

per_pageintegerpadrão: 50

1 a 200. Fora disso vale 50.

Exemplo de requisição

bash

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

Resposta

200Itens

json

{
  "items": [
    {
      "product_id": "5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c",
      "retailer_id": "wacoex-5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c",
      "sync_status": "E",
      "last_error": "Imagem inválida",
      "last_synced_at": "2026-10-10T03:00:00Z"
    }
  ]
}

Campos da resposta

itemsarray

Itens, do mais novo para o mais antigo.

product_iduuid

Id do produto na plataforma.

retailer_idstring

Id do item na Meta (wacoex- mais o id do produto).

sync_statusstring

PSED

P pendente, S sincronizado, E erro, D removido.

last_errorstring

Motivo do último erro. Vazio se não há.

last_synced_atstring

Última sincronização do item (RFC 3339). Omitido se nunca.

Erros

Status	Quando	Corpo de exemplo
401	Sem token ou token inválido.	`{"error":"missing authorization header"}`
403	O usuário não é um seller, ou o seller ainda está em análise de cadastro.	`{"error":"vendor_pending_review"}`
500	Falha interna ao calcular.	`{"error":"..."}`