SendApp Docs
Se connecter

Créer ou mettre à jour un produit

POST https://app.sendapp.ai/api/products
Crée un produit dans le catalogue WhatsApp Commerce ou met à jour celui qui a déjà le même sku. Le produit apparaît aussitôt dans le catalogue du chat et sur le site de la boutique.

Pensé pour que le logiciel de gestion, l'e-commerce ou le tableur du client garde le catalogue à jour : prix, stocks, tailles, remises, catégories et photos.
Le SKU est la clé. Envoyer deux fois le même produit ne le duplique pas : il est mis à jour. Pour une mise à jour, n'envoyez que les champs qui changent (par ex. seulement price et stock) : ceux que vous n'envoyez pas restent tels quels.
Avec des tailles (variants), le stock se compte par taille : le stock général reste vide et est ignoré. Une liste vide "variants": [] supprime les tailles.
Les photos sont des adresses publiques https:// (JPG, PNG, WebP ou GIF, 5 Mo et 6 photos au maximum). Nous les téléchargeons peu après sur notre CDN, une seule fois : tant qu'elles ne sont pas prêtes, le produit a images_pending supérieur à zéro. Renvoyer la même adresse ne la télécharge pas une nouvelle fois.
Il faut une offre avec WhatsApp Commerce et l'accès API. Si vous avez plusieurs comptes connectés, le champ token est obligatoire.

Paramètres

16 · 2 obligatoires
apikey obligatoire
Votre API Key (ou bien l'en-tête X-API-Key).
token facultatif
Token du compte. Obligatoire si vous en avez plusieurs.
sku obligatoire
Votre code produit (100 caractères max.). Il identifie le produit.
name facultatif
Nom du produit. Obligatoire uniquement pour le créer.
description facultatif
Description (2000 caractères max.).
price facultatif
Prix avec un point comme séparateur décimal (24.90).
currency facultatif
Devise en trois lettres (par défaut EUR).
discount facultatif
Remise : {"type": "percent", "value": 20} ou {"type": "fixed", "value": 5}. null la supprime.
stock facultatif
Pièces disponibles. null = stock non géré (toujours commandable), 0 = épuisé.
available facultatif
false masque le produit du catalogue et du site sans le supprimer.
variants facultatif
Tailles ou variantes : [{"label": "M", "stock": 5}], 50 au maximum. L'ordre de la liste est l'ordre affiché.
category facultatif
Chemin de la catégorie, niveaux séparés par > (Vêtements > T-shirts, 5 niveaux au maximum). Les catégories manquantes sont créées.
category_id facultatif
À la place de category : l'id d'une catégorie existante (voir la liste des catégories).
images facultatif
Liste des adresses des photos ; la première est la photo principale. Une nouvelle liste remplace la précédente.
position facultatif
Ordre dans le catalogue (les nombres les plus bas viennent en premier).
duration_min facultatif
Services réservables uniquement : durée en minutes (de 5 à 1440).
Besoin d'aide pour l'intégration ? info@sendapp.live