Visão geral da Sincronização de diretórios

A sincronização de diretório garante que os usuários do Webex para Cisco BroadWorks possam usar o diretório Webex do aplicativo Webex para ligar para qualquer entidade de chamada do servidor BroadWorks. Este recurso sincroniza as informações de chamada do BroadWorks que não faziam parte do provisionamento do usuário para o diretório Webex .

O provisionamento de usuários do Webex para Cisco BroadWorks atualiza o diretório Webex com detalhes de chamadas do Webex para usuários do Cisco BroadWorks ( número de telefone principal , número de número do celular, ramal), mas omite registros de chamadas externas. No entanto, quando a Sincronização de diretório está ativada, o recurso também sincroniza os seguintes registros de chamadas para o diretório Webex .

  • Usuários de chamadas somente BroadWorks (que não estão integrados ao Webex)

  • Entidades que chamam não usuários (p. ex., um telefone de sala de conferência, aparelho de fax, número de grupo de busca )

  • Entradas da lista de telefones BroadWorks

A tabela a seguir resume os registros de chamadas do BroadWorks e mostra como eles são adicionados ao diretório Webex .

Tabela 1. Atualizações da Sincronização de diretórios para o diretório Webex

Registros de chamadas BroadWorks

Descrição

Adicionado ao diretório Webex via...

Webex para usuários do Cisco BroadWorks

Os usuários estão ativados para o Webex for Cisco BroadWorks

Provisionamento de usuários (por exemplo, provisionamento de fluxo)

Usuários de chamadas somente BroadWorks

Chamando usuários que estão não integrado ao Webex

Sincronização de diretório

Entidades de chamada sem usuário

Por exemplo, um telefone de sala de conferência, aparelho de fax, número do grupo de busca

Sincronização de diretório

Listas de telefone do BroadWorks

Entradas da lista de telefone do BroadWorks:

  • Listas de telefones comuns para empresas

  • Listas de telefones comuns do grupo (Grupos de provedores de serviços ou grupos de empresas)

  • Listas de telefones pessoais

Sincronização de diretório (sincronização de lista telefônica)


Para obter mais detalhes sobre o provisionamento de usuários, consulte o Guia de solução Webex para Cisco BroadWorks .

Condições de sincronização de diretórios

  • Os administradores de parceiros devem ativar o recurso no nível de parceiro. Os administradores parceiros podem ativar ou desativar o recurso para várias organizações de clientes em uma única operação.

  • Por padrão, a sincronização inicial ocorre uma semana após a ativação da sincronização (o horário escolhido para iniciar a sincronização é aleatório). No entanto, as organizações de clientes podem usar o Sincronizar agora opção para ignorar o período de espera de uma semana e acionar uma sincronização imediata para uma determinada organização de clientes.

  • Por padrão, a Sincronização de diretórios é executada semanalmente para cada cliente. Cada sincronização ocorre uma semana após a última sincronização, independentemente de a última sincronização ter sido agendada ou acionada manualmente com Sincronizar agora .

  • O número máximo de sincronizações simultâneas por grupo BroadWorks é dois: uma sincronização agendada e uma sincronização sob demanda (via API ou GUI do Partner Hub). No entanto, os administradores não podem executar duas sincronizações sob demanda ao mesmo tempo a partir do mesmo BroadWorks. Esta restrição existe independentemente de a sincronização ter sido iniciada através da API ou através do Sincronizar agora opção no Partner Hub. Além disso, o Webex não agendará duas sincronizações agendadas para serem executadas ao mesmo tempo a partir do mesmo BroadWorks.

  • Se ocorrer uma falha de sincronização, o Webex tentará a sincronização novamente automaticamente a cada 24 horas até a próxima sincronização agendada.

  • A sincronização ignora os usuários que não têm um número de telefone.

  • No Partner Hub, você pode visualizar as informações de status de sincronização de um determinado cliente. Além disso, você pode exportar informação detalhada sobre a última sincronização para um registro CSV. O registro CSV fornece mais detalhes do que a exibição do Control Hub e pode ajudar na solução de problemas, analítica e auditoria.

  • O Webex armazena os contatos do usuário em um formato criptografado. Somente o usuário que possui o contato tem acesso à chave de descriptografia.

  • Para usuários de chamada somente BroadWorks e entidades de chamada sem usuário, este recurso sincroniza os seguintes tipos de número de telefone do BroadWorks:

    • Número de telefone principal

    • Número de celular

    • Ramal

    No entanto, a sincronização exclui da sincronização os usuários de chamada somente BroadWorks e as entidades de chamada sem usuário se não houver um número de telefone principal ou ramal presente.

