Descripción general de la sincronización de directorios

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.

Tabla 1. Actualizaciones de la sincronización de directorios en el directorio de Webex

Registros de llamadas de BroadWorks

Descripción

Se agregó al directorio de Webex a través de...

Webex para usuarios de Cisco BroadWorks

Los usuarios están habilitados para Webex para Cisco BroadWorks

Aprovisionamiento de usuarios (por ejemplo, aprovisionamiento de flujo)

Usuarios que llaman solo de BroadWorks

Usuarios de llamadas que no están incorporados a Webex

Sincronización de directorios

Entidades de llamadas sin usuarios

Por ejemplo, un teléfono sala de conferencia teléfono, una máquina de fax, un número de grupo de búsqueda

Sincronización de directorios

Listas de teléfonos de BroadWorks

Entradas en la lista de teléfonos de BroadWorks:

  • Listas de teléfonos comunes empresariales

  • Listas de teléfonos comunes grupales (Proveedor de servicios grupos o grupos empresariales)

  • Listas de teléfonos personales

Sincronización de directorios (sincronización de la lista de teléfonos)


Para obtener más detalles sobre el aprovisionamiento de usuarios, consulte la Guía de solución de Webex para Cisco BroadWorks.

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 del cliente pueden utilizar la opción Sincronizar ahora para omitir el período de espera de una semana y completar 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.

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 500 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).


Solo las entradas de la lista de teléfonos se agregan a los contactos de Webex. Los usuarios de llamadas de solo BroadWorks y las entidades de llamadas que no son usuarios que se incluyen en la sincronización de directorios no se agregan a los contactos, a menos que un usuario de Webex los agrega manualmente a los contactos.

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

Tabla 2. Cantidad máximas y origen de la sincronización de directorios

Tipo de contacto de Webex

Fuente del contacto

Máximo

Sincronizado desde BroadWorks...

API utilizada para la sincronización

Contactos de la organización

Sincronización de directorios

500 contactos

Listas de teléfonos comunes empresariales

/directories/enterprisecommon

Listas de teléfonos comunes grupales (para Proveedor de servicios grupo)**

/directories/groupcommon

Contactos del usuario

Sincronización de directorios

1500 contactos

Listas de teléfonos comunes grupales (para un grupo de la empresa)**

/directories/groupcommon

Listas de teléfonos personales

/directories/personal

Añadidos manualmente por el usuario

500 contactos

No disponible

No disponible


**Las entradas de las listas de teléfonos comunes grupales se sincronizan de manera diferente, según si BroadWorks está en el modo empresarial o en Proveedor de servicios móvil. El valor de la isBroadWorksEnterprise(verdadero o falso) determina cómo se sincroniza la lista:

  • Verdadero: sincronización como contacto del usuario

  • Falso: sincronización como contacto de la organización

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 permitido de contactos para la sincronización (500 contactos de la organización o 1500 contactos de usuarios sincronizados), la sincronización de directorios excluye 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.

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


Las actualizaciones de Webex para Cisco BroadWorks información de usuario manejan como parte de los procesos de aprovisionamiento.

Control Hub contiene una opción para agregar o editar contactos a nivel de la organización en Control Hub a través de un archivo CSV. Los administradores de socios y los administradores de clientes con acceso al Concentrador de control pueden acceder a esta opción. Sin embargo, Webex no admite la actualización de contactos a través del Concentrador de control para Cisco BroadWorks. Las actualizaciones de contactos aplicadas en el Control Hub no se sincronizan con BroadWorks y no están disponibles para búsquedas en directorios desde teléfonos de escritorio.

Requisitos previos de la sincronización de directorios

Le recomendamos que utilice la siguiente configuración:


En los siguientes ejemplos se asume que está utilizando un servidor XSP. Para los servidores de ADP, reemplace (XSP_CLI) por (ADP_CLI).
  • 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:

Habilitar sincronización de directorios (nueva plantilla)

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.

Habilitar sincronización de directorios (plantilla existente)

Los administradores de socios pueden completar los siguientes pasos para activar la Sincronización de directorios dentro de una plantilla de cliente existente a fin de habilitar la característica para las organizaciones del cliente que utilizan la plantilla.

1

Inicie sesión en el Partner Hub y elija Configuración.

2

Desplácese hasta Llamadas de BroadWorks y haga clic en Ver plantillas.

3

Seleccione la plantilla del cliente adecuada y desplácese hasta Sincronización de directorios deBroadWorks.

4

Para habilitar la sincronización de directorios de forma predeterminada para las nuevas estructuraciones de clientes que utilizan esta plantilla:

  1. Defina habilitar la sincronización de directorios y listas de teléfonos de BroadWorks para todas las organizaciones nuevas de clientes en Activar.

  2. Haga clic en Guardar.

5

Para habilitar la sincronización de directorios para organizaciones de clientes existentes que utilizan esta plantilla:

  1. Haga clic en Mostrar lista de estado de sincronización de clientes.

  2. Marque las casillas de verificación adyacentes para cada organización para la que quiera activar la característica.

  3. Haga clic en Habilitar sincronización.


 

