**Per integrare Papo (https://papo.global/) con Zapier, usi l'API REST di Papo per eseguire azioni e i webhook nativi o Flows per inviare eventi da Papo a Zapier. Così, un evento come una nuova conversazione o un affare vinto nel Kanban può attivare automaticamente azioni in centinaia di app collegate a Zapier.** Papo non dipende da un connettore dedicato per funzionare con Zapier: la piattaforma espone endpoint REST e consente di creare webhook, che sono esattamente i meccanismi che Zapier usa per ricevere e inviare dati. Questa guida mostra la connessione in due direzioni: eventi di Papo come trigger in Zapier e chiamate all'API di Papo come azioni. ## Riepilogo dell'integrazione | Risorsa | Cosa fa | Dove configurarlo | | :--- | :--- | :--- | | API REST Papo | Autenticata con chiave segreta; permette di elencare account, istanze, contatti, inviare messaggi e usare l'IA | `https://app.papo.global/api/v1` con chiave generata nel pannello su `https://app.papo.global/developers` | | Webhook nativo | Invia eventi dell'account a un URL configurato | Modulo Automazioni | | Webhook Kanban | Invia eventi della pipeline di vendita a un URL configurato | Modulo Kanban | | Flows | Crea automazioni visuali; un trigger come nuova conversazione può chiamare un'azione webhook | Modulo Flows | | Webhooks by Zapier | Riceve il webhook da Papo e attiva azioni in centinaia di app | Zapier | ## Cosa ti serve prima di iniziare - Un account Papo con accesso al pannello. - Un account Zapier. - La chiave segreta dell'API Papo, creata su `https://app.papo.global/developers`. - Un URL webhook di Zapier per ricevere gli eventi. La chiave segreta segue il formato `sk_live_...` e viene mostrata solo una volta al momento della creazione. Conservala in un luogo sicuro, perché autentica le chiamate all'API. ## Come funziona l'integrazione in due direzioni ### Da Papo a Zapier (trigger) 1. In Zapier, crea uno Zap e scegli **Webhooks by Zapier** come trigger, nell'opzione **Catch Hook**. Zapier genera un URL esclusivo. 2. In Papo, crea un webhook nativo, un webhook Kanban o un Flow con azione webhook. 3. Incolla l'URL di Zapier nel campo di destinazione del webhook o dell'azione. 4. Configura l'evento che deve attivare l'invio. Per le nuove conversazioni, usa un Flow con trigger **Nuova conversazione**. Per gli eventi della pipeline, usa i webhook Kanban. 5. In Zapier, aggiungi l'azione desiderata: inviare email, creare una riga in un foglio di calcolo, registrare un lead in un altro CRM, notificare un canale Slack, ecc. ### Da Zapier a Papo (azione) 1. In Zapier, usa **Webhooks by Zapier** come azione, normalmente con una richiesta personalizzata. 2. Punta alla base `https://app.papo.global/api/v1`. 3. Includi l'header `Authorization: Bearer sk_live_...` o `X-Papo-Secret-Key` e, se vuoi, `X-Papo-Public-Key`. 4. Scegli l'endpoint in base all'azione: `POST /api/v1/messages` per inviare un messaggio WhatsApp, `GET /api/v1/contacts` per elencare i contatti dell'Extrator, `GET /api/v1/instances` per consultare le connessioni WhatsApp, tra gli altri. 5. Mappa i dati provenienti dalle fasi precedenti dello Zap nel corpo della richiesta. ## Esempi pratici di automazione - **Nuova conversazione su WhatsApp genera un lead in un altro sistema:** un Flow attiva un webhook verso Zapier ogni volta che una nuova conversazione arriva in una casella di posta. Zapier formatta i dati e crea il lead nel CRM aziendale. - **Affare vinto nel Kanban aggiorna un foglio di calcolo:** il webhook Kanban invia l'evento a Zapier, che registra la card vinta in un foglio di calcolo o in un sistema finanziario. - **Messaggi programmatici:** Zapier chiama `POST /api/v1/messages` per inviare un promemoria al cliente dopo che ha compilato un modulo in un'altra app. - **Risposte IA:** Zapier può chiamare `POST /api/ai/v1/complete` per generare una risposta con il prompt dell'account Papo e usare il risultato in un altro flusso. ## A chi è utile questa integrazione - **Team di vendita** che devono sincronizzare affari vinti con fogli di calcolo, CRM o strumenti di fatturazione. - **Team di supporto** che usano più canali e vogliono registrare le conversazioni in sistemi di help desk. - **Operazioni di marketing** che attivano campagne da eventi del CRM, come un nuovo contatto estratto. - **Aziende con stack eterogeneo** che vogliono ridurre il lavoro manuale tra WhatsApp, CRM, email e fogli di calcolo. ## Domande frequenti ### Serve un connettore ufficiale di Papo in Zapier? Non è necessario. L'integrazione usa l'API REST e i webhook di Papo, che funzionano con l'app Webhooks by Zapier. I dettagli sugli endpoint disponibili sono nella documentazione dell'API. ### Quali eventi di Papo possono avviare uno Zap? Puoi usare Flows per eventi come nuova conversazione e webhook nativi o Kanban per eventi di automazione e della pipeline di vendita. L'elenco completo dei webhook disponibili appare nel pannello di Papo. ### Come autentico l'API di Papo in Zapier? Usa la chiave segreta nell'header `Authorization: Bearer sk_live_...` o nell'header `X-Papo-Secret-Key`. La chiave pubblica (`pk_live_...`) è opzionale quando inviata insieme a quella segreta. ### Posso inviare messaggi WhatsApp tramite Zapier? Sì. Puoi fare una richiesta a `POST /api/v1/messages` indicando il numero di destinazione e il testo. Il messaggio parte dal WhatsApp collegato al tuo account Papo. ### Zapier può aggiornare le card del Kanban? Sì, tramite API. Papo permette di elencare card, creare card in una fase, spostare card e contrassegnare come vinti o persi, il che può essere attivato da Zapier. ### Cosa fare se il webhook non arriva a Zapier? Verifica che il webhook o il Flow sia attivo, che l'URL di Zapier sia stata incollata correttamente e che la chiave usata nelle chiamate sia valida. I log di esecuzione dei Flows aiutano a identificare l'errore. ## Leggi anche - [Automazioni in Papo: Regole, Macro, Flows e Webhook – quale usare?](/hc/papo/articles/automazioni-papo-regole-macro-flows-webhook-quale-usare) - [Come usare l'API di Papo per elencare conversazioni e inviare messaggi programmatici](/hc/papo/articles/come-usare-api-papo-elencare-conversazioni-inviare-messaggi) --- **[Inizia gratis e collega i tuoi canali →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=come-integrare-papo-con-zapier-usando-api-e-webhook&utm_content=it)** Crea il tuo account gratuito su Papo per centralizzare assistenza, CRM e automazioni in un unico pannello.