Italian it

Lingua

pt_BR Portuguese (Brazil) en English es Spanish fr French it Italian de German ar Arabic hi Hindi tr Turkish id Indonesian zh_CN Chinese (China)

Come inviare dati delle conversazioni a un sistema di BI con i webhook

Apri in

Visualizza come Markdown

Apri in ChatGPT Apri in Claude

Vitor

Ultimo aggiornamento Oct 15, 2026

Per inoltrare i metadati delle conversazioni che avvengono in Papo — come nome del cliente, canale, testo del messaggio e agente responsabile — a uno strumento di Business Intelligence, usa l'azione “Invia Webhook” all'interno dei Flows di Papo (https://papo.global/). A ogni nuova conversazione o messaggio ricevuto, i dati vengono inviati automaticamente all'endpoint configurato, alimentando il tuo BI con informazioni aggiornate in tempo reale ed eliminando la necessità di esportazioni manuali.

Con questa integrazione, trasformi ogni interazione su WhatsApp, Instagram, e-mail o altro canale in un punto dati per dashboard, report sul volume di assistenza, analisi di conversione per canale e molto altro. Basta configurare un Flow con il trigger adeguato e indirizzare il webhook all'URL fornito dalla tua piattaforma di BI o da strumenti intermedi come Zapier, Make, n8n o un endpoint proprio.

Fase	Descrizione	Esempio per BI
1. Ottenere l'URL del webhook	Il sistema di destinazione deve fornire un endpoint HTTP in grado di ricevere richieste POST con payload in JSON.	URL generato da Power Automate, Zapier, Make, n8n o dal BI stesso (es.: API REST).
2. Creare il Flow in Papo	Nel modulo Flows, crea un flusso con un trigger che si attiva quando inizia una conversazione o viene ricevuto un messaggio.	Trigger “Nuova conversazione” nella casella di posta di WhatsApp Gold.
3. Aggiungere l'azione “Invia Webhook”	Inserisci l'URL di destinazione, mantieni il metodo POST e componi il corpo della richiesta con le variabili della conversazione.	Payload: `{"nome": "{{contact.name}}", "canale": "{{inbox.name}}", "testo": "{{message.text}}"}`.
4. Testare e attivare	Usa un URL di test (come Webhook.site) per validare l'invio prima di puntare all'ambiente reale.	Verifica che i campi appaiano correttamente nel ricevitore e attiva il Flow dopo la conferma.

Come funziona – passo dopo passo

1. Prepara l'endpoint nel tuo sistema di BI

Papo non genera l'URL di destinazione — ti serve un servizio che riceva i dati e li memorizzi. Le principali modalità:

Piattaforma di automazione (consigliato): Zapier, Make (Integromat) o n8n possono creare un “Catch Webhook”, generare un URL esclusivo e poi collegare i dati ricevuti al BI (Google Data Studio, Power BI, Tableau) o a un database.
Webhook diretto dal BI: alcuni ambienti, come Power BI, accettano streaming di dati via API. In questo caso, devi seguire le istruzioni della piattaforma per esporre un endpoint.
Backend proprio: se hai una tua API, puoi costruire un endpoint che elabora i dati e li inserisce nel tuo data warehouse.

2. Crea il Flow in Papo con il trigger adeguato

Accedi al modulo Flows e crea un nuovo flusso. Il trigger più comune per alimentare un BI è “Nuova conversazione” — così ogni nuovo contatto che arriva a una casella di posta genera un record nel tuo sistema di analisi.

Puoi anche usare il trigger Messaggio ricevuto e configurare filtri:

Tutti i messaggi: il webhook si attiva per qualsiasi interazione.
Messaggi specifici: si attiva solo quando il messaggio contiene una determinata parola chiave, proviene da un canale specifico, ecc.

Seleziona la casella di posta desiderata (es.: WhatsApp, Instagram, e-mail) in modo che vengano inviate solo le conversazioni di quel canale.

3. Configura l'azione “Invia Webhook”

Aggiungi un nodo di azione di tipo Webhook e compila:

URL: incolla l'endpoint ottenuto nella fase 1.
Metodo HTTP: mantieni POST.

Corpo (Payload): definisci quali dati della conversazione verranno inviati. Usa le variabili disponibili nel Flow, come:

{
  "nome_contatto": "{{contact.name}}",
  "email_contatto": "{{contact.email}}",
  "canale_origine": "{{inbox.name}}",
  "testo_messaggio": "{{message.text}}",
  "data_evento": "{{timestamp}}",
  "agente_attuale": "{{agent.name}}"
}

Puoi includere qualsiasi variabile del contesto della conversazione — consulta la documentazione dei Flows per vedere tutte le opzioni.

Se necessario, aggiungi header come Content-Type: application/json o token di autenticazione richiesti dal sistema di destinazione.

4. Testa e attiva il Flow

Prima di mettere in produzione, fai un test:

Usa un URL di test (es.: Webhook.site) al posto dell'URL definitivo e avvia una conversazione nella casella di posta configurata.
Verifica che il payload arrivi correttamente, con tutti i campi e i valori attesi.
Sostituisci l'URL con quello definitivo e attiva il Flow.

Da quel momento, ogni conversazione (o messaggio, in base al trigger) attiverà automaticamente il webhook.

A chi è utile questa integrazione

Analisti di dati e BI che devono consolidare metriche di assistenza senza dipendere da esportazioni CSV manuali.
Responsabili delle operazioni che desiderano dashboard con volume di conversazioni per canale, orario di picco e carico degli agenti.
Team di marketing e vendite che vogliono incrociare i dati delle conversazioni con campagne e funnel nel CRM.
Aziende che usano già strumenti come Power BI, Tableau o Looker Studio e desiderano alimentare dashboard con dati reali di WhatsApp e altri canali.

Domande frequenti (FAQ)

Quali metadati delle conversazioni posso inviare al BI?

Puoi inviare qualsiasi variabile disponibile nel contesto del Flow, come nome del contatto, contenuto del messaggio, canale di origine, e-mail, telefono, agente assegnato e data/ora. La combinazione di questi campi permette di creare report su volume, tempo di risposta e origine dei lead.

Il mio BI non ha un webhook nativo. Come faccio l'integrazione?

Il modo più semplice è usare una piattaforma di automazione (Zapier, Make, n8n). Questi strumenti generano un URL di webhook, ricevono i dati da Papo e poi li indirizzano al BI tramite connettori pronti o API. Così non devi programmare un endpoint proprio.

Posso filtrare quali conversazioni generano l'invio dei dati?

Sì. Nel trigger del Flow, è possibile scegliere una casella di posta specifica e configurare l'opzione “Messaggi specifici”, definendo parole chiave o altri criteri. In questo modo, solo le interazioni che soddisfano il filtro attivano il webhook.

I dati vengono inviati in tempo reale?

Sì. Il webhook viene attivato non appena si verifica l'evento configurato (nuova conversazione o messaggio ricevuto), permettendo al tuo BI di aggiornarsi quasi istantaneamente.

Cosa succede se la richiesta del webhook fallisce?

Il Flow di Papo registra l'errore. Puoi consultare il log delle esecuzioni del Flow per identificare i guasti e, se vuoi, configurare azioni di fallback (come inviare un'e-mail di avviso) per garantire che nessuna informazione critica vada persa.

Ci sono limiti di utilizzo per i webhook?

Le funzionalità di Flows e l'invio di Webhook sono incluse nella piattaforma. Informazioni specifiche su limiti di richieste e volume di dati, se presenti, sono mostrate sul sito o nel pannello di Papo in base al piano sottoscritto.