A computer showing a few icons related to reports API, a magnifier, graphs, video, call and more, a padlock, a robot.

Vonage Reports API ist jetzt allgemein verfügbar

Zuletzt aktualisiert am October 9, 2025

Lesedauer: 4 Minuten

Einführung

Wir freuen uns über die Einführung der Vonage Reports APIvorzustellen, eine API, mit der Sie Ihre Kommunikationsdaten auf einer zentralen Plattform anzeigen und nutzen können. Anstatt Daten aus verschiedenen Quellen abzurufen und zusammenzufügen, steht Ihnen jetzt eine einzige API zur Verfügung, die eine einheitliche Sicht auf Ihre Kommunikation bietet und die Arbeit damit schneller, einfacher und leichter macht.

Wesentliche Merkmale

Mit der Reports API können Sie den Zustellungsstatus verfolgen, auf Rechnungsdaten zugreifen, potenziellen Betrug erkennen und sogar Live-Daten in Ihre eigenen Dashboards einspeisen. Kurz gesagt, es ist Ihre zentrale Anlaufstelle für die Überwachung und Verwaltung der Kommunikation.

Keine Einrichtung erforderlich

Die API ist für jeden Vonage-Kunden sofort einsatzbereit. Sie benötigen lediglich Ihren API-Schlüssel und Ihr Geheimnis, um mit der Abfrage zu beginnen.

Vollständige Datenübersicht

Die Reports API bietet eine einzige Schnittstelle zur Anzeige und Verwaltung all Ihrer Kommunikationsdaten. Sie konsolidiert Nutzungsdaten über eine breite Palette von Vonage-Produkten, darunter:

  • SMS API, einschließlich Verkehrssteuerung

  • Voice API (In-App Voice, WebSocket-Anrufe, Text-to-Speech, ASR, AMD, SIP, PSTN)

  • Messages API (WhatsApp, RCS, SMS/MMS, Viber, Facebook Messenger, Instagram)

  • Verify

  • Netzwerk-APIs (Identity Insights, einschließlich Number Insight)

  • Video API

Flexible Preisgestaltung

Wir haben zwei Arten der Bezahlung entwickelt, damit Sie sich für die beste entscheiden können:

  • Bezahlen wie Sie gehen: Ideal für kleinere Datensätze oder gelegentliche Abfragen. Sie zahlen pro abgerufenen Datensatz.

  • Unbegrenzter Plan: Eine monatliche Pauschalgebühr für Benutzer mit hohem Datenvolumen. Empfohlen, wenn Sie mehr als 1 Million Datensätze pro Monat oder 12 Millionen pro Jahr abrufen.

Zwei Wege zum Abrufen von Daten

  • Synchrone Abfragen sind ideal für schnelle, kleine Berichte (bis zu ~10.000 Datensätze).

  • Asynchrone Abfragen sind für große Berichte mit bis zu 7 Millionen Datensätzen auf einmal gedacht.

Erweiterte Filterung

Filtern Sie nach Datumsbereich, Ereignis-ID, Telefonnummern oder Unterkonten, um genau das abzurufen, was Sie brauchen.

Verwaltung von Unterkonten

Wenn Ihr Unternehmen über mehrere Unterkonten verfügt, können Sie jedes einzelne Konto separat abfragen. Dadurch werden größere Abfragen beschleunigt und Ihre Daten bleiben übersichtlich.

Verfügbarkeit in Echtzeit

Die Daten sind meist in Echtzeit verfügbar, wobei es je nach Produkt einige Unterschiede gibt:

  • Voice API: Die Daten stehen bereit, sobald das Gespräch beendet ist.

  • Verify API: Die Daten sind bereit, sobald der Arbeitsablauf abgeschlossen ist. Die Kanaldaten sind sofort verfügbar

  • Video API: Verfügbar innerhalb von 30 bis 120 Minuten nach der Verarbeitung.

  • Die meisten anderen APIs: Aktualisierungen erfolgen sofort.

Anwendungsfälle aus der realen Welt

