Informare altri sistemi tramite webhook

Un webhook avvisa un altro sistema (per esempio il Suo archivio o il CRM) non appena succede qualcosa in actaSIGN, per esempio quando una richiesta è completata. L’altro sistema recupera poi i dettagli tramite i link contenuti nel messaggio.

Solo per amministratori

Le servono i diritti di amministratore per l’organizzazione.

Dove trovarlo

Amministrazione → Webhook

Consiglio

Il sistema ricevente lo configura di solito un integratore. Gli dia la Guida all’integrazione (pulsante in alto); descrive esattamente che cosa invia actaSIGN.

Configurare un webhook

1. Clicchi su Aggiungi webhook e inserisca un Nome.
2. URL dell’endpoint: l’indirizzo del sistema ricevente. Deve iniziare con https://.
3. Eventi: scelga che cosa viene segnalato. Seleziona tutto seleziona tutti gli eventi di un gruppo.
4. Secret di firma: clicchi su Genera secret e trasmetta subito il valore all’integratore. Viene mostrato una sola volta.
5. Link firmati senza token API: se è attivato, i link nel messaggio funzionano senza accesso API. Scelga allora una Validità dei link il più breve possibile.
6. Clicchi su Salva.

Gli eventi:

Gruppo	Eventi
Attività	Attività attivata, Attività completata, Attività rifiutata, Attività inoltrata, Attività riassegnata, Promemoria inviato
Richiesta di firma	Richiesta avviata, Richiesta completata, Richiesta ritirata, Termine scaduto, Richiesta annullata, Richiesta chiusa

Attenzione

Chi possiede un link firmato può leggere la richiesta, i suoi documenti e il suo protocollo di verifica fino alla scadenza.

Provare e monitorare

1. Aggiungi webhook
2. Prova invia un messaggio di prova all’URL dell’endpoint.
3. Sospendi ferma il webhook senza perdere le impostazioni; Attiva lo riattiva.
4. Il simbolo dell’orologio apre le consegne.

Ogni consegna ha uno stato: In coda, In invio, Consegnato o Non riuscito. Una consegna non riuscita la invia di nuovo con Ripeti.

Buono a sapersi

• Se falliscono molti tentativi di consegna di seguito (di norma 20), actaSIGN sospende il webhook (Sospeso). Finché è sospeso, non riceve messaggi. Quando il sistema ricevente è di nuovo raggiungibile, clicchi su Riattiva. Anche un nuovo URL dell’endpoint lo riattiva.
• Ogni messaggio è firmato con il secret, così il sistema ricevente può verificare che provenga da actaSIGN.
• Con la matita e il cestino modifica o elimina un webhook. Dopo l’eliminazione il sistema non riceve più messaggi; le consegne in coda decadono.

Vedi anche

• Applicazioni (accesso API) in actaPASS