Passa al contenuto principale

Webhook

La scheda Webhook serve per gestire i webhook, che consentono di collegare Siesta AI a sistemi e applicazioni esterne. Un webhook fornisce un URL unico, al quale un servizio esterno può inviare richieste HTTP, attivando o influenzando il comportamento del sistema.

Ogni webhook:

  • ha un proprio nome,
  • è associato a una chiave API specifica,
  • può essere attivo o inattivo,
  • ha un URL unico.

I webhook vengono spesso utilizzati come trigger per Workflows, che possono essere attivati da sistemi esterni.

Panoramica dei webhook​

Nella schermata principale della scheda Webhook è visualizzato un elenco di tutti i webhook creati in una tabella.

Colonne visualizzate:

  • Nome – nome del webhook fornito dall'utente
  • URL – URL del webhook generato automaticamente
  • Stato – stato attuale del webhook (Attivo / Inattivo)
  • Azioni – ulteriori opzioni di gestione del webhook (ad es. modifica)

Nella parte superiore della pagina sono disponibili:

  • ricerca dei webhook,
  • pulsante Aggiungi webhook.

Panoramica dei webhook

Creazione di un nuovo webhook​

Cliccando su Aggiungi webhook si apre una finestra di dialogo per creare un nuovo webhook.

Campi del modulo

  • Nome – campo obbligatorio per inserire il nome del webhook (ad es. Webhook)
  • Attivo – interruttore che consente di attivare immediatamente il webhook o lasciarlo inattivo
  • Chiave API – selezione della chiave API con cui il webhook sarà autorizzato (ad es. chiave API per il mio script Python)

Azioni

  • Annulla – chiude la finestra di dialogo senza creare il webhook
  • Crea – crea un nuovo webhook e genera il suo URL

Creazione del webhook

Dettagli del webhook​

Dopo aver aperto un webhook specifico, viene visualizzata la sua pagina di dettaglio.

Informazioni visualizzate:

  • nome del webhook,
  • stato (attivo / inattivo),
  • URL del webhook – indirizzo unico che può essere copiato con un clic.

Dal dettaglio del webhook è possibile:

  • modificare le impostazioni del webhook,
  • cambiare il suo stato attivo,
  • utilizzare l'URL del webhook in applicazioni esterne o in Workflows.

Dettagli del webhook

Stato del webhook​

Lo stato del webhook determina se il webhook è pronto a ricevere richieste:

  • Attivo – il webhook è acceso e disponibile
  • Inattivo – il webhook è spento e le richieste non vengono elaborate

Lo stato è visibile sia nella panoramica dei webhook che nei dettagli del webhook.

Utilizzo tipico dei webhook​

I webhook vengono utilizzati principalmente per:

  • integrare Siesta AI con applicazioni esterne,
  • avviare processi automatizzati,
  • collegare script personalizzati (ad es. Python),
  • trasferire dati tra sistemi in tempo reale.

I webhook in Siesta AI offrono un modo semplice e sicuro per collegare la piattaforma a sistemi esterni. Grazie a una gestione chiara, al legame con le chiavi API e alla possibilità di attivazione o disattivazione, i webhook possono essere facilmente controllati e gestiti. Se utilizzi il webhook come trigger, ti consigliamo di collegarne l'uso a Workflows.