Spletna kljuka Detailed Call Records vam omogoča boljši pregled nad aktivnostmi vaših strank v klicnem sistemu Webex za različne namene, od zaračunavanja do poročanja po meri. To spletno kljuko lahko uporabite za priročno zbiranje zapisov za vse stranke, ne da bi morali poizvedovati po zapisih za vsako stranko posebej. Ta spletna ključavnica vam omogoča razvoj aplikacij za poročanje in analizo po meri za notranje poslovne namene ali zagotavljanje storitev z dodano vrednostjo strankam. Za uvod v spletno kljuko in spremljajoče vmesnike API si lahko ogledate videodogodek .

Spletna kljuka posreduje zapise vsakih 5 minut. Vsak tovor spletne kljuke vsebuje zapise za klice, ki so se končali pred 10 do 5 minutami. Na primer, koristni tovor, prejet ob 17:00, vključuje klice, ki so se končali med 16:50 in 16:55. Klici, ki se končajo med 16:55 in 17:00, bodo vključeni v koristni tovor 17:05.

Zapisi o klicih Webex se posredujejo v enaki obliki kot obstoječi API-ji za podrobne zapise klicev . Nastavite lahko spletno kljuko in izberete eno od dveh vrst dovajanja:

• Analiza-Vključuje vse zapise klicev za vse organizacije strank, s katerimi ima partner razmerje Webex Calling. To vključuje organizacije, ki:
  • Partner upravlja organizacijo stranke z vlogo popolnega skrbnika partnerja.
  • Organizacija stranke ima aktivno naročnino na Webex Calling v partnerski organizaciji.
• Obračun-Vključuje samo zapise klicev, ki so jih opravili uporabniki z licenco Webex Calling, ki jo je prodal partner. V ta vir so vključeni zapisi klicev za delovne prostore.

Za pomoč pri usklajevanju podatkov zagotavljamo dve končni točki API skupaj s spletno kljuko. Te končne točke vam omogočajo, da nadoknadite ali uskladite svoje podatkovne shrambe z manjkajočimi zapisi, ki jih poslušalec spletnih kljuk ni prejel. Ta dva vmesnika API sta končna točka API za usklajevanje in končna točka API za zapise .

Zapisi so iz teh vmesnikov API na voljo 48 ur. Priporočamo, da se skladišča zapisov redno usklajujejo, na primer vsakih 12 ali 24 ur, tako da so vsi zapisi prejeti v skladu s pričakovanji. Za uporabo tega vmesnika API je potreben partnerski žeton za dostop. Pridobite lahko partnerski žeton za dostop in ga upravljate v skladu s standardnimi načeli upravljanja žetonov za dostop Webex Developer.

Končna točka API za usklajevanje

Končna točka API za usklajevanje vrne število zapisov, ki jih je ustvarila vsaka stranka, ki jo upravlja partner v določenem časovnem obdobju. Če partner upravlja več kot 200 organizacij strank, bodo rezultati API-ja zaradi boljše berljivosti razvrščeni po straneh. S temi skupnimi zneski lahko v lokalnem skladišču preverite, ali manjkajo zapisi za določene stranke. URL končne točke API za usklajevanje najdete tukaj:

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

Parametri

API za usklajevanje je mogoče klicati največ eno uro, pri čemer parametra startTime in endTime ne smeta biti oddaljena več kot 60 minut. API lahko uporabite za katero koli enourno obdobje od 5 minut do 48 ur nazaj, vendar lahko zaradi upravljanja obremenitve storitev naenkrat pokličete le eno uro.

Na voljo so naslednji parametri:

• startTime (niz) - čas prvega poročila, ki ga želite zbrati. Čas poročila določa čas zaključka klica.

  Čas morate oblikovati kot YYYYY-MM-DDTHH:MM:SS.mmmZ.

• endTime (niz) - čas zadnjega poročila, ki ga želite zbrati. Čas poročila določa čas zaključka klica.

  Navedeni čas mora biti poznejši od startTime , vendar ne poznejši od 48 ur, čas pa morate oblikovati kot YYYY-MM-DDTHH:MM:SS.mmmZ.

Tukaj je primer, kako je videti vrnjen tovor JSON končne točke API za usklajevanje:

{ "cdr_counts": [ { { "orgId": "zzzzzzzz-yyyy-zzzzz-xxxx-yyyyyyyyyyyy", "count": "org: 3009 }, {"orgId": "yyyyyyyy-yyyy-zzzz-xxxx-yyyyyyyyyyyyyy", "count":: 129 }, {"orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyy", "count":: 278 } ] } 

V glavi odgovora API je navedeno skupno število vrnjenih organizacij in morebitne dodatne strani. Preverite naslednje parametre in se prepričajte, da so bile poizvedovane vse strani.

 num-pages = 2 total-orgs = 283 current-page = 1

Zgornji parametri kažejo, da je trenutna stran prva stran, da sta skupaj 2 strani in da celoten odgovor vsebuje 283 organizacij. Do druge strani dostopate tako, da zahtevku GET dodate parameter page=2 , kot je prikazano spodaj.

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

Končna točka API za zapise

Ta končna točka API vrne zapise klicev v obliki JSON, ki je enaka obliki, opisani v API Detailed Call History API. Vrnjeni koristni tovor vsebuje enaka polja kot vrnjeni koristni tovor podrobne zgodovine klicev. Več podrobnosti o vrednostih v vsakem vrnjenem polju najdete tukaj. Končna točka API za zapise se uporablja za poizvedovanje po manjkajočih zapisih za organizacije, za katere manjkajo zapisi. URL končne točke API za zapise najdete tukaj:

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-Identiteta organizacije, za katero želite poizvedovati po zapisih. Te identifikatorje lahko odprete iz predhodne končne točke usklajevanja.

• startTime (niz) - čas prvega poročila, ki ga želite zbrati. Čas poročila določa čas zaključka klica.

  Navedeni čas mora biti med časom pred 5 minutami in 48 urami, čas pa morate oblikovati kot YYYYY-MM-DDTHH:MM:SS.mmmZ.

• endTime (niz) - čas zadnjega poročila, ki ga želite zbrati. Čas poročila določa čas zaključka klica.

  Navedeni čas mora biti poznejši od startTime , vendar ne poznejši od 48 ur, čas pa morate oblikovati kot YYYY-MM-DDTHH:MM:SS.mmmZ.