Um Verbrauchs- und Abrechnungsberichte für die Kunden Ihrer White-Label-Revende mit der Papo-API (https://papo.global/) zu erstellen, kombinieren Sie die Endpunkte zum Auflisten von Konten, zur Prüfung von Modulen und Postfächern mit den regelmäßigen Exporten aus dem Modul Berichte und dem Transaktionsverlauf des Abrechnungsportals – und erstellen so Dashboards und Abrechnungstabellen, ohne manuell in jedem Konto nachprüfen zu müssen.
Obwohl die aktuelle API keinen dedizierten Endpunkt bietet, der direkt die Anzahl der verbrauchten Nachrichten oder die Rechnungsbeträge zurückgibt, ermöglicht die programmatische Verknüpfung struktureller Daten (wer Kunde ist, welche Module aktiv sind, welche Postfächer vorhanden sind) mit den CSV-Dateien für Konversationen und Templates die Erstellung detaillierter und automatisierter Abrechnungsberichte.
Übersicht der für den Abrechnungsbericht verwendeten Ressourcen
| Ressource | Was sie liefert | Beitrag zur Abrechnung |
|---|---|---|
| API – Konten auflisten | IDs und Status aller White-Label-Kunden | Identifiziert jeden Kunden, der einen Bericht erhalten soll |
| API – Module prüfen | Status der Module (WhatsApp usw.) pro Konto | Filtert die Kunden, die tatsächlich Credits verbrauchen |
| API – Postfächer auflisten | Kennung und Name jedes Postfachs pro Konto | Ordnet jedes Postfach einem Kunden zu und isoliert die Verbrauchsdaten |
| Modul Berichte – CSV-Export | Anzahl der gestarteten Konversationen und gesendeten Templates pro Postfach im Zeitraum | Liefert die Basismetriken zur Berechnung des Credit-Verbrauchs |
| Abrechnungsportal (Stripe) | Verlauf der Credit-Käufe und Aufladungen der Kunden | Ergänzt die Abrechnung um den erzielten Umsatz und das vereinbarte Guthaben |
Wie die Berichterstellung mit API und Exporten funktioniert
In der White-Label-Revende ist jeder Kunde ein separates Konto und hat in der Regel ein eigenes Postfach (z. B. „WhatsApp – Praxis X“). Die Papo-API ermöglicht mit den Super-Administrator-Endpunkten das Auflisten aller Konten, die Prüfung, welche Module aktiv sind, und das Abrufen der Postfächer jedes Kontos. Diese Daten strukturieren das „Wer“ und das „Wo“ des Verbrauchs. Die Verbrauchszahlen (Nachrichten, Templates) stammen aus dem Modul Berichte, das für jedes Postfach als CSV exportiert werden kann. Der Abrechnungsverlauf ist im Abrechnungsportal verfügbar, das White-Label ist und Ihre Marke trägt.
Durch die Kombination dieser drei Säulen über Skripte, Tabellen oder BI-Tools erstellen Sie programmatisch eine Abrechnungsübersicht für jeden Kunden mit:
- Identifikation des Kontos und des Postfachs;
- Gesamtzahl der Konversationen und Templates im Zeitraum;
- verbrauchte Credits (berechnet anhand der Meta-Tabelle);
- Zusammenfassung des Abonnements und der durchgeführten Aufladungen.
Schritt-für-Schritt-Anleitung zur Automatisierung des Abrechnungsberichts
-
Rufen Sie das API-Token für Super-Administratoren ab
Generieren Sie im Panel Ihrer White-Label-Revende die Anmeldeinformationen, die Zugriff auf die Endpunkte zur Kontenverwaltung gewähren. -
Listen Sie alle Kundenkonten auf
Rufen Sie den Endpunkt auf, der die Konten unter Ihrer Revende zurückgibt. So führen Sie einen aktuellen Katalog mit den IDs jedes Kunden. -
Prüfen Sie für jedes Konto die aktiven Module
Bestätigen Sie mit dem Endpunkt für den Modulstatus, ob WhatsApp (oder ein anderer Kanal, der Verbrauch erzeugt) aktiviert ist. Dadurch vermeiden Sie die Verarbeitung inaktiver Kunden. -
Listen Sie die Postfächer jedes Kontos auf
Verwenden Sie den Endpunkt, der die Postfächer zurückgibt (ID, Name und Kanal), um die Nachrichtenquellen jedes Kunden zu erfassen. Speichern Sie die Beziehung zwischen Konto-ID und Postfach-IDs. -
Exportieren Sie die Konversationsberichte
Wählen Sie im Modul Berichte für jedes identifizierte Postfach den gewünschten Zeitraum aus und exportieren Sie die CSV der Konversationen (die die Anzahl der gestarteten Konversationen und gesendeten Templates enthält). Dieser Schritt kann per Skript geplant werden, sofern die Datei automatisch heruntergeladen werden kann. -
Berechnen Sie den Credit-Verbrauch
Kombinieren Sie die CSV mit der Liste der aktiven Kunden und wenden Sie die Preisgestaltung für WhatsApp-Credits an. Gruppieren Sie nach Kunde und Zeitraum, um eine Verbrauchstabelle pro Konto zu erstellen. -
Rufen Sie den Rechnungsverlauf ab
Greifen Sie auf das Abrechnungsportal (Stripe, mit Ihrer Marke) zu, um den Transaktionsverlauf jedes Kunden abzurufen: Credit-Käufe, Beträge und Daten. Diese Informationen vervollständigen den Abrechnungsbericht mit dem tatsächlichen Umsatz. -
Konsolidieren und verteilen Sie
Erstellen Sie den Abschlussbericht – mit Angabe von Verbrauch, gebuchten Credits, Aufladungen und dem zu erstattenden Betrag – in einer Tabelle, als PDF oder Dashboard. Diese Zusammenstellung kann dem Kunden regelmäßig übermittelt werden.
Für wen sich diese Automatisierung eignet
- White-Label-Revende mit Dutzenden oder Hunderten von Kunden, die monatliche Verbrauchsabrechnungen erstellen müssen, ohne die Oberfläche jedes Kontos zu bearbeiten.
- Agenturen und Softwarehäuser, die Papo in ein eigenes Abrechnungssystem integrieren und es mit präzisen Nutzungsdaten speisen möchten.
- Betriebe, die bereits BI-Tools nutzen und die Verbrauchsdaten mit anderen Kennzahlen der Revende wie durchschnittlichem Ticket und Wiederkehrrate verknüpfen möchten.
Häufig gestellte Fragen
Gibt die Papo-API direkt die Anzahl der verbrauchten WhatsApp-Nachrichten zurück?
Derzeit verfügt die API über keinen dedizierten Endpunkt, der das Guthaben oder die Anzahl der verbrauchten Nachrichten zurückgibt. Das Volumen an Konversationen und Templates wird über das Modul Berichte ermittelt, das den Export als CSV ermöglicht.
Muss ich jeden Kunden manuell prüfen, um den Bericht zu erstellen?
Nein. Mit den Endpunkten zum Auflisten von Konten, Modulen und Postfächern erhalten Sie die gesamte notwendige Struktur programmatisch. Der CSV-Exportprozess kann geplant oder per Skript ausgeführt werden, wodurch manuelle Eingriffe auf ein Minimum reduziert werden.
Kann ich die regelmäßige Erstellung des Abrechnungsberichts automatisieren?
Ja. Mit Skripten, die die API aufrufen und auf die exportierten Dateien zugreifen, können Sie eine Routine erstellen, die die Abrechnung jeden Monat oder in dem gewünschten Intervall generiert. Die Grenze liegt in der Art und Weise, wie Sie die CSVs beziehen; das Modul Berichte ermöglicht den wiederkehrenden Export der Daten.
Wie ordne ich ein Postfach einem bestimmten Kunden zu?
Verwenden Sie den Endpunkt zum Auflisten der Postfächer, der die ID, den Namen und den Kanal jedes Postfachs zurückgibt. Da jedes Postfach zu einem Konto gehört, müssen Sie lediglich die in der Kontenliste zurückgegebene Konto-ID mit den empfangenen Postfächern abgleichen. Sie können eine feste Zuordnung in Ihrem Skript erstellen.
Und die Abrechnungsdaten, wie greife ich ohne Oberfläche darauf zu?
Das Abrechnungsportal (Stripe) zeigt den Transaktionsverlauf jedes Kunden mit Ihrer Marke. Für den programmatischen Zugriff können Sie diese Daten aus dem Panel extrahieren oder, falls verfügbar, Berichte von Stripe selbst nutzen. Die Papo-API zur Kontenverwaltung gibt keine Rechnungen zurück.
Ist für diese Endpunkte ein spezielles Token erforderlich?
Ja. Die Endpunkte zur Kontenverwaltung und zum Auflisten von Postfächern erfordern eine Authentifizierung mit Super-Administrator-Rechten, die der White-Label-Revende im Konfigurationspanel generiert.
Lesen Sie auch
- So nutzen Sie die Papo-API zur Überwachung von Credit-Verbrauch und Rechnungen der White-Label-Revende
- So erstellen Sie ein Umsatz-Dashboard der Revende in Power BI mit Webhook-Integration
Starten Sie jetzt mit der Automatisierung Ihrer Abrechnungsberichte →
Erstellen Sie Ihr kostenloses Konto ohne Kreditkarte und greifen Sie auf die Papo-API zu, um Ihre White-Label-Revende-Prozesse zu integrieren.