Skip to main content
I webhook in uscita avvisano i tuoi sistemi quando qualcosa cambia nel tuo workspace. Quando succede qualcosa, ad esempio viene pubblicata un’app o la chat AI finisce una risposta, Base44 invia una richiesta firmata all’URL che scegli. Così i tuoi sistemi restano aggiornati senza dover controllare le modifiche.
Ti serve un piano Enterprise (Business o Enterprise) per usare i webhook in uscita, e solo i proprietari e gli admin del workspace possono gestirli. Prima i tuoi sviluppatori devono preparare un ricevitore all’URL. Per sapere come crearne uno, consulta la panoramica dei webhook in uscita.
La scheda Outgoing con 4 webhook: 2 attivi, 1 in pausa e 1 in attesa

Webhook in uscita nella pagina Webhooks

​
Creare un webhook

Crea un webhook per ogni URL che deve ricevere eventi. Puoi crearne fino a 10 per workspace. Un nuovo webhook è Pending e non riceve nulla finché non lo attivi. Dopo averlo creato, Base44 mostra la chiave pubblica di firma del tuo workspace. Il tuo ricevitore la usa per confermare che ogni richiesta arriva da Base44. Puoi condividere la chiave con i tuoi sviluppatori in sicurezza. Per creare un webhook:
  1. Clicca il nome del workspace in basso a sinistra e clicca Settings.
  2. Clicca Webhooks nella barra laterale, poi clicca la scheda Outgoing.
  3. Clicca Create webhook.
  4. Inserisci l’Endpoint URL. Deve iniziare con https://.
  5. Sotto Events to send, seleziona gli eventi che questo URL deve ricevere. Ci sono 2 tipi:
    • Eventi delle app: un’app del workspace viene creata, pubblicata, messa offline, spostata nel cestino o ripristinata dal cestino.
    • Eventi della chat AI: la chat AI nell’editor dell’app inizia a lavorare su un messaggio (Chat turn started) o lo termina (Chat turn ended).
  6. (Facoltativo) Inserisci una Description così il tuo team sa a cosa serve il webhook.
  7. Clicca Create webhook.
Il modulo Create webhook con un endpoint URL, 3 eventi selezionati e una descrizione

Creare un webhook

​
Attivare un webhook

L’attivazione invia un evento di test al tuo URL. Il webhook diventa Active quando il ricevitore risponde e restituisce il codice contenuto nell’evento di test. Se l’attivazione non va a buon fine, Base44 ti dice perché. Ad esempio l’endpoint non ha risposto in tempo o non ha restituito il codice. Correggi il ricevitore e attivalo di nuovo. Per attivare un webhook:
  1. Clicca il nome del workspace in basso a sinistra e clicca Settings.
  2. Clicca Webhooks nella barra laterale, poi clicca la scheda Outgoing.
  3. Clicca l’icona More actions accanto al webhook e seleziona Activate.
Un webhook in uscita in attesa con il menu More actions aperto e Activate evidenziato

Attivare un webhook in attesa

​
Gestire i webhook

Metti in pausa un webhook mentre aggiorni il ricevitore, cambia cosa riceve o rimuovilo. Un webhook che non funziona per diversi giorni di fila viene messo in Auto-paused da Base44. Quando il ricevitore funziona di nuovo, riprendilo. Base44 ripete il test di attivazione prima di ricominciare a inviare. Per gestire un webhook:
  1. Clicca il nome del workspace in basso a sinistra e clicca Settings.
  2. Clicca Webhooks nella barra laterale, poi clicca la scheda Outgoing.
  3. Clicca l’icona More actions accanto al webhook e seleziona un’opzione:
    • Send test event: invia un evento di test per controllare il ricevitore.
    • Edit endpoint: modifica l’URL, gli eventi o la descrizione. Se cambi l’URL, le consegne si fermano finché non attivi il nuovo URL.
    • Pause deliveries o Resume deliveries: interrompe o riavvia l’invio. Gli eventi che avvengono mentre un webhook è in pausa non vengono inviati in seguito.
    • Delete endpoint: interrompe subito l’invio all’URL.
Le sottoscrizioni ai vecchi eventi builder.turn_started.v1 e builder.turn_ended.v1 non ricevono più eventi. Seleziona invece Chat turn started e Chat turn ended.
Il menu More actions aperto su un webhook attivo, con Send test event, Edit endpoint, Pause deliveries e Delete endpoint

Gestire un webhook

​
Gestire la chiave di firma

Ogni richiesta è firmata con la chiave del tuo workspace. La rotazione la sostituisce con una nuova. Base44 firma con la vecchia e con la nuova chiave per 24 ore, così il ricevitore continua a funzionare mentre i tuoi sviluppatori aggiungono la nuova chiave. Quando hanno finito, clicca Finish rotation per smettere prima di usare la vecchia chiave.
Revoke fa smettere subito a Base44 di firmare con una chiave. I ricevitori che hanno solo quella chiave rifiutano ogni consegna finché non ricevono quella nuova. Per una modifica di routine, ruota invece la chiave.
Per ruotare la chiave di firma:
  1. Clicca il nome del workspace in basso a sinistra e clicca Settings.
  2. Clicca Webhooks nella barra laterale, poi clicca la scheda Outgoing.
  3. Clicca See public keys.
  4. Clicca Rotate key, poi clicca Rotate key per confermare.
La finestra Public signing keys durante una rotazione, con la chiave attuale, la data di scadenza della vecchia chiave e Finish rotation

Le chiavi di firma durante una rotazione

​
FAQ

Clicca su una domanda qui sotto per saperne di più sui webhook in uscita.
No. Un webhook riceve gli eventi che scegli per ogni app del workspace. Ogni evento indica l’app a cui si riferisce, così il ricevitore può ignorare le app che non gli servono.
Base44 continua a ritentare ogni evento per circa un giorno, aspettando sempre più a lungo tra un tentativo e l’altro. Se il webhook continua a non funzionare per diversi giorni, Base44 lo mette in pausa automaticamente. Quando il server funziona di nuovo, riprendi il webhook dal suo menu More actions.
No. L’invio di eventi ai tuoi webhook non usa crediti.
Questa pagina è stata tradotta con l’AI. Per le informazioni più accurate e aggiornate, consulta la versione inglese.