Si desea deshabilitar la sincronización de directorios, siga el procedimiento anterior y:

  • En el paso 4a, defina la opción Habilitar la sincronización de directorios telefónicos para todas las nuevas organizaciones de clientes y desactive la opción Desactivar para deshabilitar la sincronización de directorios de manera predeterminada para las nuevas organizaciones de clientes que usen esta plantilla.

  • En el paso 5c, haga clic en Deshabilitar sincronización para desactivar la característica para las organizaciones existentes.

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.

Completar sincronización inmediata

La opción Sincronizar ahora permite al administrador de socios completar una sincronización bajo demanda para una organización determinada del cliente. Esta opción solo se puede seleccionar para organizaciones de clientes individuales; no hay una opción masiva para Sincronizar ahora.

1

Inicie sesión en el Concentrador de socios (http://admin.webex.com) y elija Configuración.

2

Desplácese hasta Llamadas de BroadWorks y haga clic en Ver plantillas.

3

Seleccione la plantilla del cliente adecuada y desplácese hasta Sincronización de directorios deBroadWorks.

4

Haga clic en Mostrar lista de estado de sincronización de clientes.

5

Para la organización del cliente que desea sincronizar, haga clic en los tres puntos en la parte derecha más alejada y seleccione Sincronizar ahora.

6

Haga clic en Actualizar para ver los resultados de la sincronización.

Exportar registros de sincronización a CSV

Los administradores de socios pueden exportar información detallada sobre la última sincronización a un archivo CSV. El CSV contiene una vista más detallada del registro de sincronización que la GUI de Control Hub y puede ayudar en la resolución de problemas y el análisis.

1

Inicie sesión en el Concentrador de socios (http://admin.webex.com) y elija Configuración.

2

Desplácese hasta Llamadas de BroadWorks y haga clic en Ver plantillas.

3

Seleccione la plantilla del cliente adecuada y desplácese hasta Sincronización de directorios deBroadWorks.

4

Haga clic en Mostrar lista de estado de sincronización de clientes.

5

Marque las casillas de verificación adyacentes para cada organización que desea incluir en la exportación.

6

Haga clic en Exportar resultados.

API públicas para la sincronización de directorios

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:

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

  • Actualizar la sincronización de directorios para una empresa de BroadWorks: introduzca la empresa id para actualizar el estado sic del directorio para esa empresa, habilitar o deshabilitar la sincronización de directorios.

  • Activar la sincronización de directoriospara una empresa: utilice este método de API si quiere activar una sincronización inmediata para una empresa determinada id. Para la 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 usar el trackingID para ejecutar análisis adicional 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.

Sincronizar varias empresas con API

Complete este procedimiento para utilizar las API públicas para completar la sincronización de directorios para varias empresas.

  • La sincronización de directorios le permite sincronizar solo una empresa desde un grupo de Broadworks a la vez a través de una sincronización bajo demanda. Si intenta sincronizar más de una empresa, recibirá un error 429

  • El tiempo que demora finalizar una sincronización para una sola empresa varía según el tamaño de la empresa.

1

Ejecute la API List BroadWorks Enterprises para generar una lista de empresas que desea sincronizar.

  1. Defina startWith en la cadena de inicio del identificador empresarial o del proveedor de servicios.

  2. Haga clic en Ejecutar.

2

Ejecute el Activador de sincronización de directorios para una API empresarial en la primera empresa de la lista.

  1. Introduzca el ID empresarial .

  2. Configurar syncStatus en SYNC_NOW

  3. Haga clic en Ejecutar.

    Se activa una sincronización inmediata para la empresa. Esta sincronización cuenta con la sincronización única bajo demanda por límite de Broadworks.
3

Espere unos segundos y luego ejecute la API Obtener estado de sincronización de directorios para obtener el estado de la sincronización.

  1. Introduzca el ID empresarial

  2. Haga clic en Ejecutar.

4

Una vez que finalice la sincronización, complete los pasos del 2 al 4 en la siguiente empresa de la lista. Repita estos pasos hasta sincronizar toda la lista.

Códigos de error para la sincronización de directorios

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

Código de error

Mensaje de error

600000

Error inesperado en la sincronización de usuarios de directorios externos de Broadworks.

600001

La sincronización de usuarios de directorios externos de Broadworks falló.

600002

La sincronización de usuarios de directorios externos de Broadworks tuvo que finalizar antes de que se completara.

600003

La sincronización de usuarios de directorios externos de Broadworks solo tuvo éxito parcial. Algunas organizaciones del cliente no se pudieron sincronizar.

600004

La sincronización de usuarios de directorios externos de Broadworks no está habilitada para ConfigSet.

600005

La sincronización de usuarios de directorios externos de Broadworks está en curso para ConfigSet.

600006

Los hilos de la sincronización de usuarios de directorios externos de Broadworks están ocupados o se están cerrando; por lo tanto, no se aceptarán más solicitudes de sincronización. Vuelva a intentarlo más tarde.

600007

No se encuentra la organización de identidad de CustomerConfig.

600008

CustomerConfig no se encuentra en la organización del socio.

600009

No se puede ejecutar la sincronización de usuarios de directorios externos de Broadworks ya que el grupo de Broadworks asociado con CustomerConfig está ocupado

600010

La sincronización de usuarios de directorios externos de Broadworks no se puede ejecutar ya que no hay ningún grupo de Broadworks asociado a CustomerConfig.

600011

La sincronización de usuarios de directorios externos de Broadworks no está habilitada para CustomerConfig.

600012

La sincronización de usuarios de directorios externos de Broadworks no se puede ejecutar porque que la sincronización de directorios híbridos ya está habilitada para CustomerConfig.

600013

La sincronización de usuarios de directorios externos de Broadworks no pudo agregar usuarios y cuentas automáticas al almacén de identidades.

600014

La sincronización de usuarios de directorios externos de Broadworks falló al intentar conectarse al grupo de Broadworks. Error de Broadworks: %s.

600015

La sincronización de usuarios de directorios externos de Broadworks no encontró ningún usuario coincidente en el almacén de identidades.

600017

La sincronización de la lista de teléfonos de BroadWorks no pudo sincronizar todos los contactos de usuarios y de la empresa/organización.

600018

Error en la sincronización de la lista de teléfonos de BroadWorks para los usuarios de la empresa/organización.

600019

La sincronización de la lista de teléfonos de BroadWorks no pudo sincronizar los contactos de la empresa/organización.

600020

La sincronización de usuarios externos de BroadWorks no se puede deshabilitar porque la sincronización de CustomerConfig está en curso.

600022

La sincronización de usuarios únicos de directorios externos de BroadWorks no es posible, ya que la empresa no tiene ningún usuario aprovisionado.

600023

La sincronización de usuarios únicos de directorios externos de BroadWorks no es posible porque el usuario ya existe en esta organización.

600024

La sincronización de usuarios únicos de directorios externos de BroadWorks no es posible porque no se encontró ningún usuario que coincida en BroadWorks.

600025

La sincronización de usuarios externos de BroadWorks no pudo actualizar la cuenta de usuario en CI.

600026

La sincronización de usuarios externos de BroadWorks no pudo actualizar la cuenta de la máquina en CI.

600027

La sincronización de usuarios únicos de directorios externos de BroadWorks no es posible porque se encontraron varios usuarios en BroadWorks.

600028

La sincronización de usuarios únicos de directorios externos de BroadWorks no es posible porque debería haber finalizado al menos una sincronización de directorios empresariales.

600029

Falló la sincronización de usuarios de directorios externos de BroadWorks ya que la empresa no tiene usuarios aprovisionados.

Historial de cambios

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

Fecha

Revisión

19 de julio de 2022

Aclaraciones y correcciones para la información general:

  • Descripción general de la sincronización de directorios actualizada para aclarar las diferentes sincronizaciones involucradas y cómo se actualiza el directorio de Webex para cada una.

  • Se actualizaron la Lista de teléfonos de BroadWorks y los Máximos de contactos para aclarar que solo las listas de teléfonos se sincronizan con Contactos.

  • Correcciones en las actualizaciones para aclarar cuánto tiempo tarda la aplicación de Webex en mostrar los registros actualizados.

9 de mayo de 2022

  • En Descripción general de la sincronización dedirectorios, se corrigió Nota en la tabla Máximos de sincronización de directorios y Fuente. También se actualizó La nota sobre el aprovisionamiento de flujo.

  • Ediciones y correcciones gramaticales

7 de abril de 2022

  • Se agregó una nota a la sección Actualizaciones de la Descripción general de la sincronización de directorios acerca de la limitación de la aplicación de ediciones de contactos a nivel de la organización en Control Hub.

28 de marzo de 2022

  • Falta contenido reinsertado en Habilitar sincronización de directorios (nueva plantilla).

  • Se agregó información sobre los máximos de sincronización. Puede ejecutar una sincronización planificada y una sincronización de API en forma simultánea desde el mismo grupo.

  • Se agregó información sobre Activar la sincronización de directorios para una API de un solo usuario.

24 de marzo de 2022

Se agregó una lista de tipos de números de teléfono sincronizados a condiciones de sincronización de directorios. La sincronización ahora incluye números de teléfonos móviles.

16 de marzo de 2022

  • Se agregaron nuevos códigos de error.

  • Se agregó una declaración de descripción de introducción para una mejor facilidad de uso desde búsquedas en la Web.

17 de diciembre de 2021

  • Ediciones estructurales menores para corregir el problema con los TOC faltantes.

16 de diciembre de 2021

  • Se actualizó el artículo con valores máximos mayores para los contactos del usuario.

8 de diciembre de 2021

  • Se agregó la sección Sincronización de directorios y Máximos de contactos para aclarar cómo la sincronización de directorios deriva la cantidad máxima de contactos de organización y usuario.

  • Formato de la tabla revisada en Códigos de error para la sincronización de directorios para una mejor legibilidad.