Hvala na povratnim informacijama.

Webhook Detailed Call Records nudi sigurno, skalabilno i robusno rješenje vođeno događajima, a ne zahtjevima. Ovaj webhook pruža veću vidljivost Webex Calling aktivnosti vaših kupaca, podržavajući slučajeve upotrebe od naplate do prilagođenog izvješćivanja.

Pomoću ovog webhook-a možete prikupljati zapise prikladno za sve kupce kojima upravlja putem Partner Huba bez upita svakog kupca pojedinačno. Ovaj webhook omogućuje vam razvoj prilagođenih aplikacija za izvješćivanje, naplatu i analitičke aplikacije za interne poslovne zahtjeve i usluge s dodanom vrijedno šću.

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

Što pruža Partner webhook

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

• Zapisi poziva koji su završili između 10 minuta i 5 minuta prije trenutnog vremena.
• Svi kasni zapisi obrađeni u Webex Calling oblaku.
• Automatski popunjava zapise o kasnim pozivima u sljedećim korisnim opterećenjima webhook-a kako bi se osigurala pouzdana isporuka .

Da biste prikazali kako su zapisi poziva uključeni u svaki korisni teret, razmotrite 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 korisni teret 14:10.
• Zapisi dovršeni ranije (na primjer, poziv koji je završio u 14:04), ali kasno obra đeni Webex Calling oblakom (na primjer, u 14:11) uključeni su u sljedeći zakazani korisni teret (na primjer, 14:15).

Webhook u partnerskom čvorištu

Pružanjem webhook-a omogućavate analitičkoj platformi da šalje zapise poziva na vaš URL povratnog poziva kad god se generiraju.

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

• Analitika — uključuje sve evidencije poziva za sve organizacije kupaca s kojima partner ima Webex Calling odnos. To uključuje organizacije u kojima:
  • Partner upravlja organizacijom kupaca s ulogom punog administratora partnera.
  • Organizacija kupaca ima aktivnu Webex Calling pretplatu unutar partnerske organizacije.
• Obračunavanje — uključuje evidenciju poziva za pozive korisnika s Webex Calling licencom koju je prodao i osigurao 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 s zapisom poziva postaje vlasnik partnera.
• Vlasništvo se određuje pomoću: Korisnički ID > ID licence > ID pretplate > ID partnera.
• Svaki CDR dostupan je jednom partneru.
• Neki se zapisi poziva ne preslikavaju na partnera za naplatu, a svi partneri povezani s organizacijom nemaju jednak pristup svim zapisima jer ti zapisi mogu sadržavati osobne podatke (PII).

Osim webhook-a, Webex Calling pruža API krajnje točke za podršku usklađivanju podataka. Ove krajnje točke omogućuju vam da nadoknadite ili uskladite svoje pohrane podataka sa svim nedostajućim zapisima koje vaš slušatelj webhook-a možda nije primio. Dvije krajnje točke API-ja su API za usklađivanje i API zapisa.

Zapisi iz ovih API-ja dostupni su 30 dana. Kako biste osigurali da ćete primiti sve očekivane zapise, preporučujemo da povremeno usklađujete svoje zalihe ploča, primjerice svakih 12 ili 24 sata.

Za pristup tim API-jima morate koristiti token pristupa partneru. Korisnik koji potvrđuje provjeru autentičnosti mora biti potpuni administrator partnera s pristupom punoj administratorskoj razini organizacije i mora imati omogućen pristup Webex CallingCDR API-ju. OAuth token mora uključivati opseg. spark-admin:calling_cdr_read Uloge administratora samo za čitanje nisu dovoljne za API-je za usklađivanje partnera i zapise.

Koristite kraj analytics-callingnju točku za regiju Webex Calling podataka korisničke organizacije. Koristite primjenjivi osnovni URL i za API-je za usklađivanje i zapise:

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

Krajnja točka API-ja usklađivanja

Krajnja točka API-ja za usklađivanje vraća ukupan broj zapisa poziva generiranih za svakog kupca kojim upravlja partner u određenom vremenskom razdoblju. Pomoću tih ukupnih iznosa možete provjeriti lokalnu pohranu i identificirati sve nedostajuće ili nedosljedne zapise poziva za određene korisnike.

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

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

API parametri

Pomoću API-ja možete dohvatiti zapise poziva iz posljednjih 30 dana. Odabrani vremenski prozor mora započeti najmanje 5 minuta prije trenutnog UTC vremena i ne smije prelaziti 12 sati između vremena početka i završetka u jednom API pozivu.

