SendApp Docs
Iniciar sesión

Crear o actualizar un producto

POST https://app.sendapp.ai/api/products
Crea un producto en el catálogo de WhatsApp Commerce o actualiza el que ya tiene el mismo sku. El producto aparece enseguida en el catálogo del chat y en la web de la tienda.

Sirve para que el software de gestión, el e-commerce o la hoja de cálculo del cliente mantengan el catálogo al día: precios, existencias, tallas, descuentos, categorías y fotos.
El SKU es la clave. Enviar dos veces el mismo producto no lo duplica: lo actualiza. Al actualizar, envía solo los campos que cambian (p. ej. solo price y stock): los que no envías se quedan como están.
Con tallas (variants) las existencias se cuentan por talla: el stock general queda vacío y se ignora. Una lista vacía "variants": [] quita las tallas.
Las fotos son direcciones públicas https:// (JPG, PNG, WebP o GIF, máximo 5 MB y 6 fotos). Las descargamos poco después en nuestro CDN, una sola vez: hasta que están listas el producto tiene images_pending mayor que cero. Volver a enviar la misma dirección no la descarga de nuevo.
Necesitas un plan con WhatsApp Commerce y acceso a la API. Si tienes varias cuentas conectadas, el campo token es obligatorio.

Parámetros

16 · 2 obligatorios
apikey obligatorio
Tu API Key (como alternativa: la cabecera X-API-Key).
token opcional
Token de la cuenta. Obligatorio si tienes más de una.
sku obligatorio
Tu código de producto (máx. 100 caracteres). Identifica el producto.
name opcional
Nombre del producto. Obligatorio solo para crearlo.
description opcional
Descripción (máx. 2000 caracteres).
price opcional
Precio con punto como separador decimal (24.90).
currency opcional
Moneda de tres letras (por defecto EUR).
discount opcional
Descuento: {"type": "percent", "value": 20} o {"type": "fixed", "value": 5}. null lo quita.
stock opcional
Unidades disponibles. null = existencias no gestionadas (siempre se puede pedir), 0 = agotado.
available opcional
false oculta el producto del catálogo y de la web sin borrarlo.
variants opcional
Tallas o variantes: [{"label": "M", "stock": 5}], máximo 50. El orden de la lista es el orden mostrado.
category opcional
Ruta de la categoría, niveles separados por > (Ropa > Camisetas, máximo 5 niveles). Las categorías que faltan se crean.
category_id opcional
En lugar de category: el id de una categoría existente (ver la lista de categorías).
images opcional
Lista de direcciones de las fotos; la primera es la principal. Una lista nueva sustituye a la anterior.
position opcional
Orden en el catálogo (los números más bajos van primero).
duration_min opcional
Solo para servicios reservables: duración en minutos (de 5 a 1440).
¿Necesitas ayuda con la integración? info@sendapp.live