Máximos de contatos e lista de telefones BroadWorks

A Sincronização de diretório também sincroniza as entradas da lista de telefones do BroadWorks para os Contatos do Webex . As entradas sincronizadas são adicionadas a um dos seguintes tipos de contato:

  • Contatos da organização — O Webex armazena esses contatos em uma organização. Cada usuário pode acessar os contatos da organização para sua organização. O máximo é de até 30000 contatos.

  • Contatos do usuário — O Webex armazena esses contatos em um usuário. Somente o usuário que possui o contato pode acessar a entrada de contato. O máximo é de até 2000 contatos (1500 contatos sincronizados + 500 contatos de entrada manual).


Somente as entradas da Lista de telefones são adicionadas aos Contatos Webex . Os usuários de chamada somente BroadWorks e as entidades de chamada sem usuário que são incluídos na Sincronização de diretório não são adicionados aos Contatos, a menos que um usuário Webex os adicione aos Contatos manualmente.

A tabela a seguir mapeia os tipos de contatos Webex em relação à origem do contato (sincronizados de uma lista telefônica do BroadWorks ou adicionados manualmente):

Tabela 2. Máximos e origem da sincronização de diretórios

Tipo de contato Webex

Fonte de contato

Máximo

Sincronizado do BroadWorks...

API usada para sincronização

Contatos da organização

Sincronização de diretório

30000 contatos

Listas de telefones comuns para empresas

/directories/enterprisecommon

Listas de telefones comuns do grupo (para um grupo de provedores de serviços)**

/directories/groupcommon

Contatos do usuário

Sincronização de diretório

1500 contatos

Listas de telefones pessoais

/directories/personal

Adicionado manualmente pelo usuário

500 contatos

N/D

N/D

Contatos do grupo

Sincronização de diretório

30000 contatos por grupo

Listas de telefones comuns do grupo (para um grupo Enterprise)**

/directories/groupcommon

**As entradas das Listas de telefones comuns do grupo são sincronizadas de forma diferente, dependendo de o BroadWorks estar no Modo de empresa ou no modo de Provedor de serviços. O valor da isBroadWorksEnterprise O parâmetro (verdadeiro ou falso) determina como a lista é sincronizada:

  • Verdadeiro — Sincronizar como contato do grupo

  • Falso — Sincronizar como contato da organização

As seguintes condições se aplicam à forma como a Sincronização de diretórios trata os números máximos de contatos:

  • Se uma organização exceder o máximo de contatos permitidos para a sincronização (30000 contatos da organização ou 30000 contatos comuns do Grupo por grupo), a sincronização de diretórios excluirá entradas acima do limite máximo. Não há nenhuma ordem específica aplicada aos contatos sincronizados ou omitidos.

  • Se um dos seus clientes exceder o número máximo permitido de contatos em qualquer uma das categorias, recomendamos que você abra um caso com a Cisco para excluir essa organização da sincronização de diretórios.

  • Contatos manuais são contatos que um usuário adiciona manualmente no aplicativo Webex . Um usuário pode adicionar até 500 contatos manuais. Os contatos manuais se enquadram na categoria maior de Contato do usuário no Webex, mas não estão incluídos na sincronização.

  • O limite combinado geral de contatos da organização (30000) e contatos de grupo (30000 por grupo) é 200000.

Atualizações

É assim que o diretório Webex lida com as atualizações:

  • Se o nome do contato mudar no BroadWorks, o contato existente será excluído do diretório Webex e um novo contato será criado.

  • Se o número de contato mudar no BroadWorks, o Webex atualizará o contato existente no diretório Webex com o novo número.

