Danke für Ihr Feedback.

Der Webhook Detailed Call Records bietet eine sichere, skalierbare und robuste Lösung, die eher auf Ereignissen als auf Anfragen basiert. Dieser Webhook bietet einen besseren Überblick über die Webex Calling Aktivitäten Ihrer Kunden und unterstützt Anwendungsfälle von der Abrechnung bis hin zu maßgeschneiderten Berichten.

Sie können diesen Webhook verwenden, um bequem Datensätze für alle Kunden zu sammeln, die über Partner Hub verwaltet werden, ohne jeden Kunden einzeln abzufragen. Mit diesem Webhook können Sie benutzerdefinierte Berichts-, Abrechnungs- und Analyseanwendungen sowohl für interne Geschäftsanforderungen als auch für Mehrwertdienste entwickeln.

Für eine Einführung in den Webhook und die dazugehörigen APIs schauen Sie sich diesen Vidcast an: Webex Calling Partner Detailed Call History API.

Was der Partner-Webhook bietet

Der Webhook liefert alle 5 Minuten detaillierte Aufzeichnungen der Anrufliste. Jede Webhook-Nutzlast enthält :

• Anruflisten, die zwischen 10 Minuten und 5 Minuten vor der aktuellen Uhrzeit endeten.
• Alle verspäteten Aufzeichnungen, die von der Webex Calling Cloud verarbeitet wurden.
• Füllt automatisch die Aufzeichnungen über verspätete Anrufe in den nachfolgenden Webhook-Payloads auf, um eine zuverlässige Zustellung zu gewährleisten .

Um zu zeigen, wie Anruflisten in jeder Nutzlast enthalten sind, betrachten Sie das folgende Beispiel:

• Eine um 14:05 Uhr eingegangene Payload enthält Anrufe, die zwischen 13:55 und 14:00 Uhr endeten.
• Anrufe, die zwischen 14:00 und 14:05 Uhr enden, sind in der Payload von 14:10 enthalten.
• Datensätze, die früher abgeschlossen wurden (zum Beispiel ein Anruf, der um 14:04 Uhr endete), aber spät per Webex Calling Cloud verarbeitet wurden (zum Beispiel um 14:11 Uhr), sind in der nächsten geplanten Nutzlast enthalten (zum Beispiel 14:15).

Webhook im Partner Hub

Indem Sie einen Webhook bereitstellen, ermöglichen Sie der Analyseplattform, Anruflisten an Ihre Rückruf-URL zu senden, wann immer sie generiert werden.

Webex CallingAufzeichnungen werden im gleichen Format wie die bestehenden APIs für detaillierte Anrufaufzeichnungen geliefert. Sie können einen Webhook einrichten und zwischen zwei Arten von Feeds wählen:

• Analytik — Beinhaltet alle Anruflisten für alle Kundenorganisationen, mit denen der Partner eine Webex Calling Beziehung unterhält. Dazu gehören Organisationen, bei denen:
  • Der Partner verwaltet die Kundenorganisation mit der Rolle „Partner Full Administrator“.
  • Die Kundenorganisation hat ein aktives Webex Calling Abonnement innerhalb der Partnerorganisation.
• Abrechnung — Beinhaltet Anruflisten für Anrufe von Benutzern mit einer Webex Calling Lizenz, die vom Partner verkauft und bereitgestellt wurde. Anruflisten für Workspaces sind in diesem Feed enthalten.

Zugang und Datenschutz

Nur der Inhaberpartner kann für die Abrechnung auf Call Detail Records (CDR) zugreifen.

• Ein Partner (oder Unterpartner), der die mit dem Anrufdatensatz verknüpfte Lizenz verwaltet, wird zum besitzenden Partner.
• Die Inhaberschaft wird bestimmt durch: Benutzer-ID > Lizenz-ID > Abonnement-ID > Partner-ID.
• Jedes CDR ist für einen einzelnen Partner zugänglich.
• Manche Anruflisten sind keinem Abrechnungspartner zugeordnet, und nicht alle Partner, die mit einer Organisation verbunden sind, erhalten gleichen Zugriff auf alle Aufzeichnungen, da diese Aufzeichnungen personenbezogene Daten (PII) enthalten können.

