Webhooken for detaljerte anropslogger tilbyr en sikker, skalerbar og robust løsning drevet av hendelser i stedet for forespørsler. Denne webhooken gir bedre innsikt i kundenes Webex Calling-aktiviteter, og støtter brukstilfeller fra fakturering til skreddersydd rapportering.

Du kan bruke denne webhooken til å samle inn poster på en enkel måte for alle kunder som administreres via Partner Hub, uten å spørre hver kunde individuelt. Denne webhooken lar deg utvikle tilpassede rapporterings-, fakturerings- og analyseapplikasjoner for både interne forretningskrav og verdiskapende tjenester.

For en introduksjon til webhooken og tilhørende API-er, se denne Vidcasten: Webex Calling Partner Detaljert samtalehistorikk API.

Hva Partner-webhooken leverer

Webhooken leverer detaljerte samtalehistorikkoppføringer hvert 5. minutt. Hver webhook-nyttelast inneholder:

• Samtaleoppføringer som ble avsluttet mellom 10 og 5 minutter før gjeldende tidspunkt.
• Eventuelle forsinkede poster behandlet av Webex Calling-skyen.
• Fyller automatisk ut sene anropsposter i påfølgende webhook-nyttelaster for å sikre pålitelig levering.

For å vise hvordan samtaleoppføringer er inkludert i hver nyttelast, kan du se på følgende eksempel:

• En nyttelast mottatt kl. 14:05 inneholder samtaler som ble avsluttet mellom 13:55 og 14:00.
• Samtaler som slutter mellom 14:00 og 14:05 er inkludert i 14:10 nyttelast.
• Oppføringer fullført tidligere (for eksempel en samtale som sluttet kl. 14:04) men behandlet sent av Webex Calling Cloud (for eksempel kl. 14:11) er inkludert i den neste planlagte nyttelasten (for eksempel 14:15).

Webhook i Partner Hub

Ved å bruke en webhook, lar du analyseplattformen sende anropsoppføringer til tilbakeringings-URL-en din når de genereres.

Webex-anropsoppføringer leveres med samme format som de eksisterende detaljerte API-ene for anropsoppføringer. Du kan sette opp en webhook og velge mellom to typer feeder:

• Analyse – inkluderer alle samtaleoppføringer for alle kundeorganisasjoner som partneren har et Webex Calling-forhold med. Dette inkluderer organisasjoner der:
  • Partneren administrerer kundeorganisasjonen med rollen som partneradministrator.
  • Kundeorganisasjonen har et aktivt Webex Calling-abonnement i partnerorganisasjonen.
• Fakturering – inkluderer samtaleoppføringer for samtaler foretatt av brukere med en Webex Calling-lisens solgt og klargjort av partneren. Samtaleoppføringer for arbeidsområder er inkludert i denne feeden.

Tilgang og databeskyttelse

Bare den eierpartneren har tilgang til samtaledetaljer (CDR) for fakturering.

• En partner (eller underpartner) som administrerer lisensen knyttet til samtaleoppføringen blir eierpartner.
• Eierskap bestemmes av: Bruker-ID > Lisens-ID > Abonnements-ID > Partner-ID.
• Hver CDR er tilgjengelig for én enkelt partner.
• Enkelte samtaleoppføringer er ikke knyttet til en faktureringspartner, og ikke alle partnere som er tilknyttet en organisasjon, får lik tilgang til alle oppføringer, siden disse oppføringene kan inneholde personlig identifiserbar informasjon (PII).

I tillegg til webhooken tilbyr Webex Calling API-endepunkter for å støtte dataavstemming. Disse endepunktene lar deg ta igjen eller avstemme datalagrene dine med eventuelle manglende poster som webhook-lytteren din kanskje ikke har mottatt. De to API-endepunktene er Avstemmings-API og Records API.

Poster fra disse API-ene er tilgjengelige i 30 dager. For å sikre at du mottar alle forventede dokumenter, anbefaler vi at du avstemmer dokumentlagrene dine med jevne mellomrom, for eksempel hver 12. eller 24. time.

Du må bruke et partnertilgangstoken for å få tilgang til disse API-ene. Skaff og administrer partnerens tilgangstoken i henhold til standard Webex Developer-praksis for administrasjon av tilgangstoken.

Sluttpunkt for avstemmings-API

Sluttpunktet for avstemmings-API-et returnerer det totale antallet anropsposter som er generert for hver kunde som administreres av partneren innenfor den angitte tidsperioden. Du kan bruke disse totalene til å bekrefte din lokale lagring og identifisere eventuelle manglende eller inkonsistente samtaleoppføringer for bestemte kunder.

Hvis du administrerer mer enn 200 kundeorganisasjoner, paginerer API-et resultatene for å forbedre lesbarheten.

URL-adressen for endepunktet for avstemmings-API-et bruker følgende format:

API-parametere

Du kan bruke API-et til å hente samtaleoppføringer fra de siste 30 dagene. Det valgte tidsvinduet må starte minst 5 minutter før gjeldende UTC-tid og kan ikke overstige 12 timer mellom start- og sluttidspunktet i et enkelt API-kall.

API-parametrene er:

• startTime (obligatorisk, streng) – Startdatoen og -klokkeslettet (UTC) for den første posten du vil samle inn. Sørg for at:
  • Du formaterer tiden som YYYY-MM-DDTHH:MM:SS.mmmZ. For eksempel, 2025-08-15T06:00:00.000Z.
  • Startdatoen og -klokkeslettet må ikke være eldre enn 30 dager fra gjeldende UTC-tid.
  • Vinduet mellom startTime og endTime kan ikke overstige 12 timer.
