Hvala na povratnim informacijama.

Vebhook detaljnih zapisa poziva nudi sigurno, skalabilno i robusno rešenje vođeno događajima, a ne zahtevima. Ovaj vebhook pruža veću vidljivost u Webex Calling aktivnostima vaših kupaca, podržavajući slučajeve upotrebe od naplate do prilagođenog izveštavanja.

Možete koristiti ovu veb kuku za prikupljanje zapisa pogodno za sve kupce kojima se upravlja preko Partner Hub-a bez upita svakog kupca pojedinačno. Ovaj vebhook vam omogućava da razvijete prilagođene aplikacije za izveštavanje, naplatu i analitičke aplikacije kako za interne poslovne zahteve, tako i za usluge sa dodatom vrednošću.

Za uvod u vebhook i njegove prateće API-je pogledajte ovaj Vidcast: Webex Calling Partner Detailed Call History API.

Šta pruža Partner vebhook

Vebhook isporučuje detaljne zapise istorije poziva svakih 5 minuta. Svaki korisni teret za vebhook sadrži :

• Zapisi poziva koji su završili između 10 minuta i 5 minuta pre trenutnog vremena.
• Svi kasni zapisi obrađeni od strane Webex Calling oblaka.
• Automatski popunjava zapise o kasnim pozivima u narednim korisnim opterećenjima za vebhook kako bi se osigur ala pouzdana isporuka.

Da biste pokazali kako su zapisi poziva uključeni u svaki korisni teret, razmotrite sledeći primer:

• Korisni teret primljen u 14:05 sadrži pozive koji su završili između 13:55 i 14:00.
• Pozivi koji završavaju između 14:00 i 14:05 uključeni su u korisni teret 14:10.
• Zapisi završeni ranije (na primer, poziv koji se završio u 14:04), ali kasno obra đeni Webex Calling oblakom (na primer, u 14:11) uključeni su u sledeći zakazani korisni teret (na primer, 14:15).

Vebhook u partnerskom centru

Obezbeđivanjem vebhook-a omogućavate analitičkoj platformi da šalje zapise poziva na vaš URL povratnog poziva kad god se generišu.

Webex Callingzapisi se isporučuju koristeći isti format kao i postojeći API-ji detaljnih zapisa poziva. Možete da podesite vebhook i birate između dve vrste feeda:

• Analitika — Uključuje sve evidencije poziva za sve organizacije kupaca sa kojima partner ima Webex Calling odnos. Ovo uključuje organizacije u kojima:
  • Partner upravlja organizacijom kupaca sa ulogom punog administratora partnera.
  • Organizacija kupaca ima aktivnu Webex Calling pretplatu unutar partnerske organizacije.
• Obračunavanje — uključuje evidenciju poziva za pozive korisnika sa Webex Calling licencom koju je prodao i obezbedio partner. Zapisi poziva za radne prostore uključeni su u ovaj feed.

Pristup i privatnost podataka

Samo partner vlasnik može pristupiti evidenciji detalja poziva (CDR) za naplatu.

• Partner (ili podpartner) koji upravlja licencom povezanom sa zapisom poziva postaje vlasnički partner.
• Vlasništvo se određuje pomoću: Korisnički ID > ID licence > ID pretplate > ID partnera.
• Svaki CDR je dostupan jednom partneru.
• Neki zapisi poziva se ne preslikavaju na partnera za naplatu i ne dobijaju svi partneri povezani sa organizacijom jednak pristup svim zapisima, jer ovi zapisi mogu sadržati podatke koji mogu da identifikuju lične podatke (PII).

Pored vebhook-a, Webex Calling pruža API krajnje tačke za podršku usklađivanju podataka. Ove krajnje tačke omogućavaju vam da nadoknadite ili uskladite svoje skladišta podataka sa svim nedostajućim zapisima koje vaš slušalac veb hook-a možda nije primio. Dve krajnje tačke API-ja su API za uskla đivanje i API zapisa.

Zapisi iz ovih API-ja dostupni su 30 dana. Da biste bili sigurni da ćete dobiti sve očekivane zapise, preporučujemo da periodično usklađujete svoje prodavnice ploča, na primer svakih 12 ili 24 sata.

