La sincronización de directorios garantiza que los usuarios de Webex para Cisco BroadWorks puedan usar el directorio Webex desde la aplicación Webex para llamar a cualquier entidad de llamada desde el servidor de BroadWorks. Esta función sincroniza la información de llamada de BroadWorks que no formaba parte del aprovisionamiento de usuarios con el directorio de Webex.

El aprovisionamiento de usuarios de Webex para Cisco BroadWorks actualiza el directorio de Webex con detalles de llamadas para los 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 función también sincroniza los siguientes registros de llamadas con el directorio de Webex.

• Llamando solo a usuarios de BroadWorks (que no están incluidos en Webex)

• Entidades de llamadas que no son usuarios (por ejemplo, un teléfono de sala de conferencias, una máquina de fax, número de grupo de búsqueda)

• Entradas de la lista telefónica 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 asociados deben habilitar la función a nivel de socio. Los administradores asociados pueden activar o desactivar la función 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 (el tiempo elegido para iniciar la sincronización es aleatorio). Sin embargo, las organizaciones de clientes pueden usar 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 de clientes determinada.

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

• El número máximo de sincronizaciones simultáneas por clúster de BroadWorks es de dos: una sincronización programada y una sincronización bajo demanda (a través de API o 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 mediante la opción Sincronizar ahora en Partner Hub. Además, Webex no programará dos sincronizaciones programadas para que se ejecuten al mismo tiempo desde el mismo BroadWorks.

• Si se produce un error de sincronización, Webex vuelve a intentar la sincronización automáticamente cada 24 horas hasta la próxima sincronización programada.

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

• En Partner Hub, puede ver la información del 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, análisis y auditoría.

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

• Para usuarios que llaman solo BroadWorks y entidades que no llaman a usuarios, esta función sincroniza los siguientes tipos de número de teléfono de 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 solo llaman de BroadWorks y a las entidades de llamadas que no son 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 se admite como parte de la sincronización de directorios.

Lista telefónica de BroadWorks y máximos de contacto

La sincronización de directorios también sincroniza las entradas de la lista telefónica 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 contra de una organización. Cada usuario puede acceder a los contactos de la organización de su organización. El máximo es de hasta 30000 contactos.

• Contactos de usuario: Webex almacena estos contactos contra un usuario. Solo el usuario propietario del contacto puede acceder a la entrada de 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 el origen de contacto (sincronizado desde una lista telefónica de BroadWorks o agregado manualmente):

Las siguientes condiciones se aplican en relación con la forma en que Directory Sync maneja los máximos de contacto:

• Si una organización excede el máximo de contactos permitidos para la sincronización (30000 contactos de 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 el número máximo permitido 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 Webex. Un usuario puede agregar hasta 500 contactos manuales. Los contactos manuales se encuentran dentro de la categoría de contacto de usuario más grande en Webex, pero no se incluyen en la sincronización.

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

Actualizaciones

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

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

• 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 cuándo se muestra la actualización en la aplicación Webex de un usuario:

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

• Si la actualización es a una entrada de la lista telefónica de BroadWorks:

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

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

  • Para contactos de 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 Webex hasta que reinicien la aplicación Webex o hasta que expire el temporizador de caché local de 72 horas.

Le recomendamos que utilice la siguiente configuración:

• Valores de limitación de velocidad: establezca las siguientes propiedades del sistema OverloadControl (XSP_CLI/Applications/XSI-Actions/OverloadControl):

  • UserDirectoryTransactionLimite: se establece en un valor nulo.

  • GlobalDirectoryTransactionLimite: se establece en un valor nulo.

  Se recomienda que establezca UserDirectoryTransactionLimit y GlobalDirectoryTransactionLimit en un valor nulo. Sin embargo, si decide asignar valores, cada uno debe configurarse 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):

  • UserTransactionLimite: se establece en al menos 100.

  • TransactionLimitPeriodSecs: se establece en 1.

• Valores de paginación: establezca las propiedades del sistema de paginación (XSP_CLI/Applications/XSI-Actions/Paging):

  • Tamaño de página predeterminado: se establece en 50

  • Límite máximo de usuario disponible: establecido en 100

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

Además, dependiendo de su versión de BroadWorks, le recomendamos que aplique los siguientes parches del sistema a la implementación de BroadWorks antes de habilitar esta función:

• Para R22: AP.AS.22.0.1123.AP368517

• Para R23: AP.AS.23.0.1075.AP368517

• Para R24: no se requiere parche

Los administradores asociados pueden habilitar la sincronización de directorios para una plantilla de cliente mientras crean la nueva plantilla. Cualquier organización cliente nueva que se asigne a esa plantilla tendrá habilitada la sincronización de directorios. Para obtener más información, consulte “Configurar sus plantillas de incorporación” en Configurar su organización de partners en Partner Hub dentro de la Guía de soluciones para Webex para Cisco BroadWorks.

Qué hacer a continuación

Asegúrese de que sus usuarios sepan que deben hacer clic en la pestaña Contactos de la aplicación Webex al menos una vez para activar la función en la aplicación Webex. Esto debe completarse una sola vez.

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

• Listar empresas de BroadWorks: utilice este método de API para obtener una lista de empresas bajo un proveedor de servicios determinado y la identificación de cada empresa. Debe introducir el SPEnterpriseID como se le asignó en el aprovisionamiento.

• Actualizar sincronización de directorios para BroadWorks Enterprise: introduzca el identificador de empresa para actualizar el estado de sincronización del 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 un ID de empresa determinado. Para SyncStatus, escriba el comando SYNC_NOW.

• Obtener estado de sincronización de directorio para una empresa: introduzca el ID de la empresa y ejecútela para obtener un estado y un ID de seguimiento de la última sincronización. Puede usar el TrackingID para ejecutar análisis adicionales a través de herramientas como Kibana y Grafana.

Además, los administradores pueden usar Trigger Directory Sync para una API de un solo usuario para activar una sincronización de directorio bajo demanda para un solo usuario.

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

Necesita 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 Directory Sync.

La siguiente tabla resume las actualizaciones de este artículo.