• endTime (obligatorisk, streng) – Sluttdato og -klokkeslett (UTC) for postene du vil samle inn. Registreringer er basert på rapporteringstidspunkt, som er når samtalen er ferdig. Sørg for at:
  • Du formaterer tiden som YYYY-MM-DDTHH:MM:SS.mmmZ. For eksempel, 2025-08-15T18:00:00.000Z.
  • Sluttdatoen og -klokkeslettet må være 5 minutter før gjeldende UTC-tid og ikke eldre enn 30 dager.
  • Sluttdatoen og -klokkeslettet må være større enn startTime.
  • Vinduet mellom startTime og endTime kan ikke overstige 12 timer.

Eksempel på et JSON-svar for endepunktet for avstemmings-API-et:

          {
          "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
          }
          ]
          }          
        

API-svarhodene angir det totale antallet organisasjoner som returneres og om det er flere sider tilgjengelig. Sjekk følgende overskriftsparametere for å sikre at du har spørret alle sider:

• antall sider: Totalt antall sider (for eksempel 2)
• total-organisasjoner: Totalt antall organisasjoner inkludert i svaret (for eksempel 283)
• gjeldende side: Gjeldende sidetall (for eksempel 1)

Hvis for eksempel overskriftene viser num-pages=2, total-orgs=283, og current-page=1, Du ser på den første siden av et tosiders svar som inneholder totalt 283 organisasjoner. For å få tilgang til neste side, legg til page=2 parameter til GET-forespørselen din, som vist nedenfor:

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

Records API-endepunkt

Records API-endepunktet brukes til å spørre etter manglende anropsoppføringer for spesifikke organisasjoner der avvik eller manglende data ble identifisert ved hjelp av Reconciliation API.

Records API returnerer anropsoppføringer i JSON-format, identisk med formatet beskrevet i Detailed Call History API. Den returnerte nyttelasten inneholder identiske felt som den returnerte nyttelasten for detaljert samtalehistorikk. Hvis du vil ha mer informasjon om feltene og verdiene deres, kan du se Webex Calling Detaljert samtalehistorikkrapport.

API-et inneholder anropslogger som ble avsluttet 5 minutter før gjeldende tidspunkt. For å sikre at alle samtaleoppføringer blir tilgjengelige, anbefaler vi at du spør API-et én time etter ditt foretrukne tidsvindu.

URL-adressen for Records API-endepunktet bruker følgende 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-parametere

• OrgID (obligatorisk, streng) – Organisasjons-ID-en du vil hente poster for. Du kan hente organisasjons-ID-er fra avstemmings-API-et.
• startTime (obligatorisk, streng) – Startdatoen og -klokkeslettet (UTC) for den første posten du vil samle inn. Sørg for at:
  • Du formaterer tiden som YYYY-MM-DDTHH:MM:SS.mmmZ. For eksempel, 2025-08-15T06:00:00.000Z.
  • Startdatoen og -klokkeslettet må ikke være eldre enn 30 dager fra gjeldende UTC-tid.
  • Intervallet mellom startTime og endTime må ikke overstige 12 timer i én API-forespørsel.
• endTime (obligatorisk, streng) – Sluttdato og -klokkeslett (UTC) for den siste posten du vil samle inn. Registreringer er basert på rapporteringstidspunkt, som er når samtalen er ferdig. Sørg for at:
  • Du formaterer tiden som YYYY-MM-DDTHH:MM:SS.mmmZ. For eksempel, 2025-08-15T18:00:00.000Z.
  • Sluttdatoen og -klokkeslettet må være minst 5 minutter før gjeldende UTC-tid og ikke eldre enn 30 dager.
  • Sluttdatoen og -klokkeslettet må være større enn startTime.
  • Intervallet mellom startTime og endTime må ikke overstige 12 timer i én API-forespørsel.
• Maks (valgfritt, antall) – Begrenser det maksimale antallet poster per side i svaret. Sørg for at:
  • Spekteret er fra 500 til 5000. Standardverdien er 5000. For eksempel, Max=1000.
  • Hvis API-et har flere poster å returnere enn den angitte maksverdien, blir svaret paginert.
  • Hvis en verdi under 500 er angitt, justeres den automatisk opp til 500. Hvis en verdi over 5000 er angitt, justeres den ned til 5000.

Paginering

For å identifisere om API-svar er paginerte, sjekk svaroverskriftene for en lenkeoverskrift. Hvis en next -lenke finnes i lenkeoverskriften, pakker du den ut og bruker startTimeForNextFetch -verdien til å be om det neste settet med poster. Hvis det ikke finnes noen neste lenke, samles alle rapporter for det valgte tidsperioden inn.

API-forespørsler for påfølgende sider kan gjøres umiddelbart, men må begrenses til maksimalt 10 paginerte forespørsler per minutt, per token-omfang.

Hvis for eksempel den første API-forespørselen er:

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

så er lenkeoverskriften i svaret:

; rel="next"

Andre mulige lenkeverdier inkluderer rel="first" og rel="prev" for henholdsvis den første og forrige siden.

Partner reports/templates API-en

Du kan generere og laste ned rapporter som er tilgjengelige i Partner Hub ved hjelp av Partner Reports API-ene. For mer informasjon, se partner report/templates.

Partnere kan også få tilgang til og laste ned flere rapporter direkte fra Partner Hub. Hvis du vil ha mer informasjon, kan du se Partner Hub-rapporter.