A részletes hívásrekordok webhook segítségével jobban láthatja az ügyfelek Webex Calling-tevékenységeit különböző célokra, a számlázástól az egyéni jelentéskészítésig. Ez a webhook segítségével kényelmesen gyűjthet rekordokat az összes ügyfele számára, anélkül, hogy az egyes ügyfelek rekordjait egyenként kellene kikérnie. Ez a webhook lehetővé teszi, hogy egyéni jelentési és elemzési alkalmazásokat fejlesszen ki belső üzleti célokra vagy hozzáadott értéket jelentő szolgáltatások nyújtására az ügyfelek számára. A webhook és a kapcsolódó API-k bemutatójaként megtekintheti ezt a vidcast.

A webhook 5 percenként küld felvételeket. Minden webhook payload tartalmazza a 10 és 5 perccel ezelőtt véget ért hívások rekordjait. Például a 17:00-kor fogadott payload azokat a hívásokat is tartalmazza, amelyek 16:50 és 16:55 között zárultak. A 16:55 és 17:00 között végződő hívások a 17:05-ös hasznos terhelésben lesznek.

A Webex Calling-rekordok ugyanolyan formátumban kerülnek kézbesítésre, mint a meglévő részletes hívásrögzítési API-k. Beállíthat egy webhookot, és kétféle feed közül választhat:

• Elemzés – Tartalmazza az összes olyan ügyfélszervezet összes hívásrekordját, amellyel a partner Webex Calling-kapcsolatban áll. Ebbe beletartoznak azok a szervezetek, amelyek:
  • A partner teljes körű partnerrendszergazda szerepkörrel kezeli az ügyfél szervezetét.
  • Az ügyfélszervezet aktív Webex Calling-előfizetéssel rendelkezik a partnerszervezeten belül.
• Számlázás – Csak a partner által értékesített Webex Calling licenccel rendelkező felhasználók által kezdeményezett hívások hívásrekordjait tartalmazza. A munkaterületek hívásrekordjai benne vannak ebben a feedben.

A webhookkal együtt két API-végpontot biztosítunk az adatok egyeztetésének elősegítése érdekében. Ezek a végpontok lehetővé teszik az adattárak „felzárkózását” vagy egyeztetését a webhook figyelmébe érkező hiányzó rekordokkal. Ez a két API a Békélési API végpont és a Rekordok API-végpont.

A felvételek 48 órán keresztül érhetők el ezektől az API-któl. Javasoljuk, hogy a rekordtárakat rendszeresen, például 12 vagy 24 óránként egyeztesse, hogy az összes rekord a várt módon érkezzen meg. Az API használatához partnerhozzáférési tokenre van szükség. Partnerhozzáférési tokent szerezhet, és kezelheti azt a Webex Developer hozzáférési tokenkezelési alapelvei szerint.

Egyeztetési API-végpont

Az egyeztetési API-végpont az egyes ügyfelek által generált, a partner által kezelt rekordok számát adja vissza a megadott időszakban. Ha egy partner több mint 200 ügyfélszervezetet kezel, az API eredményei lapozásra kerülnek a jobb olvashatóság érdekében. Ezekkel az összegekkel ellenőrizheti a helyi tárhelyet, ha bizonyos ügyfelek rekordjai hiányoznak. Az egyeztetési API-végpont URL-címét itt találja:

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

Paraméterek

Az egyeztetési API legfeljebb 1 órás időtartamra hívható meg, a startTime és az endTime paraméterek között legfeljebb 60 perc eltérés van. Az API bármely 1 órás időszakban használható, 5 perc és 48 óra között, de a szolgáltatási terhelés kezeléséhez egyszerre csak 1 óra hívható meg.

A rendelkezésre álló paraméterek a következők:

• startTime (karakterlánc) – Az első begyűjteni kívánt jelentés időpontja. A jelentés ideje határozza meg a hívás befejezésének idejét.

  Az időt a következő formátumban kell formáznia: ÉÉÉÉ-HH-NN:PP:MM.mmmZ.

• endTime (karakterlánc) – Az utolsó begyűjteni kívánt jelentés időpontja. A jelentés ideje határozza meg a hívás befejezésének idejét.

  A megadott időnek későbbinek kell lennie, mint a startTime , de legkésőbb 48 órának kell lennie, és az időt a következő formátumban kell formáznia: ÉÉÉÉ-HH-NN:PP:MM.mmmZ.

Íme egy példa arra, hogy néz ki egy Megbékélési API végpont JSON visszaküldési payload:

{ "cdr_counts": [{ "orgId": "zzzzzzzz-éééé-zzzz-xxxx-éééééé", "count": 3009 }, {"orgId": "éééééé-éééé-zzzz-xxxx-éééééé", "count": 129 }, {"orgId": "xxxxxxxx-éééé-zzzz-xxxx-éééééé", "count": 278 } ] } 

Az API-válasz fejlécei jelzik a visszaküldött szervezetek teljes számát, és azt, hogy vannak-e további oldalak. Ellenőrizze a következő paramétereket, és győződjön meg arról, hogy minden oldalt lekérdezett a rendszer.

 num-pages = 2 összes szervezet = 283 aktuális oldal = 1

A fenti paraméterek azt mutatják, hogy az aktuális oldal az első oldal, összesen 2 oldal van, és hogy a teljes válasz 283 szervezetet tartalmaz. Lépjen be a második oldalra a page=2 paraméter hozzáadásával a GET kérelemhez, az alábbiak szerint.

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

Rekordok API-végpontja

Ez az API-végpont JSON formátumban tér vissza a hívásrekordokat, amelyek megegyeznek a Részletes hívásnapló API-ban leírt formátummal. A visszaküldött hasznos adat ugyanazokat a mezőket tartalmazza, mint a Részletes hívásnapló visszaküldött hasznos adat. Az egyes visszaküldött mezők értékeiről további részleteket itt talál. A rekordok API-végpontja a hiányzó rekordok lekérdezésére szolgál azon szervezetek esetében, amelyekhez hiányoznak a rekordok. A rekordok API-végpont URL-címe itt található:

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

Paraméterek

• orgID – Az a szervezeti azonosító, amelyre rekordokat szeretne lekérdezni. Ezeket az azonosítókat az előző egyeztetési végpontból nyithatja meg.

• startTime (karakterlánc) – Az első begyűjteni kívánt jelentés időpontja. A jelentés ideje határozza meg a hívás befejezésének idejét.

  A megadott időnek 5 perccel és 48 órával ezelőtt kell lennie, és a formátumot a következő formátumban kell megadni: ÉÉÉÉ-HH-NN:PP:MM.mmmZ.

• endTime (karakterlánc) – Az utolsó begyűjteni kívánt jelentés időpontja. A jelentés ideje határozza meg a hívás befejezésének idejét.

  A megadott időnek későbbinek kell lennie, mint a startTime , de legkésőbb 48 órának kell lennie, és az időt a következő formátumban kell formáznia: ÉÉÉÉ-HH-NN:PP:MM.mmmZ.