A sincronização de diretórios garante que os usuários do Webex for Cisco BroadWorks possam usar o diretório Webex do aplicativo Webex para chamar qualquer entidade chamadora do servidor BroadWorks. Esse recurso sincroniza as informações de chamada da BroadWorks que não faziam parte do aprovisionamento do usuário com o diretório Webex.

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

• Usuários que fazem chamadas somente da Broadworks (que não estão integrados ao Webex)

• Entidades de chamada que não são do usuário (por exemplo, telefone de sala de conferência, aparelho de fax, número de grupo de busca)

• Entradas da lista de telefones da BroadWorks

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

Condições de sincronização do diretório

• Os administradores do parceiro devem ativar o recurso no nível do parceiro. Os administradores de 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 (a hora escolhida para iniciar a sincronização é aleatória). No entanto, as organizações de clientes podem usar a opção Sincronizar agora 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 o Sync Now.

• O número máximo de sincronizações simultâneas por cluster 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 no mesmo BroadWorks. Essa restrição existe independentemente de a sincronização ter sido iniciada pela API ou pela opção Sincronizar agora no Partner Hub. Além disso, o Webex não agendará duas sincronizações programadas para serem executadas ao mesmo tempo no mesmo BroadWorks.

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

• A sincronização ignora 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ções detalhadas sobre a última sincronização para um registro CSV. O registro CSV fornece mais detalhes do que a tela do Control Hub e pode ajudar na solução de problemas, análises e auditoria.

• O Webex armazena os contatos do usuário em um formato criptografado. Somente o usuário proprietário do contato tem acesso à chave de decodificação.

• Para usuários que fazem chamadas somente da Broadworks e entidades que não fazem chamadas, esse recurso sincroniza os seguintes tipos de números de telefone da BroadWorks:

  • Número de telefone principal

  • Número de telefone celular

  • Extensão

  No entanto, a sincronização exclui da sincronização os usuários que fazem chamadas somente da Broadworks e as entidades que fazem chamadas não usuárias se nenhum número de telefone principal ou ramal estiver presente.

  A configuração do serviço de privacidade em nível de usuário da BroadWorks não é suportada como parte da sincronização de diretórios.

Lista telefônica e máximos de contato da BroadWorks

A sincronização de diretórios também sincroniza as entradas da lista telefônica da BroadWorks com o Webex Contacts. 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 de sua organização. O máximo é de até 30000 contatos.

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

A tabela a seguir mapeia os tipos de contato Webex em relação à fonte de contato (sincronizada de uma lista telefônica da BroadWorks ou adicionada manualmente):

As seguintes condições se aplicam à forma como o Directory Sync lida com os contatos máximos:

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

• Se um de seus clientes exceder o número máximo permitido de contatos em qualquer categoria, recomendamos que você levante um caso com a Cisco para que essa organização seja excluída 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 maior categoria de contato do usuário no Webex, mas não estão incluídos na sincronização.

• O limite geral combinado para contatos da organização (30.000) e contatos de grupo (30.000 por grupo) é de 200.000.

Atualizações

Veja a seguir como 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 atualiza 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 chamador exclusivo da Broadworks ou para uma entidade chamadora que não seja usuário, a atualização será exibida no aplicativo Webex de um usuário imediatamente após a sincronização de diretórios subsequente.

• Se a atualização for para uma entrada da lista telefônica da BroadWorks:

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

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

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

Recomendamos que você use as seguintes configurações:

• Valores de limitação 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.

  É recomendável definir UserDirectoryTransactionLimit e GlobalDirectoryTransactionLimit como um valor nulo. No entanto, se você decidir atribuir valores, cada um deverá 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/System/CommunicationUtility/DefaultSettings):

  • UserTransactionLimit — Definido como pelo menos 100.

  • TransactionLimitPeriodSecs — definido como 1.

• Valores de paginação — Defina as propriedades do sistema de paginação (XSP_CLI/applications/XSI-Actions/Paging):

  • Tamanho de página padrão — definido como 50

  • AvailableUserMaxLimit — definido como 100

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

Além disso, dependendo da versão do BroadWorks, recomendamos que você aplique os seguintes patches de sistema à 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: nenhum patch é necessário

Os administradores parceiros podem ativar a sincronização de diretórios para um modelo de cliente ao criar o novo modelo. Todas as 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 integração” em Configurar sua organização parceira no Partner Hub no Guia de soluções do Webex para Cisco BroadWorks.

O que fazer a seguir

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

As APIs públicas estão disponíveis em developer.webex.com e permitem que os administradores parceiros atualizem as configurações de sincronização de diretórios das organizações de clientes que eles gerenciam, acionem uma sincronização imediata ou obtenham informações sobre o status da sincronização. Os métodos de sincronização de diretórios estão agrupados em BroadWorks Enterprises:

• Listar empresas da BroadWorks — Use esse método de API para obter uma lista de empresas sob um determinado provedor de serviços e o ID de cada empresa. Você deve inserir o SPEnterpriseID conforme atribuído no provisionamento.

• Atualizar sincronização de diretórios para uma empresa BroadWorks — insira o ID corporativo para atualizar o status de sincronização de diretórios dessa empresa, ativando ou desativando a sincronização de diretórios.

• Acione a sincronização de diretórios para uma empresa — use esse método de API se quiser acionar uma sincronização imediata para um determinado ID corporativo. Para o SyncStatus, insira o comando SYNC_NOW.

• Obter status de sincronização de diretórios para uma empresa — Insira o ID corporativo e execute para obter um status e um ID de rastreamento 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 a API Trigger Directory Sync for a Single User para acionar uma sincronização de diretórios sob demanda para um único usuário.

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

Você precisa fazer login para ler a especificação da API em https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Os códigos de erro a seguir se aplicam à sincronização de diretórios.

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