API parametri su:

• StartTime (obavezno, niz) —Datum i vrijeme početka (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.
  • Prozor između startTimei ne endTimemože biti duži od 12 sati.
• EndTime (obavezno, niz) —Datum i vrijeme završetka (UTC) za zapise koje želite prikupiti. Zapisi se temelje na vremenu izvješća, a to je kada je poziv obavljen. 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.
  • Prozor između startTimei ne endTimemože biti duži 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 odgovora API-ja označavaju 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)
• ukupni organi: 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 odgovora na dvije stranice koja sadrži ukupno 283 organizacije. Da biste pristupili sljedećoj stranici, dodajte parametar page = 2 svom 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

Snimanje API-ja krajnje točke

Krajnja točka API-ja zapisa koristi se za ispitivanje zapisa poziva koji nedostaju za određene organizacije u kojima su odstupanja ili nedostajući podaci identificirani pomoću API-ja za usklađivanje.

Preporučeni protok: /v1/partners/cdrcountbyorgPrvo nazovite. Zatim upotrijebite točno orgIdvraćeno cdr_counts[].orgIdkad nazovete /v1/partners/cdrsbyorg.

API zapisa vraća zapise poziva u JSON formatu, identičnom formatu opisanom u API-ju Detaljna povijest poziva. Vraćeni korisni teret sadrži identična polja kao vraćeni korisni teret Detaljna povijest poziva. Dodatne informacije o poljima i njihovim vrijednostima potražite u odjel Webex Callingjku Detaljno izvješće o povijesti poziva.

API pruža zapise poziva koji su završili 5 minuta prije trenutnog vremena. Da biste osigurali da su svi zapisi poziva dostupni, preporučujemo upit API-ja sat vremena nakon željenog vremenskog prozora.

URL krajnje točke API-ja zapisa 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) —ID organizacije korisnika za koji želite dohvatiti zapise. Naziv parametra je osjetljiv na velika i mala slova. ID-ove organizacije možete dobiti iz polja za odgovor API-ja za usklađivanje cdr_counts[].orgId.
• StartTime (obavezno, niz) —Datum i vrijeme početka (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 startTimei ne endTimesmije biti duži od 12 sati u jednom API zahtjevu.
• EndTime (obavezno, niz) —Datum i vrijeme završetka (UTC) za posljednji zapis koji želite prikupiti. Zapisi se temelje na vremenu izvješća, a to je kada je poziv obavljen. 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 startTimei ne endTimesmije biti duži od 12 sati u jednom API zahtjevu.
• max (izborno, 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 povratak od navedene maksimalne vrijednosti, odgovor se paginira.
  • Ako je navedena vrijednost ispod 500, ona se automatski podešava do 500. Ako je navedena vrijednost iznad 5000, ona se podešava na 5000.

Paginacija

Da biste utvrdili jesu li odgovori API-ja označeni na stranicama, provjerite zaglavlja odgovora za zaglavlje veze. Ako je nextveza prisutna u zaglavlju veze, izdvojite je i upotrijebite startTimeForNextFetchvrijednost da biste zatražili sljedeći skup zapisa. Ako nema sljedeće veze, prikupljaju se sva izvješća za odabrani vremenski raspon.

API zahtjevi za sljedeće stranice mogu se izvršiti odmah, ali moraju biti ograničeni na najviše 10 paginiranih zahtjeva u minuti, po opsegu tokena.

Upotrijebite idempotentnu obradu i dedupliciranje kada preuzimate zapise, uključujući kroz stranice označene odgovore ili prozore ponovljenog usklađivanja. Koristite reportIdkao primarni ključ i za određ reportTimeivanje najnovijeg obrađenog zapisa.

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 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 uključuje rel="next"vezu, upotrijebite taj URL da biste preuzeli sljedeću stranicu zapisa. Ako odgovor ne uključuje rel="next"vezu, preuzeli ste sve dostupne zapise za odabrani vremenski raspon.

Izvješća dostupna u Partner Hubu možete generirati i preuzeti pomoću API-ja Partner Reports. Dodatne informacije potražite u izvješću/pred lošcima partnera.

Partneri također mogu pristupiti i preuzeti više izvješća izravno s Partner Huba. Dodatne informacije potražite u odjeljku Izvješća Centra partnera.