Catálogo de produtos do Meta Commerce

Nível: Intermediário Tempo de leitura: 8 min Plano necessário: Pro ou Ultra

O que é

O Meta Commerce Manager é onde a Meta hospeda catálogos de produto que podem ser usados em anúncios do Facebook/Instagram e em mensagens do WhatsApp Business. Quando você tem um catálogo configurado, o WhatsApp permite enviar cards de produto (com foto, título, preço, descrição) que o cliente pode tocar pra ver detalhes sem sair do app.

A Wevi se conecta a esse catálogo. Você não precisa subir produtos pra cá: o catálogo continua sendo gerenciado no Meta. A Wevi só precisa saber o catalog_id da sua loja pra mandar produtos certos pros clientes.

Quando vale configurar

Se o seu cliente vende online (e-commerce, restaurante com cardápio, imobiliária com imóveis, etc), o catálogo Meta acelera muito o atendimento. Em vez de mandar foto + descrição + link em texto, manda o card oficial e o cliente já tem tudo dentro do WhatsApp.

Não vale se você só responde dúvidas e não tem produtos pra apresentar.

Passo 1: criar (ou conectar) o catálogo no Meta

Acesse business.facebook.com com a conta Meta Business que dona o seu WhatsApp Business Account.
Vá em Catálogos (ou Commerce Manager → Catálogos).
Se não tem catálogo, clique em Criar catálogo e siga o wizard. Escolha E-commerce como tipo.
Faça upload dos produtos. Você pode:
- Subir um CSV no formato do Meta.
- Conectar uma plataforma (Shopify, WooCommerce, etc).
- Adicionar manualmente um a um.

Cada produto precisa ter um identificador único no seu sistema. No Meta isso chama retailer_id. Guarde esse ID, vai ser ele que você usa pra enviar produto via Wevi.

Passo 2: vincular o catálogo ao WhatsApp Business Account

No Commerce Manager, abra o catálogo.
Vá em Configurações → Canais de Vendas (ou Settings → Sales Channels).
Adicione o WhatsApp Business Account da sua conexão.

Sem essa vinculação, mesmo passando o catalog_id correto na Wevi, o envio falha.

Passo 3: copiar o `catalog_id`

No Commerce Manager, com o catálogo aberto, o ID aparece na URL:

https://business.facebook.com/commerce/catalogs/1234567890123456/...
                                            └────── catalog_id ──────┘

Copie esse número. Tem 15 a 16 dígitos.

Passo 4: colar na Wevi

Acesse app.wevi.chat.
Configurações → Conectores.
Role até WhatsApp e localize a conexão.
Na linha da conexão, ao lado de Catálogo, clique em configurar.
Cole o catalog_id e clique em Salvar.

Pronto. A partir daí, o WhatsApp do cliente já consegue receber cards de produto da Wevi.

Passo 5: enviar produto

Hoje o envio de produtos é via API (integrações externas tipo CRM/automação). Veja:

POST /send-product — 1 produto.
POST /send-product-list — até 30 produtos em 10 seções.

Você precisa do product_retailer_id de cada produto. Pega no Meta (mesmo lugar onde subiu o catálogo) ou no seu sistema (Shopify, ERP).

Exemplo via curl:

curl -X POST https://api.wevi.chat/functions/v1/send-product \
  -H "Authorization: Bearer wevi_<sua-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "<sua-conexao>",
    "to": "+5511999999999",
    "product_retailer_id": "SKU-1234",
    "body": "Esse modelo combina com o que você procurava 😉"
  }'

O UI builder na conversa (botão + do atendente) ainda não cobre produtos. Use a API por enquanto, ou contate o suporte se precisar dessa UI.

Erros comuns

Erro	O que fazer
`catalog_not_configured`	A conexão WhatsApp da sua org está sem catalog_id. Volte ao Passo 4.
Mensagem enviada mas o cliente recebe "Produto indisponível"	O `product_retailer_id` não existe no catálogo ou o catálogo não está vinculado ao WhatsApp Business Account (Passo 2).
Card sem foto/preço	Produto subiu sem todos os campos obrigatórios. Volte ao Commerce Manager e complete.

Resumo

Onde	O que fazer
Meta Commerce Manager	Criar catálogo, subir produtos, anotar `catalog_id` e `retailer_id`
Wevi	Colar `catalog_id` na conexão WhatsApp em Configurações → Conectores
Sua integração	Chamar `/send-product` ou `/send-product-list` passando o `retailer_id`

Sem esses 3 passos juntos, o envio falha. Com eles configurados, é instantâneo.

←

Não consigo enviar ou publicar formulários (requisitos da Meta)

Como personalizar a identidade visual do agente

→