Depois que um administrador atualiza um contato no BroadWorks, as seguintes condições descrevem quando a atualização é exibida no aplicativo Webex de um usuário:

  • Se a atualização for para um usuário de chamada somente BroadWorks ou uma entidade de chamada sem usuário, a atualização será exibida no aplicativo Webex de um usuário imediatamente após a sincronização de diretório subsequente.

  • Se a atualização for para uma entrada da lista de telefone BroadWorks:

    • Para contatos do usuário — As atualizações são exibidas no aplicativo Webex do usuário imediatamente após a sincronização de diretório subsequente.

    • Para contatos de grupo - As atualizações são exibidas no aplicativo Webex dos usuários imediatamente após a sincronização de diretório subsequente.

    • Para contatos da organização — O diretório Webex é atualizado na sincronização de diretório subsequente, mas os usuários não verão a alteração no aplicativo Webex até que o Webex ou até que o temporizador de cache de 72 horas local expire.


Atualizações no Webex para informação do usuário do Cisco BroadWorks são tratadas como parte dos processos de provisionamento.

O Control Hub contém uma opção para adicionar ou editar contatos em nível de organização no Control Hub por meio de um arquivo CSV. Os administradores parceiros e os administradores de clientes com acesso ao Control Hub podem acessar essa opção. No entanto, a atualização de contatos através do Control Hub não é suportada pelo Webex para Cisco BroadWorks. As atualizações de contatos aplicadas no Control Hub não são sincronizadas de volta com o BroadWorks e não estão disponíveis para pesquisas de diretório em telefones de mesa.

Pré-requisitos da sincronização de diretórios

Recomendamos o uso das seguintes configurações:


Os exemplos abaixo assumem que você está usando um servidor XSP. Para servidores ADP, substitua (XSP_ CLI) com (ADP_ CLI).
  • Valores limite de taxa — Defina as seguintes propriedades do sistema OverloadControl (XSP_ CLI/Applications/Xsi-Actions/OverloadControl):

    • userDirectoryTransactionLimit — definido como um valor nulo.

    • globalDirectoryTransactionLimit — definido como um valor nulo.


    É recomendado que você defina userDirectoryTransactionLimit e globalDirectoryTransactionLimit como um valor nulo. No entanto, se você decidir atribuir valores, cada um deve ser definido como pelo menos cinco vezes o valor de transactionLimitPeriodSeconds (que deve ser 1).
  • Limites de transação — Defina os seguintes valores (XSP_ CLI/Sistema/Utilitário de comunicação/Configurações padrão):

    • userTransactionLimit — Defina como pelo menos 100.

    • transactionLimitPeriodSecs — definido como 1.

  • Valores de paging — Defina as propriedades do sistema de paging (XSP_ CLI/Applications/Xsi-Actions/Paging):

    • defaultPageSize — definido como 50

    • availableUserMaxLimit — Defina como 100

  • Interface CTI — Certifique-se de carregar esses certificados de CA Webex para o armazenamento confiável da interface CTI e de ativar a autenticação de cliente na interface CTI.

Além disso, dependendo da versão do seu BroadWorks, recomendamos a aplicação dos seguintes patches de sistema para a implantação do BroadWorks antes de ativar esse recurso:

Ativar a sincronização de diretórios (novo modelo)

Os administradores de parceiros podem ativar a Sincronização de diretórios para um modelo de cliente durante a criação do novo modelo. Quaisquer novas organizações de clientes que forem atribuídas a esse modelo terão a sincronização de diretórios ativada. Para obter detalhes, consulte "Configurar seus modelos de cliente" em Configurar sua organização de parceiro no Partner Hub dentro do Guia de solução do Webex para Cisco BroadWorks .

O que fazer em seguida

Certifique-se de que seus usuários sabem que eles devem clicar no Contatos guia no aplicativo Webex pelo menos uma vez para ativar o recurso no aplicativo Webex . Isso precisa ser concluído apenas uma vez.

Ativar a sincronização de diretórios (modelo existente)

Os administradores de parceiros podem concluir as etapas a seguir para ativar a Sincronização de diretórios em um modelo de cliente existente para ativar o recurso para as organizações de clientes que usam o modelo.

