Spletni kavelj s podrobnimi zapisi klicev ponuja varno, prilagodljivo in robustno rešitev, ki jo poganjajo dogodki in ne zahteve. Ta spletni kavelj omogoča boljši vpogled v dejavnosti vaših strank pri klicih Webex in podpira primere uporabe, od obračunavanja do poročanja po meri.

Ta spletni kavelj lahko uporabite za priročno zbiranje zapisov za vse stranke, ki jih upravljate prek središča za partnerje, ne da bi vsako stranko posebej poizvedovali. Ta spletni kavelj vam omogoča razvoj prilagojenih aplikacij za poročanje, obračunavanje in analitiko tako za interne poslovne zahteve kot za storitve z dodano vrednostjo.

Za uvod v spletni kavelj in njegove spremljajoče API-je si oglejte ta videoposnetek: API za podrobno zgodovino klicev partnerja Webex Calling.

Kaj ponuja spletni kavelj Partner

Spletni kavelj vsakih 5 minut dostavi podrobne zapise zgodovine klicev. Vsak spletni kavelj vsebuje:

• Zapisi klicev, ki so se končali med 10 in 5 minutami pred trenutnim časom.
• Vsi zamujeni zapisi, ki jih obdela oblak Webex Calling.
• Samodejno zapolni zapise o poznih klicih v naslednjih koristnih podatkih spletnega kavlja, da se zagotovi zanesljiva dostava.

Za prikaz, kako so zapisi klicev vključeni v vsak koristni tovor, si oglejte naslednji primer:

• Tovor, prejet ob 14:05 vsebuje klice, ki so se končali med 13:55 in 14:00.
• Klici, ki se končajo med 14:00 in 14:05 so vključeni v 14:10 koristni tovor.
• Zapisi, opravljeni prej (na primer klic, ki se je končal ob 14:04) vendar ga Webex Calling Cloud obdela pozno (na primer ob 14:11) so vključeni v naslednji načrtovani koristni tovor (na primer 14:15).

Spletni kavelj v središču Parter

Z zagotavljanjem spletnega kavlja omogočite platformi za analitiko, da pošilja zapise klicev na vaš URL za povratni klic, kadar koli so ustvarjeni.

Zapisi klicev Webex se dostavljajo v isti obliki kot obstoječi podrobni API-ji za zapise klicev. Nastavite lahko spletni kavelj in izbirate med dvema vrstama vira:

• Analitika – vključuje vse zapise klicev za vse organizacije strank, s katerimi ima partner vzpostavljen odnos Webex Calling. To vključuje organizacije, kjer:
  • Partner upravlja organizacijo stranke z vlogo skrbnika partnerja s polnim statusom.
  • Stranka ima aktivno naročnino na Webex Calling znotraj partnerske organizacije.
• Obračunavanje – Vključuje zapise klicev, ki jih opravijo uporabniki z licenco Webex Calling, ki jo je prodal in zagotovil partner. Zapisi klicev za delovne prostore so vključeni v ta vir.

Dostop in zasebnost podatkov

Dostop do zapisov o podrobnostih klicev (CDR) za obračunavanje ima samo lastnik partnerja.

• Partner (ali podpartner), ki upravlja licenco, povezano z zapisom klica, postane lastniški partner.
• Lastništvo se določa z: ID uporabnika > ID licence > ID naročnine > ID partnerja.
• Vsak CDR je dostopen enemu partnerju.
• Nekateri zapisi klicev se ne preslikajo na partnerja za obračunavanje in vsi partnerji, povezani z organizacijo, nimajo enakega dostopa do vseh zapisov, saj lahko ti zapisi vsebujejo osebno določljive podatke.

Poleg spletnega kavlja Webex Calling ponuja tudi končne točke API-ja za podporo usklajevanja podatkov. Te končne točke vam omogočajo, da nadoknadite ali uskladite shrambe podatkov z manjkajočimi zapisi, ki jih vaš poslušalnik spletnega kavlja morda ni prejel. Končni točki API-ja sta API za usklajevanje in API za zapise.

Zapisi iz teh API-jev so na voljo 30 dni. Da boste prejeli vse pričakovane zapise, priporočamo, da redno usklajujete svoje shrambe zapisov, na primer vsakih 12 ali 24 ur.

Za dostop do teh API-jev morate uporabiti partnerski dostopni žeton. Pridobite in upravljajte svoj partnerski dostopni žeton v skladu s standardnimi praksami upravljanja dostopnih žetonov za razvijalce Webex.

Končna točka API-ja za usklajevanje

Končna točka API-ja za usklajevanje vrne skupno število ustvarjenih zapisov klicev za vsako stranko, ki jo upravlja partner v določenem časovnem obdobju. Te vsote lahko uporabite za preverjanje lokalnega pomnilnika in prepoznavanje morebitnih manjkajočih ali nedoslednih zapisov klicev za določene stranke.

Če upravljate več kot 200 organizacij strank, API rezultate oštevilči za izboljšanje berljivosti.

URL končne točke API-ja za usklajevanje uporablja naslednjo obliko zapisa:

Parametri API-ja

Z API-jem lahko pridobite zapise klicev iz zadnjih 30 dni. Izbrano časovno okno se mora začeti vsaj 5 minut pred trenutnim časom UTC in ne sme presegati 12 ur med začetnim in končnim časom v enem samem klicu API-ja.

Parametri API-ja so:

