Comment utiliser l’API de Papo pour générer des rapports de consommation et de reversement pour les clients white label

Pour générer des rapports de consommation et de reversement pour les clients de votre revente white label à l’aide de l’API de Papo (https://papo.global/), vous combinez les endpoints de liste des comptes, de vérification des modules et des boîtes de réception avec les exports périodiques du module Rapports et l’historique des transactions du portail de facturation — en construisant des tableaux de bord et des feuilles de reversement sans dépendre de la vérification manuelle sur chaque compte.

Bien que l’API actuelle n’ait pas d’endpoint dédié qui renvoie directement la quantité de messages consommés ou les montants de facture, le croisement programmatique de données structurelles (qui est client, quels modules sont activés, quelles sont ses boîtes de réception) avec les fichiers CSV de conversations et de templates permet de construire des rapports de reversement détaillés et automatisés.

Résumé des ressources utilisées pour générer le rapport de reversement

Ressource	Ce qu’elle fournit	Comment elle contribue au reversement
API – lister les comptes	IDs et statuts de tous les clients white label	Identifie chaque client qui doit recevoir un rapport
API – vérifier les modules	État des modules (WhatsApp, etc.) par compte	Filtre les clients qui consomment réellement des crédits
API – lister les boîtes de réception	Identifiant et nom de chaque boîte de réception par compte	Relie chaque boîte à un client et isole les données de consommation
Module Rapports – export CSV	Volume de conversations initiées et de templates envoyés par boîte sur la période	Fournit les métriques de base pour calculer la dépense de crédits
Portail de facturation (Stripe)	Historique des achats de crédits et des recharges des clients	Complète le reversement avec le revenu généré et le solde contracté

Comment fonctionne la génération de rapports avec l’API et les exports

Dans la revente white label, chaque client est un compte séparé et dispose généralement de sa propre boîte de réception (ex. : « WhatsApp – Cabinet X »). L’API de Papo, avec les endpoints de super administrateur, permet de lister tous les comptes, de vérifier quels modules sont actifs et d’obtenir les boîtes de réception de chacun. Ces données structurent le « qui » et le « où » de la consommation. Les chiffres de consommation (messages, templates) proviennent du module Rapports, qui peut être exporté en CSV pour chaque boîte de réception. L’historique de facturation est disponible dans le portail de facturation, qui est white label et conserve votre marque.

En combinant ces trois piliers via des scripts, des feuilles de calcul ou des outils de BI, vous construisez, de manière programmatique, un relevé de reversement pour chaque client, avec :

l’identification du compte et de la boîte de réception ;
le total des conversations et des templates de la période ;
les crédits consommés (calculés à partir de la grille tarifaire de Meta) ;
un résumé de l’abonnement et des recharges effectuées.

Étape par étape pour automatiser le rapport de reversement

Obtenez le token d’API de super administrateur
Dans le panneau de votre revente white label, générez les identifiants qui donneront accès aux endpoints de gestion des comptes.
Listez tous les comptes clients
Effectuez un appel à l’endpoint qui renvoie les comptes sous votre revente. Vous maintenez ainsi un catalogue à jour avec les ID de chaque client.
Pour chaque compte, vérifiez les modules actifs
Avec l’endpoint d’état des modules, confirmez si WhatsApp (ou un autre canal générant de la consommation) est activé. Cela évite de traiter des clients inactifs.
Listez les boîtes de réception de chaque compte
Utilisez l’endpoint qui renvoie les boîtes de réception (id, nom et canal) pour cartographier les origines des messages de chaque client. Stockez la relation entre l’ID du compte et les ID des boîtes.
Exportez les rapports de conversations
Dans le module Rapports, pour chaque boîte de réception identifiée, sélectionnez la période souhaitée et exportez le CSV de conversations (qui inclut le volume de conversations initiées et de templates envoyés). Cette étape peut être planifiée par script s’il est possible de télécharger le fichier automatiquement.
Calculez la consommation de crédits
Combinez le CSV avec la liste des clients actifs et appliquez la tarification des crédits WhatsApp. Regroupez par client et par période, en générant un tableau de consommation par compte.
Récupérez l’historique des factures
Accédez au portail de facturation (Stripe, avec votre marque) pour obtenir l’historique des transactions de chaque client : achats de crédits, montants et dates. Ces informations complètent le rapport de reversement avec le revenu réel.
Consolidez et distribuez
Montez le rapport final – indiquant la consommation, le crédit contracté, les recharges et le montant à reverser – dans une feuille de calcul, un PDF ou un tableau de bord. Ce consolidé peut être remis périodiquement au client.

À qui cette automatisation est-elle indiquée

Revendeurs white label avec des dizaines ou des centaines de clients, qui doivent générer des reversements mensuels de consommation sans manipuler l’interface de chaque compte.
Agences et sociétés de logiciels qui intègrent Papo à un système de facturation propre et veulent l’alimenter avec des données d’usage précises.
Opérations qui utilisent déjà des outils de BI et souhaitent croiser les données de consommation avec d’autres indicateurs de la revente, comme le panier moyen et la récurrence.

Questions fréquentes

L’API de Papo renvoie-t-elle directement la quantité de messages WhatsApp consommés ?

Actuellement, l’API ne possède pas d’endpoint dédié qui renvoie le solde ou le nombre de messages consommés. Le volume de conversations et de templates est obtenu via le module Rapports, qui permet l’export en CSV.

Dois-je vérifier manuellement chaque client pour générer le rapport ?

Non. Avec les endpoints de liste des comptes, des modules et des boîtes de réception, vous obtenez toute la structure nécessaire de manière programmatique. Le processus d’export des CSV peut être planifié ou exécuté par script, ce qui réduit au maximum l’intervention manuelle.

Puis-je automatiser la génération périodique du rapport de reversement ?

Oui. En utilisant des scripts qui appellent l’API et accèdent aux fichiers exportés, il est possible de mettre en place une routine qui génère le reversement chaque mois ou à l’intervalle souhaité. La limite réside dans la manière dont vous obtenez les CSV ; le module Rapports permet d’exporter les données de façon récurrente.

Comment associer une boîte de réception à un client spécifique ?

Utilisez l’endpoint de liste des boîtes de réception, qui renvoie l’ID, le nom et le canal de chacune. Comme chaque boîte appartient à un compte, il suffit de croiser l’ID du compte renvoyé dans la liste des comptes avec les boîtes reçues. Vous pouvez créer une correspondance fixe dans votre script.

Et les données de facturation, comment y accéder sans interface ?

Le portail de facturation (Stripe) affiche l’historique des transactions de chaque client avec votre marque. Pour un accès programmatique, il est possible d’extraire ces données du panneau ou, si disponible, d’utiliser les rapports de Stripe lui-même. L’API de gestion des comptes de Papo ne renvoie pas les factures.

Un token spécial est-il nécessaire pour ces endpoints ?

Oui. Les endpoints d’administration des comptes et de liste des boîtes exigent une authentification avec des privilèges de super administrateur, que le revendeur white label génère dans le panneau de configuration.