Senden Sie Ereignisse mit Webhooks an Ihr eigenes System

Ein Webhook ermöglicht es IDup, eine Ihrer Webadressen in dem Moment aufzurufen, in dem etwas passiert, zum Beispiel wenn eine Rechnung bezahlt wird. Jede Lieferung wird signiert und wiederholt, wenn Ihr System nicht antwortet.

Fügen Sie einen Endpunkt hinzu

1. Öffnen Sie die Webhooks Tabulator und drücken Sie Fügen Sie einen Endpunkt hinzu.
2. Geben Sie ein Name und die URL. Es muss öffentlich erreichbar sein. Adressen innerhalb eines privaten Netzwerks werden aus Sicherheitsgründen abgelehnt.
3. Markieren Sie die Ereignisse Sie möchten.
4. Optional: wählen Sie ein API-Schlüssel. Der Endpunkt empfängt dann nur Ereignisse, die dieser Schlüssel lesen darf.
5. Presse Speichern. IDup zeigt Ihr Signaturgeheimnis einmal. Bewahren Sie es sicher auf.

Ereignisse

• Rechnung erstellt, Rechnung bezahlt, Zahlung erhalten
• Neuer Kunde, Neuer Kontakt, Neuer Lead, Neues Ticket
• Offerte angenommen — eine Offerte, die ein Kunde akzeptiert hat

Jede Lieferung enthält drei Kopfzeilen: den Ereignisnamen, eine Liefernummer und die Unterschrift. Ein erneuter Versuch behält die gleiche Liefernummer, sodass Ihr System Duplikate erkennen kann.

Unterschrift prüfen

Ihr System sollte einen HMAC-SHA256 über die Zeit und den rohen Body mit Ihrem Geheimnis berechnen, es mit der Signatur vergleichen und eine Zeit älter als 5 Minuten ablehnen. Drücken Sie Signatur und Beispiele überprüfen für fertigen Code.

Testen, pausieren und erneuern

• Test senden sendet ein Testereignis und zeigt den HTTP-Code und die benötigte Zeit an.
• Pause stoppt die Lieferungen; Aktivieren startet sie erneut.
• Geheimnis rollen erstellt ein neues Geheimnis. Das alte funktioniert sofort nicht mehr.
• Löschen entfernt den Endpunkt. Sein Protokoll wird aufbewahrt.

Wiederholungen und das Protokoll

Ihre Adresse muss innerhalb von 5 Sekunden mit einem 2xx-Code antworten. Weiterleitungen werden nicht befolgt. Bei einem Fehler versucht IDup es nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden und 12 Stunden erneut. Nach dem sechsten Versuch wird die Zustellung markiert. Aufgegeben.

Das Protokoll zeigt jeden Versuch mit Ereignis, Endpunkt, Versuch, HTTP-Code, Dauer und dem Beginn der Antwort. Der Status ist Warten, Geliefert, Fehlgeschlagen oder Aufgegeben. Verwenden Sie Erneut senden um eine Lieferung erneut zu senden.