Ďakujeme za vašu spätnú väzbu.

Webhook Detailed Call Records ponúka bezpečné, škálovateľné a robustné riešenie riadené skôr udalos ťami ako požiadavkami. Tento webový háčik poskytuje väčší prehľad o aktivitách vašich zákazníkov a Webex Calling podporuje prípady použitia od fakturácie až po vykazovanie prispôsobené na mieru.

Tento webový háčik môžete použiť na pohodlné zhromažďovanie záznamov pre všetkých zákazníkov spravovaných prostredníctvom Partner Hub bez toho, aby ste sa dotazovali každého zákazníka individuálne. Tento webhook vám umožňuje vytvárať vlastné aplikácie pre vý kazníctvo, fakturáciu a analytické aplikácie pre interné obchodné požiadavky aj služby s pridanou hodnotou.

Úvod do webhook a jeho sprievodných rozhraní API nájdete v tomto rozhraní Vidcast: Webex Calling Partner Detailed Call History API.

Čo prináša partnerský webhook

Webhook poskytuje podrobné záznamy histórie hovorov každých 5 minút. Každá užitočná záťaž webhook obsahuje:

• Záznamy hovorov, ktoré skončili medzi 10 a 5 minútami pred aktuálnym časom.
• Akékoľvek neskoré záznamy spracované Webex Calling cloudom.
• Automaticky zaisťuje záznamy o neskorých hovoroch v nasledujúcich užitočných nákladoch webhook, aby sa zabezpeč ilo spoľahlivé doručenie.

Ak chcete ukázať, ako sú záznamy hovorov zahrnuté do každého užitočného zaťaženia, 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 užitočnom zaťažení 14:10.
• Záznamy dokončené skôr (napríklad hovor, ktorý skončil o 14:04), ale neskoro sprac ované Webex Calling cloudom (napríklad o 14:11), sú zahrnuté do ďalšieho naplánovaného užitočného zaťaženia ( napríklad 14:15).

Webhook v partnerskom centre

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

Webex Callingzáznamy sa dodávajú v rovnakom formáte ako existujúce rozhrania API detailných záznamov hovorov. Môžete nastaviť webhook a vybrať si z dvoch typov informačných kanálov:

• Analytika — Zahŕňa všetky záznamy hovorov pre všetky zákaznícke organizácie, s ktorými má partner vzťah. Webex Calling Patria sem organizácie, v ktorých:
  • Partner riadi organizáciu zákazníkov s úlohou Partner Full Administrator.
  • Zákaznícka organizácia má aktívne Webex Calling predplatné v rámci partnerskej organizácie.
• Fakturácia — Zahŕňa záznamy hovorov pre hovory uskutočnené používateľmi s Webex Calling licenciou predávanou a poskytnutou partnerom. Záznamy hovorov pre pracovné priestory sú zahrnuté v tomto informačnom kanáli.

Prístup a súkromie údajov

Pre fakturáciu má prístup k záznamom o podrobnostiach hovorov (CDR) iba vlastnícky partner.

• Partner (alebo subpartner), ktorý spravuje licenciu spojenú so záznamom hovoru, sa stáva vlastníkom.
• Vlastníctvo určuje: ID používateľa > ID licencie > ID predplatného > ID partnera.
• Každý CDR je prístupný jedinému partnerovi.
• Niektoré záznamy hovorov sa nezobrazujú na fakturačného partnera a nie všetci partneri spojení s organizáciou majú rovnaký prístup ku všetkým záznamom, pretože tieto záznamy môžu obsahovať osobne identifikovateľné informácie (PII).

Okrem webhook Webex Calling poskytuje koncové body API na podporu zosúladenia údajov. Tieto koncové body vám umožňujú dohnať alebo zosúladiť vaše dátové úložiská s akýmikoľvek chýbajúcimi záznamami, ktoré váš poslucháč webhook možno nedostal. Dva koncové body rozhrania API sú Rec onpliation API a Records API.