Webex CallingBietet zusätzlich zum Webhook API-Endpunkte zur Unterstützung des Datenabgleichs. Mit diesen Endpunkten können Sie Ihre Datenspeicher mit fehlenden Datensätzen, die Ihr Webhook-Listener möglicherweise nicht erhalten hat, nachholen oder abgleichen. Die beiden API-Endpunkte sind die Reconciliation API und die Records API.

Aufzeichnungen von diesen APIs sind 30 Tage lang verfügbar. Um sicherzustellen, dass Sie alle erwarteten Aufzeichnungen erhalten, empfehlen wir, Ihre Plattenspeicher regelmäßig abzugleichen, etwa alle 12 oder 24 Stunden.

Sie müssen ein Partnerzugriffstoken verwenden, um auf diese APIs zuzugreifen. Der authentifizierende Benutzer muss ein Partner-Volladministrator mit vollständigem Administratorzugriff für die Organisation sein und der Webex CallingCDR-API-Zugriff muss aktiviert sein. Das OAuth-Token muss den spark-admin:calling_cdr_readBereich enthalten. Schreibgeschützte Administratorrollen reichen für die Partner Reconciliation and Records APIs nicht aus.

Verwenden Sie den analytics-callingEndpunkt für die Webex Calling Datenregion der Kundenorganisation. Verwenden Sie die entsprechende Basis-URL sowohl für die Abgleich- als auch für die Datensatz-API:

• USA und Kanada: https://analytics-calling.webexapis.com
• Europa: https://analytics-calling-eu.webexapis.com
• Indien: https://analytics-calling-in.webexapis.com
• Australien: https://analytics-calling-au.webexapis.com

API-Endpunkt für den Abgleich

Der API-Endpunkt zur Abstimmung gibt die Gesamtzahl der Anrufdatensätze zurück, die für jeden vom Partner verwalteten Kunden innerhalb des angegebenen Zeitraums generiert wurden. Sie können diese Summen verwenden, um Ihren lokalen Speicher zu verifizieren und fehlende oder inkonsistente Anruflisten für bestimmte Kunden zu identifizieren.

Wenn Sie mehr als 200 Kundenorganisationen verwalten, paginiert die API die Ergebnisse, um die Lesbarkeit zu verbessern.

Die URL des Abgleich-API-Endpunkts verwendet das folgende Format:

API-Parameter

Sie können die API verwenden, um Anruflisten der letzten 30 Tage abzurufen. Ihr ausgewähltes Zeitfenster muss mindestens 5 Minuten vor der aktuellen UTC-Zeit beginnen und darf 12 Stunden zwischen den Start- und Endzeiten in einem einzigen API-Aufruf nicht überschreiten.

Die API-Parameter sind:

• startTime (erforderlich, Zeichenfolge) — Das Startdatum und die Startzeit (UTC) für den ersten Datensatz, den Sie sammeln möchten. Stellen Sie sicher, dass:
  • Sie formatieren die Uhrzeit als YYYY-MM-DDTHH:MM:SS.mmmZ. Zum Beispiel 2025-08-15T06:00:00.000Z.
  • Das Startdatum und die Startzeit dürfen nicht älter als 30 Tage von der aktuellen UTC-Zeit sein.
  • Das Zeitfenster zwischen startTimeund endTimedarf 12 Stunden nicht überschreiten.
• endTime (erforderlich, Zeichenfolge) — Das Enddatum und die Endzeit (UTC) für die Datensätze, die Sie sammeln möchten. Die Aufzeichnungen basieren auf der Berichtszeit, also dem Zeitpunkt, zu dem der Anruf abgeschlossen ist. Stellen Sie sicher, dass:
  • Sie formatieren die Uhrzeit als YYYY-MM-DDTHH:MM:SS.mmmZ. Zum Beispiel 2025-08-15T18:00:00.000Z.
  • Das Enddatum und die Endzeit müssen 5 Minuten vor der aktuellen UTC-Zeit liegen und dürfen nicht älter als 30 Tage sein.
  • Das Enddatum und die Endzeit müssen größer sein als der startTime.
  • Das Zeitfenster zwischen startTimeund endTimedarf 12 Stunden nicht überschreiten.

