Per integrare Papo (https://papo.global/) con n8n e automatizzare i processi, puoi utilizzare le chiavi API della piattaforma per inviare dati dei contatti, gestire conversazioni o attivare azioni, e anche configurare webhook nei Flussi di Automazione affinché Papo notifichi n8n ogni volta che si verifica un evento, come un nuovo messaggio o un lead qualificato.
Papo offre due modi principali per comunicare con n8n, una delle piattaforme di automazione più popolari. Il primo è l'API, che consente a n8n di effettuare chiamate attive verso Papo (ad esempio, per creare un contatto o inviare un messaggio). Il secondo sono i webhook, che fanno il percorso inverso: Papo invia automaticamente informazioni a n8n quando accade qualcosa all'interno di un flusso di assistenza.
| Metodo di Integrazione | Direzione | Uso Principale | Come Configurare |
|---|---|---|---|
| API di Papo | n8n → Papo | Inviare comandi a Papo (creare contatto, inviare messaggio, cercare dati). | Generare una chiave segreta nel pannello Papo e usare il nodo HTTP Request di n8n con autenticazione Bearer. |
| Webhook di Papo | Papo → n8n | Ricevere notifiche automatiche da Papo quando si verifica un evento (nuova conversazione, lead qualificato). | Creare un nodo Webhook in n8n per generare un URL e configurare l'azione "Invia Webhook" in un Flow di Papo. |
Come funziona l'integrazione tramite API
L'API di Papo è la porta d'ingresso affinché n8n esegua azioni sul tuo account in modo programmatico. Con essa, puoi automatizzare attività come sincronizzare contatti con un CRM esterno, inviare messaggi WhatsApp da un trigger o estrarre dati dei lead.
1. Genera le tue chiavi API su Papo
Accedi al tuo pannello Papo e vai su Impostazioni. Nella sezione Sviluppatori o API, troverai la tua Chiave Pubblica (fissa) e potrai generare una Chiave Segreta. Assegna un nome descrittivo (es.: "Integrazione n8n") e copia immediatamente la chiave segreta — verrà mostrata solo una volta.
2. Configura il nodo HTTP Request in n8n
All'interno di un workflow in n8n, aggiungi un nodo HTTP Request. Nel campo URL, utilizza l'endpoint desiderato dell'API di Papo. L'URL di base è:
https://app.papo.global/api/v1
Per autenticarti, aggiungi un header Authorization con il valore Bearer sk_live_TUA_CHIAVE_SEGRETA. Un buon test iniziale è chiamare l'endpoint /me, che restituisce i dati del tuo account:
GET https://app.papo.global/api/v1/me
Authorization: Bearer sk_live_...
3. Crea il tuo flusso di automazione
Con l'autenticazione funzionante, puoi creare workflow completi. Ad esempio:
- Nuovo lead dal modulo → creare contatto in Papo: un nodo Webhook in n8n riceve i dati del modulo, e un nodo HTTP Request chiama l'API di Papo per creare il contatto.
- Cercare contatti estratti e inviarli a un foglio di calcolo: n8n consulta periodicamente la lista dei contatti dell'Estrattore e li inserisce in Google Sheets.
L'API di Papo permette di cercare, creare e aggiornare contatti, inviare messaggi WhatsApp, elencare esecuzioni dell'Estrattore e molto altro. La documentazione completa con tutti gli endpoint è disponibile su papo.global/pt/docs.
Come funziona l'integrazione tramite Webhook
I webhook sono ideali per reagire in tempo reale agli eventi che accadono all'interno di Papo. Configuri un Flow per inviare una notifica automatica a n8n ogni volta che un contatto raggiunge una fase specifica.
1. Crea un trigger Webhook in n8n
Nell'editor di n8n, aggiungi un nodo Webhook come trigger del tuo workflow. Scegli il metodo POST e copia l'URL di produzione generato. Questo URL sarà la destinazione dei dati inviati da Papo.
2. Configura l'azione "Invia Webhook" nel Flow di Papo
All'interno dell'editor di Flow di Papo, aggiungi il nodo di azione "Invia Webhook" nel punto del percorso in cui desideri che avvenga la notifica (ad esempio, subito dopo che un lead risponde a una domanda di qualificazione).
Compila i campi:
- URL del Webhook: incolla l'URL copiato da n8n.
- Metodo HTTP: seleziona
POST. - Corpo (Payload): crea un JSON con le variabili del contatto che vuoi inviare. Esempio:
{
"nome": "{{contact.name}}",
"email": "{{contact.email}}",
"telefono": "{{contact.phone}}",
"fase": "Lead qualificato",
"origine": "Flow di Benvenuto"
}
3. Testa e attiva
Prima di pubblicare, fai un test con un URL di servizio come Webhook.site per verificare che i dati arrivino correttamente. Poi, sostituiscilo con l'URL di n8n e attiva il Flow. Da quel momento, ogni volta che un contatto passa attraverso questo nodo, n8n riceverà i dati e potrà eseguire azioni come registrare il lead in un CRM, inviare un'e-mail o aggiornare un foglio di calcolo.
A chi è destinata questa integrazione
La connessione tra Papo e n8n è utile per le aziende che già utilizzano Papo come centrale di assistenza e vendite su WhatsApp e hanno bisogno di collegare questi processi ad altri sistemi senza dipendere dallo sviluppo interno. Agenzie di marketing, team di vendita e operazioni di supporto possono, ad esempio, sincronizzare automaticamente i contatti tra Papo e un ERP, lanciare campagne segmentate o creare dashboard personalizzate.
Domande Frequenti (FAQ)
Devo saper programmare per integrare Papo con n8n?
No. n8n è uno strumento visuale di automazione, e la configurazione dell'API o del webhook si effettua compilando campi e componendo piccoli blocchi JSON. Conoscenze di base delle API REST aiutano, ma non sono obbligatorie.
Quali azioni di Papo posso automatizzare con l'API?
Puoi cercare, creare e aggiornare contatti, inviare messaggi WhatsApp, elencare i contatti estratti dall'Estrattore, consultare i dati delle esecuzioni e molto altro. L'elenco completo è nella documentazione ufficiale.
Il webhook di Papo invia i dati in tempo reale?
Sì. Non appena il contatto raggiunge il nodo "Invia Webhook" in un Flow attivo, Papo invia immediatamente la richiesta all'URL configurato.
Posso usare l'API per creare un contatto nel CRM a partire da un modulo sul mio sito?
Sì. Basta configurare un nodo Webhook in n8n per catturare i dati del modulo e, successivamente, un nodo HTTP Request per chiamare l'API di Papo e creare il contatto con le informazioni ricevute.
Dove trovo la documentazione completa dell'API di Papo?
La documentazione tecnica con tutti gli endpoint, parametri ed esempi è disponibile su papo.global/pt/docs.
L'API e i webhook sono disponibili nel piano gratuito?
Sì, sia l'API che i webhook fanno parte della piattaforma e possono essere utilizzati da qualsiasi account Papo. Puoi iniziare gratuitamente con il primo utente e testare tutte le integrazioni.
Leggi anche
Inizia gratis su Papo Global →
Il primo utente è gratis e puoi già testare l'API e i webhook per automatizzare i tuoi processi senza costi.