Visão geral
O catálogo nativo é a sua base de produtos dentro da Conversa Labs. É onde você cadastra cada item com nome, descrição, imagens, preço e disponibilidade, organiza tudo em categorias e mantém os dados que serão usados para sincronizar com o WhatsApp e para enviar produtos durante o atendimento.
Tê-lo bem organizado é o primeiro passo: a partir dele você sincroniza com a Meta, envia produtos na conversa e cobra pedidos. Mesmo que você também use plataformas externas, o catálogo nativo é a fonte da verdade dentro da plataforma.
Pré-requisitos
- Módulo de Catálogo & Comércio habilitado para sua conta e perfil de acesso.
- Permissão para gerenciar o catálogo (cadastrar/editar produtos e categorias).
- Imagens dos produtos em um formato comum (por exemplo, JPG ou PNG) e acessíveis.
Passo a passo
- Abra a área de Catálogo da plataforma.
- Crie suas categorias para agrupar produtos (por exemplo, "Bebidas", "Serviços", "Cursos").
- Cadastre um produto: informe nome, descrição, categoria e a primeira variação.
- Em cada variação, defina nome, SKU, preço e opções como
Cor: AzuleTamanho: M. - Use as setas para ordenar as variações e escolha exatamente uma como padrão.
- Adicione uma ou mais imagens ao produto. Depois, você pode vincular uma imagem do produto a cada variação; variações sem imagem usam a imagem principal.
- Defina disponibilidade e estoque quando necessário, salve e repita para os demais produtos.
Configurações & opções
- Produto: nome, descrição, preço, categoria, disponibilidade, imagens e identificadores (como SKU e link externo).
- Categorias: agrupamento dos produtos para facilitar a busca e a montagem de listas.
- Imagens: uma ou mais por produto; a primeira costuma ser usada como destaque.
- Variações: cada combinação vendável tem nome, opções, posição, preço, estoque e imagem opcional. A variação padrão é a escolha inicial nas listas e nos envios.
- Arquivar uma variação: o formulário de edição só descarta variações que ainda não foram salvas. Arquive uma variação salva no detalhe do produto, após a confirmação, e escolha antes outra variação padrão. O registro arquivado e seu histórico de pedidos e pagamentos são preservados.
- Imagem da variação: só pode ser escolhida na galeria do mesmo produto. Ao excluí-la, a variação volta com segurança para a imagem principal do produto.
- Preço: sempre em unidades maiores da moeda (veja a seção de dicas).
- Baixa automática de estoque: quando uma venda ao vivo fica paga, a quantidade de cada variação com controle de estoque é baixada uma única vez. A cobrança e o pedido da mesma venda compartilham a mesma identidade, portanto webhooks repetidos ou os dois eventos não baixam em dobro. O saldo para em zero; variações sem controle de estoque não são alteradas. Importações e adoções históricas também não alteram o saldo atual. O estoque rastreado usa unidades inteiras: uma linha fracionária falha de modo seguro, sem arredondar nem baixar parcialmente a venda, e fica visível no Histórico. Quantidades fracionárias de variações sem controle de estoque não alteram o saldo.
- Relatórios: a visão de relatórios distingue o orçamento dos itens de negócios do valor realizado nos itens de pedidos pagos. As duas métricas não são somadas e podem divergir quando há descontos, frete ou pedidos ainda não liquidados.
Casos de uso
- Cardápio de um restaurante ou lanchonete com categorias e fotos.
- Catálogo de serviços (consultas, planos, pacotes) com preço por item.
- Lista de produtos físicos de uma loja que vende por WhatsApp.
- Catálogo de infoprodutos ou cursos para enviar diretamente ao cliente.
Dicas, limites e boas práticas
- Preço em unidades maiores: digite
4,97para indicar R$4,97. A plataforma não divide por 100 — o valor que você cadastra é o valor exibido e cobrado. - O total de um pedido é a soma de
preço × quantidadede cada item — também sem divisão por 100. - Use imagens nítidas e acessíveis publicamente: a sincronização com o WhatsApp precisa conseguir baixá-las. Imagens hospedadas em endereços que ficam fora do ar não serão importadas.
- Mantenha nomes e descrições claros — eles aparecem para o cliente quando você envia o produto.
- No relatório, trate Orçado como a proposta registrada no negócio e Realizado como itens de pedidos pagos. Um item sem pedido pago não entra no realizado.
Solução de problemas
- Preço aparecendo errado (ex.: R$0,05 em vez de R$4,97): confirme que digitou o valor em unidades maiores; não multiplique nem divida por 100.
- Imagem não aparece: verifique se o arquivo é válido e se o endereço da imagem está acessível.
- Uma variação não pode ser arquivada ou excluída: escolha primeiro outra variação ativa como padrão.
- A imagem errada aparece na variação: edite o produto e escolha uma imagem da galeria para essa variação, ou selecione o uso da imagem principal.
- Produto não some das listas: marque-o como indisponível em vez de manter visível quando não estiver à venda.
- Uma venda paga não baixou o estoque: confirme que a linha da venda aponta para uma variação com controle de estoque ativo. Registros apenas importados ou adotados como histórico são mantidos para consulta e, de propósito, não reescrevem o saldo atual.
- A baixa aparece como falha depois dos retries automáticos: um administrador deve abrir Catálogo → Importar & Sincronizar → Histórico, localizar a execução Baixa automática de estoque, abrir o detalhe e clicar em Tentar baixa novamente. A execução identifica a cobrança ou o pedido e mostra apenas uma referência técnica sanitizada, sem credenciais ou payload do gateway. O retry é seguro: o recibo único da venda impede uma segunda baixa se a tentativa anterior tiver concluído de forma ambígua. Se a execução estiver Pendente ou Processando, aguarde o worker em vez de clicar novamente. Se o motivo indicar quantidade fracionária, corrija a linha de origem para unidades inteiras — ou desative o controle somente quando a variação for legitimamente fracionável — antes de tentar novamente; a plataforma nunca arredonda essa quantidade.