Synchronizácia adresárov v službe Webex pre Cisco BroadWorks

Synchronizácia adresárov zaisťuje, že používatelia Webex pre Cisco BroadWorks môžu použiť adresár Webex z aplikácie Webex na volanie ľubovoľnej volajúcej entity zo servera BroadWorks. Táto funkcia synchronizuje informácie o volaní BroadWorks, ktoré neboli súčasťou poskytovania používateľov, do adresára Webex.

Poskytovanie používateľov Webex pre Cisco BroadWorks aktualizuje adresár Webex s podrobnosťami o hovoroch pre používateľov Webex pre Cisco BroadWorks (primárne telefónne číslo, číslo mobilného telefónu, klapka), ale vynecháva záznamy externých hovorov. Keď je však zapnutá synchronizácia adresára, táto funkcia synchronizuje aj nasledujúce záznamy hovorov s adresárom Webex.

• Volajúci používatelia iba BroadWorks (ktorí nie sú prihlásení do Webexu)

• Volajúce entity, ktoré nie sú používateľmi (napr. telefón v konferenčnej miestnosti, fax, číslo lovecej skupiny)

• Položky v zozname telefónov BroadWorks

Nasledujúca tabuľka sumarizuje záznamy hovorov spoločnosti BroadWorks a ukazuje, ako sa pridávajú do adresára Webex.

Podmienky synchronizácie adresárov

• Správcovia partnerov musia túto funkciu povoliť na úrovni partnera. Správcovia partnerov môžu túto funkciu zapnúť alebo vypnúť pre viacero organizácií zákazníkov v jednej operácii.

• Predvolene sa počiatočná synchronizácia uskutoční týždeň po povolení synchronizácie (čas zvolený na spustenie synchronizácie je náhodný). Organizácie zákazníkov však môžu použiť možnosť Synchronizovať teraz na obídenie týždennej lehoty čakania a spustenie okamžitej synchronizácie pre danú organizáciu zákazníka.

• V predvolenom nastavení sa synchronizácia adresárov spúšťa týždenne pre každého zákazníka. Každá synchronizácia sa uskutoční týždeň po poslednej synchronizácii bez ohľadu na to, či bola posledná synchronizácia naplánovaná alebo spustená manuálne pomocou funkcie Synchronizovať.

• Maximálny počet súčasných synchronizácií na klaster BroadWorks je dve: jedna plánovaná synchronizácia a jedna synchronizácia na požiadanie (prostredníctvom rozhrania API alebo grafického používateľského rozhrania centra partnerov). Správcovia však nemôžu spustiť dve synchronizácie na požiadanie súčasne z rovnakého BroadWorks. Toto obmedzenie existuje bez ohľadu na to, či bola synchronizácia iniciovaná prostredníctvom rozhrania API alebo prostredníctvom možnosti Synchronizovať v centre partnerov. Okrem toho Webex nenaplánuje spustenie dvoch naplánovaných synchronizácií v rovnakom čase z rovnakého BroadWorks.

• Ak dôjde k zlyhaniu synchronizácie, Webex sa automaticky pokúsi o synchronizáciu každých 24 hodín až do ďalšej naplánovanej synchronizácie.

• Synchronizácia ignoruje používateľov, ktorí nemajú telefónne číslo.

• V centre partnerov môžete zobraziť informácie o stave synchronizácie pre daného zákazníka. Okrem toho môžete exportovať podrobné informácie o poslednej synchronizácii do CSV záznamu. Záznam CSV poskytuje viac podrobností ako displej Control Hub a môže pomôcť pri riešení problémov, analýze a audite.

• Webex ukladá kontakty používateľov v šifrovanom formáte. Prístup k dešifrovaciemu kľúču má iba používateľ, ktorý je vlastníkom kontaktu.

• Pre volajúcich používateľov BroadWorks a neužívateľských volajúcich entít táto funkcia synchronizuje nasledujúce typy telefónnych čísel zo spoločnosti BroadWorks:

  • Primárne telefónne číslo

  • Číslo mobilného telefónu

  • Rozšírenie

  Synchronizácia však zo synchronizácie vylúči volajúcich používateľov a volajúce entity, ktoré nie sú používateľmi, zo synchronizácie, ak nie je k dispozícii ani primárne telefónne číslo ani klapka.

  Nastavenie služby ochrany osobných údajov na úrovni používateľa BroadWorks nie je podporované ako súčasť synchronizácie adresárov.

