> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. # Inviare eventi del workspace con i webhook > Invia una richiesta firmata ai tuoi sistemi quando succede qualcosa nel workspace. Crea, attiva, metti in pausa e gestisci i webhook in uscita nelle impostazioni del workspace. 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. > [!WARNING] > > 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](https://docs.base44.com/developers/references/outbound-webhooks/get-started/overview.md). ![La scheda Outgoing con 4 webhook: 2 attivi, 1 in pausa e 1 in attesa](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhooks-list.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=9db3c1b0c640a60be866ef912e96fca4) 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](https://mintcdn.com/base44/Cv0IQGEx6eX2LIU1/images/create-outgoing-webhook.png?fit=max\&auto=format\&n=Cv0IQGEx6eX2LIU1\&q=85\&s=d67e53d0c07a4791f5aab4869bbad414) 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](https://mintcdn.com/base44/61xNA58oJUO_TLT3/images/outgoing-webhook-activate-menu.png?fit=max\&auto=format\&n=61xNA58oJUO_TLT3\&q=85\&s=bd0fe1030aa91e8178100c9dc8474dc7) 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. > [!NOTE] > > 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](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhook-actions-menu.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=93c4093385d7bf5870fa2618d5ea03fe) 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. > [!WARNING] > > **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](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhook-signing-keys.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=8ede530dbaeb433e3fc2c19c1707030e) Le chiavi di firma durante una rotazione *** ## FAQ Clicca su una domanda qui sotto per saperne di più sui webhook in uscita. > **Un webhook può inviare eventi per una sola app?** > > 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. > **Cosa succede se il mio server non è raggiungibile?** > > 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**. > **I webhook usano crediti?** > > No. L'invio di eventi ai tuoi webhook non usa crediti. > **Come fanno i miei sviluppatori a creare un ricevitore?** > > Condividi con loro la [guida per sviluppatori sui webhook in uscita](https://docs.base44.com/developers/references/outbound-webhooks/get-started/overview.md). Copre i [tipi di eventi](https://docs.base44.com/developers/references/outbound-webhooks/get-started/event-types.md), la [verifica delle richieste](https://docs.base44.com/developers/references/outbound-webhooks/get-started/verifying-requests.md) e la [consegna e i nuovi tentativi](https://docs.base44.com/developers/references/outbound-webhooks/get-started/delivery-and-retries.md). > [!NOTE] > > Questa pagina è stata tradotta con l'AI. Per le informazioni più accurate e aggiornate, consulta la [versione inglese](https://docs.base44.com/index.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.