• startTime (obvezno, niz) – Začetni datum in čas (UTC) za prvi zapis, ki ga želite zbrati. Zagotovite, da:
  • Čas formatirate kot YYYY-MM-DDTHH:MM:SS.mmmZ. Na primer, 2025-08-15T06:00:00.000Z.
  • Začetni datum in ura ne smeta biti starejša od 30 dni od trenutnega časa UTC.
  • Okno med startTime in endTime ne sme presegati 12 ur.
• endTime (obvezno, niz) – Končni datum in čas (UTC) za zapise, ki jih želite zbrati. Zapisi temeljijo na času poročila, kar pomeni, kdaj je klic opravljen. Zagotovite, da:
  • Čas formatirate kot YYYY-MM-DDTHH:MM:SS.mmmZ. Na primer, 2025-08-15T18:00:00.000Z.
  • Končni datum in čas morata biti 5 minut pred trenutnim časom UTC in ne starejša od 30 dni.
  • Končni datum in čas morata biti večja od startTime.
  • Okno med startTime in endTime ne sme presegati 12 ur.

Primer odgovora JSON končne točke API-ja za usklajevanje:

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

Glave odgovorov API-ja označujejo skupno število vrnjenih organizacij in ali so na voljo dodatne strani. Preverite naslednje parametre glave, da se prepričate, da ste poizvedovali po vseh straneh:

• število-strani: Skupno število strani (na primer 2)
• skupno-org: Skupno število organizacij, vključenih v odgovor (na primer 283)
• trenutna-stran: Trenutna številka strani (na primer 1)

Na primer, če se v glavah prikaže num-pages=2, total-orgs=283, in current-page=1, Ogledate si prvo stran dvostranskega odgovora, ki vsebuje skupno 283 organizacij. Za dostop do naslednje strani dodajte page=2 parameter vaši zahtevi GET, kot je prikazano spodaj:

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

Končna točka API-ja za zapise

Končna točka API-ja za zapise se uporablja za poizvedovanje manjkajočih zapisov klicev za določene organizacije, kjer so bila z uporabo API-ja za usklajevanje ugotovljena neskladja ali manjkajoči podatki.

API za zapise vrne zapise klicev v formatu JSON, ki je enak formatu, opisanemu v podrobnem API-ju za zgodovino klicev. Vrnjeni koristni tovor vsebuje enaka polja kot vrnjeni koristni tovor s podrobno zgodovino klicev. Za več informacij o poljih in njihovih vrednostih glejte Podrobno poročilo o zgodovini klicev Webex Calling.

API zagotavlja zapise klicev, ki so se končali 5 minut pred trenutnim časom. Da bi zagotovili razpoložljivost vseh zapisov klicev, priporočamo, da poizvedbo v API-ju izvedete eno uro po želenem časovnem oknu.

URL končne točke API-ja za zapise uporablja naslednjo obliko zapisa:

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

Parametri API-ja

• OrgID (obvezno, niz) – ID organizacije, za katero želite pridobiti zapise. ID-je organizacij lahko pridobite iz API-ja za usklajevanje.
• startTime (obvezno, niz) – Začetni datum in čas (UTC) za prvi zapis, ki ga želite zbrati. Zagotovite, da:
  • Čas formatirate kot YYYY-MM-DDTHH:MM:SS.mmmZ. Na primer, 2025-08-15T06:00:00.000Z.
  • Začetni datum in ura ne smeta biti starejša od 30 dni od trenutnega časa UTC.
  • Interval med startTime in endTime ne sme presegati 12 ur v eni zahtevi API.
• endTime (obvezno, niz) – Končni datum in čas (UTC) za zadnji zapis, ki ga želite zbrati. Zapisi temeljijo na času poročila, kar pomeni, kdaj je klic opravljen. Zagotovite, da:
  • Čas formatirate kot YYYY-MM-DDTHH:MM:SS.mmmZ. Na primer, 2025-08-15T18:00:00.000Z.
  • Končni datum in čas morata biti vsaj 5 minut pred trenutnim časom UTC in ne starejša od 30 dni.
  • Končni datum in čas morata biti večja od startTime.
  • Interval med startTime in endTime ne sme presegati 12 ur v eni zahtevi API.
• Max (neobvezno, število) – Omejuje največje število zapisov na stran v odgovoru. Zagotovite, da:
  • Razpon je od 500 do 5000. Privzeta vrednost je 5000. Na primer, Max=1000.
  • Če ima API za vrnitev več zapisov kot je določena največja vrednost (Max), se odgovor oštevilči.
  • Če je določena vrednost pod 500, se samodejno prilagodi do 500. Če je določena vrednost nad 5000, se zmanjša na 5000.

Oštevilčevanje strani

Če želite ugotoviti, ali so odgovori API-ja oštevilčeni, preverite glave odgovorov za glavo povezave. Če je v glavi povezave prisotna povezava next, jo izvlecite in z vrednostjo startTimeForNextFetch zahtevajte naslednji niz zapisov. Če ni naslednje povezave, se zberejo vsa poročila za izbrano časovno obdobje.

Zahteve API-ja za naslednje strani je mogoče poslati takoj, vendar morajo biti omejene na največ 10 oštevilčenih zahtev na minuto na obseg žetona.

Na primer, če je začetna zahteva API-ja:

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

potem je glava povezave v odgovoru:

; rel="next"

Druge možne vrednosti povezav vključujejo rel="first" in rel="prev" za prvo oziroma prejšnjo stran.

Partner reports/templates API

Poročila, ki so na voljo v središču za partnerje, lahko ustvarite in prenesete z uporabo API-jev za poročila partnerjev. Za več informacij glejte partnerja report/templates.

Partnerji lahko dostopajo do več poročil in jih prenesejo neposredno iz središča za partnerje. Za več informacij glejte poročila Partner Huba.