Zoznam telefónov BroadWorks a maximá kontaktov

Synchronizácia adresárov tiež synchronizuje položky zoznamu telefónov BroadWorks s kontaktmi Webex. Synchronizované položky sa pridajú k jednému z nasledujúcich typov kontaktov:

• Kontakty organizácie – Webex ukladá tieto kontakty proti organizácii. Každý používateľ má prístup ku kontaktom organizácie pre svoju organizáciu. Maximálne je až 30000 kontaktov.

• Kontakty používateľov – Webex ukladá tieto kontakty proti používateľovi. Prístup k záznamu kontaktu má iba používateľ, ktorý je vlastníkom kontaktu. Maximálne je až 2000 kontaktov (1500 synchronizovaných kontaktov + 500 kontaktov manuálneho zadávania).

Nasledujúca tabuľka mapuje typy kontaktov Webex na zdroj kontaktov (synchronizovaný zo zoznamu telefónov BroadWorks alebo pridaný manuálne):

Nasledujúce podmienky sa vzťahujú na spôsob, akým Synchronizácia adresárov spracováva maximálne počet kontaktov:

• Ak organizácia prekročí maximálny povolený počet kontaktov na synchronizáciu (30000 kontaktov organizácie alebo 30000 skupinových spoločných kontaktov na skupinu), synchronizácia adresárov vylúči položky nad maximálnou prahovou hodnotou. Na synchronizované alebo vynechané kontakty sa nevzťahuje žiadne konkrétne poradie.

• Ak jeden z vašich zákazníkov prekročí maximálny povolený počet kontaktov v ktorejkoľvek kategórii, odporúčame vám obrátiť sa na spoločnosť Cisco a vylúčiť túto organizáciu zo synchronizácie adresárov.

• Manuálne kontakty sú kontakty, ktoré používateľ pridá manuálne do aplikácie Webex. Používateľ môže pridať až 500 manuálnych kontaktov. Manuálne kontakty patria do väčšej kategórie kontaktov používateľa na Webexe, ale nie sú zahrnuté do synchronizácie.

• Celkový kombinovaný limit pre kontakty organizácie (30000) a kontakty skupiny (30000 na skupinu) je 200000.

Aktualizácie

Nasleduje spôsob, akým adresár Webex spracováva aktualizácie:

• Ak sa meno kontaktu v BroadWorks zmení, existujúci kontakt sa odstráni z adresára Webex a vytvorí sa nový kontakt.

• Ak sa kontaktné číslo v BroadWorks zmení, Webex aktualizuje existujúci kontakt v adresári Webex novým číslom.

Keď správca aktualizuje kontakt na BroadWorks, nasledujúce podmienky načrtnú, keď sa aktualizácia zobrazí v aplikácii Webex používateľa:

• Ak ide o aktualizáciu pre volajúceho používateľa iba BroadWorks alebo volajúcu entitu, ktorá nie je používateľom, aktualizácia sa zobrazí v aplikácii Webex používateľa bezprostredne po následnej synchronizácii adresárov.

• Ak ide o aktualizáciu položky telefónneho zoznamu BroadWorks:

  • Pre kontakty používateľov – aktualizácie sa zobrazia v aplikácii Webex používateľa bezprostredne po následnej synchronizácii adresárov.

  • Pre skupinové kontakty - Aktualizácie sa zobrazia v aplikácii Webex používateľov bezprostredne po následnej synchronizácii adresárov.

  • Pre kontakty organizácie – adresár Webex sa aktualizuje pri následnej synchronizácii adresára, ale používatelia neuvidia zmenu v aplikácii Webex, kým nereštartujú aplikáciu Webex alebo kým neuplynie platnosť miestneho 72-hodinového časovača vyrovnávacej pamäte.

Odporúčame vám použiť nasledujúce nastavenia:

