Pular para o conteúdo
D-APITestar grátis

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.

A gente também é SaaS

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time técnico da D-API acompanha a integração no seu produto.

Continue por aqui

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.