Webhook s podrobnými záznamami hovorov ponúka bezpečné, škálovateľné a robustné riešenie riadené udalosťami, a nie požiadavkami. Tento webhook poskytuje lepší prehľad o aktivitách vašich zákazníkov v oblasti volaní Webex a podporuje prípady použitia od fakturácie až po prispôsobené reporty.

Tento webhook môžete použiť na pohodlné zhromažďovanie záznamov pre všetkých zákazníkov spravovaných prostredníctvom Centra partnerov bez toho, aby ste každého zákazníka dotazovali jednotlivo. Tento webhook vám umožňuje vyvíjať vlastné aplikácie na tvorbu prehľadov, fakturáciu a analýzu pre interné obchodné požiadavky aj pre služby s pridanou hodnotou.

Úvod do webhooku a jeho sprievodných API nájdete v tomto videu: Rozhranie API pre podrobnú históriu hovorov partnera Webex Calling.

Čo poskytuje webhook pre partnerov

Webhook poskytuje podrobné záznamy histórie hovorov každých 5 minút. Každý dátový obsah webhooku obsahuje:

• Záznamy hovorov, ktoré sa skončili 10 až 5 minút pred aktuálnym časom.
• Akékoľvek oneskorené záznamy spracované cloudovou službou Webex Calling.
• Automaticky dopĺňa záznamy o oneskorených hovoroch v nasledujúcich dátových dátach webhooku, aby sa zabezpečilo spoľahlivé doručenie.

Ak chcete ukázať, ako sú záznamy o hovoroch zahrnuté v každom dátovom zaťažení, zvážte nasledujúci príklad:

• Užitočné zaťaženie prijaté o 14:05 obsahuje hovory, ktoré skončili medzi 13:55 a 14:00.
• Hovory končiace medzi 14:00 a 14:05 sú zahrnuté v 14:10 užitočné zaťaženie.
• Záznamy dokončené skôr (napríklad hovor, ktorý skončil o 14:04) ale spracované oneskorene cloudom Webex Calling (napríklad o 14:11) sú zahrnuté v ďalšom plánovanom užitočnom zaťažení (napríklad 14:15).

Webhook v centre pre partnerov

Poskytnutím webhooku povolíte analytickej platforme odosielať záznamy hovorov na vašu URL adresu spätného volania vždy, keď sú vygenerované.

Záznamy volaní Webex sa doručujú v rovnakom formáte ako existujúce rozhrania API pre podrobné záznamy volaní. Môžete si nastaviť webhook a vybrať si medzi dvoma typmi kanálov:

• Analytika – Zahŕňa všetky záznamy o hovoroch pre všetky zákaznícke organizácie, s ktorými má partner vzťah Webex Calling. Patria sem organizácie, kde:
  • Partner spravuje organizáciu zákazníka s rolou správcu partnera s plnou kvalifikáciou.
  • Zákaznícka organizácia má aktívne predplatné služby Webex Calling v rámci partnerskej organizácie.
• Fakturácia – Zahŕňa záznamy o hovoroch uskutočnených používateľmi s licenciou Webex Calling predanou a poskytnutou partnerom. Záznamy hovorov pre pracovné priestory sú zahrnuté v tomto informačnom kanáli.

Prístup a ochrana osobných údajov

Prístup k záznamom o hovoroch (CDR) na účely fakturácie má iba vlastník.

• Partner (alebo subpartner), ktorý spravuje licenciu spojenú so záznamom hovoru, sa stáva vlastníkom.
• Vlastníctvo sa určuje na základe: ID používateľa > ID licencie > ID predplatného > ID partnera.
• Každý CDR je prístupný jednému partnerovi.
• Niektoré záznamy o hovoroch nie sú priradené k fakturačnému partnerovi a nie všetci partneri pridružení k organizácii majú rovnaký prístup ku všetkým záznamom, pretože tieto záznamy môžu obsahovať osobné identifikačné údaje (PII).

