Sincronización de directorios en Webex para Cisco BroadWorks

La sincronización de directorios garantiza que los usuarios de Webex para Cisco BroadWorks puedan utilizar el directorio de Webex desde la aplicación de Webex para llamar a cualquier entidad que llame desde el servidor de BroadWorks. Esta característica sincroniza la información de llamadas de BroadWorks que no formaba parte del aprovisionamiento de usuarios al directorio de Webex.

El aprovisionamiento de usuarios de Webex para Cisco BroadWorks actualiza el directorio de Webex con detalles de llamadas para usuarios de Webex para Cisco BroadWorks (número de teléfono principal, número de teléfono móvil, extensión), pero omite los registros de llamadas externas. Sin embargo, cuando la sincronización de directorios está activada, la característica también sincroniza los siguientes registros de llamadas con el directorio de Webex.

• Usuarios de llamadas solo de BroadWorks (que no están incorporados a Webex)

• Entidades que llaman no usuarios (por ejemplo, un teléfono de sala de conferencias, un fax, un número de grupo de búsqueda)

• Entradas de la lista de teléfonos de BroadWorks

La siguiente tabla resume los registros de llamadas de BroadWorks y muestra cómo se agregan al directorio de Webex.

Condiciones de sincronización de directorios

• Los administradores de socios deben activar la característica a nivel de socio. Los administradores de socios pueden activar o desactivar la característica para varias organizaciones de clientes en una sola operación.

• De forma predeterminada, la sincronización inicial se produce una semana después de la activación de la sincronización (la hora elegida para iniciar la sincronización es aleatoria). Sin embargo, las organizaciones del cliente pueden utilizar la opción Sincronizar ahora para omitir el período de espera de una semana y activar una sincronización inmediata para una organización del cliente determinada.

• De forma predeterminada, la sincronización de directorios se ejecuta semanalmente para cada cliente. Cada sincronización tiene lugar una semana después de la última sincronización, independientemente de si la última sincronización se planificó o activó manualmente con Sync Now.

• La cantidad máxima de sincronizaciones simultáneas por grupo de BroadWorks es de dos: una sincronización planificada y otra bajo demanda (a través de la API o la GUI de Partner Hub). Sin embargo, los administradores no pueden ejecutar dos sincronizaciones bajo demanda al mismo tiempo desde el mismo BroadWorks. Esta restricción existe independientemente de si la sincronización se inició a través de la API o de la opción Sincronizar ahora en Partner Hub. Además, Webex no planificará dos sincronizaciones planificadas para que se ejecuten al mismo tiempo desde el mismo BroadWorks.

• Si se produce una falla de sincronización, Webex vuelve a intentar la sincronización automáticamente cada 24 horas hasta la siguiente sincronización planificada.

• La sincronización ignora a los usuarios que no tienen un número de teléfono.

• En Partner Hub, puede ver la información de estado de sincronización de un cliente determinado. Además, puede exportar información detallada sobre la última sincronización a un registro CSV. El registro CSV proporciona más detalles que la pantalla de Control Hub y puede ayudar en la resolución de problemas, el análisis y la auditoría.

• Webex almacena los contactos de los usuarios en un formato cifrado. Solo el usuario propietario del contacto tiene acceso a la clave de descifrado.

• Para usuarios que llaman solo a BroadWorks y entidades que llaman no usuarios, esta característica sincroniza los siguientes tipos de números de teléfono desde BroadWorks:

  • Número de teléfono principal

  • Número de teléfono móvil

  • Extensión

  Sin embargo, la sincronización excluye de la sincronización a los usuarios que llaman solo a BroadWorks y a las entidades que llaman no usuarios si no hay un número de teléfono principal o una extensión.

  La configuración del servicio de privacidad a nivel de usuario de BroadWorks no es compatible como parte de la sincronización de directorios.

Lista de teléfonos y máximos de contactos de BroadWorks

La sincronización de directorios también sincroniza las entradas de la lista de teléfonos de BroadWorks con los contactos de Webex. Las entradas sincronizadas se agregan a uno de los siguientes tipos de contacto:

• Contactos de la organización: Webex almacena estos contactos en una organización. Cada usuario puede acceder a los contactos de la organización para su organización. El máximo es de hasta 30000 contactos.

• Contactos del usuario: Webex almacena estos contactos contra un usuario. Solo el usuario propietario del contacto puede acceder a la entrada del contacto. El máximo es de hasta 2000 contactos (1500 contactos sincronizados + 500 contactos de entrada manual).

La siguiente tabla asigna los tipos de contacto de Webex con la fuente de contacto (sincronizada desde una lista de teléfonos de BroadWorks o agregada manualmente):

Las siguientes condiciones se aplican en torno a cómo Directory Sync maneja los máximos de contactos:

• Si una organización supera el máximo de contactos permitidos para la sincronización (30000 contactos de la organización o 30000 contactos comunes de grupo por grupo), la sincronización de directorios excluye las entradas por encima del umbral máximo. No se aplica ningún orden en particular a los contactos sincronizados u omitidos.

• Si uno de sus clientes supera la cantidad máxima permitida de contactos en cualquiera de las categorías, le recomendamos que plantee un caso a Cisco para que esa organización sea excluida de la sincronización de directorios.

