Синхронизация каталогов позволяет пользователям Webex для Cisco BroadWorks использовать каталог Webex из приложения Webex для вызова любого вызывающего объекта с сервера BroadWorks. Эта функция синхронизирует информацию о вызовах BroadWorks, которая не была частью подготовки пользователей, с каталогом Webex.

Webex для подготовки пользователей Cisco BroadWorks обновляет каталог Webex, добавляя сведения о вызовах пользователей Webex для пользователей Cisco BroadWorks (основной номер телефона, номер мобильного телефона, добавочный номер), но исключает записи внешних вызовов. Однако если включена синхронизация каталогов, эта функция также синхронизирует следующие записи вызовов с каталогом Webex.

• Пользователи, которые звонят только в Broadworks (которые не подключены к Webex)

• Звонящие лица, не являющиеся пользователями (например, телефон конференц-зала, факс, номер охотничьей группы)

• Записи в списке телефонов BroadWorks

В следующей таблице приведены записи вызовов BroadWorks и показано, как их добавить в каталог Webex.

Условия синхронизации каталогов

• Администраторы партнеров должны включить эту функцию на уровне партнера. Администраторы партнеров могут включить или выключить эту функцию для нескольких организаций-клиентов за одну операцию.

• По умолчанию первоначальная синхронизация происходит через неделю после включения синхронизации (время начала синхронизации выбрано случайное). Однако организации-заказчики могут использовать опцию Sync Now, чтобы обойти недельный период ожидания и запустить немедленную синхронизацию для данной клиентской организации.

• По умолчанию синхронизация каталогов выполняется еженедельно для каждого клиента. Каждая синхронизация происходит через неделю после последней синхронизации, независимо от того, была ли последняя синхронизация запланирована или запущена вручную с помощью Sync Now.

• Максимальное количество одновременных синхронизаций на кластер BroadWorks равно двум: одна синхронизация по расписанию и одна синхронизация по запросу (через API или графический интерфейс Partner Hub). Однако администраторы не могут одновременно выполнять две синхронизации по запросу из одного и того же BroadWorks. Это ограничение действует независимо от того, была ли синхронизация инициирована через API или с помощью опции Sync Now в Partner Hub. Кроме того, Webex не планирует одновременное выполнение двух запланированных синхронизаций из одного и того же BroadWorks.

• В случае сбоя синхронизации Webex автоматически повторяет синхронизацию каждые 24 часа до следующей запланированной синхронизации.

• При синхронизации игнорируются пользователи, у которых нет номера телефона.

• В Partner Hub вы можете просмотреть информацию о статусе синхронизации для данного клиента. Кроме того, вы можете экспортировать подробную информацию о последней синхронизации в запись CSV. Запись CSV содержит более подробную информацию, чем на дисплее Control Hub, и может помочь в устранении неполадок, анализе и аудите.

• Webex хранит контакты пользователей в зашифрованном формате. Только пользователь, владеющий контактом, имеет доступ к ключу дешифрования.

• Для пользователей, которые звонят только в Broadworks, и для лиц, не являющихся пользователями, эта функция синхронизирует следующие типы телефонных номеров с BroadWorks:

  • Основной номер телефона

  • Номер мобильного телефона

  • Дополнительный номер

  Однако при отсутствии основного телефонного номера или добавочного номера синхронизация исключает из синхронизации только звонящих пользователей Broadworks и лиц, не являющихся пользователями.

  Настройка службы конфиденциальности BroadWorks на уровне пользователя не поддерживается при синхронизации каталогов.

Список телефонов BroadWorks и максимальное количество контактов

Синхронизация каталогов также синхронизирует записи списка телефонов BroadWorks с контактами Webex. Синхронизированные записи добавляются к одному из следующих типов контактов:

• Контакты организации — Webex сохраняет эти контакты в организации. Каждый пользователь может получить доступ к контактам своей организации. Максимальное количество контактов — до 30000.

• Контакты пользователей — Webex сохраняет эти контакты вместе с пользователем. Только пользователь, владеющий контактом, может получить доступ к записи о контакте. Максимальное количество контактов — до 2000 (1500 синхронизированных контактов + 500 контактов, вводимых вручную).

В следующей таблице сопоставлены типы контактов Webex с источником контактов (синхронизированными из списка телефонов BroadWorks или добавленными вручную):

При обработке максимального количества контактов Directory Sync действуют следующие условия:

• Если организация превышает максимально допустимое количество контактов для синхронизации (30 000 контактов организации или 30 000 общих контактов в группе), синхронизация каталогов исключает записи, превышающие максимальное пороговое значение. К синхронизированным или пропущенным контактам не применяется особый порядок.

• Если один из ваших клиентов превышает максимально допустимое количество контактов в любой из категорий, мы рекомендуем обратиться в Cisco за исключением этой организации из синхронизации каталогов.

• Контакты, выполняемые вручную, — это контакты, добавленные пользователем вручную в приложение Webex. Пользователь может добавить до 500 контактов вручную. Контакты, выполняемые вручную, относятся к более широкой категории контактов пользователей в Webex, но не включены в синхронизацию.

