Visão geral
Com o catálogo pronto e sincronizado, você pode enviar produtos ao cliente dentro da conversa e receber o pedido dele de volta como um card estruturado. Em vez de descrever preços em texto, você envia o item certo; quando o cliente monta um carrinho no WhatsApp, o pedido chega organizado, com itens, quantidades e total — e com atalhos para gerar a cobrança.
São três formas de mostrar produtos: produto único, lista de produtos e abrir o catálogo. E uma forma de receber: o pedido (order) que vira card na conversa.
Pré-requisitos
- Catálogo nativo com produtos e, para recursos nativos do WhatsApp, a sincronização com o WhatsApp Business Catalog ativa.
- Uma Caixa de Entrada de WhatsApp (Cloud API) — os formatos nativos de produto, lista e pedido funcionam na API Cloud.
- A vitrine ativa no número, na aba Catálogo & Vitrine da caixa de entrada. A Meta cria todo número com a vitrine desligada: sem ativá-la, o envio de produto falha com o erro #131008. Veja Catálogo & Vitrine na caixa de entrada do WhatsApp.
- Para o envio interativo de um produto pelo WhatsApp Web, basta a caixa Web ativa; o carrinho e o pedido nativos continuam exclusivos da Cloud API.
- Para cobrar o pedido: o módulo de Pagamentos configurado.
Passo a passo
- Abra a conversa com o cliente.
- No campo de envio, escolha enviar produto e selecione um item (produto único) ou monte uma lista de produtos. Quando houver mais de uma variação, escolha a correta; quando a variação tiver preços em mais de uma moeda, escolha também a moeda. Você pode ainda abrir o catálogo para o cliente navegar.
- Na Cloud API, o cliente pode adicionar os itens ao carrinho. No WhatsApp Web, ele usa Tenho interesse ou Ver produto no card interativo.
- Quando o cliente finaliza o carrinho, o pedido chega na conversa como um card de pedido com os itens, as quantidades e o total.
- No card do pedido, use Criar cobrança ou Criar assinatura para faturar exatamente o que foi pedido — o valor já vem preenchido com o total do pedido.
- Acompanhe o pagamento pelo módulo de Pagamentos; quando confirmado, o cliente recebe a confirmação.
Configurações & opções
- Produto único: envia um item específico do catálogo.
- Variação e moeda: o card usa a variação escolhida e o preço cadastrado para a moeda escolhida; a seleção não volta silenciosamente para a primeira variação.
- Lista de produtos: envia vários itens agrupados em uma mensagem, preservando a variação e a moeda escolhidas em cada produto.
- Abrir catálogo: convida o cliente a navegar pelo catálogo no WhatsApp.
- Card de pedido: mostra itens, quantidades, total e observações do cliente.
- Atalhos do pedido: Criar cobrança (pagamento único) e Criar assinatura (recorrente), já com o valor do pedido preenchido.
- Produto referenciado: quando o cliente responde citando um produto, um indicador do item citado aparece junto da mensagem.
Casos de uso
- Cliente pergunta por um item específico — você envia o produto único com foto e preço.
- Atendimento consultivo — você envia uma lista com as melhores opções para o cliente escolher.
- Cliente monta o carrinho sozinho — o pedido chega pronto e você fatura em segundos.
- Venda recorrente (assinatura/plano) — o pedido vira uma assinatura com o valor combinado.
Dicas, limites e boas práticas
- Cobre o que foi pedido: o card usa o total do pedido combinado com o cliente; o valor não é recalculado a partir dos preços atuais do catálogo. Faturar o pedido respeita exatamente o que o cliente montou.
- Valores em unidades maiores: o total é a soma de
preço × quantidade(4,97 = R$4,97), sem divisão por 100. - API Cloud: o formato nativo é usado somente quando a variação escolhida está publicada com
retailer_idpróprio e usa a moeda publicada. Caso contrário, a plataforma envia o card enriquecido com a variação e o preço exatos, sem trocar o item. - WhatsApp Web: um produto único segue como card interativo, com o botão Tenho interesse e, quando o cadastro tem link público, Ver produto. Esse envio não depende de licença adicional.
- Confira o pedido antes de cobrar: itens, quantidades e total.
Solução de problemas
- O envio falhou com o erro #131008: a vitrine não está utilizável no número — o catálogo não está vinculado à Conta do WhatsApp Business ou a vitrine está desligada. Abra a aba Catálogo & Vitrine da caixa de entrada, selecione o catálogo e clique em Ativar vitrine neste número. Detalhes em Catálogo & Vitrine na caixa de entrada do WhatsApp.
- O cliente não recebeu o produto/lista nativos: confirme que a caixa é WhatsApp Cloud API e que o
catálogo está sincronizado. Confira também se a variação escolhida tem
retailer_idpróprio; sem ele, receber o card enriquecido é o fallback esperado. - O pedido não virou card: verifique se o pedido veio do carrinho do WhatsApp; pedidos de fora do WhatsApp seguem pelo ciclo de vida de e-commerce.
- Valor errado ao cobrar: o card preenche o total do pedido; se editar manualmente, lembre-se das unidades maiores (não divida por 100).