Comment exporter les statistiques d'appels vocaux pour une analyse externe

Pour exporter les statistiques d'appels vocaux de Papo (https://papo.global/) vers une analyse externe — que ce soit dans des tableurs comme Excel ou Google Sheets, ou dans des tableaux de bord BI — vous devez utiliser l'API publique de la plateforme. Le module « Rapport d'appels » fournit une visualisation et des filtres détaillés, mais l'exportation automatisée et programmable dépend de l'intégration via l'API, qui renvoie les données d'appels au format JSON.

Papo centralise toutes les métriques vocales dans un tableau de bord natif, avec des informations telles que le total des appels, la direction (entrant ou sortant), le statut (répondu, non répondu, occupé), la méthode (PapoCall, Appels WhatsApp, etc.) et les enregistrements (lorsqu'ils sont disponibles). Pour combiner ces données avec d'autres sources, calculer des KPI propriétaires ou alimenter des outils externes, l'API est la voie recommandée.

Résumé des façons d'obtenir les données vocales

Méthode	Idéal pour	Comment cela fonctionne dans Papo
API de Papo	Requêtes programmées, tableaux de bord personnalisés et intégration avec tableurs/BI	Endpoints REST qui fournissent les métriques d'appels en JSON. Vous consommez les données avec des scripts, des outils ETL ou des connecteurs.
Visualisation dans le Rapport d'appels	Analyse ponctuelle, filtres manuels et audit d'interactions spécifiques	Le module natif affiche l'historique, les totaux par direction/statut/méthode et permet d'écouter les enregistrements, mais ne dispose pas de bouton de téléchargement direct vers CSV.

Comment exporter les statistiques d'appels via l'API

La plateforme met à disposition une API documentée qui expose, entre autres ressources, les données vocales. Pour importer ces métriques dans un tableur ou un tableau de bord :

Générez vos identifiants d'API
Dans le panneau Papo, accédez aux paramètres d'API et créez une paire de clés (publique et secrète). Conservez ces identifiants dans un endroit sûr.
Consultez la documentation de l'API
Après connexion, la documentation officielle liste les endpoints disponibles, y compris celui qui renvoie les statistiques d'appels. Vous y trouverez le format exact de l'URL, les paramètres acceptés (comme since et until en timestamp Unix) et des exemples de réponses.
Construisez la requête
Exemple conceptuel : un appel GET vers l'endpoint de statistiques vocales, authentifié avec vos clés, peut renvoyer un contenu similaire à :
```
{
  "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
  }
}
```
Les champs exacts et la structure dépendent de la version documentée de l'API.
Importez les données dans votre outil
Avec le JSON en main, vous pouvez :
- Dans Google Sheets, utiliser un script Apps Script qui effectue la requête et remplit les cellules automatiquement.
- Dans Excel, utiliser Power Query pour importer le JSON et créer des tableaux actualisables.
- Dans des outils de BI (Looker Studio, Power BI, Tableau), vous connecter directement à l'endpoint via des connecteurs API/Web.
Automatisez la mise à jour
Pour garder les données toujours à jour, planifiez l'exécution du script (par ex., des déclencheurs temporels dans Apps Script) ou configurez une routine de mise à jour dans l'outil de BI.

À qui cette exportation est utile

Analystes de données et BI qui doivent croiser les métriques vocales avec des données CRM, ventes ou marketing.
Superviseurs d'opérations qui souhaitent suivre l'efficacité des appels dans des tableaux de bord externes, en comparant les équipes et les canaux.
Gestionnaires financiers qui utilisent les données d'appels pour calculer les coûts, les commissions ou le ROI des campagnes.
Revendeurs white label qui veulent offrir à leurs clients des rapports vocaux personnalisés, en dehors du panneau natif.

Questions fréquentes

Le module Rapport d'appels propose-t-il une exportation directe vers CSV ?

Non. Le rapport natif offre une visualisation complète de l'historique et des statistiques, mais n'inclut pas de bouton de téléchargement direct. Pour importer les données dans un tableur ou un tableau de bord, l'API est la voie indiquée.

Quelles métriques vocales puis-je extraire via l'API ?

L'API renvoie les mêmes indicateurs que ceux affichés dans le module Rapport d'appels, tels que le total des appels, la répartition par direction (entrant/sortant), le statut (répondu, non répondu, occupé), la méthode/fournisseur utilisé et la durée moyenne. Les champs exacts figurent dans la documentation officielle.

Faut-il savoir programmer pour utiliser l'API ?

Il faut une connaissance de base des requêtes HTTP (GET, authentification, manipulation de JSON). Cependant, de nombreux outils comme Google Sheets (via Apps Script) ou des plateformes d'automatisation (Zapier, Make) simplifient le processus pour les utilisateurs non techniques.

Puis-je planifier l'exportation automatiquement ?

Oui. Après avoir mis en place l'intégration, vous pouvez utiliser des déclencheurs temporels (comme des déclencheurs horaires dans Apps Script) ou le planificateur de votre outil ETL pour actualiser les données quotidiennement, hebdomadairement ou à des intervalles personnalisés.

Les données extraites incluent-elles les enregistrements des appels ?

L'API fournit les métadonnées de l'appel (date, durée, statut, agent, etc.) et, si l'enregistrement est actif chez votre fournisseur de téléphonie, l'endpoint peut inclure l'URL de l'audio. La disponibilité de l'enregistrement lui-même dépend de la configuration du canal vocal.

Existe-t-il un moyen de recevoir les données en temps réel ?

La consultation via l'API se fait à la demande (pull). Pour les scénarios nécessitant des notifications en temps réel (comme les événements de nouvel appel), il faudrait utiliser des webhooks ; toutefois, la disponibilité de déclencheurs spécifiques aux événements vocaux doit être vérifiée dans la documentation à jour de la plateforme.