A részletes hívásrekordok webhookja biztonságos, skálázható és robusztus megoldást kínál, amelyet események, nem pedig kérések vezérelnek. Ez a webhook nagyobb rálátást biztosít az ügyfelek Webex Calling tevékenységeire, támogatva a használati eseteket a számlázástól az egyedi jelentéskészítésig.

Ezzel a webhookkal kényelmesen gyűjtheti a Partner Hubon keresztül kezelt összes ügyfél rekordjait anélkül, hogy minden egyes ügyfelet külön-külön lekérdezne. Ez a webhook lehetővé teszi egyéni jelentéskészítési, számlázási és analitikai alkalmazások fejlesztését mind belső üzleti igényekhez, mind hozzáadott értékű szolgáltatásokhoz.

A webhook és a hozzá tartozó API-k bevezetéséhez nézd meg ezt a Vidcast videót: Webex híváspartner részletes híváselőzmény-API.

Mit kínál a Partner webhook?

A webhook 5 percenként részletes híváselőzményeket biztosít. Minden webhook hasznos adat a következőket tartalmazza:

• Az aktuális időpont előtt 10 és 5 perc között véget ért hívásrekordok.
• A Webex Calling felhő által feldolgozott késedelmes rekordok.
• Automatikusan kitölti a kései hívásrekordokat a későbbi webhook-adatcsomagokban a megbízható kézbesítés biztosítása érdekében.

A hívásrekordok egyes hasznos adatokba való beillesztésének bemutatásához tekintsük a következő példát:

• Hasznos adat érkezett ekkor: 14:05 között véget ért hívásokat tartalmaz 13:55 és 14:00.
• között végződő hívások 14:00 és 14:05 szerepelnek a 14:10 hasznos teher.
• Korábban befejezett rekordok (például egy hívás, amely ekkor ért véget) 14:04) de a Webex Calling cloud későn dolgozta fel (például a következő időpontban: 14:11) szerepelnek a következő ütemezett hasznos adatban (például 14:15).

Webhook a Parter Hubban

Egy webhook biztosításával lehetővé teszed az analitikai platform számára, hogy hívásrekordokat küldjön a visszahívási URL-címedre, valahányszor azok létrejönnek.

A Webex hívásrekordok kézbesítése ugyanazzal a formátummal történik, mint a meglévő részletes hívásrekordok API-jai. Beállíthatsz egy webhookot, és kétféle hírcsatorna közül választhatsz:

• Elemzések – Tartalmazza az összes olyan ügyfél-szervezet összes hívásrekordját, amellyel a partner Webex Calling kapcsolatban áll. Ez magában foglalja azokat a szervezeteket is, ahol:
  • A partner teljes partneri adminisztrátori szerepkörrel kezeli az ügyfél szervezetét.
  • Az ügyfél szervezet aktív Webex Calling előfizetéssel rendelkezik a partner szervezeten belül.
• Számlázás – Tartalmazza a partner által értékesített és kiépített Webex Calling licenccel rendelkező felhasználók által kezdeményezett hívások híváslistáit. A munkaterületek hívásrekordjai szerepelnek ebben a hírcsatornában.

Hozzáférés és adatvédelem

Csak a tulajdonos partner férhet hozzá a hívásadatokhoz (CDR) számlázási célból.

• A hívásrekordhoz társított licencet kezelő partner (vagy alpartner) lesz a tulajdonos partner.
• A tulajdonjogot a következők határozzák meg: Felhasználói azonosító > Licencazonosító > Előfizetés-azonosító > Partnerazonosító.
• Minden CDR egyetlen partner számára érhető el.
• Bizonyos hívásrekordok nem kapcsolódnak számlázási partnerhez, és nem minden, a szervezethez kapcsolódó partner kap egyenlő hozzáférést az összes rekordhoz, mivel ezek a rekordok személyazonosításra alkalmas adatokat (PII) tartalmazhatnak.

A webhook mellett a Webex Calling API-végpontokat is biztosít az adategyeztetés támogatásához. Ezek a végpontok lehetővé teszik az adattárak utolérését vagy egyeztetését a webhook-figyelő által esetleg nem kapott hiányzó rekordokkal. A két API végpont az Egyeztetési API és a Rekordok API.

