Come testare la connessione di un webhook di Papo prima di attivare l'automazione

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

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
• Come inviare i dati dei nuovi contatti a Google Sheets tramite webhook

Inizia gratis →

Con il primo utente gratis puoi già creare webhook e testare le integrazioni senza impegno.