Záznamy z týchto rozhraní API sú k dispozícii 30 dní. Aby ste zabezpečili, že dostanete všetky očakávané záznamy, odporúčame pravidelne zosúlaďovať svoje záznamy, napríklad každých 12 alebo 24 hodín.

Na prístup k týmto rozhraním API musíte použiť token prístupu pre partnerov. Autentifikujúci používateľ musí byť úplným správcom partnera s prístupom na úrovni správcu organizácie a musí mať povolený prístup k roz Webex Callinghraniu CDR API. Token OAuth musí obsahovať rozsah. spark-admin:calling_cdr_read Úlohy správcu iba na čítanie nie sú dostatočné pre rozhrania API pre zosúladenie partnerov a záznamy.

Použite kon analytics-callingcový bod pre dátovú oblasť zákazníckej organiz Webex Calling ácie. Použite príslušnú základnú adresu URL pre rozhranie API zosúladenia a záznamov:

• USA a Kanada: https://analytics-calling.webexapis.com
• Európa: https://analytics-calling-eu.webexapis.com
• India: https://analytics-calling-in.webexapis.com
• Austrália: https://analytics-calling-au.webexapis.com

Koncový bod API pre zosúladenie

Koncový bod rozhrania rozhrania rozhrania vráti celkový počet záznamov hovorov generovaných pre každého zákazníka spravovaného partnerom v stanovenom časovom období. Tieto súčty môžete použiť na overenie miestneho úložiska a identifikáciu chýbajúcich alebo nekonzistentných záznamov hovorov pre konkrétnych zákazníkov.

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

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

Parametre API

Rozhranie API môžete použiť na načítanie záznamov hovorov z posledných 30 dní. Zvolené časové okno sa musí začať najmenej 5 minút pred aktuálnym časom UTC a nesmie prekročiť 12 hodín medzi začiatočným a koncovým časom v jednom volaní API.

Parametre API sú:

• StartTime (povinný, reťazec) —dátum a čas začiatku (UTC) pre prvý záznam, ktorý chcete zhromaždiť. Uistite sa, že:
  • Čas formátujete ako YYYY-MM-DDTHH:MM:SS.mmmZ. Napríklad, 2025-08-15T06:00:00.000Z.
  • Dátum a čas začiatku nesmú byť staršie ako 30 dní od aktuálneho času UTC.
  • Okno medzi startTimea endTimenesmie presiahnuť 12 hodín.
• EndTime (povinný, reťazec) — dátum a čas ukončenia (UTC) pre záznamy, ktoré chcete zhromaždiť. Záznamy sú založené na čase hlásenia, ktorý je v čase hovoru ukončený. Uistite sa, že:
  • Č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šie ako 30 dní.
  • Dátum a čas ukončenia musia byť väčšie ako startTime.
  • Okno medzi startTimea nes endTimemie presiahnuť 12 hodín.

Príklad odpovede JSON koncového bodu rozhrania 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 odpovedí API označujú celkový počet vrátených organizácií a to, či sú k dispozícii ďalšie stránky. Skontrolujte nasledujúce parametre hlavičky, aby ste sa uistili, že ste vyhľadali všetky stránky:

• počet stránok: Celkový počet strán (napr. 2)
• celkové organizácie: Celkový počet organizácií zahrnutých do odpovede (napríklad 283)
• aktuálna stránka: Aktuálne číslo stránky (napríklad 1)

Ak sa napríklad v hlavičkách zobrazuje num-pages=2, total-orgs=283 a current-page=1, zobrazuje sa prvá stránka dvojstranovej odpovede obsahujúcej celkovo 283 organizácií. Ak chcete prejsť na ďalšiu stránku, pridajte parameter page=2 do svojej žiadosti GET, ako je znázornené 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 API zaznamenáva

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

Odporúčaný tok: Naj /v1/partners/cdrcountbyorgprv zavolajte. Potom cdr_counts[].orgIdpri zavolaní použite presné orgIdvrátené číslo /v1/partners/cdrsbyorg.

