Synchronizácia adresárov zabezpečuje, že používatelia Webex pre Cisco BroadWorks môžu používať 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 údajmi o hovoroch pre Webex pre používateľov Cisco BroadWorks (primárne telefónne číslo, číslo mobilného telefónu, rozšírenie), ale vynecháva záznamy o externých hovoroch. Ak je však synchronizácia adresárov zapnutá, funkcia tiež synchronizuje nasledujúce volacie záznamy s adresárom Webex.

• Používatelia volajúci iba na Broadworks (ktorí nie sú zapojení do Webexu)

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

• Záznamy o zozname telefónov BroadWorks

Nasledujúca tabuľka sumarizuje záznamy hovorov 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 viaceré zákaznícke organizácie v jednej operácii.

• V predvolenom nastavení sa počiatočná synchronizácia uskutoční týždeň po povolení synchronizácie (čas zvolený na spustenie synchronizácie je náhodný). Zákaznícke organizácie však môžu pomocou možnosti Synchronizovať teraz obísť týždňovú čakaciu dobu a spustiť okamžitú synchronizáciu pre danú zákaznícku organizáciu.

• V predvolenom nastavení sa synchronizácia adresárov beží 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 Sync Now.

• Maximálny počet simultánnych synchronizácií na klaster BroadWorks je dva: jedna naplánovaná synchronizácia a jedna synchronizácia na požiadanie (prostredníctvom rozhrania API alebo partnerského rozhrania GUI). Administrátori však nemôžu spustiť dve synchronizácie na požiadanie súčasne z toho istého BroadWorks. Toto obmedzenie existuje bez ohľadu na to, či bola synchronizácia spustená prostredníctvom rozhrania API alebo prostredníctvom možnosti Synchronizovať teraz v Partner Hub. Webex navyše nebude naplánovať dve naplánované synchronizácie súčasne z rovnakého BroadWorks.

• Ak dôjde k zlyhaniu synchronizácie, Webex sa o synchronizáciu pokúsi automaticky 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 Partner Hub 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 záznamu CSV. Záznam CSV poskytuje viac podrobností ako displej Control Hub a môže pomôcť pri riešení problémov, analýze a auditu.

• Webex ukladá kontakty používateľov v šifrovanom formáte. K dešifrovacému kľúču má prístup iba používateľ, ktorý vlastní kontakt.

• Pre volajúcich používateľov iba v programe Broadworks a subjekty, ktoré nie sú volajúcimi používateľmi, táto funkcia synchronizuje nasledujúce typy telefónnych čísel z BroadWorks:

  • Hlavné telefónne číslo

  • Číslo mobilného telefónu

  • Rozšírenie

  Synchronizácia však vylučuje zo synchronizácie používateľov volajúcich iba v programe Broadworks a osoby, ktoré nie sú volajúcimi používateľmi, ak nie je k dispozícii žiadne primárne telefónne číslo alebo rozšírenie.

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

Telefónny zoznam BroadWorks a maximá kontaktov

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

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

• Kontakty používateľa — Webex ukladá tieto kontakty proti používateľovi. K záznamu kontaktu má prístup iba používateľ, ktorý vlastní kontakt. Maximálne je až 2000 kontaktov (1500 synchronizovaných kontaktov + 500 kontaktov s manuálnym zadaním).

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

Nasledujúce podmienky platia pre spôsob, akým Directory Sync spracováva maximálne hodnoty kontaktov:

• Ak organizácia prekročí maximálnu povolenú hodnotu kontaktov pre synchronizáciu (30000 kontaktov organizácie alebo 30000 skupinových skupinových kontaktov na skupinu), synchronizácia adresárov vylučuje položky nad maximálnu prahovú hodnotu. Na synchronizované alebo vynechané kontakty sa nevzťahuje žiadne konkrétne poradie.

• Ak niektorý z vašich zákazníkov prekročí maximálny povolený počet kontaktov v ktorejkoľvek kategórii, odporúčame vám, aby ste v spoločnosti Cisco požiadali o vylúčenie tejto organizácie zo synchronizácie adresárov.

