Synchronizacja katalogów zapewnia, że użytkownicy Webex dla Cisco BroadWorks mogą korzystać z katalogu Webex z aplikacji Webex do wywoływania dowolnej jednostki wywołującej z serwera BroadWorks. Ta funkcja synchronizuje informacje wywołujące BroadWorks, które nie były częścią udostępniania użytkownika z katalogiem Webex.

Webex dla użytkowników Cisco BroadWorks aktualizuje katalog Webex z danymi połączeń dla Webex dla użytkowników Cisco BroadWorks (podstawowy numer telefonu, numer telefonu komórkowego, rozszerzenie), ale pomija rekordy połączeń zewnętrznych. Jednakże, gdy synchronizacja katalogów jest włączona, funkcja synchronizuje również następujące rekordy wywołań z katalogiem Webex.

• Użytkownicy dzwoniący tylko w Broadworks (którzy nie są włączeni do Webex)

• Podmioty dzwoniące niebędące użytkownikami (np. telefon sali konferencyjnej, faks, numer grupy polowania)

• Wpisy listy telefonów BroadWorks

Poniższa tabela podsumowuje rekordy wywołań BroadWorks i pokazuje, w jaki sposób są dodawane do katalogu Webex.

Warunki synchronizacji katalogów

• Administratorzy partnerów muszą włączyć tę funkcję na poziomie partnera. Administratorzy partnerów mogą włączać lub wyłączyć tę funkcję dla wielu organizacji klientów w ramach jednej operacji.

• Domyślnie początkowa synchronizacja następuje tydzień po włączeniu synchronizacji (czas wybrany na rozpoczęcie synchronizacji jest losowy). Jednak organizacje klientów mogą skorzystać z opcji Synchronizuj teraz, aby ominąć tygodniowy okres oczekiwania i uruchomić natychmiastową synchronizację dla danej organizacji klienta.

• Domyślnie synchronizacja katalogów jest uruchamiana co tydzień dla każdego klienta. Każda synchronizacja następuje tydzień po ostatniej synchronizacji, niezależnie od tego, czy ostatnia synchronizacja została zaplanowana, czy uruchomiona ręcznie za pomocą Synchronizuj teraz.

• Maksymalna liczba synchronizacji jednoczesnych na klaster BroadWorks to dwie: jedna synchronizacja zaplanowana i jedna synchronizacja na żądanie (za pośrednictwem interfejsu API lub interfejsu użytkownika Partner Hub). Jednak administratorzy nie mogą jednocześnie uruchamiać dwóch synchronizacji na żądanie z tego samego BroadWorks. Ograniczenie to istnieje niezależnie od tego, czy synchronizacja została zainicjowana za pośrednictwem interfejsu API, czy za pomocą opcji Synchronizuj teraz w centrum partnerskim. Ponadto Webex nie zaplanuje dwóch zaplanowanych synchronizacji w tym samym czasie z tego samego BroadWorks.

• Jeśli wystąpi błąd synchronizacji, Webex ponownie próbuje synchronizować automatycznie co 24 godziny aż do następnej zaplanowanej synchronizacji.

• Synchronizacja ignoruje użytkowników, którzy nie mają numeru telefonu.

• W Centrum partnerskim można wyświetlić informacje o stanie synchronizacji dla danego klienta. Ponadto można wyeksportować szczegółowe informacje na temat ostatniej synchronizacji do rekordu CSV. Rekord CSV zawiera więcej szczegółów niż wyświetlacz Control Hub i może pomóc w rozwiązywaniu problemów, analizie i audycie.

• Webex przechowuje kontakty użytkowników w zaszyfrowanym formacie. Tylko użytkownik, który jest właścicielem kontaktu, ma dostęp do klucza deszyfrowania.

• W przypadku użytkowników dzwoniących tylko w Broadworks i podmiotów dzwoniących poza użytkownikami ta funkcja synchronizuje następujące typy numerów telefonów z BroadWorks:

  • Podstawowy numer telefonu

  • Numer telefonu komórkowego

  • Przedłużenie

  Jednak synchronizacja wyklucza z synchronizacji użytkowników dzwoniących tylko w programie Broadworks i podmioty dzwoniące niebędące użytkownikami, jeśli nie ma żadnego podstawowego numeru telefonu ani rozszerzenia.

  Ustawienie usługi prywatności na poziomie użytkownika BroadWorks nie jest obsługiwane w ramach synchronizacji katalogów.