Rozhranie Records API vracia záznamy hovorov vo formáte JSON, identickom s formátom opísaným v rozhraní API Detailná história hovor ov. Vrátené užitočné zaťaženie obsahuje rovnaké polia s vráteným užitočným zaťažením podrobnej histórie hovorov. Ďalšie informácie o poliach a ich hodnotách nájdete v časti Webex CallingPodrobná správa histórie hovorov.

Rozhranie API poskytuje záznamy hovorov, ktoré skončili 5 minút pred aktuálnym časom. Aby sme sa uistili, že všetky záznamy hovorov sú k dispozícii, odporúčame vám zadať dotaz do rozhrania API hodinu po preferovanom časovom okne.

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 zákazníka, pre ktoré chcete načítať záznamy. Názov parametra rozlišuje veľké a veľké písmená. Identifikácie organizácie môžete získať z poľa odpovede rozhrania Reconpliation API cdr_counts[].orgId.
• StartTime (povinný, reťazec) —dátum a čas začiatku (UTC) pre prvý záznam, ktorý chcete zhromaždiť. Uistite sa, že:
  • Čas formátujete ako YYYY-MM-DDTHH:MM:SS.mmmZ. Napríklad, 2025-08-15T06:00:00.000Z.
  • Dátum a čas začiatku nesmú byť staršie ako 30 dní od aktuálneho času UTC.
  • Interval medzi startTimea nes endTimemie presiahnuť 12 hodín v jednej požiadavke API.
• EndTime (povinný, reťazec) —dátum a čas ukončenia (UTC) posledného záznamu, ktorý chcete zhromaždiť. Záznamy sú založené na čase hlásenia, ktorý je v čase hovoru ukončený. Uistite sa, že:
  • Č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ť najmenej 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 startTimea nes endTimemie presiahnuť 12 hodín v jednej požiadavke API.
• max (voliteľné, číslo) —Obmedzuje maximálny počet záznamov na stranu v odpovedi. Uistite sa, že:
  • Rozsah je od 500 do 5000. Predvolená hodnota je 5000. Napríklad, max=1000.
  • Ak má rozhranie API viac záznamov, ktoré treba vrátiť ako zadaná maximálna hodnota, odpoveď sa zobrazí na stránkach.
  • Ak je zadaná hodnota nižšia ako 500, automaticky sa nastaví na 500. Ak je zadaná hodnota vyššia ako 5000, upraví sa na 5000.

Stránkovanie

Ak chcete zistiť, či sú odpovede API stránkované, skontrolujte hlavičky odpovedí pre hlavičku prepojenia. Ak je pre nextpojenie prítomné v hlavičke prepojenia, extrahujte ho a použite startTimeForNextFetchhodnotu na vyžiadanie ďalšej sady záznamov. Ak neexistuje ďalší odkaz, zhromaždia sa všetky správy pre zvolený časový rozsah.

Požiadavky API pre nasledujúce stránky je možné zadať okamžite, ale musia byť rýchlosťou obmedzená na maximálne 10 stránkovaných požiadaviek za minútu na rozsah tokenu.

Pri načítaní záznamov použite spracovanie idempotentné a deduplikáciu, a to aj naprieč stranovými odpoveďami alebo oknami opakovaného zosúladenia. Použite reportIdako primárny kľúč a reportTimena určenie najnovšieho spracovaného záznamu.

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 hlavička odkazu v odpovedi je:

<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&startTimeForNextFetch=2025-08-15T09:30:00.000Z&totalCount=20000&max=5000>; rel="next"

Stránkovanie používa iba hlavičku pre rel="next"pojenia. Ak odpoveď obsahuje od rel="next"kaz, použite túto adresu URL na načítanie ďalšej stránky záznamov. Ak odpoveď neobsahuje od rel="next"kaz, načítali ste všetky dostupné záznamy pre vybraný časový rozsah.

Prehľady dostupné v centre partnerov môžete generovať a sťahovať pomocou rozhrania API prehľadov partnerov. Ďalšie informácie nájdete v správe/šab lónach partnera.

Partneri môžu tiež pristupovať a sťahovať viaceré správy priamo z centra Partner Hub. Ďalšie informácie nájdete v prehľ ade Partner Hub.