• Los contactos manuales son contactos que un usuario agrega manualmente en la aplicación de Webex. Un usuario puede agregar hasta 500 contactos manuales. Los contactos manuales entran dentro de la categoría de contactos de usuario más grande en Webex, pero no se incluyen en la sincronización.

• El límite global combinado para los contactos de la organización (30000) y los contactos de grupo (30000 por grupo) es de 200000.

Actualizaciones

A continuación, se muestra cómo maneja las actualizaciones el directorio de Webex:

• Si el nombre del contacto cambia en BroadWorks, el contacto existente se elimina del directorio de Webex y se crea un contacto nuevo.

• Si el número de contacto cambia en BroadWorks, Webex actualiza el contacto existente en el directorio de Webex con el nuevo número.

Después de que un administrador actualice un contacto en BroadWorks, las siguientes condiciones describen cuando aparece la actualización en la aplicación Webex de un usuario:

• Si la actualización es para un usuario que llama solo a BroadWorks o una entidad que llama no usuario, la actualización se muestra en la aplicación Webex de un usuario inmediatamente después de la sincronización de directorios posterior.

• Si la actualización es a una entrada de la lista de teléfonos de BroadWorks:

  • Para los contactos del usuario: las actualizaciones se muestran en la aplicación Webex del usuario inmediatamente después de la sincronización de directorios posterior.

  • Para contactos grupales: las actualizaciones se muestran en la aplicación de Webex de los usuarios inmediatamente después de la sincronización de directorios posterior.

  • Para los contactos de la organización: el directorio de Webex se actualiza en la sincronización de directorios posterior, pero los usuarios no verán el cambio en la aplicación de Webex hasta que reinicien la aplicación de Webex o hasta que caduque el temporizador de caché local de 72 horas.

Le recomendamos que utilice la siguiente configuración:

• Valores límite de velocidad: defina las siguientes propiedades del sistema OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit: establezca un valor nulo.

  • globalDirectoryTransactionLimit: establezca un valor nulo.

  Se recomienda configurar userDirectoryTransactionLimit y globalDirectoryTransactionLimit en un valor nulo. Sin embargo, si decide asignar valores, cada uno debe establecerse en al menos cinco veces el valor de transactionLimitPeriodSeconds (que debería ser 1).

• Límites de transacción: establezca los siguientes valores (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • userTransactionLimit: establecido en al menos 100.

  • transactionLimitPeriodSecs: establecido en 1.

• Valores de paginación: defina las propiedades del sistema de paginación (XSP_CLI/Applications/Xsi-Actions/Paginación):

  • defaultPageSize: establecido en 50

  • availableUserMaxLimit: establecido en 100

• Interfaz de CTI: asegúrese de cargar esos certificados de CA de Webex en el almacén de confianza de la interfaz de CTI y de habilitar la autenticación del cliente en la interfaz de CTI.

Además, según su versión de BroadWorks, le recomendamos que aplique los siguientes parches del sistema a la implementación de BroadWorks antes de habilitar esta característica:

• Para R22: AP.as.22.0.1123.ap368517

• Para R23: AP.as.23.0.1075.ap368517

• Para R24: no se requiere ningún parche

Los administradores de socios pueden habilitar la sincronización de directorios para una plantilla de cliente al crear la nueva plantilla. Todas las organizaciones de clientes nuevas que se asignen a esa plantilla tendrán habilitada la sincronización de directorios. Para obtener detalles, consulte "Configurar las plantillas de sus clientes" en Configurar la organización de su socio en el concentrador de socios en la Guía de soluciones de Webex para Cisco BroadWorks.

Qué hacer a continuación

Asegúrese de que sus usuarios sepan que deben hacer clic en la ficha Contactos de la aplicación de Webex al menos una vez para activar la característica de la aplicación de Webex. Esto solo debe completarse una vez.

Las API públicas están disponibles en developer.webex.com que permiten a los administradores de socios actualizar la configuración de la sincronización de directorios para las organizaciones del cliente que administran, para activar una sincronización inmediata u obtener información del estado de la sincronización. Los métodos de sincronización de directorios se agrupan en BroadWorks Enterprises:

• Lista de empresas de BroadWorks: utilice este método de API para obtener una lista de empresas de un determinado proveedor de servicios y de cada empresa. id. Debe introducir el spEnterpriseId como se asignó en el aprovisionamiento.

• Actualizar sincronización de directorios para una empresa de BroadWorks: introduzca la empresa id para actualizar el estado de syc de directorio para esa empresa, habilitando o deshabilitando la sincronización de directorios.

• Activar sincronización de directorios para una empresa: utilice este método de API si desea activar una sincronización inmediata para una empresa determinada. id. Para el syncStatus, introduzca el SYNC_NOW comando.

• Obtener el estado de sincronización de directorios para una empresa: introduzca la empresa id y ejecutar para obtener un estado y trackingId de la última sincronización. Puede utilizar el trackingID ejecutar análisis adicionales a través de herramientas como Kibana y Grafana.

Además, los administradores pueden utilizar la API de Activar sincronización de directorios para un solo usuario para activar una sincronización de directorios bajo demanda para un solo usuario.

Para obtener documentación detallada de la API, consulte https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Debe iniciar sesión para leer la especificación de la API en https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Los siguientes códigos de error se aplican a la sincronización de directorios.

En la siguiente tabla se resumen las actualizaciones de este artículo.