Synchronizace adresáře v aplikaci Webex pro Cisco BroadWorks

Synchronizace adresáře zajišťuje, že uživatelé Webexu pro Cisco Broadworks mohou používat adresář Webex z aplikace Webex k volání jakékoli volající entity ze serveru Broadworks. Tato funkce synchronizuje informace o volání služby Broadworks, které nebyly součástí zřizování uživatelů do adresáře služby Webex.

Zřizování uživatelů Webex pro Cisco Broadworks aktualizuje adresář Webex s podrobnostmi o volání pro uživatele Webex pro Cisco Broadworks (primární telefonní číslo, číslo mobilního telefonu, linka), ale vynechá externí záznamy volání. Když je však synchronizace adresáře zapnutá, funkce také synchronizuje následující záznamy volání do adresáře Webex.

• Uživatelé používající pouze službu Broadworks (kteří nejsou registrováni ke službě Webex)

• Entity, které nepoužívají hovory (např. telefon v konferenční místnosti, fax, číslo skupiny sdružených linek)

• Položky telefonního seznamu Broadworks

Následující tabulka shrnuje záznamy volání služby Broadworks a ukazuje, jak jsou přidány do adresáře služby Webex.

Podmínky synchronizace adresáře

• Správci partnerů musí funkci povolit na úrovni partnera. Správci partnerů mohou funkci zapnout nebo vypnout pro více organizací zákazníků v jedné operaci.

• Ve výchozím nastavení proběhne první synchronizace jeden týden po povolení synchronizace (čas pro zahájení synchronizace je náhodný). Organizace zákazníků však mohou pomocí možnosti Synchronizovat nyní obejít čekací dobu jednoho týdne a spustit okamžitou synchronizaci pro danou organizaci zákazníků.

• Ve výchozím nastavení se synchronizace adresářů pro každého zákazníka spustí týdně. Ke každé synchronizaci dojde jeden týden po poslední synchronizaci bez ohledu na to, zda byla poslední synchronizace naplánována nebo spuštěna ručně pomocí funkce Sync Now.

• Maximální počet souběžných synchronizací na cluster Broadworks je dva: jednu naplánovanou synchronizaci a jednu synchronizaci na vyžádání (přes rozhraní API nebo GUI centra Partner Hub). Správci však nemohou spustit dvě synchronizace na vyžádání současně ze stejné služby Broadworks. Toto omezení existuje bez ohledu na to, zda byla synchronizace zahájena prostřednictvím rozhraní API nebo prostřednictvím možnosti Synchronizovat nyní v partnerském centru. Kromě toho služba Webex nenaplánuje dvě naplánované synchronizace, které budou spuštěny současně ze stejné služby Broadworks.

• Pokud dojde k selhání synchronizace, aplikace Webex se synchronizaci automaticky opakuje každých 24 hodin až do další plánované synchronizace.

• Synchronizace ignoruje uživatele, kteří nemají telefonní číslo.

• V prostředí Partner Hub můžete zobrazit informace o stavu synchronizace daného zákazníka. Kromě toho můžete exportovat podrobné informace o poslední synchronizaci do záznamu CSV. Záznam CSV poskytuje více podrobností než zobrazení prostředí Control Hub a může pomoci při řešení problémů, analýze a auditu.

• Webex ukládá kontakty uživatelů v šifrovaném formátu. K dešifrovacímu klíči má přístup pouze uživatel, který je vlastníkem kontaktu.

• Tato funkce synchronizuje následující typy telefonních čísel ze služby Broadworks pro volající uživatele a nevolající entity služby Broadworks:

  • Primární telefonní číslo

  • Číslo mobilního telefonu

  • Linka

  Synchronizace však vylučuje volající uživatele a entity, které nepoužívají službu Broadworks, ze synchronizace, pokud není přítomno ani primární telefonní číslo nebo linka.

  Nastavení služby ochrany osobních údajů na úrovni uživatele služby Broadworks není podporováno jako součást synchronizace adresářů.

Telefonní seznam a maximální počet kontaktů pro Broadworks

Synchronizace adresáře také synchronizuje položky telefonního seznamu Broadworks s kontakty Webex. Synchronizované záznamy se přidají k jednomu z následujících typů kontaktů:

• Kontakty organizace – Webex ukládá tyto kontakty proti organizaci. Každý uživatel má přístup ke kontaktům organizace pro svou organizaci. Maximum je až 30000 kontaktů.

• Kontakty uživatelů – Webex ukládá tyto kontakty proti uživateli. K položce kontaktu má přístup pouze uživatel, který kontakt vlastní. Maximum je až 2000 kontaktů (1500 synchronizovaných kontaktů + 500 kontaktů ručního zadávání).

Následující tabulka mapuje typy kontaktů Webex proti zdroji kontaktu (synchronizováno ze seznamu telefonů Broadworks nebo přidáno ručně):

Následující podmínky platí pro způsob, jakým synchronizace adresářů zpracovává maxima kontaktů:

• Pokud organizace překročí maximální povolené kontakty pro synchronizaci (30000 kontaktů organizace nebo 30000 společných kontaktů skupiny pro skupinu), synchronizace adresářů vylučuje položky nad maximální prahovou hodnotou. Na synchronizované nebo vynechané kontakty není použita žádná konkrétní objednávka.

• Pokud některý z vašich zákazníků překročí maximální povolený počet kontaktů v jedné z kategorií, doporučujeme, abyste se společností Cisco obrátili na případ, aby byla tato organizace vyloučena ze synchronizace adresářů.