Mit der Reports API können Sie viele gängige Probleme lösen:

  • Nutzungs- und Abrechnungsberichte: Zugriff auf Anrufdatensätze und Nachrichtenprotokolle, um Rechnungen zu finden und Kosten zu überwachen.

  • Verfolgung des Zustellungsstatus: Überprüfen Sie sofort den Status einer Nachricht oder eines Anrufs, ohne einen ganzen Datensatz abrufen zu müssen.

  • Finanzkontrolle: Erstellung von Rechnungen für Unterkonten, ideal für Wiederverkäufer, die mehrere Kunden verwalten.

  • Kampagnenmanagement: Verfolgen Sie die Leistung nahezu in Echtzeit und passen Sie die Kampagnen entsprechend an.

  • Betrugserkennung: Erkennen von Betrugsmuster und Ergreifen von Maßnahmen mit dem Betrugsverteidiger Produkt.

  • Echtzeit-Dashboards: Live-Nutzungsdaten in BI-Tools oder benutzerdefinierten Dashboards für sofortige Einblicke.

Bewährte Praktiken

Im Folgenden finden Sie einige Tipps, wie Sie die Reports API optimal nutzen können:

  • Optimierung von Anfragen mit Filtern: Verwenden Sie Filter (z. B. Datumsbereiche, IDs oder Telefonnummern), um nur die erforderlichen Daten abzurufen und so Kosten zu senken und die Effizienz zu steigern.

  • Best Practices für die Überwachung des Nachrichtenstatus: Fordern Sie Berichte an, indem Sie die id Parameter mit der synchronen Methode an, um den aktuellen Nachrichtenstatus ohne wiederholte Aufrufe effizient zu verfolgen.

  • Optimieren von Anfragen mit all Ihren Unterkonten: Bei Hauptkonten mit mehr als 10 Unterkonten rufen Sie zunächst die Liste der Unterkonten über die Unterkonten-API ab und rufen dann die Reports API separat für jedes Unterkonto und für das Hauptkonto selbst auf.

  • Verstehen der Preisgestaltung und Abrechnung: Da die Gebühren pro Datensatz und Bericht anfallen, sollten Sie das Analyse-Dashboard nutzen, um das CDR-Volumen abzuschätzen und unnötige Doppelanfragen zu vermeiden.

  • Handhabung von Beschränkungen: Halten Sie die Größenbeschränkung für asynchrone Berichte von 1 GB und die Ratenbeschränkungen (5 asynchrone oder 10 synchrone Anfragen pro Sekunde) ein, indem Sie die Anfragen mit Filtern in Stücke schneiden.

  • Wählen Sie zwischen der synchronen und der asynchronen Methode: Verwenden Sie die synchrone Methode für kleinere, in Echtzeit benötigte Daten und die asynchrone Methode für größere Datensätze oder CSV-Exporte über mehrere Unterkonten.

  • Effektive Überwachung der API-Nutzung: Verfolgen Sie die Nutzung intern oder verwenden Sie das kostenlose Produkt REPORTS-USAGE, um die Reports API-Aktivitäten der letzten 13 Monate zu analysieren und die Leistung zu optimieren.

Ausführliche Informationen zu den einzelnen Funktionen finden Sie in unserer Dokumentation.

Schlussfolgerung

Die Vonage Reports API ist ab sofort verfügbar und unterstützt Sie bei der Verfolgung, Analyse und Verwaltung Ihrer gesamten Kommunikationsanalysen. Ganz gleich, ob Sie sich auf die Optimierung von Kampagnen, die Kostenkontrolle, die Automatisierung der Abrechnungs- und Nutzungsverfolgung oder die Aufdeckung von Betrug konzentrieren, diese API für die Berichterstellung bietet Ihnen volle Transparenz und Kontrolle. Um mit der Reports API zu beginnen, schauen Sie sich die Reports API-Dokumentation und beginnen Sie mit der Erstellung.

Haben Sie eine Frage oder möchten Sie uns mitteilen, was Sie gerade bauen?

Bleiben Sie auf dem Laufenden und halten Sie sich über die neuesten Nachrichten, Tipps und Veranstaltungen für Entwickler auf dem Laufenden.

Teilen Sie:

https://a.storyblok.com/f/270183/384x384/b68093ec17/diana-pham.png
Diana PhamAdvokat für Entwickler

Diana ist Entwicklungsbeauftragte bei Vonage. Sie isst gerne frische Austern.