WhatsApp: catálogo na Meta

Sincronização do catálogo de produtos de cada seller com o catálogo da Meta exibido dentro do WhatsApp.

Esta seção cuida de mostrar o catálogo da loja dentro do WhatsApp. A plataforma espelha os produtos ativos de um seller no catálogo da Meta, e o WhatsApp passa a exibir a vitrine ao cliente. Há duas telas de trabalho: ligar/desligar a sincronização e acompanhar o que foi enviado.

Como funciona

Ter o catálogo na Meta
Crie o catálogo no Commerce Manager e anote o id. O número de WhatsApp do seller precisa estar conectado (a plataforma usa o token dele).
Ligar
POST /catalog-sync/enable com vendor_id e meta_catalog_id. A Meta valida o id.
Enviar
POST /catalog-sync/full. Repita enquanto pushed for maior que 0 em catálogos grandes.
Auditar e corrigir
GET /catalog-sync/products?status=failed mostra o motivo; corrija o produto e chame .../retry.

Depois de ligada, a plataforma sincroniza sozinha de hora em hora apenas o que mudou.

Conceitos-chave

Catálogo da Meta e retailer_id

O catálogo da Meta identifica cada item pelo retailer_id. A plataforma usa sempre v2- seguido do UUID do produto, um valor estável que a distingue de itens que o lojista tenha cadastrado à mão na Meta.

Quais produtos entram

Só produtos ativos e visíveis para o WhatsApp. Quando um produto deixa de ser elegível (inativado ou excluído), a sincronização o apaga da Meta e o marca removed no espelho (remove_failed se a Meta recusar a exclusão).

Limites da Meta

A Meta limita as operações no catálogo (cerca de 1000 por hora). A plataforma se limita a 200 produtos por ciclo e para ao receber um limite de taxa; o que sobra fica pending e segue no próximo ciclo.

Seller e token

A sincronização usa o token do número de WhatsApp do seller. Sem número conectado para o seller, ligar a sincronização falha.

Endpoints

Método	Caminho	Para que serve	Página
`GET`	`/api/v1/admin/whatsapp/catalog-sync`	Mostra se a sincronização do catálogo está ligada para o seller	Estado da sincronização
`POST`	`/api/v1/admin/whatsapp/catalog-sync/enable`	Liga a sincronização e informa o catálogo da Meta	Estado da sincronização
`POST`	`/api/v1/admin/whatsapp/catalog-sync/disable`	Desliga a sincronização do catálogo do seller	Estado da sincronização
`POST`	`/api/v1/admin/whatsapp/catalog-sync/full`	Envia à Meta os produtos ativos do seller que mudaram	Produtos sincronizados
`GET`	`/api/v1/admin/whatsapp/catalog-sync/products`	Lista os produtos enviados e o resultado de cada envio	Produtos sincronizados
`POST`	`/api/v1/admin/whatsapp/catalog-sync/products/{id}/retry`	Reenvia um produto à Meta	Produtos sincronizados

Erros comuns

Chamar sem vendor_id na conta de administrador da loja: 400 vendor_id required.
Ligar para um seller sem número de WhatsApp conectado.
Achar que uma única chamada de sincronização completa envia catálogos grandes: o limite é 200 por chamada.
Passar o id da linha do espelho em /retry: o {id} é o UUID do produto.
Esperar que desligar remova os produtos da Meta.

Próximos passos

Estado da sincronização

Ligar, desligar e consultar.

Produtos sincronizados

Enviar, auditar e reenviar.