Okrem webhooku poskytuje Webex Calling koncové body API na podporu zosúladenia údajov. Tieto koncové body vám umožňujú dohnať alebo zosúladiť vaše úložiská údajov s chýbajúcimi záznamami, ktoré váš poslucháč webhookov možno nedostal. Dva koncové body rozhrania API sú rozhranie API pre zosúladenie a rozhranie API pre záznamy .

Záznamy z týchto API sú k dispozícii 30 dní. Aby ste zabezpečili doručenie všetkých očakávaných záznamov, odporúčame pravidelne odsúhlasovať vaše úložiská záznamov, napríklad každých 12 alebo 24 hodín.

Na prístup k týmto rozhraniam API musíte použiť partnerský prístupový token. Získajte a spravujte svoj partnerský prístupový token podľa štandardných postupov správy prístupových tokenov pre vývojárov Webex.

Koncový bod API odsúhlasenia

Koncový bod rozhrania API odsúhlasenia vráti celkový počet záznamov hovorov vygenerovaných pre každého zákazníka spravovaného partnerom v rámci zadaného časového obdobia. Tieto súčty môžete použiť na overenie lokálneho úložiska a identifikáciu chýbajúcich alebo nekonzistentných záznamov o hovoroch pre konkrétnych zákazníkov.

Ak spravujete viac ako 200 zákazníckych organizácií, rozhranie API stránkyje výsledky, aby sa zlepšila čitateľnosť.

URL koncového bodu rozhrania Reconciliation API používa nasledujúci formát:

Parametre API

Pomocou rozhrania API môžete načítať záznamy o hovoroch za posledných 30 dní. Vybrané časové okno musí začínať aspoň 5 minút pred aktuálnym časom UTC a nesmie presiahnuť 12 hodín medzi začiatkom a ukončením jedného volania API.

Parametre API sú:

• startTime (povinné, reťazec) – Dátum a čas začiatku (UTC) pre prvý záznam, ktorý chcete zhromaždiť. Zabezpečte, aby:
  • Čas formátujete ako YYYY-MM-DDTHH:MM:SS.mmmZ. Napríklad, 2025-08-15T06:00:00.000Z.
  • Dátum a čas začiatku nesmie byť starší ako 30 dní od aktuálneho času UTC.
  • Časové okno medzi startTime a endTime nesmie presiahnuť 12 hodín.
• endTime (povinné, reťazec) – Dátum a čas ukončenia (UTC) pre záznamy, ktoré chcete zhromažďovať. Záznamy sú založené na čase hlásenia, čo je čas ukončenia hovoru. Zabezpečte, aby:
  • Čas formátujete ako YYYY-MM-DDTHH:MM:SS.mmmZ. Napríklad, 2025-08-15T18:00:00.000Z.
  • Dátum a čas ukončenia musia byť 5 minút pred aktuálnym časom UTC a nie starší ako 30 dní.
  • Dátum a čas ukončenia musia byť väčšie ako startTime.
  • Časové okno medzi startTime a endTime nesmie presiahnuť 12 hodín.

Príklad odpovede JSON koncového bodu Reconciliation API:

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

Hlavičky odpovede API označujú celkový počet vrátených organizácií a či sú k dispozícii ďalšie stránky. Skontrolujte nasledujúce parametre hlavičky, aby ste sa uistili, že ste dotazovali všetky stránky:

• počet stránok: Celkový počet strán (napríklad 2)
• total-orgs: Celkový počet organizácií zahrnutých v odpovedi (napríklad 283)
• aktuálna-stránka: Aktuálne číslo strany (napríklad 1)

Napríklad, ak sa v hlavičkách zobrazujú num-pages=2, total-orgs=283, a current-page=1, Prezeráte si prvú stranu dvojstranovej odpovede, ktorá obsahuje celkovo 283 organizácií. Pre prístup k ďalšej stránke pridajte page=2 parameter do vašej požiadavky GET, ako je uvedené nižšie:

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

Koncový bod rozhrania API pre záznamy

Koncový bod rozhrania Records API sa používa na vyhľadávanie chýbajúcich záznamov o hovoroch pre konkrétne organizácie, v ktorých boli pomocou rozhrania Reconciliation API identifikované nezrovnalosti alebo chýbajúce údaje.

