Webhooks (CRM)
Webhooks benachrichtigen externe Systeme automatisch, sobald im CRM etwas Bestimmtes passiert — zum Beispiel, dass ein Ticket erstellt oder ein Deal in eine neue Phase verschoben wurde. Das eingebundene System erhält dann selbstständig eine Nachricht an eine von Ihnen hinterlegte Ziel-URL, ohne dass jemand manuell etwas exportieren muss.
Was kann ich hier tun?
- Webhooks anlegen, bearbeiten und löschen
- Festlegen, bei welchen Ereignistypen ein Webhook ausgelöst wird
- Eine Ziel-URL und ein Signatur-Geheimnis hinterlegen, mit dem das Empfängersystem die Echtheit der Nachricht prüfen kann
- Maximale Wiederholungen und Timeout für die Zustellung einstellen
- Einen Testversand auslösen, um die Verbindung zu prüfen
- Das Zustellprotokoll je Webhook einsehen und fehlgeschlagene Zustellungen erneut senden
Schritt für Schritt
- Klicken Sie auf „Webhook hinzufügen“, vergeben Sie einen Namen (z. B. „Zapier-Integration“) und tragen Sie die Ziel-URL ein.
- Wählen Sie die Ereignistypen aus, bei denen der Webhook ausgelöst werden soll.
- Legen Sie optional ein Signatur-Geheimnis, maximale Wiederholungen und einen Timeout fest, und speichern Sie.
- Nutzen Sie „Testversand“, um zu prüfen, ob die Ziel-URL erreichbar ist und korrekt antwortet.
- Prüfen Sie im Zustellprotokoll, ob echte Ereignisse erfolgreich zugestellt wurden, und stoßen Sie bei Bedarf über „Erneut senden“ eine fehlgeschlagene Zustellung erneut an.
- „Erneut senden“ fragt vor dem Absenden nach und nennt dabei die Zieladresse, an die die signierte Zustellung geht. Lesen Sie die Adresse und bestätigen Sie erst dann.
Warum wird hier gefragt? Eine erneute Zustellung ist kein lokaler Wiederholungsversuch. Der Nutzdatensatz geht mit gültiger Signatur an das fremde System - dort ist er von der ursprünglichen Zustellung nicht zu unterscheiden und lässt sich von hier aus nicht zurückholen.
Felder erklärt
| Feld | Bedeutung | Hinweise/Auswirkung |
|---|---|---|
| Name | Bezeichnung des Webhooks | |
| URL | Ziel-Adresse, an die die Benachrichtigung geschickt wird | |
| Signatur-Geheimnis | Gemeinsames Geheimnis zur Prüfung der Nachrichten-Echtheit beim Empfänger | |
| Ereignistypen | Auswahl der Ereignisse, die diesen Webhook auslösen | Siehe „Werte & Status“ unten |
| Max. Wiederholungen | Wie oft eine fehlgeschlagene Zustellung erneut versucht wird | |
| Timeout (ms) | Wie lange auf eine Antwort des Zielsystems gewartet wird | |
| Aktiv | Ob der Webhook aktuell ausgelöst wird | |
| Zustellprotokoll | Liste aller Zustellversuche mit Status und Versuchsnummer | Siehe „Werte & Status“ unten |
Werte & Status
Ereignistypen (crm_webhook_event)
Ticket erstellt, Ticket aktualisiert, Ticket gelöst, Deal-Phase geändert, Sync abgeschlossen, Kontakt erstellt, Aufgabe erstellt, Aufgabe aktualisiert, Aufgabe abgeschlossen.
Zustellstatus (crm_webhook_delivery_status)
| Wert | Klartext-Bedeutung |
|---|---|
| Erfolgreich | Die Zielanwendung hat die Nachricht bestätigt |
| Fehlgeschlagen | Die Zustellung ist endgültig fehlgeschlagen |
| Wiederholung | Die Zustellung wird gerade erneut versucht |
| Ausstehend | Die Zustellung wurde noch nicht ausgeführt |
Häufige Fragen
Wofür ist das Signatur-Geheimnis gut?
Damit kann das empfangende System prüfen, dass eine Nachricht wirklich von SELLERLOGIC Commerce Services stammt und nicht gefälscht wurde.
Was passiert, wenn die Ziel-URL nicht erreichbar ist?
Die Zustellung wird bis zur eingestellten Anzahl an Wiederholungen erneut versucht; danach gilt sie als fehlgeschlagen und erscheint entsprechend im Zustellprotokoll.
Kann ich eine fehlgeschlagene Zustellung manuell erneut anstoßen?
Ja, über „Erneut senden“ im Zustellprotokoll.