## 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

1. Na área de **Catálogo**, abra a configuração de **fontes de sincronização**.
2. Crie uma fonte do tipo **WhatsApp Business Catalog (Meta)** e selecione o catálogo da Meta a
   vincular.
3. Vincule a fonte à **caixa de entrada de WhatsApp Cloud** correspondente — a credencial de acesso é
   reaproveitada automaticamente dessa caixa, sem precisar informar um token à parte.
4. Defina o **intervalo de sincronização** (de quanto em quanto tempo a plataforma confere o catálogo
   da Meta).
5. Execute a primeira sincronização e confira os produtos importados/atualizados.
6. 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:

1. Atualize a lista e confira nome e identificador de cada possível órfão.
2. Marque somente os itens que realmente devem sair do catálogo Meta.
3. 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

- **Imagem recusada na publicação**: quando a validação recusa um arquivo de forma permanente, a
  publicação tenta a próxima imagem do produto. Se todas forem recusadas, o erro permanece e o produto
  não é enviado sem imagem. A indisponibilidade temporária de processamento também permanece como
  erro; tente novamente após sua resolução. Os limites de segurança das imagens continuam valendo.
- **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_id` não são oferecidos para
  remoção automática por segurança. Localize-os diretamente no Commerce Manager da Meta.

## Veja também

- [Catálogo nativo: produtos, categorias, imagens e preços](/hc/ajuda/articles/catalog-commerce-catalogo-nativo-pt-br)
- [Enviar produto e receber pedidos na conversa](/hc/ajuda/articles/catalog-commerce-enviar-produto-pedido-na-conversa-pt-br)
- [Visão geral de Catálogo & Comércio](/hc/ajuda/articles/catalog-commerce-overview-pt-br)