• Ruční kontakty jsou kontakty, které uživatel ručně přidá do aplikace Webex. Uživatel může přidat až 500 ručních kontaktů. Ruční kontakty spadají do větší kategorie kontaktů uživatelů v aplikaci Webex, ale nejsou zahrnuty do synchronizace.

• Celkový kombinovaný limit pro kontakty organizace (30000) a skupinové kontakty (30000 na skupinu) je 200000.

Aktualizace

Adresář Webex zpracovává aktualizace takto:

• Pokud se jméno kontaktu změní v aplikaci Broadworks, stávající kontakt se odstraní z adresáře služby Webex a vytvoří se nový kontakt.

• Pokud se číslo kontaktu v aplikaci Broadworks změní, aplikace Webex aktualizuje stávající kontakt v adresáři Webex o nové číslo.

Jakmile správce aktualizuje kontakt v aplikaci Broadworks, následující podmínky popisují, když se aktualizace zobrazí v aplikaci Webex uživatele:

• Pokud je aktualizace určena pouze volajícímu uživateli Broadworks nebo volající entitě, tato aktualizace se zobrazí v aplikaci Webex uživatele ihned po následné synchronizaci adresáře.

• Pokud se jedná o aktualizaci položky telefonního seznamu Broadworks:

  • Pro kontakty uživatelů – aktualizace se zobrazí v aplikaci Webex uživatele ihned po následné synchronizaci adresáře.

  • Pro skupinové kontakty – aktualizace se zobrazí v aplikaci Webex uživatelů ihned po následné synchronizaci adresáře.

  • Kontakty v organizaci – adresář Webex se aktualizuje při následné synchronizaci adresáře, ale uživatelé neuvidí změnu v aplikaci Webex, dokud restartují aplikaci Webex nebo dokud nevyprší místní 72hodinový časovač mezipaměti.

Doporučujeme použít následující nastavení:

• Mezní hodnoty rychlosti – nastavte následující vlastnosti systému Over Control (XSP_CLI/Applications/Xsi-Actions/Over Control):

  • user Limit – nastavte hodnotu null.

  • Limit – nastavte hodnotu null.

  Je doporučeno nastavit user Limit a Limit na hodnotu null. Pokud se však rozhodnete přiřadit hodnoty, každá musí být nastavena na nejméně pětinásobek hodnoty Limit Seconds (která by měla být 1).

• Limity transakcí – nastavte následující hodnoty (XSP_CLI/System/ Utility/ Settings):

  • user Limit – Nastaveno na nejméně 100.

  • Limit Secs – Nastaveno na 1.

• Hodnoty pagingu – nastavte vlastnosti pagingového systému (XSP_CLI/Applications/Xsi-Actions/Paging):

  • Velikost – nastavit na 50

  • UserMaxlimit – nastavit na 100

• Rozhraní CTI – nezapomeňte nahrát certifikáty certifikační autority Webex do úložiště důvěryhodných certifikátů rozhraní CTI a povolit ověřování klienta v rozhraní CTI.

V závislosti na verzi Broadworks navíc doporučujeme před povolením této funkce použít na nasazení Broadworks následující systémové opravy:

• Pro R22: AP.as.22.0.1123.ap368517

• Pro R23: AP.as.23.0.1075.ap368517

• Pro R24: není nutná náplast

Správci partnerů mohou povolit synchronizaci adresáře pro šablonu zákazníka při vytváření nové šablony. Všechny nové organizace zákazníků, které budou přiřazeny k dané šabloně, budou mít povolenou synchronizaci adresáře. Podrobnosti najdete v části „Konfigurace šablon zákazníků“ v části Konfigurace organizace partnera v prostředí Partner Hub v příručce Solution Guide for Webex for Cisco Broadworks.

Co dělat Dále

Ujistěte se, že uživatelé vědí, že musí alespoň jednou kliknout na kartu Kontakty v aplikaci Webex, aby funkci v aplikaci Webex zapnuli. To je třeba dokončit pouze jednou.

Veřejné soubory APIjsou k dispozici na stránkách developer.webex.com, které správcům partnerů umožňují aktualizovat nastavení synchronizace adresářů pro organizace zákazníků, které spravují, spustit okamžitou synchronizaci nebo získat informace o stavu synchronizace. Metody synchronizace adresářů jsou seskupeny do skupiny Broadworks Enterprises:

• Seznam podniků Broadworks – Pomocí této metody rozhraní API získáte seznam podniků v rámci daného poskytovatele služeb a jednotlivých podniků id. Musíte zadat spEnterpriseId jak je přiřazeno při zřizování.

• Aktualizace synchronizace adresáře pro podnik Broadworks – zadejte podnik id aktualizovat stav syc adresáře pro daný podnik tím, že povolíte nebo zakážete synchronizaci adresáře.

• Spustit synchronizaci adresáře pro podnik – tuto metodu rozhraní API použijte, pokud chcete spustit okamžitou synchronizaci pro daný podnik id. V případě syncStatus, zadejte SYNC_NOW příkaz.

• Získání stavu synchronizace adresáře pro podnik – zadejte podnik id a spustit za účelem získání stavu a trackingId nejnovější synchronizace. Můžete použít trackingID provádět další analýzy pomocí nástrojů, jako je Kibana a Grafana.

Kromě toho mohou správci použít funkci Trigger Directory Sync pro rozhraní API pro jednoho uživatele ke spuštění synchronizace adresáře na vyžádání pro jednoho uživatele.

Podrobná dokumentace rozhraní API viz https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Chcete-li si přečíst specifikaci rozhraní API na adrese https://developer.webex.com/docs/api/v1/broadworks-subscribers, musíte se přihlásit.

Následující kódy chyb se vztahují na synchronizaci adresáře.

Následující tabulka shrnuje aktualizace tohoto článku.