catálogo de produtos
Catálogo de produtos WhatsApp API para a vitrine do cliente seguir o estoque
Com o catálogo de produtos WhatsApp API da D-API, a sua plataforma cria, edita, oculta e organiza em coleções os produtos do WhatsApp Business do lojista. Preço, promoção e disponibilidade saem do seu sistema e aparecem no celular de quem compra.
SaaS testa 14 dias com o time técnico ajudando na integração.
- conexões na D-API
- 1.875
- de uptime garantido em contrato
- 99,9%
- datacenters no Brasil
- 4
- por ligação de WhatsApp na API não-oficial
- R$ 0
Produto completo numa chamada
Nome, descrição, moeda, preço, preço promocional, código do seu sistema, link e imagem vão juntos na criação do produto.
Preço em decimal
Envie 199.90 para R$ 199,90. A D-API faz a conversão para o formato que o WhatsApp usa e devolve o valor em decimal na leitura.
Ocultar sem apagar
Produto sem estoque some da vitrine com is_hidden e volta quando o estoque é reposto, sem perder o cadastro no WhatsApp.
Coleções para organizar a vitrine
Agrupe produtos por categoria, como Pizzas, Bebidas e Sobremesas, e mantenha as coleções em dia pela API.
O catálogo de produtos WhatsApp API resolve uma tarefa que nenhum lojista gosta de fazer duas vezes: cadastrar produto. Ele já cadastrou no sistema da loja, na plataforma de e-commerce ou no cardápio do delivery, e agora teria que repetir tudo no aplicativo do WhatsApp Business, foto por foto, preço por preço. Pior: quando o preço muda ou o estoque acaba, o catálogo do WhatsApp fica desatualizado e o cliente pede um produto que não existe mais.
Com a D-API, a sua plataforma vira a fonte do catálogo. O produto criado no seu sistema aparece na vitrine do WhatsApp do lojista, e cada mudança de preço ou de disponibilidade vai junto. As rotas ficam em /api/v1/catalog e fazem parte da API não oficial, sobre a conta WhatsApp Business conectada.
Criar produto no catálogo pela API
POST /api/v1/catalog/product/create recebe os dados do produto. name, currency e price são obrigatórios.
curl -X POST https://api.d-api.cloud/api/v1/catalog/product/create \
-H "Authorization: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "pizzaria-bella-delivery",
"name": "Pizza Margherita Grande",
"description": "Molho de tomate, muçarela de búfala e manjericão. 8 fatias.",
"currency": "BRL",
"price": 69.90,
"retailer_id": "SKU-PZ-MARG-G",
"url": "https://pizzariabella.com.br/cardapio/margherita",
"image": "https://cdn.seu-saas.com/produtos/pz-marg-g.jpg"
}'
Três campos merecem atenção num SaaS.
price e sale_price em decimal. Envie 69.90 para R$ 69,90. O WhatsApp trabalha com valores multiplicados por mil, e a D-API faz essa conversão na entrada e o caminho inverso na leitura, com arredondamento que evita que 19,99 vire 19,98999 por erro de ponto flutuante.
retailer_id com o seu código. É o lugar para o SKU ou o id do produto no seu banco. Com ele, o seu sistema reconhece o produto do WhatsApp sem precisar de uma tabela de correspondência à parte.
image por URL pública. Use uma URL https:// acessível de fora. O WhatsApp busca a imagem direto nesse endereço. Imagem em base64 ainda não é aceita na criação de produto do catálogo, então hospede a foto no seu CDN ou storage antes.
A resposta traz o product_id gerado pelo WhatsApp. Guarde junto do produto no seu banco, porque é ele que as rotas de edição e exclusão pedem.
Editar preço, promoção e disponibilidade
POST /api/v1/catalog/product/edit funciona como um patch: só os campos enviados mudam, o resto fica como está. Isso deixa as atualizações do dia a dia pequenas.
{
"sessionId": "pizzaria-bella-delivery",
"product_id": "7421938475123",
"sale_price": 59.90
}
Algumas operações comuns, traduzidas para a API:
| Situação na loja | Chamada |
|---|---|
| Promoção da semana | edit com sale_price |
| Fim da promoção | edit com sale_price: 0 |
| Produto esgotado | edit com is_hidden: true |
| Estoque reposto | edit com is_hidden: false |
| Produto descontinuado | POST /api/v1/catalog/product/delete |
O is_hidden é o melhor amigo de quem integra estoque. O produto sai da vitrine sem perder o cadastro, a foto e o histórico, e volta com uma chamada quando o fornecedor entrega. Na criação, o padrão é false, ou seja, o produto nasce visível.
Organizar a vitrine em coleções
Coleções agrupam produtos, como as categorias de um cardápio ou as seções de uma loja. POST /api/v1/catalog/collection/create recebe name, description e, opcionalmente, product_ids para já criar a coleção com os produtos dentro.
{
"sessionId": "pizzaria-bella-delivery",
"name": "Pizzas Salgadas",
"product_ids": ["7421938475123", "7421938475124"]
}
Depois, /catalog/collection/edit e /catalog/collection/delete mantêm as coleções alinhadas com as categorias do seu sistema. Para uma plataforma de delivery, isso significa que reorganizar o cardápio no painel do restaurante reorganiza também o catálogo do WhatsApp.
Ler o catálogo e reconciliar com o seu sistema
Sincronização confiável precisa de leitura, para conferir o que está publicado.
POST /api/v1/catalog/list devolve os produtos do catálogo, com limit e cursor para percorrer catálogos grandes em partes. POST /api/v1/catalog/collections/list devolve as coleções, e POST /api/v1/catalog/product/get busca um produto pelo product_id. Na leitura, o nome do produto vem no campo title, e os preços voltam em decimal.
Um padrão que funciona bem é rodar uma reconciliação periódica: listar o catálogo, comparar com o seu cadastro pelo retailer_id e corrigir divergências. Isso cobre o caso do lojista que editou um produto direto no aplicativo.
Sem business_jid, as rotas de leitura usam o catálogo da própria conta conectada. Com ele, leem o catálogo de outra conta business.
Catálogo num SaaS com muitos lojistas
Cada sessão tem o catálogo da conta conectada a ela, então o modelo multi-tenant é direto: um lojista, uma sessão, um catálogo. Três cuidados evitam dor de cabeça na escala.
Guarde o product_id do WhatsApp por tenant e por produto, ao lado do retailer_id. Assim, uma edição no seu painel encontra o produto certo sem nenhuma busca.
Faça a carga inicial em lote controlado. Um catálogo de mil itens vira mil chamadas de criação; com async: true, o seu worker não fica preso esperando cada resposta, e os resultados chegam por webhook para você marcar o que foi publicado.
E ofereça ao lojista um botão de sincronizar agora, que roda a reconciliação sob demanda. É o recurso que resolve o “mudei no celular e não apareceu no sistema” sem chamado no suporte.
Do catálogo à venda dentro da conversa
O catálogo é a vitrine. A venda acontece na conversa, e a API de WhatsApp tem as peças para fechar o ciclo. Uma plataforma de e-commerce pode mostrar uma seleção de produtos num carrossel, responder dúvidas pelo atendimento e cobrar com um botão de Pix na própria mensagem.
Para quem constrói plataforma de e-commerce ou plataforma de delivery, o catálogo sincronizado é um argumento de venda forte: o lojista cadastra uma vez e o WhatsApp se atualiza sozinho. O mesmo vale para a plataforma de vendas por WhatsApp que atende pequenos negócios: menos cadastro manual é menos motivo para cancelar.
A referência de todos os endpoints está na documentação da D-API, e a visão geral da plataforma na página da API de WhatsApp.
Time D-API. Atualizado em .
Perguntas frequentes
Preciso de conta WhatsApp Business para usar o catálogo?
Sim. O catálogo é um recurso de conta business. As rotas de catálogo trabalham sobre o catálogo da conta conectada na sessão.
Consigo ler o catálogo de outra empresa?
As rotas de listagem e de busca aceitam business_jid. Sem esse campo, elas usam o catálogo da própria conta conectada.
Como sei se um contato tem catálogo?
A consulta de contato em GET /api/v1/contacts/{phone} traz, para contas business, o campo commerceExperience, com catalog, shop ou none, e cartEnabled, que indica se o carrinho está ativo.
O produto criado pela API aparece no aplicativo do lojista?
Aparece. A API trabalha sobre o catálogo da própria conta WhatsApp Business conectada, o mesmo que o lojista vê no aplicativo.