• Manuálne kontakty sú kontakty, ktoré používateľ pridáva 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 Používateľských kontaktov na webexe, ale nie sú zahrnuté v synchronizácii.

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

Aktualizácie

Ďalej uvádzame, ako adresár Webex spracováva aktualizácie:

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

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

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

• Ak sa aktualizácia týka volajúceho používateľa iba pre Broadworks alebo nevolajúcu entitu, aktualizácia sa zobrazí v aplikácii Webex používateľa ihneď po následnej synchronizácii adresárov.

• Ak sa aktualizácia týka položky zoznamu telefónov BroadWorks:

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

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

  • Pre kontakty organizácie — Adresár Webex sa aktualizuje pri nasledujúcej synchronizácii adresárov, ale používatelia sa nezobrazia zmena v aplikácii Webex, kým nereštartujú aplikáciu Webex alebo kým nevyprší miestny časovač vyrovnávacej pamäte 72 hodín.

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

• Hodnoty obmedzujúce rýchlosť — nastavte nasledujúce vlastnosti systému OverloadControl (XSP_CLI/Applications/XSI-actions/OverloadControl):

  • UserDirectoryTransactionLimit—nastavená na nulovú hodnotu.

  • GlobalDirectoryTransactionLimit—nastavená na nulovú hodnotu.

  Odporúča sa nastaviť hodnotu UserDirectoryTransactionLimit a GlobalDirectoryTransactionLimit na nulovú hodnotu. Ak sa však rozhodnete priradiť hodnoty, každá z nich musí byť nastavená na najmenej päťnásobok hodnoty TransactionLimitPeriodSeconds (ktorá by mala byť 1).

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

  • UserTransactionLimit — nastavená na najmenej 100.

  • TransactionLimitPeriodSecs — nastavená na 1.

• Hodnoty stránkovania — Nastavte vlastnosti systému stránkovania (XSP_CLI/Applications/XSI-Actions/Paging):

  • DefaultPageSize — nastavená na 50

  • AvailableUserMaxLimit—nastavená na 100

• Rozhranie CTI — Uistite sa, že ste tieto certifikáty Webex CA nahrali do dôveryhodného úložiska rozhrania CTI a povoľte autentifikáciu klienta na 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: nevyžaduje sa žiadna náplasť

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

Čo robiť ďalej

Uistite sa, že vaši 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é dokončiť len raz.

Verejné rozhrania API sú k dispozícii na stránke developer.webex.com, ktoré umožňujú správcom partnerov aktualizovať nastavenia synchronizácie adresárov pre zákaznícke organizácie, 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 podnikov BroadWor ks — Pomocou tejto metódy API získate zoznam podnikov pod daným poskytovateľom služieb a ID každého podniku. SpEnterpriseID musíte zadať tak, ako je priradený v poskytovaní.

• Aktualizácia synchronizácie adresárov pre program BroadWorks Enterprise — Zadajte identifik átor podniku, aby ste aktualizovali stav adresára syc pre daný podnik, čím zapnete alebo vypnete synchronizáciu adresárov.

• Spúšťať synchronizáciu adresárov pre pod nik — Túto metódu rozhrania API použite, ak chcete spustiť okamžitú synchronizáciu pre dané ID podniku. Pre SyncStatus zadajte príkaz SYN C_NOW.

• Získajte stav synchronizácie adresárov pre podnik — Zadajte identifik átor podniku a spustite, aby ste získali stav a sledovaniaID najnovšej synchronizácie. TrackInGid môžete použiť na spustenie ďalších analýz pomocou nástrojov, ako sú Kibana a Grafana.

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

Podrobnú dokumentáciu API nájdete na stránke https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

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

Nasledujúce chybové kódy sa vzťahujú na synchronizáciu adresárov.

Nasledujúca tabuľka sumarizuje aktualizácie tohto článku.