Vai al contenuto
AurionAI

Webhook di notifica

4 min di letturaDi Emmanuel Yazbeck

Un webhook di notifica invia gli eventi di notifica di AurionAI a un altro sistema, ad esempio uno strumento di chat. AurionAI pubblica ogni evento come corpo JSON all'indirizzo che inserisci.

Disponibilità: profili Helpdesk e AI Voice + Helpdesk. Solo amministratori.

Prerequisiti

  • Hai il ruolo Proprietario o Amministratore. Gli altri utenti visualizzano Accesso negato.
  • La tua organizzazione utilizza il profilo Helpdesk o AI Voice + Helpdesk.
  • Un indirizzo HTTPS pubblico che accetta richieste POST con un corpo JSON.

Aprire i webhook di notifica

  1. Nella barra laterale, seleziona Configurazione.
  2. Apri la categoria Sistema.
  3. Seleziona Webhook di notifica.

La pagina Webhook di notifica con l'elenco dei webhook.

Aggiungere un webhook

  1. Seleziona Aggiungi webhook.
  2. In Nome, digita un nome.
  3. In URL, digita l'indirizzo. Deve iniziare con https://.
  4. Facoltativo: in Segreto (opzionale), digita un segreto. AurionAI firmerà quindi ogni richiesta. Lascia vuoto per inviare richieste non firmate.
  5. Scegli gli eventi:
    • Per ricevere ogni evento di notifica, attiva Iscriviti a tutti gli eventi.
    • Altrimenti, seleziona gli eventi nell'elenco.
  6. Seleziona Crea.

Appare il messaggio Webhook creato. Un nuovo webhook è Abilitato.

Testare il webhook

  1. Sul webhook, seleziona Testa.
  2. Nella finestra di dialogo Inviare un payload di test?, seleziona Invia test.

AurionAI invia immediatamente un evento webhook.test. Appare il messaggio Payload di test inviato correttamente o Invio del payload di test non riuscito.

Verificare la firma

Quando il webhook ha un segreto, ogni richiesta contiene due intestazioni aggiuntive:

  • X-Webhook-Timestamp: l'ora della richiesta, in secondi dal 1° gennaio 1970 (UTC).
  • X-Webhook-Signature: sha256= seguito dalla firma.

Per verificare una richiesta, calcola un HMAC-SHA256 del timestamp, un punto e il corpo grezzo, utilizzando il tuo segreto. Scrivi il risultato in esadecimale. Deve essere uguale alla parte dopo sha256=.

Modificare, disabilitare o eliminare un webhook

  • Per modificare un webhook, seleziona Modifica webhook, modifica i campi e seleziona Salva. Lascia il segreto vuoto per mantenerlo, oppure seleziona Rimuovi segreto per inviare richieste non firmate.
  • Per interrompere temporaneamente le consegne, apri Modifica webhook e porta l'interruttore su Disabilitato. Poi salva.
  • Per rimuovere un webhook, seleziona Elimina. Nella finestra di dialogo Eliminare questo webhook?, seleziona Elimina webhook. Questa operazione rimuove anche la cronologia delle consegne e il segreto. Non è possibile annullare questa azione.
  • Per visualizzare le consegne precedenti, seleziona Cronologia sul webhook. Ogni riga mostra Consegnato, Non riuscito o Ignorato, con il motivo dell'errore.

Risultato

AurionAI invia ogni evento selezionato nel momento in cui si verifica. Se il tuo indirizzo non risponde, o risponde con uno stato 5xx, AurionAI riprova immediatamente, fino a un massimo di tre tentativi in totale. Una risposta 4xx è definitiva: AurionAI non riprova.

In caso di problemi

  • L'URL deve iniziare con https://. Inizia l'indirizzo con https://.
  • Gli endpoint dei metadati cloud sono sempre bloccati. o un messaggio che indica che un indirizzo IP si trova in un intervallo bloccato. AurionAI non invia webhook a indirizzi privati o interni. Utilizza un indirizzo pubblico.
  • Un messaggio indica che la risoluzione DNS non è riuscita. Il nome host non esiste o non ha record DNS. Controlla l'indirizzo.
  • Selezioni almeno un evento oppure scelga «Iscriviti a tutti gli eventi». Seleziona almeno un evento oppure attiva Iscriviti a tutti gli eventi.
  • Invio del payload di test non riuscito Leggi il motivo, lo stato HTTP e il numero di tentativi nel messaggio. Verifica che il tuo ricevitore sia online e risponda con uno stato 2xx.
  • Questo webhook è disabilitato Abilita prima il webhook. Se selezioni Invia comunque, AurionAI registra solo un tentativo ignorato.
  • Una consegna mostra Ignorato. Il webhook era disabilitato oppure l'indirizzo non ha superato il controllo di sicurezza prima dell'invio. Leggi il motivo nella cronologia.
  • Impossibile caricare i webhook o Impossibile caricare gli eventi di notifica Seleziona Riprova.

Articoli correlati

Hai ancora bisogno di aiuto? Invia una richiesta o .