## 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](/hc/ajuda/articles/catalog-commerce-catalogo-vitrine-whatsapp-pt-br).
- Para o envio interativo de um produto pelo **WhatsApp Web**, basta a caixa Web ativa; o envio de
  carrinho e de lista nativos continua exclusivo da Cloud API. O pedido que o cliente envia pelo
  carrinho também chega no WhatsApp Web e vira card de pedido quando a plataforma consegue ler os itens
  pelo número conectado.
- Para cobrar o pedido: o módulo de **Pagamentos** configurado.

## Passo a passo

1. Abra a conversa com o cliente.
2. 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.
3. Na Cloud API, o cliente pode adicionar os itens ao carrinho. No WhatsApp Web, ele usa **Tenho
   interesse** ou **Ver produto** no card interativo.
4. Quando o cliente finaliza o carrinho, o **pedido** chega na conversa como um **card de pedido** com
   os itens, as quantidades e o **total**.
5. 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.
6. 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_id` pró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.
- **Nome e foto dos produtos**: a plataforma procura o produto nesta ordem: o catálogo nativo da
  plataforma; o que ela já aprendeu sobre o produto em pedidos anteriores; o próprio WhatsApp, pelo
  número conectado; e o catálogo da Meta, quando o token da caixa tem permissão de
  leitura. O nome e a foto podem aparecer alguns segundos depois do card, sem recarregar a página. O
  preço e a quantidade sempre vêm do pedido do cliente.
- **Caixa híbrida (Coexistência + WhatsApp Web no mesmo número)**: o card continua sendo um só. A cópia
  que chega pelo WhatsApp Web só completa o nome e a foto do produto no card da Coexistência; ela não
  cria uma segunda mensagem.

## 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](/hc/ajuda/articles/catalog-commerce-catalogo-vitrine-whatsapp-pt-br).
- **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_id` pró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).
- **O card mostra um código no lugar do nome do produto**: o código é o identificador do produto no
  catálogo do WhatsApp. Ele aparece quando o produto não está no catálogo nativo da plataforma e nenhuma
  outra fonte informou o nome, por exemplo quando o catálogo do número é o do aplicativo WhatsApp
  Business e o token da Cloud API não tem permissão para lê-lo. Em uma caixa híbrida, o nome e a foto
  são preenchidos automaticamente pela cópia do WhatsApp Web. Para resolver de forma permanente,
  sincronize esse catálogo com o catálogo nativo. A plataforma nunca inventa um nome.
- **O pedido do WhatsApp Web mostra só o total, sem os itens**: a plataforma não conseguiu ler os itens
  do pedido pelo número conectado, por exemplo porque o WhatsApp Web estava desconectado naquele
  momento, ou os itens lidos não conferem com a quantidade e o total do pedido. Nesse caso a plataforma
  não monta um card parcial, que cobraria menos do que o cliente pediu. O card mostra o que a mensagem
  trouxe; confirme os itens com o cliente antes de cobrar.

## Veja também

- [Catálogo & Vitrine na caixa de entrada do WhatsApp](/hc/ajuda/articles/catalog-commerce-catalogo-vitrine-whatsapp-pt-br)
- [Catálogo nativo: produtos, categorias, imagens e preços](/hc/ajuda/articles/catalog-commerce-catalogo-nativo-pt-br)
- [Sincronização e WhatsApp Business Catalog](/hc/ajuda/articles/catalog-commerce-sync-whatsapp-business-catalog-pt-br)
- [Ciclo de vida de e-commerce](/hc/ajuda/articles/catalog-commerce-commerce-lifecycle-pt-br)

### Verificações de disponibilidade e entrega

Antes de criar a mensagem de saída, o catálogo verifica a disponibilidade e os preços representados no card. Uma variante padrão esgotada é substituída por uma disponível; uma variante indisponível selecionada explicitamente é recusada. Produtos sem variantes disponíveis não são enviados. Uma variante disponível gera um card, mesmo que o produto tenha várias fotos. Variantes sem controle de estoque continuam disponíveis.

As descrições são enviadas sem marcação HTML. Imagens do WhatsApp são preparadas em formato compatível; se a preparação falhar, substitua a imagem e tente novamente. Corrija preços inválidos no catálogo. Uma solicitação bem-sucedida indica que a mensagem entrou na fila; confira o status de entrega na conversa. Envios automáticos preservam como autor o bot autenticado da caixa de entrada.

### Histórico de pedidos e citações

Cartões recebidos pelo WhatsApp Web mostram o produto, o total e as atualizações que a mensagem realmente contém. Uma atualização de pedido **concluído** não confirma pagamento: confira o pagamento no módulo ou no provedor correspondente. A citação de um produto preserva seu nome e preço quando disponíveis e permite voltar à mensagem original.

A apresentação também se aplica às mensagens antigas após recarregar a conversa, desde que os dados do cartão tenham sido preservados. Recarregar não reenvia o pedido nem executa uma cobrança. Quando os dados de origem não chegaram, a plataforma não inventa itens, valores ou confirmação de pagamento.