Visão geral
Ter um catálogo criado e sincronizado na Meta não é o mesmo que ter a vitrine ligada no seu número de WhatsApp. São três coisas diferentes, e todas precisam estar em ordem para que um produto possa ser enviado na conversa:
- O catálogo existe na sua conta comercial da Meta e tem itens publicados.
- O catálogo está vinculado à sua Conta do WhatsApp Business (a WABA).
- A vitrine está visível no número — esta é a etapa que costuma passar despercebida, porque a Meta cria o número com a vitrine desligada por padrão.
Quando a etapa 2 ou a 3 está faltando, o catálogo aparece perfeito no gerenciador da Meta, mas o envio de produto na conversa falha — normalmente com o erro #131008.
A aba Catálogo & Vitrine existe para tornar isso visível. Ela fica dentro das configurações da caixa de entrada, lê o estado ao vivo na Meta e mostra, em linhas simples, o que está pronto e o que falta. Um único botão — Ativar vitrine neste número — resolve a etapa 3.
A aba cuida do comércio do número. A sincronização dos produtos (mapeamento, agendamento, histórico) continua no Sync Studio, no módulo de Catálogo.
Pré-requisitos
- Uma Caixa de Entrada de WhatsApp (Cloud API). A aba não aparece em caixas de WhatsApp Web nem em outros canais — a vitrine é um recurso da API Cloud.
- Um catálogo na Meta com itens publicados. Se você ainda não tem, crie e sincronize primeiro pelo Sync Studio.
- Permissão de administrador na caixa de entrada, dentro da plataforma.
- A conexão com a Meta precisa ter permissão sobre o catálogo e sobre a Conta do WhatsApp Business. Sem isso, a leitura funciona parcialmente e a ativação é recusada pela Meta.
Passo a passo
- Abra Configurações → Caixas de Entrada e selecione a caixa de entrada do WhatsApp Cloud API.
- Abra a aba Catálogo & Vitrine.
- Leia o diagnóstico. Cada linha responde uma pergunta objetiva: qual catálogo está selecionado, se ele está vinculado à Conta do WhatsApp Business, se a vitrine está visível no número, se o carrinho está habilitado, quantos itens o catálogo tem e quando foi a última sincronização.
- Se ainda não houver um catálogo selecionado, escolha o catálogo que este número deve usar.
- Se a vitrine estiver desligada, clique em Ativar vitrine neste número e confirme.
- Recarregue o diagnóstico e confirme que o vínculo e a vitrine aparecem como ativos.
- Abra uma conversa e envie um produto para validar de ponta a ponta.
Configurações & opções
- Catálogo selecionado — qual catálogo da Meta este número usa. É a origem dos produtos que você envia na conversa.
- Vínculo com a Conta do WhatsApp Business — indica se o catálogo está associado à WABA. Sem o vínculo, o número não enxerga os produtos, mesmo que eles existam.
- Vitrine visível no número — indica se a vitrine está ligada neste número específico. É o que o botão de ativação altera.
- Carrinho habilitado — indica se o cliente pode montar um carrinho e enviar um pedido. Quando o carrinho está desligado, o cliente ainda vê os produtos, mas não fecha um pedido pelo WhatsApp.
- Itens no catálogo — quantos produtos a Meta enxerga hoje. Um número zerado quase sempre significa que a sincronização não concluiu.
- Última sincronização — quando os produtos foram enviados ao catálogo pela última vez.
- Ativar vitrine neste número — o único botão que escreve na sua conta da Meta. Nada é alterado lá sem esse clique: abrir a aba apenas lê o estado atual.
Casos de uso
- Caixa nova: você acabou de conectar o número, o catálogo já está sincronizado e quer deixar o envio de produtos pronto antes do primeiro atendimento.
- Envio falhando: um agente relata que "não consegue enviar produto". A aba mostra em segundos se o problema é vínculo, vitrine ou catálogo vazio.
- Vários números: cada número tem a própria vitrine. Ao abrir um novo número na mesma conta comercial, você repete apenas a ativação — o catálogo continua o mesmo.
- Auditoria periódica: antes de uma campanha, conferir itens no catálogo e a última sincronização evita anunciar produto que a Meta não enxerga.
Dicas, limites e boas práticas
- A vitrine nasce desligada. É um comportamento da Meta, não uma falha da plataforma. Todo número novo precisa da ativação uma vez.
- A ativação é explícita. A plataforma nunca liga a vitrine sozinha, nem durante a sincronização. A escrita acontece somente quando você clica no botão.
- A leitura é ao vivo. Os valores vêm da Meta no momento em que a aba abre, não de um cache. Se alguém alterar algo no gerenciador da Meta, recarregar a aba já mostra o novo estado.
- Vitrine é por número; catálogo é por conta comercial. O mesmo catálogo pode servir vários números, mas cada número precisa da própria ativação.
- Sincronizar não ativa. Uma sincronização bem-sucedida no Sync Studio publica produtos, mas não liga a vitrine. São etapas independentes.
- Carrinho e pedidos: para receber pedidos estruturados na conversa, o carrinho precisa estar habilitado além da vitrine.
Solução de problemas
- Erro #131008 ao enviar um produto — a Meta indica que falta um parâmetro obrigatório para a mensagem de produto. Na prática, o número não tem uma vitrine utilizável: o catálogo não está vinculado à Conta do WhatsApp Business, ou a vitrine está desligada no número. Correção: abra a aba Catálogo & Vitrine, selecione o catálogo e clique em Ativar vitrine neste número.
- Erro #131009 ao enviar um produto — a Meta indica que um valor enviado é inválido. Em geral o produto informado não está no catálogo vinculado: o item não foi sincronizado, foi arquivado, ou pertence a outro catálogo. Correção: confira no diagnóstico se o catálogo selecionado é o mesmo onde o produto foi publicado, verifique a contagem de itens e rode a sincronização no Sync Studio.
- A aba não aparece — a caixa de entrada não é do WhatsApp Cloud API. Vitrine e catálogo nativo são recursos da API Cloud.
- A ativação é recusada — a conexão com a Meta não tem permissão suficiente sobre o catálogo ou sobre a Conta do WhatsApp Business. Revise as permissões no gerenciador da Meta e tente novamente.
- Itens no catálogo = 0 — a sincronização não concluiu ou os produtos foram rejeitados pela Meta. Confira o histórico de sincronização no Sync Studio.
- Vitrine ativa, mas o cliente não fecha o pedido — provavelmente o carrinho está desabilitado.