• Hodnoty obmedzenia rýchlosti – nastavte nasledujúce vlastnosti systému OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit – Nastavte hodnotu null.

  • globalDirectoryTransactionLimit – nastavená na hodnotu null.

  Odporúča sa nastaviť userDirectoryTransactionLimit a globalDirectoryTransactionLimit na hodnotu null. Ak sa však rozhodnete priradiť hodnoty, každá z nich musí byť nastavená aspoň na päťnásobok hodnoty transactionLimitPeriodSeconds (ktorá by mala byť 1).

• Limity transakcií – nastavte nasledujúce hodnoty (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • userTransactionLimit – nastavte aspoň na 100.

  • transactionLimitPeriodSecs – nastavené na hodnotu 1.

• Hodnoty stránkovania – nastavte vlastnosti stránkovacieho systému (XSP_CLI/Applications/Xsi-Actions/Paging):

  • defaultPageSize – nastavte na 50

  • availableUserMaxLimit – nastavené na 100

• Rozhranie CTI – Nezabudnite nahrať certifikáty certifikačnej autority Webex do úložiska dôveryhodnosti rozhrania CTI a povoliť overenie klienta v rozhraní CTI.

Okrem toho, v závislosti od vášho vydania BroadWorks, odporúčame, aby ste pred povolením tejto funkcie použili nasledujúce systémové opravy na nasadenie BroadWorks:

• Pre R22: AP.as.22.0.1123.ap368517

• Pre R23: AP.as.23.0.1075.ap368517

• Pre R24: nie je potrebná žiadna oprava

Správcovia partnerov môžu povoliť synchronizáciu adresárov pre šablónu zákazníka pri vytváraní novej šablóny. Všetky nové organizácie zákazníkov, ktoré budú priradené k tejto šablóne, budú mať povolenú synchronizáciu adresárov. Podrobnosti nájdete v časti "Konfigurácia šablón zákazníkov" v časti Konfigurácia partnerskej organizácie v centre partnerov v Sprievodcovi riešením pre Webex pre Cisco BroadWorks.

Čo robiť ďalej

Uistite sa, že používatelia vedia, že musia aspoň raz kliknúť na kartu Kontakty v aplikácii Webex, aby mohli zapnúť funkciu v aplikácii Webex. Toto je potrebné vykonať iba raz.

Na developer.webex.com sú k dispozícii verejné rozhrania API, ktoré umožňujú správcom partnerov aktualizovať nastavenia synchronizácie adresárov pre organizácie zákazníkov, ktoré spravujú, spustiť okamžitú synchronizáciu alebo získať informácie o stave synchronizácie. Metódy synchronizácie adresárov sú zoskupené v časti BroadWorks Enterprises:

• Zoznam podnikovBroadWorks – pomocou tejto metódy API získate zoznam podnikov daného poskytovateľa služieb a každého podniku id. Musíte zadať spEnterpriseId ako je priradené v poskytovaní.

• Aktualizácia synchronizácie adresárov pre BroadWorks Enterprise– zadajte podnik id na aktualizáciu stavu syc adresára pre daný podnik povolením alebo vypnutím synchronizácie adresárov.

• Spustenie synchronizácie adresárov pre podnik– túto metódu rozhrania API použite, ak chcete spustiť okamžitú synchronizáciu pre daný podnik id. Pre syncStatus, zadajte SYNC_NOW príkaz.

• Získanie stavu synchronizácie adresárov pre podnik– zadajte podnik id a spustite sa, aby ste získali status a trackingId najnovšej synchronizácie. Môžete použiť trackingID na spustenie ďalšej analýzy prostredníctvom nástrojov, ako sú Kibana a Grafana.

Okrem toho môžu správcovia použiť rozhranie API Trigger Directory Sync for a Single User na spustenie synchronizácie adresárov na požiadanie pre jedného používateľa.

Podrobnú dokumentáciu k rozhraniu API nájdete v časti https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Ak si chcete prečítať špecifikáciu API na adrese https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Nasledujúce kódy chýb sa vzťahujú na synchronizáciu adresárov.

Nasledujúca tabuľka obsahuje súhrn aktualizácií tohto článku.