• Общее суммарное ограничение для контактов организации (30000) и групповых контактов (30000 на группу) составляет 200000.

Обновления

Ниже описано, как каталог Webex обрабатывает обновления:

• При изменении имени контакта в BroadWorks существующий контакт удаляется из каталога Webex и создается новый контакт.

• Если номер контакта меняется в BroadWorks, Webex обновляет существующий контакт в каталоге Webex новым номером.

После обновления администратором контакта в BroadWorks при отображении обновления в приложении Webex пользователя действуют следующие условия:

• Если обновление предназначено для вызывающего только Broadworks пользователя или объекта, не являющегося пользователем, обновление отображается в приложении Webex пользователя сразу после последующей синхронизации каталога.

• Если обновление касается записи в списке телефонов BroadWorks, выполните следующие действия:

  • Для контактов пользователей — обновления отображаются в приложении Webex пользователя сразу после последующей синхронизации каталогов.

  • Для групповых контактов — обновления отображаются в приложении Webex пользователей сразу после последующей синхронизации каталогов.

  • Для контактов в организации: каталог Webex обновляется при последующей синхронизации каталогов, но пользователи не увидят изменений в приложении Webex, пока не перезапустят приложение Webex или не истечет таймер локального кэширования на 72 часа.

Мы рекомендуем использовать следующие настройки:

• Значения ограничения скорости — задайте следующие свойства системы OverloadControl (xSP_CLI/Приложения/XSI-действия/OverloadControl):

  • UserDirectoryTransactionLimit — задано нулевое значение.

  • Ограничение транзакций в глобальном каталоге — установлено нулевое значение.

  Рекомендуется присвоить UserDirectoryTransactionLimit и globalDirectoryTransactionLimit нулевое значение. Однако если вы все же решите присвоить значения, каждое из них должно быть не менее чем в пять раз больше значения TransactionLimitPeriodSeconds (которое должно быть равно 1).

• Лимиты транзакций — задайте следующие значения (xsp_cli/system/CommunicationUtility/DefaultSettings):

  • Лимит транзакций пользователей — задайте не менее 100.

  • Период ограничения транзакций в секундах — равен 1.

• Значения пейджинга — задайте свойства пейджинговой системы (xsp_cli/приложения/XSI-действия/пейджинг):

  • Размер страницы по умолчанию — равен 50

  • Максимальное количество доступных пользователей — 100

• Интерфейс CTI. Обязательно загрузите сертификаты Webex CA в доверенное хранилище интерфейса CTI и включите аутентификацию клиентов в интерфейсе CTI.

Кроме того, в зависимости от версии BroadWorks мы рекомендуем перед включением этой функции применить следующие системные исправления к развертыванию BroadWorks:

• Для версии R22: AP.AS.22.0.1123.ap368517

• Для документа R23: документ AS.23.0.1075.AP368517

• Для R24: патч не требуется

Администраторы партнеров могут включить Directory Sync для шаблона клиента при создании нового шаблона. Для любых новых организаций-клиентов, которым будет назначен этот шаблон, будет включена синхронизация каталогов. Дополнительные сведения см. в разделе «Настройка шаблонов адаптации» раздела Настройка партнерской организации в Центре партнеров руководства по решению Webex для Cisco BroadWorks.

Что делать дальше

Убедитесь, что пользователи знают, что для включения этой функции в приложении Webex им необходимо хотя бы один раз перейти на вкладку Контакты. Это нужно сделать только один раз.

На сайте developer.webex.com доступны общедоступные API, позволяющие администраторам-партнерам обновлять настройки Directory Sync для управляемых ими организаций-клиентов, запускать немедленную синхронизацию или получать информацию о статусе синхронизации. Методы синхронизации каталогов сгруппированы в разделе BroadWorks Enterprises:

• Список предприятий BroadWorks — используйте этот метод API для получения списка предприятий, принадлежащих данному поставщику услуг, и идентификатора каждого предприятия. Необходимо ввести идентификатор SPEnterpriseID, назначенный при выделении ресурсов.

• Обновить синхронизацию каталогов для BroadWorks Enterprise — введите идентификатор предприятия, чтобы обновить статус синхронизации каталогов на этом предприятии, включив или отключив синхронизацию каталогов.

• Запустите синхронизацию каталогов для предприятия — используйте этот метод API, если хотите запустить немедленную синхронизацию данного идентификатора предприятия. В поле SyncStatus введите команду SYNC_NOW.

• Получите статус синхронизации каталогов для предприятия — введите идентификатор предприятия и запустите его, чтобы получить статус и идентификатор отслеживания последней синхронизации. TrackingID можно использовать для проведения дополнительной аналитики с помощью таких инструментов, как Kibana и Grafana.

Кроме того, администраторы могут использовать API Trigger Directory Sync для одного пользователя, чтобы запустить синхронизацию каталогов по запросу для одного пользователя.

Подробную документацию по API см. на сайте https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Чтобы ознакомиться со спецификацией API, вам необходимо войти в систему по адресу https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Следующие коды ошибок относятся к синхронизации каталогов.

В следующей таблице перечислены обновления этой статьи.