Az ezekből az API-kból származó rekordok 30 napig érhetők el. Annak érdekében, hogy minden várt adatot megkapjon, javasoljuk, hogy rendszeresen, például 12 vagy 24 óránként, egyeztessen adattárolóival.

Partner hozzáférési tokent kell használnia ezen API-k eléréséhez. Szerezze be és kezelje partner-hozzáférési tokenjét a szabványos Webex fejlesztői hozzáférési tokenkezelési gyakorlatoknakmegfelelően.

Egyeztetési API végpont

Az Egyeztetési API végpont visszaadja a partner által a megadott időszakban kezelt egyes ügyfelekhez generált hívásrekordok teljes számát. Ezekkel az összesítésekkel ellenőrizheti a helyi tárhelyét, és azonosíthatja az egyes ügyfelek hiányzó vagy inkonzisztens hívásrekordjait.

Ha több mint 200 ügyfélszervezetet kezel, az API oldalszámozással jeleníti meg az eredményeket az olvashatóság javítása érdekében.

Az Egyeztetési API végpont URL-címe a következő formátumot használja:

API-paraméterek

Az API segítségével lekérheti az elmúlt 30 nap hívásrekordjait. A kiválasztott időablaknak legalább 5 perccel az aktuális UTC idő előtt kell kezdődnie, és egyetlen API-híváson belül a kezdési és befejezési időpontok között nem lehet több 12 óránál.

Az API-paraméterek a következők:

• startTime (kötelező, karakterlánc) – Az első gyűjteni kívánt rekord kezdési dátuma és időpontja (UTC). Győződjön meg arról, hogy:
  • Az időt YYYY-MM-DDTHH:MM:SS.mmmZformátumban kell formázni. Például, 2025-08-15T06:00:00.000Z.
  • A kezdési dátum és időpont nem lehet régebbi 30 napnál az aktuális UTC időhöz képest.
  • A startTime és endTime közötti időablak nem haladhatja meg a 12 órát.
• endTime (kötelező, karakterlánc) – A gyűjteni kívánt rekordok befejezési dátuma és időpontja (UTC). A rekordok a jelentési időn alapulnak, azaz amikor a hívás befejeződik. Győződjön meg arról, hogy:
  • Az időt YYYY-MM-DDTHH:MM:SS.mmmZformátumban kell formázni. Például, 2025-08-15T18:00:00.000Z.
  • A befejezési dátumnak és időpontnak 5 perccel az aktuális UTC idő előtt kell lennie, és nem lehet 30 napnál régebbi.
  • A befejezési dátumnak és időpontnak nagyobbnak kell lennie, mint a startTime.
  • A startTime és endTime közötti időablak nem haladhatja meg a 12 órát.

Példa egy Reconciliation API végpont JSON válaszára:

          {
          "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
          }
          ]
          }          
        

Az API válaszfejlécek jelzik a visszaadott szervezetek teljes számát, valamint azt, hogy elérhetők-e további oldalak. Ellenőrizze a következő fejlécparamétereket, hogy megbizonyosodjon arról, hogy az összes oldalt lekérdezte:

• oldalak száma: Oldalak teljes száma (például 2)
• összes szervezet: A válaszban szereplő szervezetek teljes száma (például 283)
• aktuális oldal: Az aktuális oldalszám (például 1)

Például, ha a fejlécek megjelennek num-pages=2, total-orgs=283, és current-page=1, Egy kétoldalas válasz első oldalát tekinti meg, amely összesen 283 szervezetet tartalmaz. A következő oldal eléréséhez adja hozzá a page=2 paramétert a GET kérésedhez, az alábbiak szerint:

https://analytics-calling.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

A Records API végpont hiányzó hívásrekordok lekérdezésére szolgál bizonyos szervezetek esetében, ahol eltéréseket vagy hiányzó adatokat azonosítottak az Egyeztetési API használatával.

