Come integrare Papo con Zapier usando API e webhook

Q: 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.

Q: 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.

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)

In Zapier, crea uno Zap e scegli Webhooks by Zapier come trigger, nell'opzione Catch Hook. Zapier genera un URL esclusivo.
In Papo, crea un webhook nativo, un webhook Kanban o un Flow con azione webhook.
Incolla l'URL di Zapier nel campo di destinazione del webhook o dell'azione.
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.
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)

In Zapier, usa Webhooks by Zapier come azione, normalmente con una richiesta personalizzata.
Punta alla base https://app.papo.global/api/v1.
Includi l'header Authorization: Bearer sk_live_... o X-Papo-Secret-Key e, se vuoi, X-Papo-Public-Key.
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.
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.