Morate koristiti token za pristup partneru da biste pristupili ovim API-jima. Korisnik koji potvrđuje autentifikaciju mora biti potpuni administrator partnera sa pristupom punom administratorskom nivou organizacije i mora imati omogućen pristup Webex CallingCDR API-ju. OAuth token mora uključivati obim. spark-admin:calling_cdr_read Uloge administratora samo za čitanje nisu dovoljne za API-je za usklađivanje partnera i zapise.

Koristite analytics-callingkrajnju tačku za region Webex Calling podataka organizacije korisnika. Koristite primenljivi osnovni URL i za API-je za usklađivanje i zapise:

• SAD i Kanada: https://analytics-calling.webexapis.com
• Evropa: https://analytics-calling-eu.webexapis.com
• Indija: https://analytics-calling-in.webexapis.com
• Australija: https://analytics-calling-au.webexapis.com

Krajnja tačka API-ja za usklađivanje

Krajnja tačka API-ja za usklađivanje vraća ukupan broj zapisa poziva generisanih za svakog kupca kojim upravlja partner u određenom vremenskom periodu. Ove ukupne iznose možete da koristite da biste proverili lokalno skladište i identifikovali sve nedostajuće ili nedosledne zapise poziva za određene kupce.

Ako upravljate više od 200 organizacija kupaca, API prikazuje rezultate kako bi poboljšao čitljivost.

URL krajnje tačke API-ja za usklađivanje koristi sledeći format:

API parametri

Možete koristiti API za preuzimanje zapisa o pozivima iz poslednjih 30 dana. Vaš izabrani vremenski prozor mora početi najmanje 5 minuta pre trenutnog UTC vremena i ne može biti duži od 12 sati između početnog i završnog vremena u jednom API pozivu.

API parametri su:

• StartTime (obavezno, niz) —Datum i vreme početka (UTC) za prvi zapis koji želite da sakupite. Uverite se da:
  • Vreme formatirate kao YYYY-MM-DDTHH:MM:SS.mmmZ. Na primer, 2025-08-15T06:00:00.000Z.
  • Datum i vreme početka ne smeju biti stariji od 30 dana od trenutnog UTC vremena.
  • Prozor između startTimei ne endTimemože biti duži od 12 sati.
• EndTime (obavezno, niz) —Datum i vreme završetka (UTC) za zapise koje želite da sakupite. Zapisi se zasnivaju na vremenu izveštaja, a to je kada je poziv obavljen. Uverite se da:
  • Vreme formatirate kao YYYY-MM-DDTHH:MM:SS.mmmZ. Na primer, 2025-08-15T18:00:00.000Z.
  • Datum i vreme završetka moraju biti 5 minuta pre trenutnog UTC vremena i ne stariji od 30 dana.
  • Krajnji datum i vreme moraju biti veći od startTime.
  • Prozor između startTimei ne endTimemože biti duži od 12 sati.

Primer JSON odgovora krajnje tačke API-ja za usklađivanje:

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

Zaglavlja odgovora API-ja ukazuju na ukupan broj vraćenih organizacija i da li su dostupne dodatne stranice. Proverite sledeće parametre zaglavlja da biste bili sigurni da ste upitali sve stranice:

• broj stranica: Ukupan broj stranica (na primer, 2)
• ukupni organi: Ukupan broj organizacija uključenih u odgovor (na primer, 283)
• trenutna stranica: Trenutni broj stranice (na primer, 1)

Na primer, ako zaglavlja prikazuju num-pages=2, total-orgs=283 i current-page=1, gledate prvu stranicu odgovora na dve stranice koja sadrži ukupno 283 organizacije. Da biste pristupili sledećoj stranici, dodajte parametar page = 2 svom GET zahtevu, kao što je prikazano ispod:

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

Snimanje API krajnje tačke

Krajnja tačka API-ja zapisa koristi se za ispitivanje zapisa o nedostajućim pozivima za određene organizacije gde su odstupanja ili nedostajući podaci identifikovani pomoću API-ja za usklađivanje.

Preporučeni protok: /v1/partners/cdrcountbyorgPrvo pozovite. Zatim koristite tačno orgIdvraćeno cdr_counts[].orgIdkada pozovete /v1/partners/cdrsbyorg.

