- Página inicial
- /
- Artigo
Este artigo descreve como implantar a Sincronização de diretórios no Webex para Cisco BroadWorks. O artigo se destina a administradores de provedores de serviços em organizações parceiras.
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 .
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:
| 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.
A configuração do serviço de privacidade em nível de usuário do BroadWorks não é suportada como parte da sincronização de diretórios.
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):
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 |
|
Listas de telefones comuns do grupo (para um grupo de provedores de serviços)** |
| |||
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
|
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:
Para R22:
AP.as.22.0.1123.ap368517
Para R23:
AP.as.23.0.1075.ap368517
Para R24: não é necessário patch
Para obter a lista completa dos requisitos de patch que formam o requisito mínimo do Webex para o Cisco BroadWorks, consulte Requisitos de software BroadWorks no Guia de soluções do Webex para o Cisco BroadWorks . |
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)
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: | ||
5 | Para habilitar a sincronização de diretórios para organizações de clientes existentes que usam este modelo:
|
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
1 | Inicie 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
1 | Inicie 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 aspEnterpriseId
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 osyncStatus
, insira oSYNC_NOW
comando.Obter o status de sincronização de diretórios de uma empresa —Insira a empresa
id
e executado para obter um status etrackingId
da sincronização mais recente. Você pode usar otrackingID
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
|
1 | Execute o Listar empresas BroadWorks API para gerar uma lista de empresas que você deseja sincronizar. |
2 | Execute o Acionar a Sincronização de diretórios para uma empresa API na primeira empresa na lista. |
3 | Aguarde alguns segundos e execute o Obter o status da sincronização de diretórios API para obter o status de sincronização. |
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:
|
09 de maio de 2022 |
|
07 de abril de 2022 |
|
28 de março de 2022 |
|
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 |
|
17 de dezembro de 2021 |
|
16 de dezembro de 2021 |
|
08 de dezembro de 2021 |
|