Rozhranie Records API vracia záznamy hovorov vo formáte JSON, identickom s formátom opísaným v rozhraní Detailed Call History API. Vrátený dátový dátový súbor obsahuje identické polia ako vrátený dátový súbor Podrobná história hovorov. Viac informácií o poliach a ich hodnotách nájdete v článku Podrobná správa o histórii hovorov služby Webex Calling.

API poskytuje záznamy o hovoroch, ktoré skončili 5 minút pred aktuálnym časom. Aby ste zabezpečili dostupnosť všetkých záznamov o hovoroch, odporúčame odoslať dotaz do API hodinu po uplynutí preferovaného časového okna.

URL koncového bodu rozhrania Records API používa nasledujúci formát:

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

Parametre API

• OrgID (povinné, reťazec) – ID organizácie, pre ktorú chcete načítať záznamy. ID organizácií môžete získať z rozhrania API na zosúladenie.
• startTime (povinné, reťazec) – Počiatočný dátum a čas (UTC) pre prvý záznam, ktorý chcete zhromaždiť. Zabezpečte, aby:
  • Čas formátujete ako YYYY-MM-DDTHH:MM:SS.mmmZ. Napríklad, 2025-08-15T06:00:00.000Z.
  • Dátum a čas začiatku nesmie byť starší ako 30 dní od aktuálneho času UTC.
  • Interval medzi startTime a endTime nesmie v jednej požiadavke API presiahnuť 12 hodín.
• endTime (povinné, reťazec) – Dátum a čas ukončenia (UTC) pre posledný záznam, ktorý chcete zhromaždiť. Záznamy sú založené na čase hlásenia, čo je čas ukončenia hovoru. Zabezpečte, aby:
  • Čas formátujete ako YYYY-MM-DDTHH:MM:SS.mmmZ. Napríklad, 2025-08-15T18:00:00.000Z.
  • Dátum a čas ukončenia musia byť aspoň 5 minút pred aktuálnym časom UTC a nie staršie ako 30 dní.
  • Dátum a čas ukončenia musia byť väčšie ako startTime.
  • Interval medzi startTime a endTime nesmie v jednej požiadavke API presiahnuť 12 hodín.
• Max (voliteľné, číslo) – Obmedzuje maximálny počet záznamov na stránku v odpovedi. Zabezpečte, aby:
  • Rozsah je od 500 do 5000. Predvolená hodnota je 5000. Napríklad, Max=1000.
  • Ak má API na vrátenie viac záznamov, ako je zadaná maximálna hodnota, odpoveď sa stránkuje.
  • Ak je zadaná hodnota nižšia ako 500, automaticky sa upraví až na 500. Ak je zadaná hodnota nad 5000, upraví sa nadol na 5000.

Stránkovanie

Ak chcete zistiť, či sú odpovede API stránkované, skontrolujte hlavičky odpovedí, či neobsahujú hlavičku odkazu. Ak sa v hlavičke odkazu nachádza odkaz next, extrahujte ho a na vyžiadanie ďalšej sady záznamov použite hodnotu startTimeForNextFetch. Ak neexistuje ďalší odkaz, zhromaždia sa všetky prehľady pre vybratý časový rozsah.

Požiadavky API pre nasledujúce stránky je možné vykonať okamžite, ale ich frekvencia musí byť obmedzená na maximálne 10 stránkovaných požiadaviek za minútu na rozsah tokenu.

Napríklad, ak je počiatočná požiadavka API:

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

potom je hlavička odkazu v odpovedi:

; rel="next"

Medzi ďalšie možné hodnoty odkazu patria rel="first" a rel="prev" pre prvú a predchádzajúcu stránku.

Partner reports/templates API

Prehľady dostupné v Centre pre partnerov môžete generovať a sťahovať pomocou rozhraní API pre prehľady partnerov. Viac informácií nájdete na stránke partnera report/templates.

Partneri môžu tiež pristupovať k viacerým prehľadom a sťahovať ich priamo z Centra partnerov. Viac informácií nájdete v správach Centra partnerov.