Logo
Login

Reports API

Mit der Reports API steht Ihnen eine Schnittstelle zur Verfügung, die Ihnen Zugriff auf detaillierte Aufzeichnungen aller Kommunikationsaktivitäten Ihres Unternehmens ermöglicht. Wenn Sie Kommunikationsdienste wie SMS, Telefonie, WhatsApp oder andere Messaging-Kanäle nutzen, werden automatisch Protokolldaten erstellt – sogenannte Call Detail Records (CDRs). Die Reports API ermöglicht es Ihnen, diese Daten strukturiert abzurufen und auszuwerten.

Die Vorteile der Reports API

/uploads/C_Paa_S_7c8405c9c9_1fbd6fbd82.svg

Umfassende Übersicht über alle Kommunikationskanäle

Mit einer einzigen Schnittstelle erhalten Sie Zugriff auf Daten aus verschiedenen Kommunikationskanälen: - SMS und MMS - WhatsApp, Viber, Instagram und Messenger - Telefonie (klassische Anrufe und Internettelefonie) - Videokonferenzen - Verifizierungsdienste - und weitere
/uploads/news_icon_18_27640312aa_e69e8464d6.svg

Flexible Datenabrufmöglichkeiten

Die Reports API bietet zwei verschiedene Abrufmethoden, die Sie je nach Bedarf wählen können: Synchroner Abruf – für den schnellen Zugriff auf kleinere Datenmengen: - Sofortige Ergebnisse - Ideal für regelmäßige Abfragen - Abruf von einzelnen bis zu mehreren tausend Datensätzen - Möglichkeit, einzelne Nachrichten oder Anrufe gezielt anhand ihrer ID zu suchen Asynchroner Abruf – für große Datenmengen: - Optimiert für umfangreiche Auswertungen - Verarbeitung von tausenden bis Millionen von Datensätzen - Ergebnisse werden als komprimierte Datei bereitgestellt - Automatische Benachrichtigung, wenn die Daten verfügbar sind

Umfangreiche Filtermöglichkeiten

Sie können Ihre Daten nach verschiedenen Kriterien filtern:

  • Zeiträume (bis zu 13 Monate zurück)
  • Telefonnummern (Absender und Empfänger)
  • Kommunikationsrichtung (eingehend oder ausgehend)
  • Status der Nachricht (zugestellt, fehlgeschlagen, abgelehnt, etc.)
  • Unterkonten
  • Spezifische Nachrichteninhalte

Datenaufbewahrung

Ihre Kommunikationsdaten werden standardmäßig 13 Monate lang gespeichert (bei Video-API 90 Tage). Ältere Daten werden automatisch gelöscht.

So funktioniert der Datenabruf

Synchroner Abruf (für kleinere Datenmengen)

  1. Sie senden eine Anfrage mit Ihren gewünschten Filterkriterien
  2. Die API liefert sofort bis zu 1.000 Datensätze im JSON-Format
  3. Falls mehr Daten verfügbar sind, erhalten Sie einen Link zur nächsten Seite
  4. Sie können einzelne Nachrichten anhand ihrer eindeutigen ID gezielt abrufen

Asynchroner Abruf (für große Datenmengen)

  1. Sie erstellen eine Datenanfrage mit Ihren Filterkriterien
  2. Die API registriert Ihre Anfrage und beginnt mit der Verarbeitung
  3. Die Daten werden zu einer komprimierten CSV-Datei zusammengefasst
  4. Optional: Sie erhalten eine automatische Benachrichtigung, wenn die Datei fertig ist
  5. Sie laden die Datei innerhalb von 72 Stunden herunter (danach wird sie automatisch gelöscht)

Hinweis zur Leistung: Die asynchrone API verarbeitet durchschnittlich 1 Million Datensätze in 5 bis 10 Minuten. Für optimale Ergebnisse wird empfohlen, Abfragen auf maximal 7 Millionen Datensätze zu begrenzen.

Unterstützte Produkte und Dienste

Die Reports API funktioniert mit einer Vielzahl von Kommunikationsdiensten:

  • Textnachrichten (SMS, MMS, RCS)
  • Instant Messaging (WhatsApp, Viber, Instagram, Facebook Messenger)
  • Telefonie (klassische und Internet-basierte Anrufe)
  • Spracherkennung und Sprachsynthese
  • Videokonferenzen
  • Zwei-Faktor-Authentifizierung
  • Telefonnummern-Informationsdienste
  • Netzwerk-APIs (z.B. SIM-Swap-Erkennung)

Learn more about our APIs

Interested in how our APIs can help your business? Connect with a Deutsche Telekom API expert: fill out the form and we'll get back to you shortly..