Installation
Kann mein System Conversions per Webhook melden?
Der Endpunkt POST /v1/webhooks/conversions ist für Systeme gedacht, die von sich aus einen Webhook auslösen, statt einen API-Aufruf zu programmieren. Er verlangt zwingend eine gültige Signatur.
Wann nehme ich den Webhook statt der Server Events API?
| Server Events API | Webhook | |
|---|---|---|
| Pfad | /v1/server/events | /v1/webhooks/conversions |
| Signatur | optional | verpflichtend |
| Mehrere Events je Aufruf | ja | ja |
| Typischer Auslöser | eigener Code im Backend | Ereignis im Fremdsystem |
Inhaltlich gelten dieselben Regeln: dasselbe Event-Schema, dieselbe Idempotenz über die Event-ID, dieselbe Consent-Prüfung. Auch hier braucht es eine gemeinsame Kennung, damit die Conversion in einer Journey landet.
Zuletzt geprüft am 11.10.2026
Ebenfalls gefragt
- Webhook einrichten
- Conversions per Webhook
- Unterschied Webhook und API
Weiterführende Artikel
- Wie melde ich Conversions serverseitig?
Wie sende ich Events aus meinem Shop, CRM oder Backend?
Über POST /v1/server/events an den Collector, mit dem Serverschlüssel im Authorization-Header. Die Adresse und den fertigen Aufruf für deine Website zeigt das Portal unter „Einrichtung“ im Reiter „Server Events API“. Der Aufruf ist unabhängig vom Browser und damit robust gegenüber Adblockern und kurzlebigen Cookies.
- Wie signiere ich serverseitige Anfragen?
Wie funktioniert die HMAC-Signatur und der Replay-Schutz?
Du sendest den Kopf x-metrunio-signature mit Zeitstempel und HMAC-SHA256 über "<Zeitstempel>.<roher Body>", berechnet mit dem Serverschlüssel. Das Zeitfenster beträgt fünf Minuten, und jede Signatur wird genau einmal akzeptiert.
- Kann Metrunio mein System benachrichtigen?
Wie bekomme ich neue Bestellungen, Erstattungen und Alarme per Webhook in mein CRM?
Per Webhook, ab Growth: Unter „Datenverbindungen → Webhooks“ trägst du eine https-Adresse ein und wählst die Ereignisse. Metrunio ruft sie bei jeder neuen Bestellung oder Anfrage, jeder Erstattung, jedem Alarm und jedem abgeschlossenen Kostenabgleich auf, signiert. Eine Browser- oder Kundenkennung ist nicht dabei, wohl aber Bestell- oder Anfragekennung, Wert und Zeitpunkt; diese Angaben können personenbezogen sein.