Beispiel für eine JSON-Antwort auf einen API-Endpunkt zur Abstimmung:

          {
          "cdr_counts": [
          {
          "orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 3009
          },
          {
          "orgId": "yyyyyyyy-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 129
          },
          {
          "orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 27895
          }
          ]
          }          
        

Die API-Antwort-Header geben die Gesamtzahl der zurückgegebenen Organisationen an und ob zusätzliche Seiten verfügbar sind. Überprüfen Sie die folgenden Header-Parameter, um sicherzustellen, dass Sie alle Seiten abgefragt haben:

• num-pages: Gesamtzahl der Seiten (zum Beispiel 2)
• total-orgs: Gesamtzahl der Organisationen, die in der Antwort berücksichtigt wurden (zum Beispiel 283)
• aktuelle Seite: Die aktuelle Seitennummer (zum Beispiel 1)

Wenn die Header beispielsweise num-pages=2, total-orgs=283 und current-page=1 anzeigen, sehen Sie die erste Seite einer zweiseitigen Antwort mit insgesamt 283 Organisationen. Um auf die nächste Seite zuzugreifen, fügen Sie Ihrer GET-Anfrage den Parameter page=2 hinzu, wie unten gezeigt:

https://analytics-calling.webexapis.com/v1/partners/cdrcountbyorg?endTime=YYYY-MM-DDTHH:MM:SS.000Z&startTime=YYYY-MM-DDTHH:MM:SS.000Z&page=2

Datensatz-API-Endpunkt

Der Records-API-Endpunkt wird verwendet, um fehlende Anruflisten für bestimmte Organisationen abzufragen, bei denen Unstimmigkeiten oder fehlende Daten mithilfe der Reconciliation-API festgestellt wurden.

Empfohlener Ablauf: Rufen Sie /v1/partners/cdrcountbyorgzuerst an. Verwenden Sie dann den exakten orgIdcdr_counts[].orgIdRückgabewert, wenn Sie anrufen /v1/partners/cdrsbyorg.

Die Datensatz-API gibt Anruflisten im JSON-Format zurück, identisch mit dem Format, das in der Detailed Call History API beschrieben ist. Die zurückgegebene Payload enthält identische Felder wie die zurückgegebene Payload „Detailed Call History“. Weitere Informationen zu den Feldern und ihren Werten finden Sie unter Webex CallingDetaillierter Bericht zur Anrufliste.

Die API stellt Anruflisten bereit, die 5 Minuten vor der aktuellen Uhrzeit endeten. Um sicherzustellen, dass alle Anruflisten verfügbar sind, empfehlen wir, die API eine Stunde nach Ihrem bevorzugten Zeitfenster abzufragen.

Die Records-API-Endpunkt-URL verwendet das folgende Format:

https://analytics-calling.webexapis.com/v1/partners/cdrsbyorg?orgId=zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy&endTime=YYYY-MM-DDTHH:MM:SS.000Z&startTime=YYYY-MM-DDTHH:MM:SS.000Z

API-Parameter

• orgId(erforderlich, Zeichenfolge) — Die ID der Kundenorganisation, für die Sie Datensätze abrufen möchten. Beim Parameternamen wird zwischen Groß- und Kleinschreibung unterschieden. Sie können Organisations-IDs aus dem Antwortfeld der Reconciliation API abrufen cdr_counts[].orgId.
• startTime (erforderlich, Zeichenfolge) — Das Startdatum und die Startzeit (UTC) für den ersten Datensatz, den Sie sammeln möchten. Stellen Sie sicher, dass:
  • Sie formatieren die Uhrzeit als YYYY-MM-DDTHH:MM:SS.mmmZ. Zum Beispiel 2025-08-15T06:00:00.000Z.
  • Das Startdatum und die Startzeit dürfen nicht älter als 30 Tage von der aktuellen UTC-Zeit sein.
  • Das Intervall zwischen startTimeund endTimedarf 12 Stunden in einer einzigen API-Anfrage nicht überschreiten.
