Öffne die Registerkarte Berichte.
Zuletzt aktualisiert am
11. Mai 2026
Generiere geplante CSV-Berichte, um die SMS- und WhatsApp-Nutzung zu verfolgen, Kontingente zu überwachen und den Verbrauch nach Gruppe zu analysieren.
Transaktionsnutzungs-Exporte bieten Sichtbarkeit in SMS- und WhatsApp-Aktivitäten in deinem gesamten Konto, einschließlich gekaufter Mengen, Verbrauchssummen und Nutzung auf Gruppenebene. Zu diesen Exporten gehören:
- SMS-Authentifizierung
- SMS-Versand
- WhatsApp-Authentifizierung
- WhatsApp-Zustellungstransaktionen.
Exporte werden als geplante Momentaufnahmen generiert, nicht als Echtzeit-Abfragen. Verwende Zeitpläne für kontinuierliche Überwachung oder bereite den Export manuell vor, um ihn zu regenerieren, wenn du sofort aktualisierte Daten benötigst.
So funktionieren Datenexporte
Transaktionsdaten werden als CSV-Dateien innerhalb eines festgelegten Datumsbereichs und mit festgelegten Filtern exportiert.
- Exporte werden asynchron generiert und sind nicht in Echtzeit.
- Exporte werden nach einem konfigurierten Zeitplan aktualisiert.
- Die Auswahl von Vorbereiten regeneriert den Export mit den neuesten verfügbaren Daten.
Jede Zeile in der CSV repräsentiert eine einzelne Vereinbarung und enthält Nutzungsdaten von SMS- und WhatsApp-Transaktionen.
Transaktionsnutzungsbericht erstellen
Erstelle auf der Registerkarte Berichte einen CSV-Bericht.
-
-
Wähle Neuer Export aus.
-
Wähle Transaktionsverbrauch aus.
-
Definiere den Export:
- Wählen einen Datumsbereich aus.
- Wende Filter an, einschließlich einer oder mehrerer Gruppen, falls erforderlich.
-
Wähle Spalten auswählen und wähle die einzuschließenden Daten.
Erweitere für die Nutzung von SMS- und WhatsApp-Transaktionen im Abschnitt „Verfügbare Spalten“ Add-on und schließe Folgendes ein:
- Gekaufte Menge für Add-on zur Nachrichtenzustellung – Gesamtanzahl der gekauften Transaktionen.
- Startdatum für Nachrichtenbereitstellung Add-On — Das jährliche Wirksamkeitsdatum, an dem das Transaktionskontingent angewendet wurde.
- SMS-OTP-Verbrauchszahl — Transaktionen, die für SMS-basierte Authentifizierung verwendet wurden.
- Anzahl der verbrauchten SMS für die Bereitstellung von Vereinbarungen – Transaktionen, die zum Versenden von Vertragslinks per SMS verwendet werden.
- WhatApp-OTP-Verbrauchszahl – Transaktionen, die für WhatsApp-basierte Authentifizierung verwendet wurden.
- Anzahl der verbrauchten WhatsApp-Nachrichten für die Bereitstellung von Vereinbarungen – Transaktionen, die zum Versenden von Vereinbarungslinks per WhatsApp verwendet werden.
Um Berichte auf Gruppenebene zu aktivieren, füge auch die Spalte Sender Group hinzu.
-
Wähle Speichern aus, und gib einen Namen für den Export ein.
Der Export wird asynchron generiert und erscheint in der Liste Aktuelle Berichte, wenn er abgeschlossen ist.
Genaue Daten auf Gruppenebene konfigurieren
Die Nutzung auf Gruppenebene erfordert sowohl Filterung als auch Spaltenauswahl.
- Wende einen oder mehrere Gruppenfilter an, wenn du den Export definierst.
- Beziehe die Spalte Absendendengruppe in den Export ein.
Wenn eine der beiden Anforderungen nicht erfüllt ist, wird die Nutzung auf Gruppenebene in den exportierten Daten nicht genau dargestellt.
Stelle genaue Vertragsnutzungsdaten sicher
So erstellst du Berichte für die korrekte Vertragsperiode:
- Verwende das Phone Quota Effective (Start) date als Startdatum des Berichts.
- Dieser Wert ist verfügbar in: Account Settings > Send Settings
Die Verwendung des korrekten Startdatums stellt sicher, dass alle Transaktionen unter dem aktuellen Vertrag eingeschlossen sind und dass Nutzungssummen und Zusammenfassungen auf Gruppenebene genau sind.
Bericht planen
Plane einen Bericht, um aktualisierte Transaktionsdaten automatisch zu generieren.
-
Lege einen neuen Export an oder bearbeite einen vorhandenen.
-
Wähle die Auslassungspunkte für den Export aus, den du planen möchtest, und wähle im Dropdown-Menü Planen aus.
-
Konfiguriere den Zeitplan, indem du Folgendes definierst:
- Planungsfrequenz (Täglich, Wöchentlich, Monatlich)
- An welche E-Mail-Adressen der Bericht gesendet werden soll
- Eine optionale Nachricht
-
Speichere den Zeitplan.
Geplante Berichte werden automatisch generiert und können aus der Liste Aktuelle Berichte heruntergeladen oder per E-Mail zugestellt werden.
Export mit den neuesten Daten aktualisieren
Um einen Export zu aktualisieren:
- Wähle Vorbereiten aus, um den Export sofort neu zu erstellen.
- Oder warte auf den nächsten geplanten Lauf.
- Du kannst auch einen neuen Export mit denselben Parametern anlegen, falls erforderlich.
Export über die API herunterladen
Rufe den zuletzt generierten Export über die API ab.
- Endpunkt: POST /api/rest/v6/reportDownload
- Erforderlicher Parameter: scheduleId
Dieser Endpunkt:
- Erfordert einen Export-Zeitplan, der in der Benutzungsoberfläche „Berichte“ angelegt wurde.
- Gibt die Download-URL nur für die neueste CSV-Datei zurück.
- Generiert keinen neuen Export auf Anfrage.
Wenn der Export nicht aktualisiert wurde, wird die zuvor generierte CSV-Datei zurückgegeben.
Beim Herunterladen großer CSV-Dateien kann die Verarbeitung länger dauern, da alle Einträge vorbereitet werden müssen. Konfiguriere ein Client-Timeout von mindestens 5 Minuten, um erfolgreiche Downloads sicherzustellen.
Export-Verfügbarkeit und -Aufbewahrung
- Exportierte CSV-Dateien werden 7 Tage lang gespeichert.
- Nach 7 Tagen läuft die Datei ab und steht nicht mehr zum Herunterladen zur Verfügung.
- Um auf aktualisierte Daten zuzugreifen, regeneriere den Export mit Vorbereiten oder warte auf den nächsten geplanten Lauf.
Wissenswertes
- Exporte müssen angelegt oder geplant werden, bevor über die API darauf zugegriffen werden kann.
- Nur die neueste CSV-Datei für einen Zeitplan ist über die API verfügbar.
- Reporting auf Gruppenebene erfordert beides:
- Einen Gruppenfilter
- Die Spalte Absendergruppe
- Die Verwendung des korrekten Startdatums des gültigen Telefonkontingents ist für genaues Reporting auf Vertragsebene erforderlich.
- Export-Dateien laufen nach 7 Tagen ab und müssen bei Bedarf regeneriert werden.