Lista telefonów BroadWorks i maksimum kontaktów

Synchronizacja katalogów synchronizuje również wpisy listy telefonów BroadWorks z kontaktami Webex. Zsynchronizowane wpisy są dodawane do jednego z następujących typów kontaktów:

• Kontakty organizacji — Webex przechowuje te kontakty w organizacji. Każdy użytkownik może uzyskać dostęp do kontaktów organizacji dla swojej organizacji. Maksymalna liczba kontaktów wynosi do 30000.

• Kontakty użytkownika — Webex przechowuje te kontakty przeciwko użytkownikowi. Tylko użytkownik, który jest właścicielem kontaktu, może uzyskać dostęp do wpisu kontaktu. Maksymalna liczba styków wynosi do 2000 (1500 zsynchronizowanych kontaktów + 500 kontaktów ręcznego wprowadzania).

Poniższa tabela przedstawia typy kontaktów Webex ze źródłem kontaktów (zsynchronizowane z listy telefonów BroadWorks lub dodane ręcznie):

Następujące warunki dotyczą sposobu, w jaki Directory Sync obsługuje maksymalną liczbę kontaktów:

• Jeśli organizacja przekroczy maksymalną dozwoloną liczbę kontaktów do synchronizacji (30000 kontaktów organizacji lub 30000 wspólnych kontaktów grupowych na grupę), synchronizacja katalogów wyklucza wpisy powyżej maksymalnego progu. Nie ma określonej kolejności stosowanej do zsynchronizowanych lub pominiętych kontaktów.

• Jeśli jeden z Twoich klientów przekroczy maksymalną dozwoloną liczbę kontaktów w którejkolwiek z kategorii, zalecamy wniesienie sprawy do Cisco w celu wykluczenia tej organizacji z synchronizacji katalogów.

• Kontakty ręczne to kontakty, które użytkownik dodaje ręcznie w aplikacji Webex. Użytkownik może dodać do 500 kontaktów ręcznych. Kontakty ręczne należą do większej kategorii kontaktów użytkownika na Webex, ale nie są uwzględnione w synchronizacji.

• Całkowity łączny limit kontaktów organizacyjnych (30000) i kontaktów grupowych (30000 na grupę) wynosi 200000.

Aktualizacje

Poniżej przedstawiono sposób, w jaki katalog Webex obsługuje aktualizacje:

• Jeśli nazwa kontaktu zmieni się w BroadWorks, istniejący kontakt zostanie usunięty z katalogu Webex i zostanie utworzony nowy kontakt.

• Jeśli numer kontaktowy ulegnie zmianie w BroadWorks, Webex aktualizuje istniejący kontakt w katalogu Webex o nowy numer.

Po tym, jak administrator zaktualizuje kontakt w BroadWorks, następujące warunki przedstawiają, kiedy aktualizacja zostanie wyświetlona w aplikacji Webex użytkownika:

• Jeśli aktualizacja dotyczy użytkownika dzwoniącego tylko w programie Broadworks lub podmiotu dzwoniącego poza użytkownikiem, aktualizacja zostanie wyświetlona w aplikacji Webex użytkownika natychmiast po późniejszej synchronizacji katalogów.

• Jeśli aktualizacja dotyczy pozycji listy telefonów BroadWorks:

  • W przypadku kontaktów użytkownika — aktualizacje są wyświetlane w aplikacji Webex użytkownika natychmiast po kolejnej synchronizacji katalogów.

  • W przypadku kontaktów grupowych — Aktualizacje są wyświetlane w aplikacji Webex użytkowników natychmiast po kolejnej synchronizacji katalogów.

  • W przypadku kontaktów organizacji — katalog Webex jest aktualizowany podczas kolejnej synchronizacji katalogów, ale użytkownicy nie zobaczą zmiany w aplikacji Webex, dopóki nie zrestartują aplikacji Webex lub do czasu wygaśnięcia lokalnego 72-godzinnego czasu pamięci podręcznej.

Zalecamy użycie następujących ustawień:

• Wartości ograniczające szybkość — Ustaw następujące właściwości systemu OverloadControl (XSP_CLI/Applications/XSI-Actions/OverloadControl):

  • UserDirectoryTransactionLimit — ustawiona na wartość null.

  • GlobalDirectoryTransactionLimit — ustawiona na wartość null.

  Zaleca się ustawienie UserDirectoryTransactionLimit i GlobalDirectoryTransactionLimit na wartość null. Jeśli jednak zdecydujesz się przypisać wartości, każda z nich musi być ustawiona na co najmniej pięciokrotność wartości TransactionLimitPeriodSeconds (która powinna wynosić 1).

• Limity transakcji — Ustaw następujące wartości (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • UserTransactionLimit — ustawiony na co najmniej 100.

  • TransactionLimitPeriodSecs — ustawienie na 1.

• Wartości stronicowania — Ustaw właściwości systemu stronicowania (XSP_CLI/Applications/XSI-Actions/Paging):

  • DefaultPageSize — ustawienie na 50

  • AvailableUserMaxLimit—ustawienie na 100

• Interfejs CTI — Pamiętaj, aby przesłać te certyfikaty Webex CA do magazynu zaufania interfejsu CTI i włączyć uwierzytelnianie klienta w interfejsie CTI.

Ponadto, w zależności od wydania programu BroadWorks, zalecamy zastosowanie następujących poprawek systemowych do wdrożenia BroadWorks przed włączeniem tej funkcji:

• Dla R22: AP.AS.22.0.1123.AP368517

• Dla R23: AP.AS.23.0.1075.AP368517

• Dla R24: nie jest wymagana łatka

Administratorzy partnerów mogą włączyć synchronizację katalogów dla szablonu klienta podczas tworzenia nowego szablonu. Wszelkie nowe organizacje klientów, które zostaną przypisane do tego szablonu, będą miały włączoną synchronizację katalogów. Aby uzyskać szczegółowe informacje, zobacz „Konfigurowanie szablonów wdrażania” w sekcji Konfigurowanie organizacji partnerskiej w centrum partner skim w przewodniku po rozwiązaniach dla Webex dla Cisco BroadWorks.

Co robić dalej

Upewnij się, że użytkownicy wiedzą, że muszą przynajmniej raz kliknąć kartę Kontakty w aplikacji Webex, aby włączyć funkcję w aplikacji Webex. Trzeba to zakończyć tylko raz.

Publiczne interfejsy API są dostępne na stronie developer.webex.com, które umożliwiają administratorom partnerów aktualizowanie ustawień synchronizacji katalogów dla zarządzanych przez nich organizacji klientów, w celu uruchomienia natychmiastowej synchronizacji lub uzyskania informacji o stanie synchronizacji. Metody synchronizacji katalogów są zgrupowane w kategorii BroadWorks Enterprises:

• Lista przedsiębiorstw BroadWorks — Użyj tej metody API, aby uzyskać listę przedsiębiorstw pod danym usługodawcą i identyfikator każdego przedsiębiorstwa. Należy wprowadzić spEnterpriseID jako przypisany w udostępnianiu.

• Aktualizacja synchronizacji katalogów dla przedsiębiorstwa BroadWor ks — wprowadź identyfikator przedsiębiorstwa, aby zaktualizować stan syc katalogu dla danego przedsiębiorstwa, włączając lub wyłączając synchronizację katalogów.

• Wyzwalanie synchronizacji katalogów dla przedsiębiorstwa — Użyj tej metody API, jeśli chcesz wywołać natychmiastową synchronizację dla danego identyfik atora przedsiębiorstwa. W przypadku funkcji SyncStatus wprowadź polec enie SYN C_NOW.

• Uzyskaj status synchronizacji katalogów dla przedsiębiorstwa — wprowadź identyfikator przedsiębiorstwa i uruchom, aby uzyskać status i identyfikator śledzenia najnowszej synchron izacji. Możesz użyć TrackingID do uruchamiania dodatkowych analiz za pomocą narzędzi takich jak Kibana i Grafana.

Ponadto administratorzy mogą użyć interfejsu API Trigger Directory Sync dla jednego użytkownika, aby uruchomić synchronizację katalogów na żądanie dla jednego użytkownika.

Szczegółowa dokumentacja interfejsu API znajduje się na stronie https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Musisz się zalogować, aby przeczytać specyfikację API pod adresem https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Następujące kody błędów mają zastosowanie do synchronizacji katalogów.

Poniższa tabela podsumowuje aktualizacje tego artykułu.