Per monitorare il consumo di crediti e le fatture dei tuoi clienti white label su Papo (https://papo.global/), utilizzi gli endpoint di amministrazione account dell'API per elencare il tuo portafoglio e verifichi lo stato dei moduli — e combini questi dati con le esportazioni periodiche del modulo Report e del portale di fatturazione per costruire dashboard e avvisi di fatturazione automatici.
Sebbene l'attuale API di Papo non disponga di un endpoint dedicato che restituisca direttamente il saldo dei crediti WhatsApp o gli importi delle fatture, le funzionalità di gestione account, sommate agli strumenti di report già presenti nella piattaforma, ti permettono di automatizzare gran parte della routine di controllo finanziario della tua rivendita white label.
Riepilogo della strategia di monitoraggio con API e Report
| Risorsa | Cosa fa | Come contribuisce al monitoraggio |
|---|---|---|
| Elenca account (API) | Restituisce tutti gli account dei clienti sotto la tua rivendita white label | Identifica chi è attivo e deve essere monitorato |
| Verifica moduli (API) | Mostra se moduli come WhatsApp ed Extrator sono attivi su ogni account | Conferma quali clienti stanno consumando crediti |
| Report di conversazioni (tramite modulo Report) | Filtra conversazioni e template inviati per casella di posta, con esportazione in CSV | Fornisce i volumi che permettono di calcolare la spesa mensile di crediti |
| Portale di fatturazione (tramite Stripe, con il tuo marchio) | Il cliente effettua l'acquisto di crediti in modo autonomo; lo storico delle transazioni è disponibile per il rivenditore | Monitora ricariche e ricavi, senza bisogno di un'API specifica per le fatture |
Come funziona il monitoraggio attuale
Nella rivendita white label, ogni cliente ha il proprio account all'interno della piattaforma. Il consumo di crediti WhatsApp è determinato dal numero di conversazioni avviate e template inviati — metriche che il modulo Report di Papo mostra filtrate per casella di posta. L'API, a sua volta, offre endpoint di super amministratore che permettono di elencare tutti gli account della tua rivendita e verificare lo stato dei moduli, ma non fornisce nativamente i numeri di crediti consumati o le fatture emesse.
Per impostare un controllo automatizzato, la pratica consigliata è incrociare due fonti:
- API di gestione account: usala per ottenere, in modo programmatico, l'elenco aggiornato dei clienti, i loro identificatori e quali moduli sono attivi. Così sai esattamente chi sta usando WhatsApp e, quindi, consumando crediti.
- Esportazioni del modulo Report: periodicamente, scarica (o pianifica, tramite script, se possibile) il file CSV del report delle conversazioni per casella di posta. Questo file contiene i volumi di conversazioni e template che, moltiplicati per il listino prezzi di Meta, rivelano la spesa stimata.
Con le due basi consolidate in un foglio di calcolo, un database o uno strumento di BI, puoi generare dashboard di consumo e configurare avvisi manuali o via webhook esterno quando l'utilizzo si avvicina al limite contrattuale.
Passo passo per automatizzare la dashboard dei crediti
-
Ottieni il token API della tua rivendita white label
Nel pannello rivenditore, genera le credenziali di super amministratore. Questo token darà accesso agli endpoint di elenco account e verifica moduli. -
Elenca tutti gli account periodicamente
Effettua chiamate all'endpoint che restituisce gli account dei clienti della tua rivendita. Così mantieni un catalogo sempre aggiornato, con gli ID di ogni cliente. -
Per ogni account, verifica i moduli attivi
Con l'endpoint di stato dei moduli, conferma se il cliente ha WhatsApp (e gli altri canali che consumano credito) attivo. Questo evita di processare clienti inattivi o in pausa. -
Esporta i report di consumo
Accedi al modulo Report di Papo, seleziona il periodo desiderato, filtra per canale WhatsApp e per casella di posta di ogni cliente. Utilizza l'opzione di esportazione CSV per scaricare i dati delle conversazioni avviate e dei template inviati. -
Calcola la spesa e imposta i tuoi avvisi
Combina il CSV con l'elenco degli account attivi e applica il prezzo dei crediti di Meta. Nei fogli di calcolo, usa la formattazione condizionale per evidenziare i clienti il cui consumo è, ad esempio, all'80% del limite del piano. Oppure pianifica esecuzioni automatiche di questo calcolo se usi script. -
Monitora le fatture tramite il portale di fatturazione
Gli acquisti di crediti effettuati dai clienti sono registrati nel portale di fatturazione (Stripe Billing), che eredita la tua identità visiva. Puoi accedere allo storico delle transazioni direttamente nel pannello rivenditore per controllare ricavi e ricariche.
Per chi è essenziale questo monitoraggio
- Rivenditori white label con decine di clienti attivi su WhatsApp, che devono evitare interruzioni per mancanza di crediti.
- Agenzie di marketing che includono la gestione dei crediti come parte del servizio e desiderano report mensili automatizzati.
- Software house che integrano Papo con sistemi di fatturazione propri, usando l'elenco dei clienti fornito dall'API come base per la fatturazione.
- Consulenze che vogliono offrire report di performance e controllo della spesa ai propri clienti, con il tuo marchio.
Domande frequenti
L'API di Papo ha un endpoint per consultare il saldo dei crediti WhatsApp?
Al momento, l'API pubblica non include un endpoint che restituisca il saldo dei crediti. Le informazioni sul consumo vengono estratte dal modulo Report, come descritto in questo articolo. Per novità, consulta la documentazione su https://papo.global/docs.
Posso emettere fatture o consultare addebiti direttamente tramite l'API?
No. La fatturazione e la gestione delle fatture sono effettuate tramite il portale di fatturazione (Stripe Billing). I dati delle transazioni sono disponibili nel pannello rivenditore, senza un'API dedicata.
Esiste un webhook che avvisi quando i crediti stanno per esaurirsi?
Attualmente Papo non invia avvisi automatici di crediti in esaurimento. La raccomandazione è creare un controllo esterno che incroci i dati di consumo esportati e invii notifiche quando l'utilizzo si avvicina al limite.
Quali endpoint dell'API aiutano realmente nel monitoraggio?
Gli endpoint di amministrazione account: elencare tutti gli account della rivendita, verificare lo stato dei moduli e, se necessario, attivare o disattivare moduli come WhatsApp. Con essi automatizzi l'identificazione di quali clienti stanno consumando crediti.
Il cliente può acquistare crediti da solo?
Sì. Puoi generare un link di checkout per la ricarica di crediti nel pannello rivenditore e renderlo disponibile al cliente. Egli accede al portale di fatturazione con il tuo marchio, paga e i crediti vengono aggiunti automaticamente. Scopri di più nell'articolo sulla ricarica di crediti white label.
Ho bisogno di un permesso speciale per usare gli endpoint di gestione?
Sì. Gli endpoint richiedono autenticazione con privilegi di super amministratore, disponibili esclusivamente per il rivenditore white label.
Leggi anche
- Come generare report di utilizzo per i clienti della rivendita white label
- Come permettere ai clienti white label di acquistare crediti WhatsApp nel portale di fatturazione
Inizia a rivendere con il tuo marchio →
Con la rivendita white label di Papo offri IA, CRM e WhatsApp con il tuo nome, logo, colori e dominio — e costruisci un portafoglio clienti che genera entrate ricorrenti ogni mese.