Sincronización de directorios en Webex para Cisco BroadWorks

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

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

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

• Entidades que no son usuarios de llamadas (por ejemplo, un sala de conferencia teléfono, máquina de fax, grupo de búsqueda móvil)

• Entradas a 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 habilitar la característica a nivel del socio. Los administradores de socios pueden activar o desactivar la característica para varias organizaciones de clientes en una sola operación.

• De manera predeterminada, la sincronización inicial ocurre una semana después de la habilitación de la sincronización (la hora elegida para iniciar la sincronización es aleatoria). Sin embargo, las organizaciones de clientes pueden utilizar la opción Sync Now para saltarse el periodo de espera de una semana y activar una sincronización inmediata para una organización de clientes determinada.

• De manera predeterminada, la sincronización de directorios se ejecuta semanalmente para cada cliente. Cada sincronización ocurre una semana después de la última sincronización, independientemente de si la última sincronización se planizó o se activó manualmente con Sincronizar ahora.

• La cantidad máxima de sincronizaciones simultáneas por grupo de BroadWorks es dos: una sincronización planificada y una sincronización bajo demanda (a través de la API o de la GUI del concentrador de socios). Sin embargo, los administradores no pueden ejecutar dos sincronizaciones bajo demanda al mismo tiempo desde la misma BroadWorks. Esta restricción existe independientemente de si la sincronización se inició a través de la API o a través de la opción Sincronizar ahora en el concentrador del socio. Además, Webex no planifica dos sincronizaciones planificadas para que se ejecuten al mismo tiempo desde la misma 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 el Concentrador de socios, puede ver la información de estado de la sincronización para 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 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 que es el propietario del contacto tiene acceso a la clave de descifrado.

• En el caso de usuarios de llamadas que solo de BroadWorks y entidades que llaman sin 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 a los usuarios de llamadas solo de BroadWorks y a las entidades de llamadas no usuarios de la sincronización si no hay ningún número de teléfono o extensión primarios.

  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 de teléfonos de BroadWorks y máximos de contactos

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 contactos:

• 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 30000 contactos.

• Contactos del usuario: Webex almacena estos contactos en función de un usuario. Solo el usuario que es el propietario del contacto puede acceder a la entrada de contacto. El máximo es de 2000 contactos (1500 contactos sincronizados y 500 contactos de entrada manual).

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

Se aplican las siguientes condiciones en torno al modo en el que la Sincronización de directorios maneja los máximos de contactos:

• Si una organización supera 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 hay ningún orden en particular aplicado a 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 presente 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 web de Webex. Un usuario puede agregar hasta 500 contactos manuales. Los contactos manuales se encuentran dentro de la categoría de contacto del usuario más grande en Webex, pero no se incluyen en la sincronización.

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

Actualizaciones

A continuación se muestra 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 número nuevo.

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

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

• 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 subsiguiente.

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

  • Para los contactos de la organización: el directorio de Webex se actualiza en la sincronización de directorios subsiguiente, 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 del caché local de 72 horas.

Le recomendamos que utilice la siguiente configuración:

• Velocidad de límite de valores: configure las siguientes propiedades del sistema OverloadControl (CLI_/Applications/Xsi-Actions/OverloadControl):

  • userDirectorioTransactionLimit: dedúzcalo en un valor nulo.

  • globalDirectorioTransactionLimit: dedúzcalo en un valor nulo.

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

• Límites de transacción: configure los siguientes valores (CLI/System/CommunicationUtility/DefaultSettings de XSP_):

  • userTransactionLimit: de configure como mínimo 100.

  • transactionLimitPeriodSecs: definido en 1.

• Valores de paginación: defina las propiedades del sistema de paginación (CLI/Aplicaciones de XSP_/Xsi-Acciones/Paginación):

  • defaultPageSize: se establece en 50

  • availableUserMaxLimit: de configuración en 100

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

Además, según su versión de BroadWorks, le recomendamos que aplique las siguientes revisiones 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 necesita revisión

Los administradores de socios pueden habilitar la sincronización de directorios para una plantilla de cliente mientras crean la nueva plantilla. Todas las organizaciones del cliente nuevas que se asignen a esa plantilla tendrán habilitada la sincronización de directorios. Para obtener detalles, consulte "Configurar sus plantillas de cliente" en Configurar la organización de socio en el concentrador del socio 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 en la aplicación de Webex al menos una vez a fin de activar la característica en 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 de clientes que administran, activar una sincronización inmediata u obtener información sobre el estado de la sincronización. Los métodos de sincronización de directorios se agrupan en Empresas de BroadWorks:

• List BroadWorks Enterprises-Utilice este método API para obtener una lista de empresas bajo un Proveedor de Servicios determinado y el id de cada empresa . Debe introducir el spEnterpriseId asignado en el aprovisionamiento.

• Actualizar la sincronización de directorios para una empresa BroadWorks- Introduzca el identificador de la empresa para actualizar el estado de la sincronización de directorios para esa empresa, activando o desactivando la sincronización de directorios.

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

• Get Directory Sync Status for an Enterprise-Introduzca el id de la empresa y ejecute para obtener un estado y trackingId de la última sincronización. Puede utilizar trackingID para ejecutar análisis adicionales a través de herramientas como Kibana y Grafana.

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

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

Necesita iniciar sesión para leer la especificación 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.

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