SendApp Docs
Anmelden

Produkt anlegen oder aktualisieren

POST https://app.sendapp.ai/api/products
Legt ein Produkt im Katalog von WhatsApp Commerce an oder aktualisiert das Produkt, das bereits dieselbe sku hat. Das Produkt erscheint sofort im Chat-Katalog und auf der Website des Shops.

Gedacht für die Warenwirtschaft, den Onlineshop oder die Tabelle des Kunden, um den Katalog aktuell zu halten: Preise, Bestand, Größen, Rabatte, Kategorien und Fotos.
Die SKU ist der Schlüssel. Wird dasselbe Produkt zweimal gesendet, entsteht kein Duplikat: Es wird aktualisiert. Bei einer Aktualisierung nur die Felder senden, die sich ändern (z. B. nur price und stock): Nicht gesendete Felder bleiben unverändert.
Mit Größen (variants) wird der Bestand pro Größe gezählt: Der allgemeine stock bleibt leer und wird ignoriert. Eine leere Liste "variants": [] entfernt die Größen.
Fotos sind öffentliche https://-Adressen (JPG, PNG, WebP oder GIF, höchstens 5 MB und 6 Fotos). Wir laden sie kurz darauf einmalig auf unser CDN: Bis sie bereit sind, hat das Produkt images_pending größer als null. Dieselbe Adresse erneut zu senden, lädt sie nicht noch einmal.
Nötig ist ein Tarif mit WhatsApp Commerce und API-Zugang. Bei mehreren verbundenen Konten ist das Feld token Pflicht.

Parameter

16 · 2 Pflichtfelder
apikey erforderlich
Ihr API Key (alternativ: der Header X-API-Key).
token optional
Konto-Token. Pflicht, wenn Sie mehrere haben.
sku erforderlich
Ihr Produktcode (max. 100 Zeichen). Er identifiziert das Produkt.
name optional
Produktname. Nur zum Anlegen erforderlich.
description optional
Beschreibung (max. 2000 Zeichen).
price optional
Preis mit Punkt als Dezimaltrennzeichen (24.90).
currency optional
Währung mit drei Buchstaben (Standard EUR).
discount optional
Rabatt: {"type": "percent", "value": 20} oder {"type": "fixed", "value": 5}. null entfernt ihn.
stock optional
Verfügbare Stück. null = Bestand wird nicht geführt (immer bestellbar), 0 = ausverkauft.
available optional
false blendet das Produkt im Katalog und auf der Website aus, ohne es zu löschen.
variants optional
Größen oder Varianten: [{"label": "M", "stock": 5}], höchstens 50. Die Reihenfolge der Liste ist die angezeigte Reihenfolge.
category optional
Kategoriepfad, Ebenen getrennt durch > (Bekleidung > T-Shirts, höchstens 5 Ebenen). Fehlende Kategorien werden angelegt.
category_id optional
Statt category: die ID einer bestehenden Kategorie (siehe Kategorienliste).
images optional
Liste der Fotoadressen; die erste ist das Hauptfoto. Eine neue Liste ersetzt die vorherige.
position optional
Reihenfolge im Katalog (kleinere Zahlen kommen zuerst).
duration_min optional
Nur für buchbare Leistungen: Dauer in Minuten (5 bis 1440).
Brauchen Sie Hilfe bei der Integration? info@sendapp.live