Webhooks
Ein Webhook ist eine automatische Benachrichtigung, die vom TARGPatrol-Server an Ihren Server gesendet wird, wenn im System ein bestimmtes Ereignis eintritt, zum Beispiel wenn eine Aufgabe erstellt, aktualisiert oder abgeschlossen wird. Webhooks sind wichtig, um Prozesse zu automatisieren, andere Systeme zu integrieren und in Echtzeit auf Änderungen zu reagieren. Wenn in TARGPatrol ein Ereignis auftritt (z. B. eine Änderung des Aufgabenstatus), sendet das System eine POST-Anfrage an eine vordefinierte URL. Diese Anfrage enthält eine Payload - ein JSON-Objekt mit Ereignisdetails wie Aufgaben-ID, Status und weiteren relevanten Daten.
Webhooks in TARGPatrol einrichten
So erstellen Sie einen Webhook:
Melden Sie sich in TARGPatrol an.
Navigieren Sie zum Bereich "Verwaltung" -> "Webhooks".
Fügen Sie einen neuen Webhook hinzu:
Klicken Sie auf die Schaltfläche Webhook hinzufügen.
Geben Sie die URL ein, an die Benachrichtigungen gesendet werden sollen. Stellen Sie sicher, dass Ihr Server POST-Anfragen verarbeiten und JSON-Daten auswerten kann.
Wählen Sie die Ereignistypen aus, die den Webhook auslösen sollen. TARGPatrol unterstützt verschiedene Trigger.
Optional: Anfrage-Header hinzufügen: Geben Sie bei Bedarf Header wie Content-Type an, um das Anfrageformat anzupassen.
Klicken Sie auf die Schaltfläche "Speichern".
Webhook testen:
Nach dem Speichern können Sie den Webhook in TARGPatrol testen, indem Sie ein Ereignis simulieren.
Wenn Ihr Webhook zum Beispiel auf task.created reagiert, erhalten Sie eine Benachrichtigung, wenn eine neue Aufgabe erstellt wird.
Webhook-Protokolle in TARGPatrol anzeigen
Webhook-Protokolle öffnen:
Öffnen Sie den Bereich „Webhooks“ in TARGPatrol.
Klicken Sie auf die Webhook-URL oder das zugehörige Symbol, um die Details anzuzeigen.
Ein Fenster zeigt eine Liste ausgelöster Ereignisse einschließlich Status, Anfrage-Payloads und Serverantworten.
Auf Fehler prüfen: Wenn ein Webhook fehlschlägt, wird die entsprechende Anfrage in den Protokollen mit einem Fehlersymbol markiert. TARGPatrol deaktiviert einen Webhook automatisch nach 25 aufeinanderfolgenden fehlgeschlagenen Anfragen.
Tipps zur Verwaltung von Webhooks
Fehler sauber behandeln: Webhooks laufen in Echtzeit. Wenn Ihr Server jedoch nicht antwortet, wiederholt TARGPatrol die Anfrage automatisch.
Fehler überwachen und analysieren: Wiederkehrende Probleme wie Timeouts können auf Serverleistungsprobleme oder Routing-Fehlkonfigurationen hinweisen.
Informiert bleiben: TARGPatrol sendet E-Mail-Benachrichtigungen, wenn neue Webhooks erstellt werden, Fehler auftreten oder ein Webhook automatisch deaktiviert wird. So behalten Sie den Zustand Ihrer Integration im Blick.
HTTPS für Sicherheit verwenden: TARGPatrol-Webhooks unterstützen ausschließlich sichere HTTPS-URLs, um die Datensicherheit zu gewährleisten.
Das Einrichten von Webhooks in TARGPatrol ermöglicht es Ihnen, Aufgaben zu automatisieren, andere Systeme zu integrieren und Echtzeitdaten effektiv zu verwalten. Befolgen Sie die Tipps zur Webhook-Verwaltung, um typische Fehler zu vermeiden und eine reibungslose Integration sicherzustellen. Verwenden Sie HTTPS für Sicherheit, überwachen Sie Fehler, um Probleme schnell zu beheben, und bleiben Sie mit TARGPatrol-Benachrichtigungen über den Status Ihrer Webhooks informiert. Mit der richtigen Konfiguration optimieren Sie Workflows und steigern die Produktivität Ihres Teams.