Webhook-Integrationen

Webhooks in Deskwoot sind HTTP-Rückrufe, die ausgelöst werden, wenn in Ihrem Postfach etwas passiert (neue Konversation, neue Nachricht, Statusänderung). So können Sie Supportereignisse mit einem CRM synchronisieren, eine externe Automatisierung auslösen oder sie in Ihrer eigenen Datenbank protokollieren, alles ohne die API abzufragen. Ob Sie ein CRM aktualisieren, in einem externen Tool eine Benachrichtigung auslösen oder Supportereignisse in Ihrer eigenen Datenbank protokollieren möchten, Webhooks bieten eine schlanke, ereignisgesteuerte Möglichkeit, alles synchron zu halten.

Diese Anleitung führt Sie durch das Erstellen eines Webhooks, die Auswahl der richtigen Ereignisse und die Behebung häufiger Probleme.

Einen Webhook erstellen

Gehen Sie in Ihrem Deskwoot-Dashboard zu Einstellungen > Webhooks.
Klicken Sie auf Webhook hinzufügen.
Geben Sie die URL des Endpunkts ein, der die Ereignisdaten empfangen soll. Dies muss eine öffentlich zugängliche HTTPS-URL sein.
Wählen Sie die Ereignistypen aus, die Sie abonnieren möchten (zum Beispiel Konversation erstellt, Nachricht gesendet oder Kontakt aktualisiert).
Klicken Sie auf Speichern, um den Webhook zu aktivieren.

Nach dem Speichern sendet Deskwoot jedes Mal, wenn ein passendes Ereignis auftritt, eine HTTP-POST-Anfrage mit einem JSON-Payload an Ihre angegebene URL.

Tipps aus der Praxis

Verwenden Sie nur HTTPS-Endpunkte. Das stellt sicher, dass Ereignisdaten bei der Übertragung verschlüsselt sind, und schützt sensible Kundeninformationen.
Abonnieren Sie gezielt. Wählen Sie nur die Ereignistypen, die Sie tatsächlich brauchen. Alle Ereignisse zu abonnieren, kann ein hohes Anfragevolumen erzeugen und das Debugging erschweren.
Antworten Sie schnell. Ihr Endpunkt sollte so schnell wie möglich einen 2xx-Statuscode zurückgeben. Lagern Sie aufwendige Verarbeitung in einen Hintergrundjob aus, um Timeouts zu vermeiden.
Protokollieren Sie eingehende Payloads. Protokollieren Sie während der ersten Einrichtung das rohe JSON, damit Sie die Struktur des Payloads prüfen und Ihre Integration korrekt aufbauen können.
Halten Sie Ihren Endpunkt idempotent. In seltenen Fällen wird ein Webhook mehr als einmal zugestellt. Gestalten Sie Ihren Handler so, dass das zweimalige Verarbeiten desselben Ereignisses keine doppelten Aktionen auslöst.

Fehlerbehebung

Keine Ereignisse empfangen? Prüfen Sie, ob Ihre Endpunkt-URL korrekt und öffentlich zugänglich ist und eine 2xx-Antwort zurückgibt. Firewalls oder Regeln zur IP-Freigabe können eingehende Anfragen unbemerkt blockieren.
Unerwartetes Payload-Format? Stellen Sie sicher, dass Sie den Anfragetext als JSON parsen (Content-Type: application/json). Prüfen Sie Ihre Serverprotokolle auf Parsing-Fehler.
Ereignisse kommen verspätet an? In Zeiten mit hohem Datenverkehr kann es zu kurzen Verzögerungen kommen. Wenn Verzögerungen anhalten, bestätigen Sie, dass Ihr Server eingehende Verbindungen nicht drosselt oder in eine Warteschlange stellt.

Häufig gestellte Fragen

Kann ich mehrere Webhooks für verschiedene Endpunkte einrichten?

Ja. Sie können so viele Webhooks erstellen, wie Sie benötigen, jeder mit Verweis auf eine andere URL und dem Abonnement verschiedener Ereignistypen. Das ist nützlich, wenn getrennte Dienste auf verschiedene Ereignisse reagieren müssen.

Was passiert, wenn mein Endpunkt vorübergehend nicht erreichbar ist?

Wenn Deskwoot eine Antwort erhält, die nicht 2xx ist, oder die Anfrage zeitlich abläuft, gilt die Zustellung als fehlgeschlagen. Überwachen Sie die Verfügbarkeit Ihres Endpunkts, um verpasste Ereignisse zu minimieren, und ziehen Sie in Betracht, auf Ihrer Seite einen Mechanismus zur Ausfallprotokollierung umzusetzen.

Gibt es eine Möglichkeit, einen Webhook vor dem Livegang zu testen?

Ein gängiger Ansatz ist, während der Einrichtung ein Werkzeug zur Anfragenprüfung als Endpunkt zu verwenden (etwa eine temporäre öffentliche URL, die eingehende Anfragen protokolliert). So können Sie die Struktur des Payloads prüfen und die Zustellung bestätigen, bevor Sie den Webhook auf Ihr Produktivsystem richten.