API zapisa vraća zapise poziva u JSON formatu, identičan formatu opisanom u API-ju Detaljna istorija poziva. Vraćeni korisni teret sadrži identična polja sa vraćenim korisnim teretom Detaljne istorije poziva. Za više informacija o poljima i njihovim vrednostima pogledajte Webex CallingDetaljan izveštaj o istoriji poziva.

API pruža zapise poziva koji su završili 5 minuta pre trenutnog vremena. Da biste bili sigurni da su svi zapisi o pozivima dostupni, preporučujemo da upitujete API jedan sat nakon željenog vremenskog prozora.

URL krajnje tačke API-ja zapisa koristi sledeći 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 parametri

• orgId(obavezno, niz) —ID organizacije korisnika za koji želite da preuzmete zapise. Naziv parametra je osetljiv na velika i mala slova. Identifikacije organizacije možete dobiti iz polja za odgovor API-ja za usklađivanje cdr_counts[].orgId.
• StartTime (obavezno, niz) —Datum i vreme početka (UTC) za prvi zapis koji želite da sakupite. Uverite se da:
  • Vreme formatirate kao YYYY-MM-DDTHH:MM:SS.mmmZ. Na primer, 2025-08-15T06:00:00.000Z.
  • Datum i vreme početka ne smeju biti stariji od 30 dana od trenutnog UTC vremena.
  • Interval između startTimei ne sme endTimebiti duži od 12 sati u jednom API zahtevu.
• EndTime (obavezno, niz) —Datum i vreme završetka (UTC) za poslednji zapis koji želite da sakupite. Zapisi se zasnivaju na vremenu izveštaja, a to je kada je poziv obavljen. Uverite se da:
  • Vreme formatirate kao YYYY-MM-DDTHH:MM:SS.mmmZ. Na primer, 2025-08-15T18:00:00.000Z.
  • Datum i vreme završetka moraju biti najmanje 5 minuta pre trenutnog UTC vremena i ne stariji od 30 dana.
  • Krajnji datum i vreme moraju biti veći od startTime.
  • Interval između startTimei ne sme endTimebiti duži od 12 sati u jednom API zahtevu.
• maks (opcionalno, broj) —Ograničava maksimalni broj zapisa po stranici u odgovoru. Uverite se da:
  • Raspon je od 500 do 5000. Podrazumevana vrednost je 5000. Na primer, max=1000.
  • Ako API ima više zapisa za povratak od navedene maksimalne vrednosti, odgovor se paginira.
  • Ako je navedena vrednost ispod 500, ona se automatski podešava do 500. Ako je navedena vrednost iznad 5000, ona se podešava na 5000.

Paginacija

Da biste utvrdili da li su API odgovori paginirani, proverite zaglavlja odgovora za zaglavlje veze. Ako je nextveza prisutna u zaglavlju veze, izdvojite je i koristite startTimeForNextFetchvrednost da biste zatražili sledeći skup zapisa. Ako ne postoji sledeća veza, prikupljaju se svi izveštaji za izabrani vremenski opseg.

API zahtevi za naredne stranice mogu se podneti odmah, ali moraju biti ograničeni na maksimalno 10 paginiranih zahteva u minuti, po opsegu tokena.

Koristite idempotentnu obradu i dedupliciranje kada preuzimate zapise, uključujući i preko stranica označenih odgovora ili prozora ponovljenog usklađivanja. Koristite reportIdkao primarni ključ i za određ reportTimeivanje najnovijeg obrađenog zapisa.

Na primer, ako je početni API zahtev:

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

onda je zaglavlje veze u 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"

Paginacija koristi samo zaglavlje rel="next"veze. Ako odgovor sadrži rel="next"vezu, koristite taj URL da biste preuzeli sledeću stranicu zapisa. Ako odgovor ne uključuje rel="next"vezu, preuzeli ste sve dostupne zapise za izabrani vremenski opseg.

Možete da generišete i preuzimate izveštaje dostupne u Partner Hubu pomoću API-ja partnerskih izveštaja. Za više informacija pogledajte izveštaj/ predloške partnera.

Partneri takođe mogu pristupiti i preuzeti više izveštaja direktno sa Partner Hub-a. Za više informacija pogledajte Iz veštaji Partner Hub.