Come esportare le statistiche delle chiamate vocali per analisi esterne

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:

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.
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.
Prepara la richiesta
Esempio concettuale: una chiamata GET all'endpoint delle statistiche vocali, autenticata con le tue chiavi, può restituire un contenuto simile a:
```
{
  "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.
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.
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.