SendApp Docs
Accedi

Crea o aggiorna un prodotto

POST https://app.sendapp.ai/api/products
Crea un prodotto nel catalogo di WhatsApp Commerce o aggiorna quello che ha già lo stesso sku. Il prodotto compare subito nel catalogo della chat e nel sito del negozio.

Serve al gestionale, all'e-commerce o al foglio di calcolo del cliente per tenere il catalogo allineato: prezzi, scorte, taglie, sconti, categorie e foto.
Lo SKU è la chiave. Inviare due volte lo stesso prodotto non lo duplica: lo aggiorna. Nell'aggiornamento manda solo i campi che cambiano (es. solo price e stock): quelli che non mandi restano come sono.
Con le taglie (variants) le scorte si contano per taglia: lo stock generale resta vuoto e viene ignorato. Una lista vuota "variants": [] toglie le taglie.
Le foto sono indirizzi pubblici https:// (JPG, PNG, WebP o GIF, massimo 5 MB e 6 foto). Le scarichiamo in un secondo momento sul nostro CDN, una volta sola: finché non sono pronte il prodotto ha images_pending maggiore di zero. Rimandare lo stesso indirizzo non le scarica di nuovo.
Serve un piano con WhatsApp Commerce e accesso API. Se hai più account collegati, il campo token è obbligatorio.

Parametri

16 · 2 obbligatori
apikey obbligatorio
La tua API Key (in alternativa: header X-API-Key).
token opzionale
Token dell'account. Obbligatorio se ne hai più di uno.
sku obbligatorio
Il tuo codice prodotto (max 100 caratteri). Identifica il prodotto.
name opzionale
Nome del prodotto. Obbligatorio solo per crearlo.
description opzionale
Descrizione (max 2000 caratteri).
price opzionale
Prezzo con il punto come separatore dei decimali (24.90).
currency opzionale
Valuta in tre lettere (predefinita EUR).
discount opzionale
Sconto: {"type": "percent", "value": 20} oppure {"type": "fixed", "value": 5}. null lo toglie.
stock opzionale
Pezzi disponibili. null = scorte non gestite (sempre ordinabile), 0 = esaurito.
available opzionale
false nasconde il prodotto dal catalogo e dal sito senza cancellarlo.
variants opzionale
Taglie o varianti: [{"label": "M", "stock": 5}], massimo 50. L'ordine della lista è l'ordine mostrato.
category opzionale
Percorso della categoria, livelli separati da > (Abbigliamento > T-shirt, massimo 5 livelli). Le categorie che mancano vengono create.
category_id opzionale
In alternativa a category: l'id di una categoria esistente (vedi l'elenco categorie).
images opzionale
Lista di indirizzi delle foto; la prima è quella principale. Una lista nuova sostituisce quella di prima.
position opzionale
Ordine nel catalogo (i numeri più bassi vengono prima).
duration_min opzionale
Solo per i servizi prenotabili: durata in minuti (da 5 a 1440).
Serve aiuto con l'integrazione? info@sendapp.live