1

Inicie sessão no Partner Hub e escolha Configurações .

2

Role para Chamadas BroadWorks e clique em Visualizar modelos .

3

Selecione o modelo de cliente apropriado e role até Sincronização de diretório BroadWorks .

4

Para habilitar a sincronização de diretórios por padrão para novas organizações de clientes que usam este modelo:

  1. Defina o Habilitar a Sincronização de lista de telefones e diretórios BroadWorks para todas as novas organizações de clientes alternar para Ativado .

  2. Clique em Salvar.

5

Para habilitar a sincronização de diretórios para organizações de clientes existentes que usam este modelo:

  1. Clique Mostrar lista de status de sincronização dos clientes .

  2. Marque as caixas de seleção adjacentes para cada organização para a qual você deseja ativar o recurso.

  3. Clique Ativar sincronização .


 

Se você quiser desabilitar a sincronização de diretórios, siga o procedimento acima e:

  • Na etapa 4a, defina a Habilitar a sincronização de diretórios telefônicos para todas as novas organizações de clientes alternar para Desligado para desabilitar a sincronização de diretórios por padrão para novas organizações de clientes que usam este modelo.

  • Na etapa 5c, clique em Desativar sincronização para desativar o recurso em organizações existentes.

O que fazer em seguida

Certifique-se de que seus usuários sabem que eles devem clicar no Contatos guia no aplicativo Webex pelo menos uma vez para ativar o recurso no aplicativo Webex . Isso precisa ser concluído apenas uma vez.

Acionar sincronização imediata

O Sincronizar agora A opção permite que o administrador parceiro acione uma sincronização sob demanda para uma determinada organização de clientes. Essa opção pode ser selecionada apenas para organizações de clientes individuais - não há opção em massa para Sincronizar agora.

1

