Come esportare i dati delle conversazioni su Google Sheets tramite webhook

Per esportare automaticamente i dati delle conversazioni — come nome del contatto, canale, testo del messaggio e agente responsabile — su Google Sheets, utilizza il modulo Flows di Papo (https://papo.global/) per creare un'automazione con trigger di nuova conversazione e un'azione webhook. Il webhook invia i dati a un URL preparato in Google Sheets tramite una piattaforma di automazione (Zapier, Make) o un Google Apps Script.

Questa integrazione elimina la raccolta manuale delle metriche di assistenza e mantiene un foglio di calcolo sempre aggiornato con ogni interazione che entra nelle tue caselle di posta in arrivo. Con i dati centralizzati, puoi creare dashboard in Google Sheets o Looker Studio per monitorare il volume per canale, gli orari di punta, il carico degli agenti e molto altro.

Panoramica dell'integrazione

Fase	Dove avviene	Cosa fa
1. Preparare la destinazione	Google Sheets + intermediario	Creare il foglio di calcolo e generare un URL webhook con Zapier, Make o Google Apps Script.
2. Creare il trigger	Papo (Flows)	Definire l'evento "Nuova conversazione" (o "Messaggio ricevuto") per avviare l'automazione.
3. Configurare il webhook	Papo (Flows)	Aggiungere l'azione webhook con l'URL di destinazione e il corpo in JSON contenente i dati della conversazione.
4. Ricevere e registrare	Google Sheets	L'URL riceve il payload e inserisce una nuova riga nel foglio di calcolo con le informazioni della conversazione.
5. Creare dashboard	Google Sheets / Looker Studio	Utilizzare i dati accumulati per generare grafici di volume, conversione per canale, prestazioni degli agenti, ecc.

Come funziona – passo dopo passo

1. Preparare Google Sheets per ricevere i dati

Papo non genera l'URL di Google Sheets. Devi creare un endpoint che riceva il JSON inviato dal webhook e salvi i dati nel foglio di calcolo. I due modi più comuni sono:

Opzione A – Piattaforma di automazione senza codice (consigliata)
Strumenti come Zapier o Make permettono di creare un "Catch Webhook", che genera un URL univoco. Poi, aggiungi un'azione per "Aggiungi riga" in Google Sheets, mappando i campi ricevuti alle colonne del foglio di calcolo. Questa opzione non richiede programmazione e gestisce l'autenticazione con Google.

Opzione B – Google Apps Script
In Google Sheets, accedi a Estensioni > Apps Script, incolla un codice con la funzione doPost(e) che interpreta il JSON e inserisce i dati. Distribuisci come "App web" con accesso "Chiunque" e copia l'URL generato. Questa alternativa offre più controllo, ma richiede una conoscenza di base di JavaScript.

2. Creare il Flow in Papo con il trigger adatto

Accedi al modulo Flows nel pannello di Papo e crea una nuova automazione.

Trigger: scegli l'evento "Nuova conversazione" in modo che il webhook si attivi ogni volta che un contatto avvia una conversazione in una casella di posta in arrivo. Se preferisci catturare ogni singolo messaggio, utilizza il trigger "Messaggio ricevuto" e, se necessario, applica filtri (per canale, parola chiave, ecc.).
Casella di posta in arrivo: seleziona la casella desiderata (WhatsApp, Instagram, e-mail, ecc.) per limitare l'invio solo alle conversazioni di quel canale.

3. Configurare l'azione webhook

Aggiungi un passaggio di tipo Webhook e compila:

URL: incolla l'indirizzo generato in Zapier, Make o Apps Script.
Metodo: mantieni POST.
Corpo (Body): definisci il JSON con le variabili della conversazione che desideri esportare. Esempio:

{
  "nome_contato": "{{contact.name}}",
  "canal": "{{inbox.name}}",
  "texto_mensagem": "{{message.text}}",
  "agente": "{{agent.name}}",
  "data_evento": "{{timestamp}}"
}

Le variabili disponibili possono essere consultate nella documentazione del modulo Flows. Se il sistema di destinazione richiede intestazioni specifiche (come Content-Type: application/json o token di autenticazione), aggiungile nel campo headers.

4. Testare e attivare il Flow

Prima di mettere in produzione, fai un test:

Sostituisci temporaneamente l'URL di destinazione con un URL di test (es.: Webhook.site).
Avvia una conversazione nella casella di posta in arrivo configurata.
Verifica che il payload arrivi correttamente, con tutti i campi e i valori attesi.
Sostituisci con l'URL definitivo e attiva il Flow.

Da questo momento in poi, ogni nuova conversazione (o messaggio, a seconda del trigger) sarà registrata automaticamente nel tuo foglio di calcolo Google Sheets.

A chi è utile questa integrazione

Analisti di dati e BI che devono consolidare metriche di assistenza senza esportazioni manuali.
Manager delle operazioni che desiderano dashboard con volume di conversazioni per canale, orario di punta e carico degli agenti.
Team di marketing e vendite che vogliono incrociare i dati delle conversazioni con campagne e funnel nel CRM.
Aziende che già usano Google Sheets come hub di informazioni e desiderano alimentarlo automaticamente con i dati dell'assistenza.

Domande frequenti

Devo saper programmare per configurare il webhook?

Non necessariamente. Con Zapier o Make, l'integrazione avviene senza codice. Solo l'opzione Google Apps Script richiede una conoscenza di base di JavaScript.

I dati vengono inviati in tempo reale?

Sì. Non appena il trigger configurato nel Flow viene attivato (es.: nuova conversazione), il webhook invia immediatamente i dati all'URL configurato.

Quali informazioni posso inviare a Google Sheets?

Puoi inviare nome del contatto, canale di origine, testo del messaggio, agente responsabile, data/ora e altre variabili disponibili nel Flow. Consulta la documentazione del modulo Flows per vedere tutte le opzioni.

Posso testare prima di attivare il Flow?

Sì. Consigliamo di utilizzare un URL di test (come Webhook.site) per validare l'invio prima di puntare al Google Sheets definitivo.

Papo fornisce l'URL del webhook?

No. L'URL deve essere creato in Zapier, Make o Google Apps Script. Papo invia solo i dati all'indirizzo configurato.

Posso esportare i dati delle conversazioni da canali specifici?

Sì. Quando configuri il trigger nel Flow, puoi selezionare la casella di posta in arrivo desiderata (WhatsApp, Instagram, e-mail, ecc.) in modo che solo le conversazioni di quel canale attivino il webhook.