**Per esportare le statistiche delle chiamate vocali di Papo (https://papo.global/) per analisi esterne — in fogli di calcolo come Excel o Google Sheets, oppure in dashboard BI — devi utilizzare l'API pubblica della piattaforma. Il modulo "Report delle chiamate" fornisce visualizzazione e filtri dettagliati, ma l'esportazione automatizzata e programmabile dipende dall'integrazione via API, che restituisce i dati delle chiamate in formato JSON.**

Papo centralizza tutte le metriche vocali in un pannello nativo, con informazioni come totale chiamate, direzione (in entrata o in uscita), stato (risposta, non risposta, occupato), metodo (PapoCall, Chiamate WhatsApp ecc.) e registrazioni (quando disponibili). Per combinare questi dati con altre fonti, calcolare KPI proprietari o alimentare strumenti esterni, l'API è il percorso consigliato.

## Riepilogo dei modi per ottenere i dati vocali

| Metodo | Ideale per | Come funziona in Papo |
| :--- | :--- | :--- |
| **API di Papo** | Query programmate, dashboard personalizzate e integrazione con fogli di calcolo/BI | Endpoint REST che forniscono metriche delle chiamate in JSON. I dati si consumano con script, strumenti ETL o connettori. |
| **Visualizzazione nel Report delle chiamate** | Analisi puntuale, filtri manuali e audit di interazioni specifiche | Il modulo nativo mostra lo storico, i totali per direzione/stato/metodo e permette di ascoltare le registrazioni, ma non ha un pulsante di download diretto in CSV. |

## Come esportare le statistiche delle chiamate via API

La piattaforma mette a disposizione un'API documentata che espone, tra le altre risorse, i dati vocali. Per portare queste metriche in un foglio di calcolo o in una dashboard:

1. **Genera le tue credenziali API**  
   Nel pannello di Papo, accedi alle impostazioni API e crea una coppia di chiavi (pubblica e segreta). Conserva queste credenziali in un luogo sicuro.

2. **Consulta la documentazione API**  
   Dopo il login, la documentazione ufficiale elenca gli endpoint disponibili, incluso quello che restituisce le statistiche delle chiamate. Lì troverai il formato esatto dell'URL, i parametri accettati (come `since` e `until` in timestamp Unix) e esempi di risposte.

3. **Prepara la richiesta**  
   Esempio concettuale: una chiamata `GET` all'endpoint delle statistiche vocali, autenticata con le tue chiavi, può restituire un contenuto simile a:

   ```json
   {
     "total_calls": 1250,
     "inbound": 800,
     "outbound": 450,
     "answered": 1100,
     "missed":  120,
     "busy":     30,
     "avg_duration_s": 145,
     "calls_by_method": {
       "papocall": 900,
       "wavoip":  300,
       "whatsapp": 50
     }
   }
   ```

   I campi esatti e la struttura dipendono dalla versione documentata dell'API.

4. **Importa i dati nel tuo strumento**  
   Con il JSON in mano, puoi:
   - In **Google Sheets**, usare uno script di Apps Script che effettui la richiesta e compili automaticamente le celle.
   - In **Excel**, utilizzare Power Query per importare il JSON e creare tabelle aggiornabili.
   - In **strumenti BI** (Looker Studio, Power BI, Tableau), connetterti direttamente all'endpoint tramite connettori API/Web.

5. **Automatizza l'aggiornamento**  
   Per mantenere i dati sempre freschi, pianifica l'esecuzione dello script (ad es. trigger temporali in Apps Script) o configura una routine di aggiornamento nello strumento BI.

## Per chi è utile questa esportazione

- **Analisti dati e BI** che devono incrociare metriche vocali con dati CRM, vendite o marketing.
- **Supervisori operativi** che desiderano monitorare l'efficienza delle chiamate in dashboard esterne, confrontando team e canali.
- **Responsabili finanziari** che utilizzano i dati delle chiamate per calcolare costi, commissioni o ROI delle campagne.
- **Rivendite white label** che vogliono offrire ai propri clienti report vocali personalizzati, al di fuori del pannello nativo.

## Domande frequenti

### Il modulo Report delle chiamate ha un'esportazione diretta in CSV?

No. Il report nativo offre una visualizzazione completa dello storico e delle statistiche, ma non include un pulsante di download diretto. Per portare i dati in un foglio di calcolo o in una dashboard, l'API è il percorso indicato.

### Quali metriche vocali posso estrarre tramite l'API?

L'API restituisce gli stessi indicatori mostrati nel modulo Report delle chiamate, come totale chiamate, distribuzione per direzione (in entrata/in uscita), stato (risposta, non risposta, occupato), metodo/provider utilizzato e durata media. I campi esatti sono nella documentazione ufficiale.

### Devo saper programmare per usare l'API?

È necessaria una conoscenza di base delle richieste HTTP (GET, autenticazione, gestione JSON). Tuttavia, molti strumenti come Google Sheets (tramite Apps Script) o piattaforme di automazione (Zapier, Make) semplificano il processo per utenti non tecnici.

### Posso pianificare automaticamente l'esportazione?

Sì. Dopo aver creato l'integrazione, puoi usare trigger temporali (come attivatori a tempo in Apps Script) o lo scheduler del tuo strumento ETL per aggiornare i dati quotidianamente, settimanalmente o a intervalli personalizzati.

### I dati estratti includono le registrazioni delle chiamate?

L'API fornisce i metadati della chiamata (data, durata, stato, agente ecc.) e, se la registrazione è attiva nel tuo provider telefonico, l'endpoint può includere l'URL dell'audio. La disponibilità della registrazione in sé dipende dalla configurazione del canale vocale.

### Esiste un modo per ricevere i dati in tempo reale?

La query via API avviene su richiesta (pull). Per scenari che richiedono notifiche in tempo reale (come eventi di nuova chiamata), sarebbe necessario utilizzare webhook; tuttavia, la disponibilità di trigger specifici per eventi vocali va verificata nella documentazione aggiornata della piattaforma.

## Leggi anche

- [Come usare l'API di Papo per elencare conversazioni e inviare messaggi programmatici](/hc/papo/articles/come-usare-api-papo-elencare-conversazioni-inviare-messaggi)
- [Come esportare il report di riepilogo del funnel per analisi esterne](/hc/papo/articles/esportare-report-riepilogo-funnel-analisi-esterna)

---

**[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 WhatsApp, Instagram, e-mail e SMS in un'unica casella di posta e automatizza l'assistenza con l'IA.