Web-dojavnik s detaljnim zapisom poziva omogućuje vam veću vidljivost nad vašim korisnicima aktivnosti usluge Webex Calling za različite svrhe, od naplate do prilagođenih izvješća. Ovaj web-dojavnik možete upotrijebiti za jednostavno prikupljanje zapisa za sve svoje korisnike, bez potrebe da pojedinačno tražite zapise za svakog korisnika. Ovaj web-dojavnik omogućuje vam razvoj prilagođenih aplikacija za izvješćivanje i analitiku u interne poslovne svrhe ili pružanje usluga s dodanom vrijednošću korisnicima. Za uvod u web-dojavnik i pripadajuće API-je pogledajte ovu videoobjavu.

Web-dojavnik omogućuje zapise svakih 5 minuta. Svaki korisni podaci web-dojavnika sadrži zapise za pozive koji su završili prije između 10 i 5 minuta. Na primjer, korisni teret primljen u 17:00 uključuje pozive koji su završili između 16:50 i 16:55. Pozivi koji završavaju između 16:55 i 17:00 bit će u korisničkom opterećenju 17:05.

Zapisi usluge Webex Calling isporučuju se s pomoću istog formata kao i postojeći API-ji detaljnih zapisa poziva. Možete postaviti web-dojavnik i birati između dvije vrste sažetka sadržaja:

• Analitika– uključuje sve zapise poziva za sve korisničke organizacije s kojima partner ima odnos s uslugom Webex Calling. To uključuje organizacije za koje:
  • Partner upravlja organizacijom korisnika s ulogom potpunog partnerskog administratora.
  • Organizacija korisnika ima aktivnu pretplatu na uslugu Webex Calling unutar partnerske organizacije.
• Naplata– uključuje samo zapise poziva za pozive korisnika s licencom Webex Calling koju je prodao partner. Zapisi poziva za radne prostore uključeni su u ovaj sažetak sadržaja.

Pružamo dvije krajnje točke API-ja zajedno s web-dojavnikom kako bismo pomogli pri usklađivanju podataka. Ove vam krajnje točke omogućuju da "uhvatite korak" ili pomirite pohranu podataka s zapisima koji nedostaju, a koje slušatelj web-dojavnika ne prima. Ova dva API-ja su krajnja točka API-ja za usklađivanje i krajnja točka API-ja za zapise.

Zapisi su dostupni iz ovih API-ja 48 sati. Preporučujemo povremeno usklađivanje pohrana zapisa, primjerice svakih 12 ili 24 sata, kako bi svi zapisi bili primljeni prema očekivanjima. Za upotrebu ovog API-ja potreban je pristupni token partnera. Token za pristup partnera možete nabaviti i upravljati njime u skladu sa standardnim načelima upravljanja pristupnim tokenom za razvojne programere Webex.

Krajnja točka API-ja za usklađivanje

Krajnja točka API-ja za usklađivanje vraća broj zapisa koje je generirao svaki korisnik kojima upravlja partner u određenom razdoblju. Ako partner upravlja s više od 200 korisničkih organizacija, rezultati iz API-ja bit će dojavljeni radi bolje čitljivosti. Te ukupne brojeve možete upotrijebiti da biste provjerili lokalnu pohranu ako za određene korisnike nedostaju neki zapisi. URL API krajnje točke za usklađivanje možete pronaći ovdje:

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

Parametri

API usklađivanja može se pozvati samo maksimalno trajanje od 1 sata, s parametrima startTime i endTime u razmaku od 60 minuta. API se može koristiti za bilo koje razdoblje od 1 sata između 5 minuta i 48 sati, ali za upravljanje opterećenjem usluge možete pozvati samo 1 sat odjednom.

Dostupni parametri su:

• startTime (niz) – vrijeme prvog izvješća koje želite prikupiti. Vrijeme izvješća određuje vrijeme završetka poziva.

  Morate formatirati vrijeme kao GGGG-MM-DDTHH:MM:SS.mmmZ.

• endTime (niz) ‒ vrijeme posljednjeg izvješća koje želite prikupiti. Vrijeme izvješća određuje vrijeme završetka poziva.

  Navedeno vrijeme treba biti kasnije od startTime , ali ne kasnije od 48 sati, a morate formatirati vrijeme kao YYYY-MM-DDTHH:MM:SS.mmmZ.

Evo primjera kako izgleda korisni teret povratnog JSON API-ja krajnje točke usklađivanja:

{ "cdr_counts": [ { "orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyyyyyy", "count": 3009 }, { "orgId": "gggggggg-gggg-zzzz-xxxx-gggggggggg", "count": 129 }, { "orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyyyy", "count": 278 } ] } 

Zaglavlja API odgovora označavaju ukupan broj vraćenih organizacija i postoje li dodatne stranice. Provjerite sljedeće parametre kako biste bili sigurni da su zatražene sve stranice.

 broj-stranica = 2 ukupno-organizacija = 283 current-page = 1

Gore navedeni parametri pokazuju da je trenutna stranica prva stranica, da postoje ukupno 2 stranice, te da cijeli odgovor sadrži 283 organizacije. Pristupite drugoj stranici dodavanjem parametra page=2 zahtjevu GET , kao što je prikazano u nastavku.

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

Krajnja točka API-ja za zapise

Ova krajnja točka API-ja vraća zapise poziva u JSON formatu, identičan formatu koji je opisan u API-ju detaljne povijesti poziva. Vraćeni korisni teret sadrži identična polja s vraćenim detaljnim prethodnim pozivima. Više pojedinosti o vrijednostima u svakom vraćenom polju možete pronaći ovdje. Krajnja točka API-ja zapisa upotrebljava se za traženje zapisa koji nedostaju za organizacije za koje zapisi nedostaju. URL API krajnje točke zapisa možete pronaći ovdje:

https://analytics.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

• orgID – ID organizacije za koji želite pretraživati zapise. Te identifikatore možete otvoriti iz prethodne krajnje točke usklađivanja.

• startTime (niz) – vrijeme prvog izvješća koje želite prikupiti. Vrijeme izvješća određuje vrijeme završetka poziva.

  Navedeno vrijeme mora biti između 5 minuta i 48 sati te morate formatirati vrijeme kao YYYY-MM-DDTHH:MM:SS.mmmZ.

• endTime (niz) ‒ vrijeme posljednjeg izvješća koje želite prikupiti. Vrijeme izvješća određuje vrijeme završetka poziva.

  Navedeno vrijeme treba biti kasnije od startTime , ali ne kasnije od 48 sati, a morate formatirati vrijeme kao YYYY-MM-DDTHH:MM:SS.mmmZ.