Iniciar sessão no Partner Hub (http://admin.webex.com ) e escolha Configurações .

2

Role para Chamadas BroadWorks e clique em Visualizar modelos .

3

Selecione o modelo de cliente apropriado e role até Sincronização de diretório BroadWorks .

4

Clique Mostrar lista de status de sincronização dos clientes .

5

Para a organização de clientes que você deseja sincronizar, clique nos três pontos na extrema direita e selecione Sincronizar agora .

6

Clique Atualizar para ver os resultados da sincronização.

Exportar registros de sincronização para CSV

Os administradores parceiros podem exportar informação detalhada sobre a última sincronização para um arquivo CSV. O CSV contém uma visualização mais detalhada do registro de sincronização do que a GUI do Control Hub e pode ajudar na solução de problemas e nas análises.

1

Iniciar sessão no Partner Hub (http://admin.webex.com ) e escolha Configurações .

2

Role para Chamadas BroadWorks e clique em Visualizar modelos .

3

Selecione o modelo de cliente apropriado e role até Sincronização de diretório BroadWorks .

4

Clique Mostrar lista de status de sincronização dos clientes .

5

Marque as caixas de seleção adjacentes para cada organização que você deseja incluir na exportação.

6

Clique Exportar resultados .

APIs públicas para a Sincronização de diretórios

APIs públicas estão disponíveis em developer.webex.com que permitem aos administradores de parceiros atualizar as configurações de Sincronização de diretório para as organizações de clientes que gerenciam, acionar uma sincronização imediata ou obter informações de status da sincronização. Os métodos de sincronização de diretórios são agrupados em BroadWorks Enterprises :

  • Listar empresas BroadWorks —Use este método de API para obter uma lista de empresas em um determinado provedor de serviços e as informações de cada empresa id. Você deve inserir a spEnterpriseId conforme atribuído no provisionamento.

  • Atualizar a Sincronização de diretórios para uma BroadWorks Enterprise —Insira a empresa id para atualizar o status de sincronização de diretórios dessa empresa, ativando ou desativando a sincronização de diretórios.

  • Acionar a Sincronização de diretórios para uma empresa —Use este método de API se você quiser acionar uma sincronização imediata para uma determinada empresa id. Para o syncStatus, insira o SYNC_NOW comando.

  • Obter o status de sincronização de diretórios de uma empresa —Insira a empresa id e executado para obter um status e trackingId da sincronização mais recente. Você pode usar o trackingID para executar análises adicionais por meio de ferramentas como Kibana e Grafana.

Além disso, os administradores podem usar o Acionar a sincronização de diretórios para um único usuário API para acionar uma sincronização de diretório sob demanda para um único usuário.

Para documentação detalhada da API, consultehttps://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide .

Você precisa Iniciar sessão para ler a especificação da API emhttps://developer.webex.com/docs/api/v1/broadworks-subscribers .

Sincronizar várias empresas com a API

Conclua este procedimento para usar as APIs públicas para acionar a sincronização de diretórios para várias empresas.

  • A sincronização de diretórios permite que você sincronize apenas uma única empresa de um cluster do Broadworks por vez por meio de uma sincronização sob demanda. Se você tentar sincronizar mais de uma empresa, você receberá um erro 429

  • O tempo necessário para acionar uma sincronização em uma única empresa varia, dependendo do tamanho da empresa.

1

Execute o Listar empresas BroadWorks API para gerar uma lista de empresas que você deseja sincronizar.

  1. Definir iniciar com para a cadeia inicial do identificador da empresa ou do provedor de serviços .

  2. Clique em Executar.

2

Execute o Acionar a Sincronização de diretórios para uma empresa API na primeira empresa na lista.

  1. Inserir a empresa ID .

  2. Definir syncStatus para SYNC_NOW

  3. Clique em Executar.

    Uma sincronização imediata é acionada para a empresa. Esta sincronização conta para o limite de sincronização sob demanda única por Broadworks.
3

Aguarde alguns segundos e execute o Obter o status da sincronização de diretórios API para obter o status de sincronização.

  1. Inserir a empresa ID

  2. Clique em Executar.

4

Após a conclusão da sincronização, conclua as etapas 2 a 4 na próxima empresa da lista. Repita essas etapas até sincronizar a lista inteira.

Códigos de erro para sincronização de diretórios

Os seguintes códigos de erro se aplicam à Sincronização de diretórios.

Código do erro

Mensagem de erro

600000

Erro inesperado de Sincronização do Usuário do Diretório Externo do Broadworks.

600001

Falha na Sincronização do usuário do diretório externo do BroadWorks.

600002

A Sincronização do usuário do diretório externo do BroadWorks teve que ser encerrada antes da conclusão.

600003

A Sincronização do usuário do diretório externo do Broadworks foi bem-sucedida apenas parcialmente. Algumas Organizações de clientes falharam ao sincronizar.

600004

A Sincronização do usuário do diretório externo do BroadWorks não está habilitada no ConfigSet.

600005

A Sincronização do usuário do diretório externo do BroadWorks está em andamento no ConfigSet.

600006

As threads de Sincronização do usuário do diretório externo do BroadWorks estão ocupadas ou desligando, por isso, não aceitarão mais solicitações de sincronização. Tente novamente mais tarde.

600007

A Organização da identidade do CustomerConfig não foi encontrada.

600008

O CustomerConfig não foi encontrado na organização parceira.

600009

A Sincronização do usuário do diretório externo do Broadworks não pode ser executada porque o grupo broadworks associado ao CustomerConfig está ocupado

600010

A Sincronização do usuário do diretório externo do BroadWorks não pode ser executada porque não há um grupo do Broadworks associado ao CustomerConfig.

600011

A Sincronização do usuário do diretório externo do BroadWorks não está ativada no CustomerConfig.

600012

A Sincronização do Usuário do Diretório Externo do Broadworks não pode ser executada já que a sincronização do Diretório Híbrido já está ativada para o CustomerConfig.

600013

A Sincronização do usuário do diretório externo do BroadWorks falhou ao adicionar usuários e contas de máquina ao armazenamento de identidade.

600014

Falha de Sincronização do Usuário do Diretório Externo do Broadworks ao tentar conectar ao grupo Bradworks. Erro do Broadworks - %s.

600015

A Sincronização do Usuário do Diretório Externo do Broadworks não encontrou nenhum usuário correspondente no armazenamento de identidade.

600017

A Sincronização da lista de telefones BroadWorks falhou ao sincronizar todos os contatos do usuário e da empresa/organização.

600018

A Sincronização da lista de telefones BroadWorks falhou para usuários na empresa/organização.

600019

A Sincronização da lista de telefones BroadWorks falhou ao sincronizar os contatos da empresa/organização.

600020

A Sincronização do usuário do diretório externo do BroadWorks não pode ser desativada, pois a sincronização do CustomerConfig está Em andamento.

600022

A Sincronização de usuário único do diretório externo do BroadWorks não é possível porque a empresa não possui nenhum usuário provisionado.

600023

A Sincronização de usuário único do diretório externo do BroadWorks não é possível porque o usuário já existe nesta organização.

600024

A Sincronização de usuário único do diretório externo do BroadWorks não é possível porque nenhum usuário correspondente foi encontrado no BroadWorks.

600025

A Sincronização do usuário do diretório externo do BroadWorks falhou ao atualizar a conta de usuário na CI.

600026

A Sincronização do usuário do diretório externo do BroadWorks falhou ao atualizar a conta da máquina na CI.

600027

A Sincronização de usuário único do diretório externo do BroadWorks não é possível porque vários usuários foram encontrados no BroadWorks.

600028

A Sincronização de usuário único do diretório externo do BroadWorks não é possível porque, pelo menos, uma sincronização de diretório empresarial deve ter sido concluída.

600029

A Sincronização do usuário do diretório externo do BroadWorks falhou porque a empresa não tem nenhum usuário provisionado.

Histórico de alterações

A tabela a seguir resume as atualizações deste artigo.

Data

Revisão

14 de fevereiro de 2023

Atualizado Máximos e origem da sincronização de diretórios seção.

10 de dezembro de 2022

O termo foi atualizado Concluir sincronização imediata para Acionar a sincronização de diretórios

19 de julho de 2022

Esclarecimentos e correções nas informações gerais:

  • Atualizado Visão geral da Sincronização de diretórios para esclarecer as diferentes sincronizações envolvidas e como o diretório Webex é atualizado para cada uma.

  • Atualizado Máximos de contatos e lista de telefones BroadWorks para esclarecer que somente listas de telefone são sincronizadas com os Contatos.

  • Correções para Atualizações para esclarecer quanto tempo leva para o aplicativo Webex exibir registros atualizados.

09 de maio de 2022

  • Em Visão geral da Sincronização de diretórios , Nota corrigida sob o Máximos e origem da sincronização de diretórios tabela. Nota também atualizada sobre provisionamento de fluxo.

  • Edições e correções gramaticais

07 de abril de 2022

  • Nota adicionada ao Atualizações seção em Visão geral da Sincronização de diretórios sobre a limitação de aplicação de edições de contato no nível da organização no Control Hub.

28 de março de 2022

  • Conteúdo ausente reinserido em Ativar a sincronização de diretórios (novo modelo) .

  • Adicionadas informações sobre os máximos de sincronização. Você pode executar uma sincronização agendada e uma sincronização de API simultaneamente a partir do mesmo cluster.

  • Informações adicionadas em Acionar a Sincronização de diretórios para um único usuário API.

24 de março de 2022

Adicionada lista de tipos de número de telefone sincronizados a Condições de sincronização de diretórios . A sincronização agora inclui números de telefone celular .

16 de março de 2022

  • Adicionados novos códigos de erro.

  • Foi adicionada uma instrução de descrição introdutória para uma melhor usabilidade de pesquisas na web.

17 de dezembro de 2021

  • Pequenas edições estruturais para corrigir problema com sumário ausente.

16 de dezembro de 2021

  • Artigo atualizado com valores máximos aumentados para contatos do usuário.

08 de dezembro de 2021

  • Seção adicionada Máximo de contatos e sincronização de diretórios para esclarecer como a Sincronização de diretórios deriva o número máximo de contatos da Organização e do Usuário.

  • Formatação de tabela revisada em Códigos de erro para sincronização de diretórios para uma melhor legibilidade.