A Records API JSON formátumban adja vissza a hívásrekordokat, amely megegyezik a Részletes híváselőzmények API-banleírt formátummal. A visszaadott hasznos adat azonos mezőket tartalmaz, mint a részletes híváselőzményekben visszaadott hasznos adat. A mezőkkel és azok értékeivel kapcsolatos további információkért lásd: Webex hívás részletes híváselőzmény-jelentés.

Az API olyan hívásrekordokat biztosít, amelyek az aktuális időpont előtt 5 perccel fejeződtek be. Annak érdekében, hogy minden hívásrekord elérhető legyen, javasoljuk, hogy a kívánt időablak után egy órával kérdezze le az API-t.

A Records API végpont URL-címe a következő formátumot használja:

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-paraméterek

• OrgID (kötelező, karakterlánc) – A szervezet azonosítója, amelyhez rekordokat szeretne lekérni. A szervezeti azonosítókat az Egyeztetési API-ból szerezheti be.
• startTime (kötelező, karakterlánc) – Az első gyűjteni kívánt rekord kezdési dátuma és időpontja (UTC). Győződjön meg arról, hogy:
  • Az időt YYYY-MM-DDTHH:MM:SS.mmmZformátumban kell formázni. Például, 2025-08-15T06:00:00.000Z.
  • A kezdési dátum és időpont nem lehet régebbi 30 napnál az aktuális UTC időhöz képest.
  • A startTime és endTime közötti időköz nem haladhatja meg a 12 órát egyetlen API-kérésben.
• endTime (kötelező, karakterlánc) – Az utolsó gyűjteni kívánt rekord befejezési dátuma és időpontja (UTC). A rekordok a jelentési időn alapulnak, azaz amikor a hívás befejeződik. Győződjön meg arról, hogy:
  • Az időt YYYY-MM-DDTHH:MM:SS.mmmZformátumban kell formázni. Például, 2025-08-15T18:00:00.000Z.
  • A befejezési dátumnak és időpontnak legalább 5 perccel az aktuális UTC idő előtt kell lennie, és nem lehet 30 napnál régebbi.
  • A befejezési dátumnak és időpontnak nagyobbnak kell lennie, mint a startTime.
  • A startTime és endTime közötti időköz nem haladhatja meg a 12 órát egyetlen API-kérésben.
• Max (opcionális, szám) – Korlátozza a válaszban oldalonként maximálisan megjeleníthető rekordok számát. Győződjön meg arról, hogy:
  • A tartomány 500 és 5000 között van. Az alapértelmezett érték 5000. Például, Max=1000.
  • Ha az API-nak több rekordja van visszaadni, mint a megadott Max érték, akkor a válasz lapozásra kerül.
  • Ha 500 alatti értéket ad meg, akkor az automatikusan 500-ra módosul. Ha 5000 feletti értéket adunk meg, akkor az 5000-re lesz lejjebb módosítva.

Tördelés

Annak megállapításához, hogy az API-válaszok lapozottak-e, ellenőrizze a válaszfejléceket egy hivatkozásfejléchez. Ha a Link fejlécben next hivatkozás található, akkor azt ki kell nyerni, és a startTimeForNextFetch érték használatával kell lekérni a következő rekordhalmazt. Ha nincs következő hivatkozás, akkor a kiválasztott időtartomány összes jelentése begyűjtésre kerül.

A következő oldalakra vonatkozó API-kérelmek azonnal elküldhetők, de a sebességet percenként legfeljebb 10 lapozott kérésre kell korlátozni token hatókörönként.

Például, ha a kezdeti API-kérés:

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

akkor a válaszban szereplő link fejléce a következő:

; rel="next"

Egyéb lehetséges linkértékek lehetnek rel="first" a és rel="prev" a az első, illetve az előző oldalakhoz.

Partner reports/templates API

A Partner Hubban elérhető jelentéseket a Partner Reports API-khasználatával generálhatja és töltheti le. További információkért lásd a partnert report/templates.

A partnerek közvetlenül a Partner Hubból is elérhetnek és letölthetnek több jelentést. További információkért lásd: Partner Hub jelentések.