Webhook za detaljne zapise poziva nudi sigurno, skalabilno i robusno rješenje vođeno događajima, a ne zahtjevima. Ovaj webhook pruža bolji uvid u aktivnosti Webex poziva vaših klijenata, podržavajući slučajeve upotrebe od naplate do prilagođenog izvještavanja.

Ovaj webhook možete koristiti za praktično prikupljanje zapisa za sve kupce kojima se upravlja putem Partner Huba bez pojedinačnog ispitivanja svakog kupca. Ovaj webhook vam omogućuje razvoj prilagođenih aplikacija za izvještavanje, naplatu i analitiku, kako za interne poslovne zahtjeve, tako i za usluge s dodanom vrijednošću.

Za uvod u webhook i njegove prateće API-je, pogledajte ovaj Vidcast: API za detaljnu povijest poziva Webex Calling Partnera.

Što pruža Partner webhook

Webhook isporučuje detaljne zapise povijesti poziva svakih 5 minuta. Svaki webhook sadržaj sadrži:

• Zapisi poziva koji su završili između 10 i 5 minuta prije trenutnog vremena.
• Svi zakašnjeli zapisi obrađeni putem Webex Calling clouda.
• Automatski dopunjuje zapise o zakašnjelim pozivima u sljedećim webhook korisnim podacima kako bi se osigurala pouzdana isporuka.

Kako bismo pokazali kako su zapisi poziva uključeni u svaki korisni sadržaj, razmotrimo sljedeći primjer:

• 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 14:10 korisni teret.
• Zapisi dovršeni ranije (na primjer, poziv koji je završio u 14:04) ali ga Webex Calling cloud obrađuje kasno (na primjer, u 14:11) uključeni su u sljedeći planirani korisni teret (na primjer, 14:15).

Webhook u Parter Hubu

Pružanjem webhooka omogućujete analitičkoj platformi slanje zapisa poziva na vaš URL povratnog poziva kad god se generiraju.

Webex zapisi poziva isporučuju se u istom formatu kao i postojeći detaljni API-ji za zapise poziva. Možete postaviti webhook i birati između dvije vrste feeda:

• Analitika – uključuje sve zapise poziva za sve organizacije korisnika s kojima partner ima odnos Webex Calling. To uključuje organizacije u kojima:
  • Partner upravlja organizacijom klijenta s ulogom punopravnog administratora partnera.
  • Organizacija korisnika ima aktivnu pretplatu na Webex Calling unutar partnerske organizacije.
• Naplata – Uključuje zapise poziva koje su uputili korisnici s licencom za Webex Calling koju je prodao i omogućio partner. Zapisi poziva za radne prostore uključeni su u ovaj feed.

Pristup i privatnost podataka

Samo vlasnik partner može pristupiti zapisima o detaljima poziva (CDR) za naplatu.

• Partner (ili podpartner) koji upravlja licencom povezanom sa zapisom poziva postaje vlasnik.
• Vlasništvo se određuje: ID korisnika > ID licence > ID pretplate > ID partnera.
• Svaki CDR je dostupan jednom partneru.
• Neki zapisi poziva ne povezuju se s partnerom za naplatu, a nemaju svi partneri povezani s organizacijom jednak pristup svim zapisima jer ti zapisi mogu sadržavati osobne podatke (PII).

Uz webhook, Webex Calling pruža API krajnje točke za podršku usklađivanja podataka. Ove krajnje točke omogućuju vam da nadoknadite ili uskladite svoje pohrane podataka s bilo kojim nedostajućim zapisima koje vaš slušač webhook-a možda nije primio. Dvije krajnje točke API-ja su Reconciliation API i Records API.

Zapisi s ovih API-ja dostupni su 30 dana. Kako biste osigurali da primite sve očekivane zapise, preporučujemo periodično usklađivanje vaših pohrana zapisa, na primjer svakih 12 ili 24 sata.

Za pristup ovim API-jima morate koristiti partnerski token za pristup. Nabavite i upravljajte svojim partnerskim tokenom za pristup u skladu sa standardnim praksama upravljanja tokenima za pristup za Webex developere.

Krajnja točka API-ja za usklađivanje

Krajnja točka API-ja za usklađivanje vraća ukupan broj generiranih zapisa poziva za svakog korisnika kojim upravlja partner unutar navedenog vremenskog razdoblja. Ove ukupne brojeve možete koristiti za provjeru lokalne pohrane i identifikaciju nedostajućih ili nedosljednih zapisa poziva za određene korisnike.

Ako upravljate s više od 200 korisničkih organizacija, API stranicera rezultate radi bolje čitljivosti.

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

API parametri

API možete koristiti za dohvaćanje zapisa poziva iz posljednjih 30 dana. Odabrani vremenski prozor mora započeti najmanje 5 minuta prije trenutnog UTC vremena i ne smije biti dulji od 12 sati između vremena početka i završetka u jednom API pozivu.

API parametri su:

• startTime (obavezno, niz znakova) – Početni datum i vrijeme (UTC) za prvi zapis koji želite prikupiti. Osigurajte da:
  • Vrijeme formatirate kao YYYY-MM-DDTHH:MM:SS.mmmZ. Na primjer, 2025-08-15T06:00:00.000Z.
  • Datum i vrijeme početka ne smiju biti stariji od 30 dana od trenutnog UTC vremena.
  • Razdoblje između startTime i endTime ne smije biti dulje od 12 sati.
