Yksityiskohtaiset puhelutiedot -verkkokoukun avulla saat paremman näkyvyyden asiakkaidesi Webex-puhelujen aktiivisuuteen eri tarkoituksia varten, laskutuksesta räätälöityyn raportointiin. Voit käyttää tätä verkkokoukkua kerätäksesi kaikkien asiakkaidesi tietueet kätevästi ilman, että sinun tarvitsee kysyä kunkin asiakkaan tietueita yksitellen. Tämän verkkokoukun avulla voit kehittää mukautettuja raportointi- ja analyysisovelluksia sekä sisäisiin liiketoimintatarkoituksiin että lisäarvopalvelujen tarjoamiseen asiakkaille. Voit tutustua webhookiin ja siihen liittyviin API-ohjelmiin tässä vidcastissa.

Webhook toimittaa tietueet 5 minuutin välein. Kukin webhookin hyötykuorma sisältää tietueet puheluista, jotka päättyivät 10 ja 5 minuuttia sitten. Esimerkiksi klo 17:00 vastaanotettu hyötykuorma sisältää puhelut, jotka päättyivät klo 16:50 ja 16:55 välillä. Puhelut, jotka päättyvät kello 16:55 ja 17:00 välillä, kuuluvat kello 17:05 lähetettävään hyötykuormaan.

Webex-puhelutietueet toimitetaan samassa muodossa kuin olemassa olevat yksityiskohtaiset puhelutietueet API:t. Voit määrittää verkkokoukun ja valita kahden eri syötetyypin välillä:

• Analytics- Sisältää kaikkien niiden asiakasorganisaatioiden kaikki puhelutiedot, joihin kumppanilla on Webex Calling -suhde. Tähän kuuluvat organisaatiot, joiden osalta:
  • Kumppani hallinnoi asiakasorganisaatiota Partner Full Administrator -roolilla.
  • Asiakasorganisaatiolla on aktiivinen Webex Calling -tilaus kumppaniorganisaatiossa.
• Laskutus- Sisältää vain sellaisten käyttäjien soittamat puhelutiedot, joilla on kumppanin myymä Webex Calling -lisenssi. Työtilojen puhelutiedot sisältyvät tähän syötteeseen.

Tarjoamme kaksi API-päätepistettä yhdessä webhookin kanssa tietojen täsmäytyksen helpottamiseksi. Näiden päätepisteiden avulla voit "kuroa kiinni" tai täsmäyttää tietovarastojasi puuttuvien tietueiden kanssa, joita webhook-kuuntelija ei ole vastaanottanut. Nämä kaksi sovellusliittymää ovat täsmäytysliittymän päätepiste ja tietueiden sovellusliittymän päätepiste.

Tietueet ovat saatavilla näistä sovellusliittymistä 48 tunnin ajan. Suosittelemme, että tietovarastot täsmäytetään määräajoin, esimerkiksi 12 tai 24 tunnin välein, jotta kaikki tietueet saadaan odotetulla tavalla. Tämän API:n käyttäminen edellyttää kumppanin käyttöoikeuskoodia. Voit hankkia kumppanin käyttöoikeustunnisteen ja hallita sitä standardien Webex Developer -käyttöoikeustunnisteen hallintaperiaatteiden mukaisesti.

Täsmäytys-API-päätepiste

Täsmäytys-API-päätepiste palauttaa kunkin kumppanin hallinnoiman asiakkaan tuottamien tietueiden määrän määritettynä ajanjaksona. Jos kumppani hallinnoi yli 200 asiakasorganisaatiota, API:n tulokset sivutetaan luettavuuden parantamiseksi. Voit käyttää näitä summia tarkistaaksesi paikallisesta varastostasi, jos tietueet puuttuvat tietyiltä asiakkailta. Löydät yhteensovittamisen API-päätepisteen URL-osoitteen täältä:

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

Parametrit

Täsmäytysliittymää voidaan kutsua enintään yhden tunnin ajan, ja parametrien startTime ja endTime välinen aika saa olla enintään 60 minuuttia. API:ta voidaan käyttää mille tahansa 1 tunnin ajanjaksolle 5 minuutin ja 48 tunnin väliseltä ajalta, mutta palvelun kuormituksen hallitsemiseksi vain 1 tunti kerrallaan.

Käytettävissä olevat parametrit ovat:

• startTime (merkkijono)- Ensimmäisen kerättävän raportin kellonaika. Raporttiaika määrittää puhelun päättymisajan.

  Kellonaika on muotoiltava muotoon VVVVV-KK-MM-PVKKH:MM:SS.mmmZ.

• endTime (merkkijono)- Viimeisen kerättävän raportin ajankohta. Raporttiaika määrittää puhelun päättymisajan.

  Määritetyn ajan on oltava myöhempi kuin startTime mutta enintään 48 tuntia, ja aika on muotoiltava muotoon VVVV-MM-KK-PVKK:MM:SS.mmmZ.

Tässä on esimerkki siitä, miltä Reconciliation API -loppupisteen JSON-palautuksen hyötykuorma näyttää:

{ "cdr_counts": [ { "orgId": { "orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy", "count": 3009 }, { "orgId": "yyyyyyyyyy-yyyyyy-zzzz-xxxx-yyyyyyyyyyyyyyyyyyyy", "count": 129 }, { "orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyy", "count": 278 } ] } 

API-vastauksen otsikoista käy ilmi palautettujen organisaatioiden kokonaismäärä ja se, onko ylimääräisiä sivuja. Tarkista seuraavat parametrit varmistaaksesi, että kaikki sivut on haettu.

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

Edellä esitetyt parametrit osoittavat, että nykyinen sivu on ensimmäinen sivu, että sivuja on yhteensä kaksi ja että koko vastaus sisältää 283 organisaatiota. Pääset toiselle sivulle lisäämällä parametrin page=2 GET -pyyntöön, kuten alla näkyy.

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

Tietueiden API-päätepiste

Tämä API-päätepiste palauttaa puhelutiedot JSON-muodossa, joka vastaa muotoa, joka on kuvattu osoitteessa Detailed Call History API. Palautettu hyötykuorma sisältää samat kentät kuin Detailed Call History -palautetun hyötykuorman kentät. Lisätietoja kunkin kentän palautetuista arvoista löydät täältä. Tietueiden API-päätepistettä käytetään sellaisten organisaatioiden puuttuvien tietueiden kyselyyn, joiden tietueet puuttuvat. Löydät tietueiden API-päätepisteen URL-osoitteen täältä:

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

Parametrit

• orgID-Organisaation tunnus, jonka tietueita haluat kysyä. Voit avata nämä tunnisteet edellisestä yhteensovittamisen päätepisteestä.

• startTime (merkkijono)- Ensimmäisen kerättävän raportin kellonaika. Raporttiaika määrittää puhelun päättymisajan.

  Määritetyn ajan on oltava 5 minuuttia ja 48 tuntia sitten väliltä, ja aika on muotoiltava muotoon VVVVV-KK-PP-PÄIVK:MM:SS.mmmZ.

• endTime (merkkijono)- Viimeisen kerättävän raportin ajankohta. Raporttiaika määrittää puhelun päättymisajan.

  Määritetyn ajan on oltava myöhempi kuin startTime mutta enintään 48 tuntia, ja aika on muotoiltava muotoon VVVV-MM-KK-PVKK:MM:SS.mmmZ.