Visão geral
A sincronização conecta o seu catálogo nativo ao WhatsApp Business Catalog da Meta. Depois de vincular, os produtos passam a existir nos dois lugares e podem ser mantidos em duas vias: o que você cadastra na plataforma é enviado para a Meta, e o que existe no catálogo da Meta pode ser importado para a plataforma.
Isso é o que torna possível enviar produtos nativos no WhatsApp, abrir o catálogo dentro da conversa e receber pedidos do carrinho do cliente — tudo a partir de um catálogo único e atualizado.
Pré-requisitos
- Uma Caixa de Entrada de WhatsApp (Cloud API) conectada e funcionando.
- Um catálogo configurado na sua conta comercial da Meta (Business / Commerce Manager).
- Módulo de Catálogo & Comércio habilitado e permissão para gerenciar fontes de sincronização.
- Catálogo nativo com produtos cadastrados (recomendado antes da primeira sincronização).
Passo a passo
- Na área de Catálogo, abra a configuração de fontes de sincronização.
- Crie uma fonte do tipo WhatsApp Business Catalog (Meta) e selecione o catálogo da Meta a vincular.
- Vincule a fonte à caixa de entrada de WhatsApp Cloud correspondente — a credencial de acesso é reaproveitada automaticamente dessa caixa, sem precisar informar um token à parte.
- Defina o intervalo de sincronização (de quanto em quanto tempo a plataforma confere o catálogo da Meta).
- Execute a primeira sincronização e confira os produtos importados/atualizados.
- A partir daí, alterações fluem nas duas vias conforme o intervalo configurado, e você pode forçar uma sincronização manual quando quiser.
Configurações & opções
- Catálogo da Meta vinculado: qual catálogo da conta comercial está conectado à fonte.
- Caixa de entrada: a inbox de WhatsApp Cloud usada para a credencial e para enviar produtos.
- Intervalo de sincronização: frequência das sincronizações automáticas.
- Sincronização manual: botão para rodar a sincronização na hora.
- Duas vias: produtos cadastrados na plataforma são publicados na Meta; produtos da Meta são importados para a plataforma, casando os identificadores de cada lado.
Publicar com segurança e revisar a validação
Cada variação vendável é publicada como um item próprio no catálogo da Meta. As variações do mesmo produto ficam agrupadas, mas têm identificadores independentes; assim, preço e disponibilidade não se misturam entre tamanhos, cores ou opções.
Antes de enviar, a plataforma bloqueia a variação e mostra o motivo quando faltar algum requisito da Meta: nome, descrição, marca, link público HTTPS, preço, moeda ou imagem pública HTTPS de ao menos 500 × 500 pixels. Complete os campos no produto e tente novamente — um bloqueio local não é tratado como produto sincronizado.
Depois que a Meta aceita o lote, ela ainda valida o conteúdo de forma assíncrona. Abra o produto e veja o status em cada variação: Aguardando validação, Validado, Rejeitado, Envio bloqueado ou Validação inconclusiva. Um item só deve ser considerado disponível na Meta depois de Validado; a mensagem de rejeição aponta o campo que precisa ser corrigido. Validação inconclusiva significa que a Meta respondeu sem um resultado reconhecido. Estados transitórios, como “iniciado”, são consultados novamente por até quatro minutos; se aparecer tempo de validação esgotado, reenvie o produto e acompanhe o histórico de execuções.
Ao importar de volta, os itens do mesmo grupo voltam para o mesmo produto, cada um como a sua variação. A plataforma reconhece o produto pelo grupo e pelo identificador de cada variação, então uma reimportação atualiza o produto existente em vez de criar uma cópia.
Reconciliação assistida de itens remotos
Ao editar uma fonte Meta de saída ou de duas vias, a seção Reconciliação assistida do catálogo Meta
lista itens remotos que não têm uma variação local com o mesmo retailer_id. Ela é apenas uma revisão:
- Atualize a lista e confira nome e identificador de cada possível órfão.
- Marque somente os itens que realmente devem sair do catálogo Meta.
- Clique em Solicitar remoção selecionada e confirme no diálogo.
Nada é removido ao abrir ou atualizar a lista. A plataforma relê o catálogo no momento da solicitação, recusa uma seleção que mudou e também recusa um lote acima do limite de segurança de 10% do catálogo remoto. Mesmo após aceitar a solicitação, a Meta valida o lote: o resultado exibido é “enviado para validação”, não “removido”, até a confirmação remota.
Casos de uso
- Loja que já tem catálogo na Meta e quer trazê-lo para a plataforma para atender e cobrar.
- Operação que prefere cadastrar produtos na plataforma e publicá-los automaticamente no WhatsApp.
- Equipe que mantém um catálogo único e quer evitar atualizar preços em dois lugares.
Dicas, limites e boas práticas
- Credencial automática: ao vincular a fonte à caixa de WhatsApp Cloud, a plataforma usa a credencial dessa inbox — você não precisa cadastrar um token só para o catálogo.
- Imagens precisam estar acessíveis: a sincronização baixa as imagens dos produtos. Se a imagem original estiver hospedada em um endereço que saiu do ar, ela não será importada. Mantenha as imagens em um local público, estável, HTTPS e com pelo menos 500 × 500 pixels para publicação.
- Valores em unidades maiores: preços continuam em unidades maiores (4,97 = R$4,97) dos dois lados.
- Faça a primeira sincronização fora do horário de pico para revisar com calma o resultado.
Solução de problemas
- Produtos importados sem imagem: a imagem original pode estar inacessível; garanta um endereço público e refaça a sincronização (cada execução tenta baixar as imagens novamente).
- Nada sincroniza: confirme que a fonte está vinculada a uma caixa de WhatsApp Cloud válida e que o catálogo da Meta selecionado é o correto.
- Mudança não apareceu do outro lado: aguarde o intervalo de sincronização ou rode uma sincronização manual. Para publicação, abra a variação e confira se a validação da Meta está aguardando, bloqueada ou rejeitada; uma resposta de lote aceita ainda não é confirmação de catálogo.
- Tempo de validação esgotado: a Meta não entregou um resultado final durante as tentativas automáticas. Reenvie o produto; se o aviso persistir, confira o item no Commerce Manager da Meta.
- O item não aparece na reconciliação: itens remotos sem
retailer_idnão são oferecidos para remoção automática por segurança. Localize-os diretamente no Commerce Manager da Meta.