• endTime (erforderlich, Zeichenfolge) — Das Enddatum und die Endzeit (UTC) für den letzten Datensatz, den Sie sammeln möchten. Die Aufzeichnungen basieren auf der Berichtszeit, also dem Zeitpunkt, zu dem der Anruf abgeschlossen ist. Stellen Sie sicher, dass:
  • Sie formatieren die Uhrzeit als YYYY-MM-DDTHH:MM:SS.mmmZ. Zum Beispiel 2025-08-15T18:00:00.000Z.
  • Das Enddatum und die Endzeit müssen mindestens 5 Minuten vor der aktuellen UTC-Zeit liegen und dürfen nicht älter als 30 Tage sein.
  • Das Enddatum und die Endzeit müssen größer sein als der startTime.
  • Das Intervall zwischen startTimeund endTimedarf 12 Stunden in einer einzigen API-Anfrage nicht überschreiten.
• max (optional, Zahl) — Begrenzt die maximale Anzahl von Datensätzen pro Seite in der Antwort. Stellen Sie sicher, dass:
  • Der Bereich reicht von 500 bis 5000. Der Standardwert ist 5000. Zum Beispiel max=1000.
  • Wenn die API mehr Datensätze als den angegebenen Maximalwert zurückgeben muss, wird die Antwort paginiert.
  • Wenn ein Wert unter 500 angegeben wird, wird er automatisch auf 500 angepasst. Wenn ein Wert über 5000 angegeben wird, wird er auf 5000 herunterkorrigiert.

Paginierung

Um festzustellen, ob API-Antworten paginiert sind, überprüfen Sie die Antwort-Header auf einen Link-Header. Wenn ein nextLink im Link-Header vorhanden ist, extrahieren Sie ihn und verwenden Sie den startTimeForNextFetchWert, um die nächsten Datensätze anzufordern. Wenn es keinen nächsten Link gibt, werden alle Berichte für den ausgewählten Zeitraum gesammelt.

API-Anfragen für nachfolgende Seiten können sofort gestellt werden, müssen jedoch auf maximal 10 paginierte Anfragen pro Minute pro Token-Umfang begrenzt werden.

Verwenden Sie idempotente Verarbeitung und Deduplizierung, wenn Sie Datensätze abrufen, auch über paginierte Antworten oder wiederholte Abstimmungsfenster hinweg. Verwenden Sie reportIdals Primärschlüssel und reportTimeum den zuletzt verarbeiteten Datensatz zu ermitteln.

Zum Beispiel, wenn die erste API-Anfrage lautet:

https://analytics-calling.webexapis.com/v1/partners/cdrsbyorg?orgId=zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy&endTime=2025-08-15T18:00:00.000Z&startTime=2025-08-15T06:00:00.000Z&max=5000

dann lautet der Link-Header in der Antwort:

<https://analytics-calling.webexapis.com/v1/partners/cdrsbyorg?orgId=zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy&endTime=2025-08-15T18:00:00.000Z&startTime=2025-08-15T06:00:00.000Z&startTimeForNextFetch=2025-08-15T09:30:00.000Z&totalCount=20000&max=5000>; rel="next"

Bei der Paginierung wird nur der rel="next"Link-Header verwendet. Wenn die Antwort einen rel="next"Link enthält, verwenden Sie diese URL, um die nächste Seite mit Datensätzen abzurufen. Wenn die Antwort keinen rel="next"Link enthält, haben Sie alle verfügbaren Datensätze für den ausgewählten Zeitraum abgerufen.

Sie können Berichte, die in Partner Hub verfügbar sind, mithilfe der Partner Reports APIs generieren und herunterladen. Weitere Informationen finden Sie im Partnerbericht/in den Vorlagen.

Partner können auch direkt vom Partner Hub auf mehrere Berichte zugreifen und diese herunterladen. Weitere Informationen finden Sie unter Partner Hub-Berichte.