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

Možete koristiti ovaj vebhook za prikupljanje zapisa 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 za interne poslovne zahteve i usluge sa dodatnom vrednošću.

Za uvod u vebhook i prateće API-je, gledajte ovaj Vidcast: Vebek Calling Partner Detaljna istorija poziva API.

Šta isporučuje partner vebhook

Vebhook isporučuje detaljne zapise istorije poziva svakih 5 minuta. Svaki vebhook nosivost 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 oblaka Vebek Calling.
• Automatski popunjava kasne zapise poziva u narednim vebhook nosivosti kako bi se osigurala 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 se završavaju između 14:00 i 14:05 uključeni su u 14:10 nosivost.
• Zapisi završeni ranije (na primer, poziv koji je završio u KSNUMKS: KSNUMKS), ali obrađeni kasno od strane oblaka Vebek Calling (na primer, u KSNUMKS: KSNUMKS) uključeni su u sledeći planirani korisni teret (na primer, KSNUMKS: KSNUMKS).

Vebhook u Parter Hub-u

Obezbeđivanjem vebhook-a, omogućavate analitičkoj platformi da šalje zapise poziva na URL adresu za povratni poziv kad god se generišu.

Zapisi Vebek poziva isporučuju se u istom formatu kao i postojeći API-ji za detaljne zapise poziva. Možete podesiti vebhook i izabrati između dve vrste feeda:

• Analitika - Uključuje sve zapise poziva za sve korisničke organizacije sa kojima partner ima odnos sa Vebek pozivima. Ovo uključuje organizacije u kojima:
  • Partner upravlja organizacijom klijenata sa ulogom partnera Full Administrator.
  • Korisnička organizacija ima aktivnu pretplatu na Vebek pozive u okviru partnerske organizacije.
• Naplata - Uključuje zapise poziva za pozive koje su uputili korisnici sa licencom za Vebex pozive koju je prodao i obezbedio partner. Evidencija poziva za radne prostore uključena je u ovaj feed.

Pristup i privatnost podataka

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

• Partner (ili pod-partner) koji upravlja licencom povezanom sa zapisom poziva postaje vlasnik partnera.
• Vlasništvo se određuje: ID korisnika > ID licence > ID pretplate > ID partnera.
• Svaki CDR je dostupan jednom partneru.
• Neki zapisi poziva se ne mapiraju na partnera za naplatu, a ne svi partneri povezani sa organizacijom dobijaju jednak pristup svim zapisima, jer ovi zapisi mogu sadržavati lične podatke (PII).

Pored vebhook-a, Vebek Calling obezbeđuje API krajnje tačke za podršku usklađivanju podataka. Ove krajnje tačke vam omogućavaju da nadoknadite ili pomirite svoje prodavnice podataka sa svim nedostajućim zapisima koje vaš slušalac vebhook-a možda nije primio. Dve API krajnje tačke su API za pomirenje i API za zapise.

Zapisi iz ovih API-ja dostupni su 30 dana. Da biste bili sigurni da ćete dobiti sve očekivane zapise, preporučujemo da povremeno pomirete svoje prodavnice ploča, kao što je svakih 12 ili 24 sata.

Morate koristiti token za pristup partneru da biste pristupili ovim API-jima. Nabavite i upravljajte svojim partnerskim pristupnim tokenom u skladu sa standardnim praksama upravljanja pristupnim tokenima VeWebex Developer-a.

Krajnja tačka API-ja za pomirenje

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

Ako upravljate više od 200 korisničkih organizacija, API paginira rezultate kako bi poboljšao čitljivost.

URL krajnje tačke API-ja za pomirenje koristi sledeći format:

API parametri

Možete koristiti API za preuzimanje zapisa poziva 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, string)—Datum i vreme početka (UTC) za prvi zapis koji želite da prikupite. 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 sme biti stariji od 30 dana od trenutnog UTC vremena.
  • Prozor između startTime i endTime ne može biti duži od 12 sati.
• endTime (obavezno, string)—Datum i vreme završetka (UTC) za zapise koje želite da prikupite. Evidencija se zasniva na vremenu izveštaja, a to je kada je poziv završen. 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.
  • Datum i vreme završetka moraju biti veći od .startTime
  • Prozor između startTime i endTime ne može biti duži od 12 sati.

Primer JSON odgovora na krajnju tačku API-ja za pomirenje:

          {
          "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 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)
• total-orgs: Ukupan broj organizacija uključenih u odgovor (na primer, 283)
• Aktuelna-strana: Trenutni broj stranice (na primer, 1)

Na primer, ako zaglavlja prikazuju num-pages = 2, total-orgs = 283 i current-page = 1, pregledavate prvu stranicu odgovora na dve stranice koji sadrži ukupno 283 organizacije. Da biste pristupili sledećoj stranici, dodajte page=2 parametar na vaš GET zahtev, 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

Evidencija API krajnja tačka

Krajnja tačka API-ja za zapise se koristi za upit koji nedostaju zapise poziva za određene organizacije u kojima su odstupanja ili podaci koji nedostaju identifikovani pomoću API-ja za pomirenje.

API za zapise vraća zapise poziva u JSON formatu, identičan formatu opisanom u API-ju za detaljnu istoriju poziva. Vraćeni korisni teret sadrži identična polja za detaljnu istoriju poziva vraćenog korisnog tereta. Za više informacija o poljima i njihovim vrednostima pogledajte Detaljni izveštaj o istoriji poziva Vebek poziva.

API obezbeđuje evidenciju poziva koja je završila 5 minuta pre trenutnog vremena. Da biste bili sigurni da su svi zapisi poziva dostupni, preporučujemo upit API jedan sat nakon željenog vremenskog prozora.

URL krajnje tačke API-ja za zapise 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, string)—ID organizacije za koju želite da preuzmete zapise. Možete dobiti ID organizacije iz API-ja za usklađivanje.
• startTime (obavezno, string)—Datum i vreme početka (UTC) za prvi zapis koji želite da prikupite. 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 sme biti stariji od 30 dana od trenutnog UTC vremena.
  • Interval između startTime i endTime ne sme biti veći od 12 sati u jednom API zahtevu.
• endTime (obavezno, string)—Datum i vreme završetka (UTC) za poslednji zapis koji želite da sakupite. Evidencija se zasniva na vremenu izveštaja, a to je kada je poziv završen. 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.
  • Datum i vreme završetka moraju biti veći od .startTime
  • Interval između startTime i endTime ne sme biti veći od 12 sati u jednom API zahtevu.
• Maksimum (opciono, broj)—Ograničava maksimalan 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 da se vrati od određene maksimalne vrednosti, onda je odgovor paginiran.
  • 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.

Numerisanje

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

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

Na primer, ako je početni zahtev API-ja:

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:

; rel="next"

Ostale moguće vrednosti veze uključuju rel="first" i rel="prev" za prvu i prethodnu stranicu, respektivno.

API za izveštaje / šablone partnera

Možete generisati i preuzeti izveštaje dostupne u Partner Hub-u koristeći API-je za izveštaje partnera. Za više informacija, pogledajte izveštaj / šablone partnera.

Partneri takođe mogu pristupiti i preuzeti više izveštaja direktno iz Partner Hub-a. Za više informacija, pogledajte Izveštaji Partner Hub-a.