Verbinden Sie SliceQuote mit Ihren Tools: Webhooks melden Ereignisse wie neue Bestellungen in Echtzeit, die REST-API liefert Daten auf Abruf. Beides funktioniert ohne eigene Programmierung mit n8n, Zapier & Co.
Webhooks und API-Keys sind Bestandteil der Premium- und Enterprise-Pläne – Verwaltung im Admin unter Webhooks bzw. API-Keys.
Jede Zustellung ist ein POST mit JSON-Body im Format { event, createdAt, data }. Fehlgeschlagene Zustellungen werden bis zu 5-mal mit exponentiellem Backoff wiederholt.
| Event | Auslöser | Felder in data |
|---|---|---|
order.created | Neue Bestellung über das Widget eingegangen | orderId, orderNumber, subtotal, shippingMethod, shippingCost, totalAmount, quantity, customerName |
order.paid | Bestellung wurde bezahlt (z. B. Stripe) | orderId, orderNumber, totalAmount, paidAt |
order.status_changed | Bestellstatus wurde geändert | orderId, orderNumber, previousStatus, status, paymentStatus |
quote.saved | Kunde hat sich ein Angebot per E-Mail gesichert | customerEmail, itemCount, totalPrice |
quote_request.created | Kunde hat ein individuelles Angebot angefordert | customerEmail, customerName, itemCount, calculatedPrice |
Beispiel-Payload
{
"event": "order.created",
"createdAt": "2026-07-29T12:34:56.000Z",
"data": {
"orderId": "cm…",
"orderNumber": "SQ-2026-0042",
"subtotal": 18.49,
"shippingMethod": "standard",
"shippingCost": 4.9,
"totalAmount": 23.39,
"quantity": 2,
"customerName": "Max Mustermann"
}
}n8n lässt sich selbst hosten (DSGVO-souverän) oder als Cloud nutzen und passt damit besonders gut zu SliceQuote. Die Anbindung braucht nur den eingebauten Webhook-Node:
In n8n einen Workflow mit einem Webhook-Node anlegen (Methode POST) und die Produktions-URL kopieren.
Im SliceQuote-Admin unter Webhooks einen neuen Webhook mit dieser URL anlegen und die gewünschten Events abonnieren. Das angezeigte Secret notieren.
Im Workflow auf die Daten zugreifen: {{ $json.body.data.orderNumber }} – fertig. Der „Webhook testen“-Button im SliceQuote-Admin schickt eine Probe-Zustellung.
In n8n über Workflows → Import from File importieren, Zugangsdaten (SMTP/Slack/Google) hinterlegen, Webhook-URL in SliceQuote eintragen – läuft.
Jede Zustellung trägt den Header X-SliceQuote-Signature – ein HMAC-SHA256 (hex) über den rohen Request-Body mit Ihrem Webhook-Secret. So prüfen Sie ihn in einem n8n Code-Node:
// n8n Code-Node: Signatur prüfen (optional, empfohlen)
// Voraussetzung: im Webhook-Node unter Options → "Raw Body" aktivieren.
const crypto = require('crypto');
const item = $input.first();
const raw = item.binary?.data
? Buffer.from(item.binary.data.data, 'base64').toString('utf8')
: JSON.stringify(item.json.body);
const expected = crypto
.createHmac('sha256', 'IHR_WEBHOOK_SECRET')
.update(raw, 'utf8')
.digest('hex');
if (expected !== item.json.headers['x-slicequote-signature']) {
throw new Error('Ungültige Webhook-Signatur');
}
return $input.all();Mit dem eingebauten Trigger „Webhooks by Zapier“ (Catch Hook) funktioniert SliceQuote auch ohne eigene Zapier-App:
data orderNumber) und die gewünschte Action anhängen (Gmail, Sheets, CRM …).Hinweis: „Webhooks by Zapier“ setzt einen kostenpflichtigen Zapier-Plan voraus.
Für Abfragen in die andere Richtung (z. B. nächtlicher Export aller Aufträge per n8n „HTTP Request“-Node oder Cron) steht die v1-API mit shop-eigenen API-Keys bereit:
curl https://slicequote.de/api/v1/orders \
-H "Authorization: Bearer sq_live_IHR_API_KEY"API-Keys erstellen Sie im Admin unter API-Keys (Scopes wählbar, Limit 120 Anfragen/Minute). Alle Endpunkte und Schemas:
Wir helfen gerne beim Einrichten Ihres Workflows – oder nehmen Wünsche für fertige Integrationen entgegen.
Kontakt aufnehmen