Webhook

Was ist ein Webhook?

Webhook (auch HTTP Callback oder Reverse API) ist ein Mechanismus, bei dem ein System selbst eine HTTP-POST-Anfrage an eine vorab festgelegte URL sendet, wenn ein definiertes Ereignis in ihm eintritt — eine neue Rechnung, eine Änderung des Bestellstatus, ein Zahlungseingang. Es ist das Gegenteil eines klassischen API-Aufrufs, bei dem der Client den Server fragt („Hast du etwas Neues?”). Webhook ist Push, der klassische API-Aufruf ist Pull.

Vorteile von Webhooks:

• Echtzeit — Ereignisse werden sofort zugestellt, ohne periodisches Polling
• Effizienz — belasten beide Systeme nicht mit leeren Aufrufen
• Einfachheit — Konfiguration besteht oft nur aus URL + Authentifizierungstoken

Typische Probleme, die bei der Webhook-Implementierung zu beachten sind:

• Authentifizierung — HMAC-Signatur oder Token hinzufügen, um den Absender zu verifizieren
• Retry-Logik — wenn das Zielsystem mit einem Fehler (5xx) antwortet, erneut versuchen mit exponentiellem Backoff
• Idempotenz — das Zielsystem muss damit umgehen können, dasselbe Ereignis zweimal zu erhalten
• Reihenfolge der Zustellung — Webhooks können nicht in der richtigen Reihenfolge ankommen

Im deutschen SaaS-Ökosystem sind Webhooks Standard — Stripe, Shopify, Mailchimp, DATEV und E-Commerce-Integrationen nutzen alle das Webhook-Modell.

Wann werden sie eingesetzt

Webhooks eignen sich für:

• Synchronisierung zwischen Systemen (ERP ↔ Onlineshop)
• Auslösen von Workflow-Automatisierungen bei Ereignissen
• Benachrichtigungen in Kommunikationskanäle (Slack, Teams)
• Echtzeit-Dashboards

Siehe API-Seite, Modul Arbeitsabläufe und Integrationen.

Verwandte Begriffe

• API — klassisches Request/Response-Modell. Siehe /de/glossar/api.
• Workflow Automation — Webhooks sind typische Trigger. Siehe /de/glossar/workflow-automation.
• MCP — alternatives Protokoll für KI-Assistenten. Siehe /de/glossar/mcp.

In Modulario

Modulario stellt konfigurierbare Webhooks für jedes wichtige Ereignis bereit — Rechnungserstellung, Dealabschluss, Statusänderung einer Bestellung. Automatischer Retry mit Signatur gewährleistet eine zuverlässige Zustellung. Beispiele und Schemata auf /api.

Modulario bietet eine Webhook-Management-UI, in der der Administrator alle aktiven Registrierungen, Logs der letzten 1.000 Aufrufe (einschließlich Payload und Antwort) einsehen und einen „Replay” für die Zustellung von Ereignissen nach einem Ausfall des Zielsystems starten kann.