Webhook

Un webhook informa un altro strumento che qualcosa è successo nel tuo account Reigniter. Quando l’evento avviene, Reigniter invia un messaggio JSON firmato all’indirizzo che scegli. Quell’indirizzo può essere il trigger di un webhook di un’automazione, un altro strumento di workflow o il tuo server personale.

Aggiungi un abbonamento e ogni evento viene inviato al tuo indirizzo come JSONfirmato.

Eventi

Evento	Etichetta nell’app	Inviato quando
video.completed	Video completato	Un render video termina. Il messaggio porta un link di download che funziona per 7 giorni.
video.failed	Video guasto	Un rendering video fallisce.
training.completed	Lo studente ha completato un modulo	Un studente con nome raggiunge la fine di un modulo, con il suo punteggio e se ha superato.
training.overdue	Apprendente in ritardo	Uno studente non ha finito entro la scadenza.

L’elenco completo è in Webhook. All’interno delle Automazioni non hai bisogno di un webhook: i Reigniter trigger (Video terminato, Learner superato e il resto) si registrano da soli.

Aggiungi un webhook

1. Connettori > ragazzi a tela.

2. Seleziona Aggiungi.

3. Scegli l’evento.

4. Incolla l’indirizzo che dovrebbe riceverlo. Deve essere un indirizzo web pubblico. Gli indirizzi su una rete privata vengono rifiutati.

5. Seleziona Aggiungi.

6. Copia il segreto della firma e conservalo in un posto sicuro. Viene mostrato solo una volta. Poi seleziona Fatto.

Controlla che funzioni

Seleziona il pulsante test sul webhook per inviare un messaggio di test firmato. Controlla che arrivi al tuo indirizzo.

Verifica ogni messaggio

Ogni messaggio è firmato con il tuo segreto di firma. Il tuo strumento di ricezione dovrebbe controllare la firma prima di fidarsi del messaggio, così nessun altro può inviargli eventi falsi. Come controllare la firma è trattato nella guida API webhooks.

Ogni messaggio porta anche un ID di consegna che rimane lo stesso quando una consegna viene riprovata. Usalo per ignorare i duplicati.

Pausa, riprendi o cancella

Ogni webhook nella lista ha dei pulsanti per:

• Metti in pausa. Mostra Messo in pausa e non riceve nulla finché non riprendi.
• Cancellalo.

Quando le consegne falliscono

• Reigniter riprova una consegna fallita alcune volte.
• Il webhook mostra quante consegne consecutive sono fallite, ad esempio 3 fallite. Una consegna riuscita azzera il conteggio.
• Dopo molti fallimenti consecutivi, il webhook viene messo in pausa automaticamente. Fissa l’indirizzo, poi riprendilo.
• Un webhook fallito non influisce mai sui tuoi render.

Fai video con un altro strumento

I webhook inviano eventi fuori da Reigniter. Per creare video da un altro strumento, usa una chiave API. Vedi Costruisci un’automazione o il API quickstart.