Automatisierung anbinden

Webhook einrichten und absichern, fehlgeschlagene Aufrufe nachvollziehen, Zapier verbinden, die API mit einem Schlüssel ansprechen und einen KI-Assistenten per MCP andocken.

Vier Wege, Rabbit Checkout mit anderen Systemen zu verbinden, vom einfachsten zum flexibelsten.

Webhooks#

Ein Webhook ruft eine Adresse bei dir auf, sobald etwas passiert.

Einrichten#

1. Einstellungen → Webhooks → Neu.
2. Webhook-Name vergeben (nur zur Orientierung).
3. Webhook-Endpunkt eintragen: die Adresse, die aufgerufen werden soll.
4. Unter Ereignistypen ankreuzen, worauf reagiert werden soll.
5. Speichern.

Pro Shop darf jede Endpunkt-Adresse nur einmal vorkommen. Mit dem Schalter Aktiviert? kannst du einen Webhook stilllegen, ohne ihn zu löschen.

Ein Secret trägst du nicht selbst ein: Rabbit Checkout erzeugt es beim Anlegen automatisch. Du liest es später in der Webhook-Liste über Show Secret aus — siehe „Signatur prüfen" weiter unten.

Ereignistypen auswählen#

Ein Webhook kann auf beliebig viele Ereignisse hören — kreuze einfach alle an, die dieselbe Adresse aufrufen sollen. Welches Ereignis den Aufruf ausgelöst hat, steht dann im Feld type des Aufrufs, sodass dein Endpunkt die Fälle auseinanderhalten kann.

Ob du einen Webhook pro Ereignis anlegst oder einen für alle, ist Geschmackssache. Ein Webhook mit mehreren Ereignissen ist übersichtlicher; getrennte Webhooks lassen sich einzeln abschalten.

Fährst du mit der Maus über einen Ereignistyp, erklärt eine Kurzbeschreibung, wann er ausgelöst wird und wofür er sich eignet.

Die Ereignisse im Einzelnen#

Wann Zugänge kommen und gehen, hängt an den Abo-Ereignissen: PAUSED, CANCELED und EXPIRED entziehen den Produktzugang, ACTIVATED gibt ihn wieder frei. Jedes Mal folgt zusätzlich ein PRODUCT_ACCESS_*-Ereignis. Wenn dich nur der Zugang interessiert und nicht der Grund, reichen die beiden PRODUCT_ACCESS_*-Ereignisse.

Testereignis senden, bevor du verkauft hast#

Make, n8n, Zapier und ähnliche Dienste lassen sich meist erst einrichten, nachdem sie einmal einen Aufruf empfangen haben — vorher kennen sie die Feldnamen nicht. Bisher hieß das: erst verkaufen, dann automatisieren.

Auf der Webhook-Seite gibt es dafür Simulieren. Du wählst einen der Ereignistypen, die der Webhook abonniert hat, Rabbit Checkout schickt ein Beispiel an deine Adresse und zeigt dir, was dein Endpunkt geantwortet hat (Statuscode und Antworttext).

Das Beispiel hat dieselbe Struktur wie ein echtes Ereignis, damit deine Zuordnung später nicht bricht.

Was im Aufruf steht#

Der Körper ist ein JSON-Objekt mit einem festen Umschlag; das Feld type nennt das Ereignis, payload enthält die Daten:

{ "id": 4711, "storeId": 1, "type": "ORDER_PAYED", "payload": { "order": { "…": "…" } } }

Welche Felder je Ereignis in payload stehen, an welchem Pfad die Käufer-Adresse liegt und welche Header mitkommen → Webhook-Payloads.

Signatur prüfen#

Jeder Webhook bekommt beim Anlegen automatisch ein Secret. Du findest es in der Webhook-Liste über Show Secret. Rabbit Checkout schickt damit bei jedem Aufruf zwei Header mit:

x-webhook-id: <id des Webhooks>
x-signature:  <HMAC-SHA256 über den Rohkörper, hex>

Berechne dieselbe Signatur mit deinem Secret über den unveränderten Anfragekörper und vergleiche. In Node.js:

const crypto = require('node:crypto')

const expected = crypto
  .createHmac('sha256', SECRET)
  .update(rawBody)          // der Rohkörper, nicht das geparste JSON
  .digest('hex')

const ok = expected === request.headers['x-signature']

Wiederholungen und Fehlersuche#

Antwortet dein Endpunkt nicht mit Erfolg, wird der Aufruf bis zu dreimal mit wachsendem Abstand wiederholt. Bleibt es erfolglos, bekommst du eine Benachrichtigung („Webhook-Aufruf fehlgeschlagen"), sofern unter Einstellungen → Benachrichtigungen aktiviert.

Unter Einstellungen → Ereignisse siehst du jedes Ereignis mit seinen Zustellversuchen: Ziel-Adresse, gesendeter Inhalt, Antwortstatus und Antworttext. Von dort lässt sich ein Aufruf auch erneut auslösen.

Zapier#

Rabbit Checkout hat eine Zapier-App. Verbunden wird sie mit einem API-Key (siehe unten).

Als Auslöser stehen zur Verfügung:

• Produktzugang erteilt
• Produktzugang entzogen

Das deckt den häufigsten Fall ab: „Kunde hat gekauft → trag ihn in mein E-Mail-Tool ein". Für alles Darüberhinausgehende sind Webhooks der flexiblere Weg: Die meisten Automatisierungswerkzeuge (Zapier, Make, n8n) können einen Webhook als Auslöser entgegennehmen.

API#

1. Im Dashboard oben rechts über das Menü zu Konto.
2. API-Key erstellen und den Schlüssel sicher notieren.
3. Den Schlüssel gegen ein Zugriffstoken tauschen:

POST https://dashboard.rabbit-checkout.de/api/auth/token
Content-Type: application/json

{ "apiKey": "DEIN_API_KEY" }

4. Weitere Aufrufe mit dem Token:

GET https://dashboard.rabbit-checkout.de/api/stores
Authorization: Bearer DEIN_TOKEN

Die vollständige, immer aktuelle Referenz mit allen Endpunkten und Feldern liegt unter:

https://dashboard.rabbit-checkout.de/api/docs

KI-Assistenten anbinden (MCP)#

Rabbit Checkout stellt einen MCP-Server bereit, mit dem ein KI-Assistent wie Claude oder ChatGPT in deinem Shop arbeiten kann. Die Adresse steht unter Einstellungen → Integrationen → MCP:

https://dashboard.rabbit-checkout.de/api/mcp

Diese Adresse trägst du im Assistenten als eigenen Connector ein und meldest dich einmal an. Der Umfang ist groß: lesen und ändern, über Produkte, Checkout-Seiten und -Flows, Erfolgs- und Upsell-Seiten, Bump-Angebote, Gutscheine und Kurslektionen. Bestellungen und Abonnements kann er nur lesen.

Einrichtung Schritt für Schritt, was der Assistent genau darf, die Reichweite der Freigabe und wie du sie widerrufst → KI-Assistenten verbinden (MCP).

Fragen zur Bedienung beantworten lassen#

Wenn du deinen Assistenten stattdessen zu Anleitungen befragen willst („Wie erstelle ich einen Gutschein?"), brauchst du keinen Connector. Gib ihm diese Adresse:

https://rabbit-checkout.de/llms.txt

Dort stehen alle Hilfeseiten als reines Markdown verlinkt. Der Assistent liest sich von dort weiter. Einzelseiten gibt es jeweils auch direkt, etwa https://rabbit-checkout.de/hilfe/anleitungen/gutschein-erstellen.md.