Ga naar inhoud
ReigniterDocs
Terug naar de website

Webhooks

Een webhook vertelt een ander hulpmiddel dat er iets is gebeurd in je Reigniter-account. Wanneer het evenement plaatsvindt, stuurt Reigniter een ondertekend JSON-bericht naar het door jou gekozen adres. Dat adres kan de webhook-trigger van een automatisering zijn, een andere workflowtool, of je eigen server.

De Webhooks-pagina met de lijst met evenementenabonnementen
Voeg een abonnement toe en elk evenement wordt naar jouw adres gestuurd zoals ondertekend JSON.
Evenement Label in de app Verzonden wanneer
video.completed Video voltooid Een videorender is voltooid. Het bericht bevat een downloadlink die 7 dagen werkt.
video.failed Video mislukt Een videorender faalt.
training.completed Leerling heeft een module afgerond Een benoemde leerling bereikt het einde van een module, met zijn score en of hij geslaagd is.
training.overdue Leerling te laat Een leerling is nog niet klaar op de deadline.

De volledige lijst staat in Webhooks. Inside Automations heb je geen webhook nodig: de Reigniter triggers (Video voltooid, Leerling geslaagd en de rest) registreren zichzelf.

  1. Open Connectors > Webhooks.

  2. Selecteer Toevoegen.

  3. Kies het evenement.

  4. Plak het adres dat het zou moeten ontvangen. Het moet een openbaar webadres zijn. Adressen op een privénetwerk worden geweigerd.

  5. Selecteer Toevoegen.

  6. Kopieer het signeringsgeheim en bewaar het ergens veilig. Het wordt maar één keer getoond. Selecteer dan Klaar.

Selecteer de testknop op de webhook om een ondertekend testbericht te sturen. Controleer of het op jouw adres aankomt.

Elk bericht wordt ondertekend met jouw signeergeheim. Je ontvangende tool zou de handtekening moeten controleren voordat het het bericht vertrouwt, zodat niemand anders nep-events naar hem kan sturen. Hoe je de handtekening controleert wordt behandeld in de API webhooks-gids.

Elk bericht draagt ook een bezorg-ID die hetzelfde blijft wanneer een levering opnieuw wordt geprobeerd. Gebruik het om duplicaten te negeren.

Elke webhook in de lijst heeft knoppen om:

  • Pauzeer het. Het toont Gepauzeerd en ontvangt niets totdat je het hervat.
  • Verwijder het.
  • Reigniter probeert een mislukte levering een paar keer opnieuw.
  • De webhook toont hoeveel leveringen achter elkaar zijn mislukt, bijvoorbeeld 3 mislukten. Een succesvolle levering reset de telling.
  • Na vele mislukkingen achter elkaar wordt de webhook automatisch gepauzeerd. Herstel het adres en hervat het dan.
  • Een mislukte webhook beïnvloedt je renders nooit.

Webhooks sturen gebeurtenissen uit Reigniter. Om video’s te maken met een andere tool, gebruik je een API-sleutel. Zie Build an automation of de API quickstart.