**Per testare la connessione di un webhook di Papo (https://papo.global/) prima di attivare l'automazione, puoi usare uno strumento esterno come Webhook.site per validare l'URL di destinazione, verificare il formato del payload JSON e correggere errori di invio senza influire sui contatti reali. Questo processo funziona sia per i webhook nativi dell'account sia per l'azione "Invia Webhook" all'interno dei Flow di Automazione.** La validazione anticipata evita che un'integrazione non funzionante perda dati o interrompa i percorsi dei clienti. Con un URL di test temporaneo, puoi ispezionare esattamente ciò che Papo sta inviando — header, corpo e codici di risposta — e apportare modifiche prima di puntare al sistema finale. ## Riepilogo del processo di test | Fase | Azione | Strumento / posizione | | :--- | :--- | :--- | | 1. Ottenere un URL di test | Accedi a webhook.site e copia l'URL generato. | Webhook.site | | 2. Configurare il webhook in Papo con l'URL di test | Inserisci l'URL nel campo di destinazione del webhook (nella sezione Integrazioni o nell'azione del Flow). | Pannello di Papo | | 3. Attivare il webhook | Per i webhook dell'account, invia un messaggio WhatsApp alla casella connessa. Per i webhook nei Flow, iscrivi un contatto di test al flusso. | Posta in arrivo o Flow | | 4. Analizzare il payload ricevuto | Nel pannello di Webhook.site, visualizza la richiesta arrivata: metodo, header e il JSON del corpo. | Webhook.site | | 5. Correggere e sostituire con l'URL di produzione | Se il payload è corretto, sostituisci l'URL di test con l'URL reale del tuo sistema e attiva l'automazione. | Pannello di Papo | ## Come testare i webhook dell'account (Integrazioni) I webhook nativi di Papo si attivano a ogni nuovo messaggio ricevuto in una casella di posta. Per validarli senza rischi: 1. Nel pannello di Papo, accedi a **Impostazioni > Integrazioni > Webhook** e crea un nuovo webhook. 2. Definisci il trigger — ad esempio, **Tutti i messaggi** — e nel campo **URL**, incolla l'indirizzo temporaneo di Webhook.site. 3. Salva il webhook. 4. Invia un messaggio di test (tramite WhatsApp o un altro canale connesso) alla casella di posta monitorata. 5. Su Webhook.site, aggiorna il pannello e individua la richiesta appena arrivata. Verifica il corpo JSON: deve contenere dati come il numero del mittente, il contenuto del messaggio e l'ID della conversazione. 6. Se il JSON è vuoto o malformato, rivedi il trigger scelto e conferma che il messaggio sia stato effettivamente ricevuto dalla casella. 7. Dopo la validazione, modifica il webhook e sostituisci l'URL con quello del tuo sistema di destinazione. ## Come testare l'azione "Invia Webhook" nei Flow di Automazione Nell'editor dei Flow, l'azione **Invia Webhook** permette di inviare dati in una fase specifica del percorso. Il test viene eseguito con un flusso temporaneamente attivo e un contatto di controllo: 1. Crea il Flow e aggiungi il nodo **Invia Webhook** nel punto desiderato. 2. Nel pannello di configurazione del nodo, inserisci l'**URL** con l'indirizzo di Webhook.site, scegli il metodo **POST** e componi il corpo JSON usando variabili di Papo, come `{{contact.name}}` e `{{contact.phone}}`. 3. Attiva il Flow. 4. Nel CRM, iscrivi manualmente un contatto di test a questo flusso (seguendo la stessa procedura per testare i Flow di automazione). 5. Monitora la cronologia delle esecuzioni del Flow e, allo stesso tempo, osserva Webhook.site. 6. La richiesta ricevuta deve mostrare il JSON con i valori reali del contatto di test, sostituendo le variabili. In caso contrario, verifica il corpo (usa `"nome": "{{contact.name}}"` e assicurati che il contatto abbia i campi compilati). 7. Se la richiesta restituisce un errore 4xx o 5xx, controlla se il metodo è corretto (normalmente POST) e se l'header `Content-Type: application/json` è stato incluso. 8. Dopo la validazione, disattiva il Flow, sostituisci l'URL di destinazione con l'URL di produzione e attivalo di nuovo. ## A chi è indicato questo processo - **Amministratori e analisti di sistema** che devono garantire l'integrità delle integrazioni prima di rilasciarle. - **Team che costruiscono Flow con webhook per CRM, fogli di calcolo o strumenti di automazione** e vogliono eseguire il debug del payload senza impattare sui lead reali. - **Qualsiasi utente che personalizza i webhook dell'account** e desidera confermare che gli eventi vengano inviati correttamente. ## Domande frequenti ### Posso testare il webhook senza inviare un messaggio reale? Non è possibile per i webhook dell'account, perché vengono attivati da messaggi in entrata. Usa un numero WhatsApp di test (tuo o di un collega) per generare l'evento. Per i Flow, invece, l'iscrizione manuale di un contatto di controllo consente il test senza che il lead sia un cliente reale. ### Webhook.site è gratuito? Devo usarlo in produzione? Sì, Webhook.site genera URL pubblici temporanei e mostra il traffico in tempo reale, ideali per il debug. Non usare mai questi URL in produzione — dopo il test, sostituiscili con l'URL del sistema di destinazione. ### Il webhook si è attivato ma il payload è vuoto. Cosa verificare? Per i webhook dell'account, controlla il trigger (se sta catturando il tipo di messaggio corretto) e i permessi della casella. Per l'azione del Flow, rivedi le variabili nel corpo — campi come {{contact.name}} verranno compilati solo se il contatto ha il campo nome registrato. Testa con un contatto che abbia dati completi. ### Come correggere errori 401 (non autorizzato) o 403 (proibito)? Questi errori indicano che il sistema di destinazione ha rifiutato la richiesta. Aggiungi un header di autenticazione (ad esempio, `Authorization: Bearer tuo-token`) nel campo **Headers** della configurazione del webhook, come indicato dalla documentazione dello strumento esterno. ### Posso testare i webhook del Kanban allo stesso modo? Sì. I webhook configurati nel modulo Kanban possono essere testati con un URL temporaneo di Webhook.site — basta spostare una scheda da una colonna all'altra (azione che attiva l'evento) e ispezionare il payload nel pannello di test. ### Devo mantenere il Flow attivo per testare il webhook? Sì. Solo i Flow con stato **Attivo** elaborano il nodo webhook. Attiva il flusso, esegui il test e disattivalo subito dopo se necessario. ## Leggi anche - [Come testare un Flow di automazione prima di attivarlo](/hc/papo/articles/come-testare-un-flow-di-automazione-prima-di-attivarlo) - [Come inviare i dati dei nuovi contatti a Google Sheets tramite webhook](/hc/papo/articles/come-inviare-dati-nuovi-contatti-google-sheets-webhook) --- **[Inizia gratis →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=testare-connessione-webhook-papo-prima-attivare-automazione&utm_content=it)** Con il primo utente gratis puoi già creare webhook e testare le integrazioni senza impegno.