**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: ```json { "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 - [Come inviare notifiche di nuove conversazioni a Slack usando i Webhook](/hc/papo/articles/come-inviare-notifiche-nuove-conversazioni-slack-webhook) --- **[Inizia gratis su Papo Global →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)** Il primo utente è gratis e puoi già testare l'API e i webhook per automatizzare i tuoi processi senza costi.