Webhook detaljnih zapisa o pozivima omogućava vam veću vidljivost u Webex Calling aktivnosti kupaca u različite namene, od naplate do prilagođenog izveštavanja po meri. Možete koristiti ovaj webhook da biste udobno prikupili evidencije za sve svoje kupce, bez potrebe da unosite evidencije za svakog kupca jedan po jedan. Ovaj webhook vam omogućava da razvijate prilagođene izveštaje i analitičke aplikacije za interne poslovne svrhe ili za pružanje usluga sa dodatom vrednošću kupcima. Za uvod u webhook i njegove prateće API-je možete pogledati ovaj vidcast.

Webhook obezbeđuje snimke na svakih 5 minuta. Svaki webhook korisni teret sadrži zapise za pozive koji su se završili pre 10 do 5 minuta. Na primer, korisni teret primljen u 17:00 uključuje pozive koji su se završili između 16:50 i 16:55. Pozivi koji se završavaju između 16:55 i 17:00 biće u 17:05 korisni teret.

Webex Calling zapisi se dostavljaju u istom formatu kao postojeći API-ji detaljnih zapisa o pozivima. Možete da podesite webhook i da odaberete između dva tipa feed-a:

• Analitika – sadrži sve zapise poziva za sve organizacije kupca sa kojima partner ima Webex Calling odnos. To uključuje organizacije za koje:
  • Partner upravlja organizacijom kupca uz ulogu potpunog administratora partnera.
  • Organizacija kupca ima aktivnu pretplatu za Webex Calling u okviru partnerske organizacije.
• Naplata – sadrži samo zapise poziva za pozive koje su uputili korisnici sa Webex Calling licencom koju je prodao partner. Zapisi poziva za radne prostore su uključeni u ovaj feed.

Obezbeđujemo dve API krajnje tačke zajedno sa webhook-om da bismo pomogli u rešavanju podataka. Ove krajnje tačke vam omogućavaju da „budete u toku” ili da pomirite svoja skladišta podataka sa nedostajućim zapisima koje nije primio webhook slušalac. Ova dva API-ja su API krajnja tačka za pomirenje i Records API krajnja tačka.

Zapisi su dostupni iz ovih API-ja u trajanju od 48 sati. Preporučujemo usklađivanje skladišta zapisa periodično, na primer svakih 12 ili 24 sata, tako da se svi zapisi primaju kao što je očekivano. Za korišćenje ovog API-ja je potreban token za pristup partnera. Možete da nabavite token za pristup partnera i da upravljate njime u skladu sa standardnim principima upravljanja tokenom za pristup Webex projektoru.

Krajnja tačka za API za pomirenje

API krajnja tačka za pomirenje vraća broj zapisa koje je generisao svaki kupac kojim upravlja partner u navedenom vremenskom periodu. Ako partner upravlja više od 200 organizacija kupca, rezultati iz API-ja će biti obeleženi radi boljeg čitljivosti. Ove ukupne vrednosti možete da koristite za proveru u odnosu na lokalno skladište ako nedostaju neki zapisi za određene kupce. URL krajnje tačke pomirenja možete pronaći ovde:

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

Parametri

API za pomirenje se može pozvati samo tokom maksimalnog trajanja od 1 sata, pri čemu su parametri startTime i endTime razdvojeni za najviše 60 minuta. API može da se koristi bilo koji period od 1 sata između 5 minuta i 48 sati, ali da biste upravljali učitavanjem usluga, samo 1 sat se može pozvati u datom trenutku.

Dostupni parametri su:

• startTime (niska) – Vreme prvog izveštaja koji želite da prikupite. Vreme izveštaja određuje se vreme završetka poziva.

  Morate da oblikujete vreme kao YYYY-MM-DDTHH:MM:SS.mmmZ.

• endTime (niska) – Vreme poslednjeg izveštaja koji želite da prikupite. Vreme izveštaja određuje se vreme završetka poziva.

  Navedeno vreme treba da bude kasnije od vremena početka , ali ne kasnije od 48 sati i morate da oblikujete vreme kao GGGG-MM-DDTHH:MM:SS.mmmZ.

Evo primera kako izgleda Reconciliation API krajnja tačka JSON povraćaj korisni teret:

{ "cdr_counts": [ { "orgId": "zzzzzz-yyyy-zzzz-xxxx-yyyyyyy", "count": 3009 }, { „orgId”: „yyyyyy-yyyy-zzzz-xxxx-yyyyyyy”, „count”: 129 }, { „orgId“: „xxxxxxx-yyyy-zzzz-xxxx-yyyyyyyy“, „count“: 278 } ] } 

Zaglavlja odgovora za API označavaju ukupan broj vraćenih organizacija i da li je bilo dodatnih stranica. Proverite sledeće parametre da biste bili sigurni da su sve stranice upitane.

 num-stranice = 2 ukupno-organizacije = 283 trenutna-stranica = 1

Gore navedeni parametri pokazuju da je trenutna stranica prva stranica, da postoje ukupno 2 stranice i da ceo odgovor sadrži 283 organizacije. Pristupite drugoj stranici tako što ćete dodati parametar page=2 u GET zahtev, kao što je prikazano ispod.

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

Krajnja tačka za API zapisa

Ova API krajnja tačka vraća zapise poziva u JSON formatu, identičnom formatu kao što je opisano u API-ju detaljnu istoriju poziva. Vraćeni korisni teret sadrži identična polja sa detaljnom istorijom poziva dobijenim korisni teret. Više detalja o vrednostima možete da pronađete u svakom polju vraćenom ovde. API krajnja tačka zapisa zapisa se koristi za upit nedostajućih zapisa za organizacije za koje nedostaju zapisi. URL krajnje tačke zapisa možete pronaći ovde:

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 da postavite zapise. Ove identifikatore možete otvoriti sa prethodne krajnje tačke pomirenja.

• startTime (niska) – Vreme prvog izveštaja koji želite da prikupite. Vreme izveštaja određuje se vreme završetka poziva.

  Navedeno vreme mora da bude pre između 5 minuta i 48 sati i morate da oblikujete vreme kao GGGG-MM-DDTHH:MM:SS.mmmZ.

• endTime (niska) – Vreme poslednjeg izveštaja koji želite da prikupite. Vreme izveštaja određuje se vreme završetka poziva.

  Navedeno vreme treba da bude kasnije od vremena početka , ali ne kasnije od 48 sati i morate da oblikujete vreme kao GGGG-MM-DDTHH:MM:SS.mmmZ.