• endTime (obavezno, niz znakova) – Datum i vrijeme završetka (UTC) za zapise koje želite prikupiti. Zapisi se temelje na vremenu prijave, odnosno vremenu kada je poziv završen. Osigurajte da:
  • Vrijeme formatirate kao YYYY-MM-DDTHH:MM:SS.mmmZ. Na primjer, 2025-08-15T18:00:00.000Z.
  • Datum i vrijeme završetka moraju biti 5 minuta prije trenutnog UTC vremena i ne stariji od 30 dana.
  • Datum i vrijeme završetka moraju biti veći od startTime.
  • Razdoblje između startTime i endTime ne smije biti dulje od 12 sati.

Primjer JSON odgovora krajnje toč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 API odgovora pokazuju ukupan broj vraćenih organizacija i jesu li dostupne dodatne stranice. Provjerite sljedeće parametre zaglavlja kako biste bili sigurni da ste upitali sve stranice:

• broj stranica: Ukupan broj stranica (na primjer, 2)
• ukupno-org: Ukupan broj organizacija uključenih u odgovor (na primjer, 283)
• trenutna-stranica: Trenutni broj stranice (na primjer, 1)

Na primjer, ako zaglavlja prikazuju num-pages=2, total-orgs=283, i current-page=1, Pregledavate prvu stranicu dvostranog odgovora koji sadrži ukupno 283 organizacije. Za pristup sljedećoj stranici dodajte page=2 parametar vašem GET zahtjevu, kao što je prikazano u nastavku:

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

Krajnja točka Records API-ja koristi se za upite o nedostajućim zapisima poziva za određene organizacije gdje su pomoću Reconciliation API-ja utvrđene neslaganja ili nedostajući podaci.

API za zapise vraća zapise poziva u JSON formatu, identičnom formatu opisanom u Detaljnom API-ju za povijest poziva. Vraćeni korisni sadržaj sadrži identična polja kao i vraćeni korisni sadržaj Detaljna povijest poziva. Za više informacija o poljima i njihovim vrijednostima pogledajte Detaljno izvješće o povijesti poziva za Webex.

API pruža zapise poziva koji su završili 5 minuta prije trenutnog vremena. Kako biste osigurali dostupnost svih zapisa poziva, preporučujemo da pošaljete upit API-ju sat vremena nakon željenog vremenskog prozora.

URL krajnje točke Records API-ja koristi sljedeć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 znakova) – ID organizacije za koju želite dohvatiti zapise. ID-ove organizacija možete dobiti iz API-ja za usklađivanje.
• startTime (obavezno, niz znakova) – Početni datum i vrijeme (UTC) za prvi zapis koji želite prikupiti. Osigurajte da:
  • Vrijeme formatirate kao YYYY-MM-DDTHH:MM:SS.mmmZ. Na primjer, 2025-08-15T06:00:00.000Z.
  • Datum i vrijeme početka ne smiju biti stariji od 30 dana od trenutnog UTC vremena.
  • Interval između startTime i endTime ne smije biti veći od 12 sati u jednom API zahtjevu.
• endTime (obavezno, niz znakova) – Datum i vrijeme završetka (UTC) za posljednji zapis koji želite prikupiti. Zapisi se temelje na vremenu prijave, odnosno vremenu kada je poziv završen. Osigurajte da:
  • Vrijeme formatirate kao YYYY-MM-DDTHH:MM:SS.mmmZ. Na primjer, 2025-08-15T18:00:00.000Z.
  • Datum i vrijeme završetka moraju biti najmanje 5 minuta prije trenutnog UTC vremena i ne stariji od 30 dana.
  • Datum i vrijeme završetka moraju biti veći od startTime.
  • Interval između startTime i endTime ne smije biti veći od 12 sati u jednom API zahtjevu.
• Maks. (neobavezno, broj) – Ograničava maksimalni broj zapisa po stranici u odgovoru. Osigurajte da:
  • Raspon je od 500 do 5000. Zadana vrijednost je 5000. Na primjer, Max=1000.
  • Ako API ima više zapisa za vratiti od navedene maksimalne vrijednosti, odgovor se paginira.
  • Ako je navedena vrijednost ispod 500, automatski se podešava do 500. Ako je navedena vrijednost iznad 5000, ona se smanjuje na 5000.

Numeriranje

Da biste utvrdili jesu li API odgovori numerirani, provjerite zaglavlja odgovora za zaglavlje veze. Ako se u zaglavlju poveznice nalazi poveznica next, izdvojite je i upotrijebite vrijednost startTimeForNextFetch za zahtjev sljedećeg skupa zapisa. Ako nema sljedeće poveznice, prikupljaju se sva izvješća za odabrani vremenski raspon.

API zahtjevi za sljedeće stranice mogu se odmah poslati, ali brzina mora biti ograničena na maksimalno 10 paginiranih zahtjeva u minuti, po opsegu tokena.

Na primjer, ako je početni API zahtjev:

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

tada je zaglavlje poveznice u odgovoru:

; rel="next"

Druge moguće vrijednosti poveznice uključuju rel="first" i rel="prev" za prvu i prethodnu stranicu.

Izvješća dostupna u Partner Hubu možete generirati i preuzeti pomoću Partner Reports API-ja. Za više informacija pogledajte partnera report/templates.

Partneri također mogu pristupiti i preuzeti više izvješća izravno iz Partner Huba. Za više informacija pogledajte izvješća Partner Huba.