Producten syncen via de API
Draai je een shop op een eigen stack, dan push je je catalogus rechtstreeks naar de bot. Zodra producten zijn gesynct, beantwoordt hij koopvragen met echte productkaarten, compleet met prijs, afbeelding en een link.
Stuur je catalogus
POST naar /api/v1/chat/sync-products met je sync key in de X-Sync-Key-header (dit endpoint gebruikt niet de Bearer-key). De body is JSON: je bot_id en een products-array. Per product is alleen een titel verplicht; de rest maakt de kaart rijker.
POST /api/v1/chat/sync-products
X-Sync-Key: awsk_YOUR_SYNC_KEY
{
"bot_id": "YOUR_BOT_ID",
"products": [
{
"title": "Blue Wool Scarf",
"price": "€39.00",
"sale_price": "€29.00",
"badge": "Sale",
"url": "https://shop.example.com/scarf",
"image_url": "https://shop.example.com/scarf.jpg"
}
]
}Het vervangt de hele catalogus
Elke call is een volledige vervanging, geen update, dus stuur altijd je complete lijst. Je kunt tot 500 producten per call meesturen en maximaal 6 calls per minuut doen. Een geslaagde sync geeft { "ok": true, "synced": 128, "indexed": true } terug.
Gesyncte producten voeden de tekstantwoorden van de bot op elk abonnement, maar de visuele productkaarten verschijnen vanaf het Pro-abonnement. Onze WordPress-, Shopify- en Magento-apps roepen dit endpoint ook automatisch voor je aan, dus je hoeft het alleen op een eigen platform zelf te scripten.