SendApp Docs
Entrar

Criar ou atualizar um produto

POST https://app.sendapp.ai/api/products
Cria um produto no catálogo do WhatsApp Commerce ou atualiza o que já tem o mesmo sku. O produto aparece de imediato no catálogo do chat e no site da loja.

Serve para que o software de gestão, o e-commerce ou a folha de cálculo do cliente mantenham o catálogo alinhado: preços, stock, tamanhos, descontos, categorias e fotos.
O SKU é a chave. Enviar duas vezes o mesmo produto não o duplica: atualiza-o. Na atualização, envie só os campos que mudam (ex.: só price e stock): os que não envia ficam como estão.
Com tamanhos (variants) o stock conta-se por tamanho: o stock geral fica vazio e é ignorado. Uma lista vazia "variants": [] remove os tamanhos.
As fotos são endereços públicos https:// (JPG, PNG, WebP ou GIF, no máximo 5 MB e 6 fotos). Descarregamo-las pouco depois para o nosso CDN, uma única vez: enquanto não estão prontas, o produto tem images_pending maior que zero. Voltar a enviar o mesmo endereço não o descarrega de novo.
É preciso um plano com WhatsApp Commerce e acesso à API. Se tiver várias contas ligadas, o campo token é obrigatório.

Parâmetros

16 · 2 obrigatórios
apikey obrigatório
A sua API Key (em alternativa: o cabeçalho X-API-Key).
token opcional
Token da conta. Obrigatório se tiver mais do que uma.
sku obrigatório
O seu código de produto (máx. 100 caracteres). Identifica o produto.
name opcional
Nome do produto. Obrigatório apenas para o criar.
description opcional
Descrição (máx. 2000 caracteres).
price opcional
Preço com ponto como separador decimal (24.90).
currency opcional
Moeda de três letras (predefinida EUR).
discount opcional
Desconto: {"type": "percent", "value": 20} ou {"type": "fixed", "value": 5}. null remove-o.
stock opcional
Unidades disponíveis. null = stock não gerido (sempre encomendável), 0 = esgotado.
available opcional
false oculta o produto do catálogo e do site sem o apagar.
variants opcional
Tamanhos ou variantes: [{"label": "M", "stock": 5}], no máximo 50. A ordem da lista é a ordem apresentada.
category opcional
Caminho da categoria, níveis separados por > (Vestuário > T-shirts, no máximo 5 níveis). As categorias em falta são criadas.
category_id opcional
Em alternativa a category: o id de uma categoria existente (ver a lista de categorias).
images opcional
Lista de endereços das fotos; a primeira é a principal. Uma lista nova substitui a anterior.
position opcional
Ordem no catálogo (os números mais baixos vêm primeiro).
duration_min opcional
Apenas para serviços reserváveis: duração em minutos (de 5 a 1440).
Precisa de ajuda com a integração? info@sendapp.live