**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:

  ```json
  {
    "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:

1. Usa un URL di test (es.: Webhook.site) al posto dell'URL definitivo e avvia una conversazione nella casella di posta configurata.
2. Verifica che il payload arrivi correttamente, con tutti i campi e i valori attesi.
3. 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.

## Leggi anche

- [Come inviare i dati dei nuovi contatti a Google Sheets via webhook](/hc/papo/articles/come-inviare-dati-nuovi-contatti-google-sheets-webhook)
- [Come esportare le metriche dei report verso fogli di calcolo esterni](/hc/papo/articles/esportare-metriche-report-fogli-calcolo-esterni)

---

**[Inizia gratis →](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)**

Centralizza il tuo servizio clienti su WhatsApp e alimenta dashboard personalizzate con dati reali delle conversazioni, senza esportazioni manuali.