Hvala za povratne informacije.

Spletni priključek Detailed Call Records ponuja varno, razširljivo in robustno rešitev, ki jo poganjajo dogodki in ne zahteve. Ta spletna povezava zagotavlja večjo prepoznavnost Webex Calling dejavnosti vaših strank in podpira primere uporabe od obračunavanja do poročanja po meri.

S tem spletnim priključkom lahko priročno zbirate zapise za vse stranke, ki jih upravlja prek Partner Hub, ne da bi pri tem povpraševali vsako stranko posebej. Ta spletna povezava vam omogoča razvoj aplikacij za poročanje, obračunavanje in analitiko po meri za notranje poslovne zahteve in storitve z dodano vrednostjo.

Za uvod v spletno povezavo in spremljajoče API-je si oglejte ta API Vidcast: Webex Calling Partner Detailed Call History.

Kaj ponuja partnerski webhook

Webhook vsakih 5 minut ponuja podrobne zapise zgodovine klicev. Vsak koristni tovor webhook vsebuje:

• Zapisi klicev, ki so se končali med 10 minutami in 5 minutami pred trenutnim časom.
• Vsi pozni zapisi, ki jih obdeluje Webex Calling oblak.
• Samodejno poskrbi zapise poznih klicev v naslednjih uporabnih obremenitvah spletnega priključka, da zagotovi zanesljivo dostavo .

Če želite prikazati, kako so zapisi klicev vključeni v vsako koristno tovor, upoštevajte naslednji primer:

• Uporabni 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 koristni tovor 14:10.
• Zapisi, dokončani prej (na primer klic, ki se je končal ob 14:04), vendar so pozno obdelani v Webex Calling oblaku (na primer ob 14:11), so vključeni v naslednjo načrtovano koristno obremenitev (na primer 14:15).

Webhook v partnerskem središču

Z zagotavljanjem spletnega kljuka omogočite analitični platformi, da pošilja zapise klicev na vaš URL povratnega klica, kadar koli so ustvarjeni.

Webex Callingzapisi se dostavljajo v isti obliki kot obstoječi API-ji podrobnih zapisov klicev. Nastavite lahko spletno povezavo in izbirate med dvema vrstama vira:

• Analitika — vključuje vse zapise klicev za vse organizacije strank, s katerimi ima Webex Calling partner odnos. To vključuje organizacije, kjer:
  • Partner upravlja organizacijo strank z vlogo polnega skrbnika partnerja.
  • Organizacija strank ima aktivno Webex Calling naročnino znotraj partnerske organizacije.
• Obračunavanje — vključuje zapise klicev za klice uporabnikov z Webex Calling licenco, ki jo je prodal in zagotovil partner. Zapisi klicev za delovne prostore so vključeni v ta vir.

Dostop in zasebnost podatkov

Za obračunavanje lahko dostopa le lastnik podatkov o klicih (CDR).

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

Poleg spletnega priključka ponuja končne točke API Webex Calling za podporo usklajevanju podatkov. Te končne točke vam omogočajo, da dohitete ali uskladite shranjevanje podatkov z vsemi manjkajočimi zapisi, ki jih poslušalec spletnega priključka morda ni prejel. Dve končni točki API-ja sta API za usklad itev in API zapisa.

Zapisi iz teh API-jev so na voljo 30 dni. Če želite zagotoviti, da boste prejeli vse pričakovane zapise, priporočamo, da svoje zaloge plošč občasno usklajujete, na primer vsakih 12 ali 24 ur.

Za dostop do teh API-jev morate uporabiti žeton partnerskega dostopa. Uporabnik, ki potrjuje preverjanje pristnosti, mora biti polni skrbnik partnerja z dostopom do celotnega skrbniškega nivoja organizacije in mora imeti omogočen dostop do Webex Calling CDR API- ja. Žeton OAuth mora vključevati obseg. spark-admin:calling_cdr_read Skrbniške vloge samo za branje ne zadostujejo za API-je za usklajevanje partnerjev in zapise.

Uporabite kon analytics-callingčno točko za podatkovno regijo Webex Calling organizacije stranke. Uporabite ustrezen osnovni URL za API-je za usklajevanje in zapise:

• ZDA in Kanada: https://analytics-calling.webexapis.com
• Evropa: https://analytics-calling-eu.webexapis.com
• Indija: https://analytics-calling-in.webexapis.com
• Avstralija: https://analytics-calling-au.webexapis.com

Končna točka API za usklajevanje

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

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

URL končne točke API za uskladitev uporablja naslednjo obliko:

Parametri API

API lahko uporabite za pridobivanje zapisov 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 klicu API.

Parametri API so:

• StartTime (obvezno, niz) —začetni datum in čas (UTC) za prvi zapis, ki ga želite zbrati. Zagotovite, da:
  • Čas oblikujete kot YYYY-MM-DDTHH:MM:SS.mmmZ. Na primer, 2025-08-15T06:00:00.000Z.
  • Začetni datum in čas ne smejo biti starejši od 30 dni od trenutnega časa UTC.
  • Okno med startTimein endTimene sme presegati 12 ur.
