Webhooks

Ein Webhook teilt einem anderen Tool mit, dass in Ihrem Reigniter-Konto etwas passiert ist. Wenn das Ereignis auftritt, sendet Reigniter eine signierte JSON-Nachricht an die von Ihnen gewählte Adresse. Diese Adresse kann der Webhook-Trigger einer Automatisierung, ein weiteres Workflow-Tool oder Ihr eigener Server sein.

Veranstaltungen

Veranstaltung	Etikett in der App	Gesendet, wann
video.completed	Video abgeschlossen	Ein Video-Rendering ist abgeschlossen. Die Nachricht enthält einen Download-Link, der 7 Tage lang funktioniert.
video.failed	Video fehlgeschlagen	Ein Videorendering fehlschlägt.
training.completed	Der Lernende hat ein Modul abgeschlossen	Ein benannter Lernender erreicht das Ende eines Moduls, mit seiner Punktzahl und ob er bestanden hat.
training.overdue	Lernender überfällig	Ein Lernender hat bis zum Abgabetermin nicht abgeschlossen.

Die vollständige Liste findet sich in Webhooks. Innerhalb von Automatisierungen benötigt man keinen Webhook: Die Reigniter Trigger (Video fertig, Lerner bestanden und die resten) registrieren sich selbst.

Fügen Sie einen Webhook hinzu

1. Offene Connectoren > Webhooks.

2. Auswählen Sie Hinzufügen.

3. Wähle das Ereignis aus.

4. Füge die Adresse ein, die sie empfangen sollte. Es muss eine öffentliche Webadresse sein. Adressen in einem privaten Netzwerk werden abgelehnt.

5. Auswählen Sie Hinzufügen.

6. Kopiere das Signiergeheimnis und bewahre es an einem sicheren Ort auf. Es wird nur einmal angezeigt. Dann wähle Fertig.

Überprüfe, ob es funktioniert

Wähle die Test-Schaltfläche auf dem Webhook, um eine signierte Testnachricht zu senden. Überprüfe, ob sie an deiner Adresse ankommt.

Verifizieren Sie jede Nachricht

Jede Nachricht ist mit deinem Signing-Secret signiert. Dein Empfangstool sollte die Signatur überprüfen, bevor es der Nachricht vertraut, damit niemand sonst gefälschte Ereignisse an es senden kann. Wie man die Signatur überprüft, wird im API Webhooks-Guide behandelt.

Jede Nachricht trägt außerdem eine Zustell-ID, die gleich bleibt, wenn eine Zustellung erneut versucht wird. Nutze sie, um Duplikate zu ignorieren.

Pausieren, fortsetzen oder löschen

Jeder Webhook in der Liste hat Buttons, um:

• Pausiere sie. Es zeigt Pause an und erhält nichts, bis du es fortsetzt.
• Lösch es.

Wenn Lieferungen scheitern

• Reigniter versucht eine fehlgeschlagene Lieferung mehrmals.
• Der Webhook zeigt, wie viele Lieferungen in Folge fehlgeschlagen sind, zum Beispiel sind 3 fehlgeschlagen. Eine erfolgreiche Lieferung setzt die Zählung zurück.
• Nach vielen Fehlschlägen in Folge wird der Webhook automatisch pausiert. Adressadresse korrigieren und dann wieder aufnehmen.
• Ein fehlgeschlagener Webhook beeinflusst deine Renderings nie.

Mach Videos mit einem anderen Tool

Webhooks senden Ereignisse aus Reigniter. Um Videos mit einem anderen Tool zu erstellen, verwenden Sie eine API-Taste. Siehe Build an automation oder den API Quickstart.