I webhook in uscita

Come ricevere una notifica firmata sul tuo endpoint ogni volta che succede un evento in Accordyx, con retry automatici.

Prima di iniziare: Permesso «Gestisci integrazioni e API».

Un webhook ti avvisa in tempo reale quando succede qualcosa in Accordyx — un contratto creato, firmato, una scadenza in arrivo — inviando un POST JSON firmato al tuo endpoint, invece di doverlo interrogare ripetutamente con l'API.

Creare un webhook

Nel tab Webhook, premi Nuovo webhook.
Inserisci l'URL del tuo endpoint: deve essere https e pubblicamente raggiungibile (indirizzi locali o privati vengono rifiutati).
Spunta gli eventi a cui vuoi iscriverti (di default sono selezionati tutti): «Contratto creato», «Contratto firmato», «Stato contratto cambiato», «Scadenza in arrivo», «Controparte creata», «Controparte aggiornata», «Approvazione conclusa», «Firma completata».
Premi Crea webhook e, nel dialog Webhook creato, copia subito il secret mostrato: ti serve per verificare le firme e non sarà più visibile dopo la chiusura del dialog.

Verificare la firma

Ogni consegna include l'header X-Accordyx-Signature: t=<timestamp>,v1=<firma>. La firma è un HMAC-SHA256 calcolato col tuo secret sulla stringa timestamp + "." + corpo della richiesta; scarta le richieste con timestamp più vecchio di 5 minuti per proteggerti da eventuali replay.

Gestire i webhook attivi

Per ogni endpoint iscritto puoi:

Premere Test per inviare subito un evento di prova e verificare che il tuo endpoint risponda correttamente.
Usare lo switch per sospendere o riattivare temporaneamente le consegne.
Eliminarlo dal cestino: l'endpoint smette di ricevere eventi e l'operazione non è reversibile.

Il registro delle consegne

In fondo alla pagina trovi le ultime 50 consegne, con tipo di evento, esito ("in coda", "consegnato", "fallito", "abbandonato"), numero di tentativi ed eventuale codice HTTP di errore. Premi Aggiorna per rinfrescare.

Limiti

Puoi avere fino a 20 webhook attivi per organizzazione. Ogni consegna fallita viene ritentata fino a 10 volte con un'attesa crescente tra un tentativo e l'altro; dopo l'ultimo tentativo fallito lo stato passa ad "abbandonato". Se il tuo endpoint risponde con HTTP 410, Accordyx interpreta che non vuoi più ricevere eventi e disattiva la sottoscrizione in automatico.

Problemi comuni

"Inserisci l'URL https dell'endpoint" / "Seleziona almeno un evento" — completa entrambi i campi prima di creare il webhook.
"Test fallito (HTTP ): " — il tuo endpoint non ha risposto correttamente: controlla che sia raggiungibile e che accetti richieste POST.