• EndTime (obvezno, niz) —končni datum in čas (UTC) za zapise, ki jih želite zbrati. Zapisi temeljijo na času poročanja, ki je takrat, ko je klic opravljen. Zagotovite, da:
  • Čas oblikujete 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ši od 30 dni.
  • Končni datum in čas morata biti večji od startTime.
  • Okno med startTimein endTimene sme presegati 12 ur.

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

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

Odgovorne glave 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 vprašali vse strani:

• num-pages: Skupno število strani (na primer 2)
• skupni organi: Skupno število organizacij, vključenih v odgovor (na primer 283)
• trenutna stran: trenutna številka strani (na primer 1)

Če na primer glave prikazujejo num-pages=2, total-orgs=283 in current-page=1, si ogledate prvo stran dvostranskega odziva, ki vsebuje skupaj 283 organizacij. Če želite dostopati do naslednje strani, v zahtevo GET dodajte parameter page = 2, 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 zapisa API

Končna točka API-ja zapisi se uporablja za poizvedbo o manjkajočih zapisih klicev za določene organizacije, kjer so bile odstopanja ali manjkajoči podatki ugotovljeni z uporabo API-ja za uskladitev.

Priporočeni tok: /v1/partners/cdrcountbyorgNajprej pokličite. Nato uporabite točno orgIdvrnjeno vrednost, ko cdr_counts[].orgIdpokličete /v1/partners/cdrsbyorg.

API zapisi vrne zapise klicev v obliki JSON, ki je enaka obliki, opisani v API-ju Podrobna zgodovina klicev. Vrnjeni tovor vsebuje enaka polja vrnjenemu tovoru s podrobno zgodovino klicev. Če želite več informacij o poljih in njihovih vrednostih, glejte Webex CallingPodrobno poročilo o zgodovini klicev.

API ponuja zapise klicev, ki so se končali 5 minut pred trenutnim časom. Če želite zagotoviti, da so vsi zapisi klicev na voljo, priporočamo, da poizvedete API eno uro po želenem časovnem oknu.

URL končne točke API-ja Records uporablja naslednjo obliko:

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

• orgId(obvezno, niz) —ID organizacije strank, za katerega želite pridobiti zapise. Ime parametra je občutljivo na velike in male črke. ID organizacije lahko pridobite iz polja odziva API-ja za uskladitev cdr_counts[].orgId.
• StartTime (obvezno, niz) —začetni datum in čas (UTC) za prvi zapis, ki ga želite zbrati. Zagotovite, da:
  • Čas oblikujete kot YYYY-MM-DDTHH:MM:SS.mmmZ. Na primer, 2025-08-15T06:00:00.000Z.
  • Začetni datum in čas ne smejo biti starejši od 30 dni od trenutnega časa UTC.
  • Interval med startTimein endTimene sme presegati 12 ur v eni zahtevi za API.
• EndTime (obvezno, niz) —končni datum in čas (UTC) za zadnji zapis, ki ga želite zbrati. Zapisi temeljijo na času poročanja, ki je takrat, ko je klic opravljen. Zagotovite, da:
  • Čas oblikujete 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ši od 30 dni.
  • Končni datum in čas morata biti večji od startTime.
  • Interval med startTimein endTimene sme presegati 12 ur v eni zahtevi za 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 več zapisov za vrnitev od določene največje vrednosti, se odziv strani.
  • Če je določena vrednost pod 500, se samodejno prilagodi do 500. Če je določena vrednost nad 5000, se prilagodi na 5000.

Paginacija

Če želite ugotoviti, ali so odgovori API-ja stranirani, preverite glave odzivov za glavo povezave. Če je nextpovezava prisotna v glavi povezave, jo izvlecite in uporabite startTimeForNextFetchvrednost, da zahtevate naslednji niz zapisov. Če ni naslednje povezave, se zbirajo vsa poročila za izbrani časovni razpon.

Zahteve za API za naslednje strani je mogoče vložiti takoj, vendar morajo biti omejene na največ 10 stranskih zahtev na minuto na obseg žetona.

Pri pridobivanju zapisov uporabite obdelavo idempotent in odstranjevanje podvajanja, vključno s stranskimi odgovori ali ponavljajočimi se okni usklajevanja. Uporabite reportIdkot primarni ključ in za določ reportTimeitev zadnjega obdelanega zapisa.

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

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:

<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"

Straniranje uporablja samo glavo rel="next"povezave. Če odgovor vključuje rel="next"povezavo, uporabite ta URL za pridobitev naslednje strani zapisov. Če odgovor ne vključuje rel="next"povezave, ste pridobili vse razpoložljive zapise za izbrani časovni razpon.

Poročila, ki so na voljo v središču partnerjev, lahko ustvarite in prenesete z API-ji partnerskih poročil. Če želite več informacij, glejte poročilo/ predloge partnerja.

Partnerji lahko dostopajo do več poročil in prenesejo neposredno iz Partnerskega središča. Če želite več informacij, glejte poročila Partnerskega središča.