Solução de problemas do Webex para Cisco BroadWorks

Este artigo está dividido em três seções principais:

  • Recursos, que é uma lista de ferramentas, material de leitura, registros e contatos que você possa precisar.
  • Processos, que descrevem algumas das ações que você pode tomar ao solucionar um problema do cliente.
  • Problemas específicos, que categorizam e listam problemas que têm sido conhecidos por ocorrer, como localiza-los e como você poderia potencialmente resolvê-los.

Recursos de solução de problemas do Webex para Cisco BroadWorks

Arquivos de log úteis

Nome do registro

Origem

Útil para solução de problemas

PSLog

Servidor de aplicação

Provisionamento por fluxo

gato access_log

XSP

Login do aplicativo Webex

XsiActionsLogXSP

Interações de login do aplicativo Webex com o proxy IDP Webex, interações do cliente para consulta de perfis de dispositivos

registro do serviço de autenticação

XSP

Logon do aplicativo Webex (validação de token e emissão)

XSLogO XSP?

Inscrições móveis para notificações por push

Sinalização de chamada

Registro de inicialização do aplicativo Webex

Windows: \Users\{username}\AppData\Local\CiscoSpark\current_log.txt

Mac:/Users/{username}/Library/Logs/SparkMacDesktop/current_log

Celular: Usar Enviar registros

Verificações de direitos de inicialização (sequência) para o usuário

Inicialização da biblioteca BWC para conexão com o BroadWorks

getUserProfile & Log de busca do token JwT

Chamada BroadWorks

Registro do aplicativo Webex

Cliente

Windows: \Users\{username}\AppData\Local\CiscoSpark\current_log.txt

Mac:/Users/{username}/Library/Logs/SparkMacDesktop/current_log

Celular: Usar Enviar registros

Todo o tráfego SIP para registro e chamadas

Manter o tráfego em vida ao backend do BWKS

Recursos de chamada intermediária que exigem sinalização (Hold/Resume, Transferência, e assim por diante.)

Registro de mídia (Mecanismo de mídia Webex)

Cliente

Windows: \Users\{username}\AppData\Local\CiscoSpark\media\*.log

Mac: /Users/{username}/Library/Logs/SparkMacDesktop/media/

Celular: Usar Enviar registros

Todos os logging de mídia

Codecs negociados para uma chamada

Funcionalidades da Chamada Média

Lista de leitura

Problemas conhecidos e limitações

O artigo Problemas e limitações conhecidos contém informações atualizadas sobre problemas conhecidos que identificamos na solução Webex para BroadWorks.

Conector de operacionalidade

O serviço Webex Serviceability aumenta a velocidade com que a equipe de assistência técnica da Cisco pode diagnosticar problemas com a infraestrutura. Ele automatiza as tarefas de localizar, recuperar e armazenar registros de diagnóstico e informações em um caso SR. O serviço também aciona análises contra assinaturas de diagnóstico para que o TAC possa identificar e resolver com mais eficiência problemas com seus equipamentos no local.

Para obter detalhes sobre como implantar o conector de manutenção, consulte Guia de implantação do conector de manutenção do Cisco Webex.

Processo de solução de problemas do Webex para BroadWorks

Escalando um problema

Após você ter seguido algumas das orientações de solução de problemas, você deve ter uma ideia razoável de onde o problema está raiz.

Procedimento

  1. Colete o máximo de informações possível dos sistemas relacionados ao problema.
  2. Entre em contato com a equipe apropriada da Cisco para abrir um caso.

Quais informações do cliente coletar

Se você acha que precisa abrir um caso ou escalar um problema, colete as seguintes informações ao solucionar os problemas com o usuário:

  • Identificador de usuário: Endereço de e-mail do CI ou UUID do usuário (este é o identificador do Webex, mas se você também obtiver o identificador do BroadWorks do usuário, isso ajuda).
  • Identificador da organização.
  • Período aproximado durante o qual o problema ocorreu.
  • Plataforma e versão do cliente.
  • Enviar ou coletar logs do cliente.
  • Registre o ID de rastreamento, se mostrado ao cliente.

Verifique os detalhes do usuário no Help Desk

Os administradores de parceiros que têm privilégios de função de Administrador do Help Desk (Básico ou Avançado) podem usar este procedimento para verificar detalhes do usuário usando a exibição do Help Desk.

Procedimento

  1. Entre no Help Desk.
  2. Procure e clique no usuário. Isso abre a tela de resumo do usuário.
  3. Clique no nome de usuário para ver a configuração detalhada do usuário. As informações úteis nesta visualização incluem o UUID do usuário, o cluster de identidade comum (CI), o cluster de aplicativo Webex, o comportamento de chamada e o GUID da conta BroadWorks.
  4. Clique em Copiar se precisar usar essas informações em outra ferramenta ou anexá-la a um caso da Cisco.

Ver a organização do cliente no Help Desk

Os administradores de parceiros que têm privilégios de função de Administrador do Help Desk (Básico ou Avançado) podem usar este procedimento para visualizar detalhes da organização do cliente na exibição do Help Desk.

Procedimento

  1. Entre no Help Desk.
  2. Procure e clique no nome da organização do cliente.
  3. Role para baixo até ver Visualização do portal do cliente e clique em Visualizar nome do cliente para ver uma visualização somente leitura da organização do cliente, incluindo usuários e configuração.

Recuperar logs de usuários do Partner Hub

Ao solucionar problemas de clientes de desktop e móveis, é importante que os Parceiros (e o TAC) consigam visualizar os logs do cliente.

Procedimento

  1. Peça ao usuário para enviar registros. Para obter ajuda, consulte: Aplicativo Webex | Relatar um problema.
  2. Peça ao usuário para exportar o ambiente de chamada e envie a você o arquivo ced.dat.
  3. Obtenha os logs do cliente no Partner Hub ou no Help Desk.

    Opção hub do parceiro:

    1. Entre no Hub de parceiros e encontre a organização do cliente do usuário.
    2. Selecione Solução de problemas.
    3. Selecione Registros.
    4. Procure pelo usuário (por e-mail).
    5. Exibir e baixar os registros do cliente como um arquivo zip.

    Suporte técnico opção:

    1. Faça o sign in para Suporte técnico.
    2. Procure a organização.
    3. Clique na organização (abre a tela de resumo).
    4. Role para baixo para clicar em Ver cliente.
    5. Selecione Solução de problemas.
    6. Selecione Registros.
    7. Procure pelo usuário (por e-mail).
    8. Exibir e baixar os registros do cliente como um arquivo zip.

Como encontrar a versão do cliente

Procedimento

  1. Compartilhar este link com o usuário: https://help.webex.com/njpf8r5
  2. Peça ao usuário para enviar o número da versão.

Verificação do cliente para serviço de chamada

Procedimento

  1. Faça login no cliente Webex.
  2. Verifique se o ícone de Opções de chamada (um telefone com uma engrenagem acima dele) está presente na barra lateral. Se o ícone não estiver presente, o usuário ainda não estará habilitado para o serviço de chamada no Control Hub.
  3. Abra o menu Configurações/Preferências e vá para a seção Serviços telefônicos. Você deve ver o status SSO Da sessão em que você está logado. (Se for um serviço telefônico diferente, como Webex Calling ,é mostrado, o usuário não está usando o Webex para o Cisco BroadWorks.)

    Esta verificação significa:

    • O cliente caminhou com sucesso os microsserviços Webex necessários.
    • O usuário foi autenticado com êxito.
    • O cliente recebe um token web JSON de longa duração do seu sistema BroadWorks.
    • O cliente recupera o perfil de dispositivo e foi registrado na BroadWorks.

Obter registros ou feedback do cliente

  • Consulte a seção Recursos para encontrar registros de clientes específicos nos clientes de desktop Webex ou peça aos usuários para enviarem registros. Para obter ajuda, consulte: Aplicativo Webex | Relatar um problema.
  • Peça aos usuários de clientes móveis para enviar registros, depois você pode conseguir através do hub de parceiros ou do help desk.

    Enviar registros é silencioso. No entanto, se um usuário enviar comentários, ele será para a equipe de devops do aplicativo Webex. Certifique-se de gravar o número de comentários do usuário se você quiser acompanhar com a Cisco. Por exemplo:

    número do caso para o caso de suporte enviado

Obter dados do ambiente de chamada

Os registros de clientes Webex são altamente reacionados para remover informações de identificação pessoal. Você deve exportar os dados do ambiente de chamada do cliente na mesma sessão que você notar o problema.

Procedimento

  1. No cliente clique em Ajuda > Verificador de saúde.
  2. Selecione Redefinir banco de dados. Isso aciona uma redefinição completa do cliente e carrega a tela de logon do aplicativo Webex.

Verifique se o Webex deve se registrar no BroadWorks

O aplicativo Webex verifica as seguintes informações para determinar se irá se registrar no BroadWorks:

  • Direito do usuário a broadworks-connector.
  • Comportamento de chamada para organização e usuário.

Verifique o comportamento de chamada de um usuário e a autorização do conector

  1. Entre no Help Desk com suas credenciais de administrador de parceiro.
  2. Procure o usuário.
  3. Clique no usuário e marque a entrada Comportamento de chamada. Ele deve ser "Calling in Webex".

    verificar o comportamento de chamada de um usuário

  4. Clique no nome de usuário para abrir a tela Detalhes do usuário.
  5. Role para baixo para localizar a seção entitlements e verifique se broadworks-connector está incluído

    Tela de detalhes do usuário - conector broadworks habilitado

    Um usuário do Webex para Cisco BroadWorks NÃO deve ter o direito bc-sp-standard se pretende usar o Webex para Cisco BroadWorks. Esta é a autorização para "Webex Calling (Broadcloud)", que é o aplicativo Webex ligando de um serviço de chamada em nuvem gerenciado pela Cisco.

Verifique o comportamento de chamada da organização

  1. Entre no Help Desk com suas credenciais de administrador de parceiro.
  2. Procure a organização.
  3. Clique na organização e marque a entrada Comportamento de chamada. Ele deve ser "Calling in Webex".

Analisar o PSLog para problemas de provisionamento de usuários

Use o PSLog do servidor de aplicativo para ver a solicitação HTTP POST para a ponte de provisionamento e a resposta do Webex. Em um caso de trabalho correto, a resposta é 200 OK e após alguns minutos você pode ver o usuário - e a nova org. do cliente, se for o primeiro usuário - foi criada no Webex. Você pode verificar isso pesquisando Suporte técnico pelo endereço de e-mail que você vê no POST.

Antes de começar

Colete um PSLog do servidor de aplicativos durante uma tentativa de provisionamento fluxo remoto com um usuário de teste.

Procedimento

  1. A primeira coisa a verificar é o código de resposta HTTP:
    • Qualquer coisa que não seja 200 OK é uma falha de provisionamento de usuário.
    • 200 OK ainda pode indicar uma falha se algo sobre o perfil do assinante não funcionar nos serviços Webex a montante da ponte de provisionamento.
    • 400 pode conter um nó message na resposta. A ponte de provisionamento não conseguiu processar algo em subscriberProfile. Pode haver algo errado com os detalhes do assinante ou incompatibilidade com uma configuração no modelo.
    • 401 significa que as credenciais de provisionamento inseridas no AS não são igual às inseridas no modelo no Partner Hub.
    • 403 pode indicar algo mal configurado no Servidor de Aplicativo. Verifique o destino da solicitação. ele não deve ser um endereço IP, deve ser a URL da ponte de provisionamento que você pode ver no seu modelo no Partner Hub.
    • 409 indica um conflito entre os dados fornecidos subscriberProfile e os dados Webex existentes. Pode haver um usuário existente com esse endereço de e-mail. Verifique o message na resposta.
  2. Você também pode verificar o HTTP POST original quanto a valores de suspeita que podem causar falha no provisionamento. O POST contém uma estrutura XML subscriberProfile. Dentro disso, os nós úteis para verificar são:
    • bwuserid: Use isso para encontrar o perfil do assinante se precisar editá-lo no BroadWorks.
    • group: Se o modelo estiver no "modo Provedor de Serviços", ele será escrito em minúsculas e se tornará o nome da organização do Cliente que você vê no Partner Hub.
    • serviceProvider: Se o modelo estiver no "modo Enterprise", ele será menor e se tornará o nome da org. do cliente que você vê no Partner Hub.
    • primaryPhoneNumber: Deve existir. O provisionamento falha sem ele.
    • email: Torna-se a ID do usuário no Webex. Deve ser válido e exclusivo para o Webex, caso contrário o provisionamento falha.

      Ignore a estrofe services : ele é criado por AS e aceito, mas não é usado pelo Webex.

Analisar logs XSP para solucionar problemas de login do assinante

Este fluxo descreve o modo de autenticação BroadWorks. Você pode ver o modo de autenticação no modelo BroadWorks, no Partner Hub. Consulte Configurar os modelos do cliente em https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726.

O diagrama de escada a seguir mostra a interação entre o usuário, o cliente, os serviços Webex e o sistema BroadWorks, quando o usuário realiza a autenticação BroadWorks no aplicativo Webex. Além disso, a conexão entre o Webex e o XSP é protegida por MTLS.

A discussão que se segue explica o que você pode esperar ver ao investigar os registros para um logon bem-sucedido. Analisar logs XSP para solucionar problemas de log de assinante em -flow

O usuário interage com o cliente, o cliente interage com os serviços Webex:

  • O usuário fornece seu endereço de e-mail para o aplicativo Webex (1 no diagrama).
  • A CI sabe como redirecionar este usuário para inserir a senha do BroadWorks (via UAP) (2 no diagrama).
  • O proxy IDP envia uma solicitação de obter perfil para a interface Xsi no XSP.

No gato access_log:

  • Procure a solicitação GET para o perfil do assinante, do Webex para a interface Xsi-Actions (2.1 no diagrama). Ela tem a versão Webex ID do usuário. Por exemplo:

    GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile

No XsiActionsLog:

  • Procure a solicitação GET do perfil do Webex (2.1 no diagrama). Ela tem a versão Webex ID do usuário. Por exemplo:

    GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile Os cabeçalhos incluem authorization: Basic e user-agent: broadworksTeamsClient

  • O XSP então faz a autenticação OCI-P Basic contra o BroadWorks (AuthenticationVerifyRequest e AuthenticationVerifyResponse, como qualquer outro aplicativo que faz autenticação básica via Xsi) e também um UserGetRequest e ServiceProviderGetRequest para coletar as informações do assinante.
  • A resposta Xsi ao Webex contém um bloco XML Profile contendo o (BroadWorks) userId e outros detalhes (2.2 no diagrama).

Interações dos serviços Webex e cliente:

  • O proxy IDP corresponde ao perfil de usuário recebido do BroadWorks e emite a asserção SAML para o cliente (2.3 no diagrama).
  • O cliente troca a asserção SAML por um token CI (3 no diagrama).
  • O cliente verifica se o usuário que se inscreveu tem a autorização de conector broadworks (4 no diagrama). Você pode verificar os direitos do usuário no Help Desk.
  • O cliente usa o token CI para solicitar um JSON Web Token (JWT) do proxy IDP (5 no diagrama).
  • O proxy IDP valida o token CI no CI.
  • O proxy IDP solicita JWT do serviço de autenticação.

No registro do Serviço de autenticação:

  • Procure a solicitação de token do Webex (5.2 no diagrama), por exemplo: GET /authService/token que tem cabeçalho http_bw_userid e outros.
  • O XSP executa OCI-P UserGetLoginInfoRequestpara validar se o ID de usuário fornecido corresponde a um usuário do BroadWorks (5.3 no diagrama). AuthService estabeleceu confiança com a Webex em virtude da conexão mTLS, então pode emitir LLT.
  • Procure a resposta (5.4 no diagrama) de LongLivedTokenManager - Token generated, subject: bwksUserId@example.com, issuer: BroadWorks … e StatusCode=200 que você pode associar à solicitação original usando o cabeçalho trackingid: CLIENT… .

No XsiActionsLog:

  • O cliente pode apresentar o token de longa duração na interface Xsi-Actions para obter seu perfil de dispositivo (6 no diagrama). Por exemplo: GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device Com os cabeçalhos authorization: Bearer token e user-agent: WebexTeams (variant/version)
  • A interface Xsi-Actions envia o token para o authservice (configurado para estar na interface de loopback). Por exemplo: 127.0.0.1:80 POST http://127.0.0.1:80/authService/token que você pode correlacionar com o cabeçalho trackingid: CLIENT… no GET e o cabeçalho X-BROADSOFT-CORRELATION-ID : CLIENT… no POST.

No registro do Serviço de autenticação:

  • O recibo do POST a partir de Xsi (loopback)

  • Um StatusCode=200 de volta para Xsi

  • E uma resposta de validação de token, tendo um bloco JSON "token" no corpo.

  • Tem relação com o uso do trackingid: CLIENT…

No XsiActionsLog:

  • Tendo recebido 200 OK do authservice, que validou o token do cliente, o aplicativo Xsi-Actions agora envia uma solicitação OCI-P para UserPrimaryAndSCADeviceGetListRequest
  • Recebe OCI-P UserPrimaryAndSCADeviceGetListResponse contendo a estrutura XML accessDeviceTable.
  • A resposta OCI-P é codificada como resposta Xsi ao cliente, incluindo a estrutura XML AccessDevices, que tem o deviceTypes. Por exemplo: Business Communicator – PC e as urls onde o cliente pode recuperar os arquivos de configuração do dispositivo.

Cliente continua como normal:

  • Seleciona uma entrada de dispositivo e interage com o DMS para obter o perfil do dispositivo (6 no diagrama).
  • Registros no BroadWorks via SBC recuperados na configuração do DMS (7 no diagrama).

Solução de problemas específicos do Webex para BroadWorks

Problemas do Partner Hub

O administrador não consegue ver as organizações dos clientes

Como administrador da sua organização parceira no Webex, você deve ter a função Administrador completo. Essa função é usada para gerenciar a organização do seu parceiro, inclusive a atribuição de privilégios administrativos para você mesmo e para terceiros. Para gerenciar organizações de clientes, você precisa conceder a si mesmo (ou a outras pessoas) a função Administrador completo de vendas ou Administrador de vendas . Para obter detalhes, consulte Atribuir funções de conta da organização no Control Hub.

Problemas de provisionamento de usuários

IM integrado & Erros P para empresas específicas / clientes

Se você tem uma combinação de empresas que usam diferentes serviços de colaboração em nuvem, por exemplo, UC-One SaaS e Webex para Cisco BroadWorks, você pode ter optado por modificar o adaptador de provisionamento em uma base por empresa.

Para verificar o que está configurado para IM integrado & P (padrão para empresas, a menos que exista uma configuração mais específica), execute AS_CLI/Interface/Messaging> get. Para parâmetros de provisionamento de uma empresa específica, abra a empresa e vá para Serviços > IM integrado & P.

Verifique se a configuração IM&P integrada para essa empresa corresponde exatamente ao que é mostrado no modelo de cliente no Partner Hub. As configurações a seguir devem corresponder ou o provisionamento falha para todos os usuários na empresa:

Configuração do IM&P Integrado BroadWorks Enterprise Configuração do modelo de cliente Hub do parceiro
URL do servidor de mensagens URL de provisionamento
Nome de usuário do servidor de mensagensNome da conta de provisionamento
Senha do servidor de mensagensSenha da conta de provisionamento, confirmar senha

IM integrado & Erros P para usuários específicos

Isso se aplica se você está usando o provisionamento fluxo e assume que o provisionamento está funcionando para alguns/para a maioria dos usuários (assim você pode descartar um problema de configuração). Se você estiver vendo erros de IM&P integrado no BroadWorks, por exemplo, "[Erro 18215] erro de provisionamento com o servidor de mensagens" e "[Erro 18211] Erro de comunicação com o servidor de mensagens", você deve investigar as seguintes possíveis causas:

  • O endereço de e-mail do usuário já pode existir CI. Procure pelo usuário no Suporte técnico para verificar se o endereço de e-mail já está lá. Isso não é necessariamente implicante, porque o usuário pode existir em uma organização cujos dados você não tem permissão para ver em Suporte técnico.
  • O usuário inscreveu-se de forma independente no Webex, antes de ser atribuído ao serviço IM&P integrado. Nesse caso, uma opção é fazer com que o usuário exclua sua conta gratuita para que ele possa se tornar parte da Organização do Cliente que você está provisionando. As instruções estão em https://help.webex.com/5m4i4y
  • O usuário não tem um número de telefone primário atribuído ao seu perfil (todos os assinantes do Cisco BroadWorks devem ter um DID primário). Consulte o tópico sobre analisar PSLog de AS.

Falhas de provisionamento do usuário em resposta à ponte de provisionamento

Se os usuários não estão aparecendo no Control Hub, dentro de alguns minutos após a atribuição do IM&P integrado, dê uma olhada nos códigos de resposta do serviço de ponte de provisionamento. Execute um PSLog para ver os códigos de resposta HTTP.

200 OK

Uma resposta 200 OK não significa que o usuário foi provisionado com sucesso. Isso significa que o serviço de provisionamento recebeu a solicitação e enviou com sucesso a solicitação de criação do usuário correspondente para os serviços de upstream. A transação de provisionamento é assíncrona pelo design. O serviço responde 200 OK porque o processo de criação do usuário pode levar vários minutos e, por motivos de desempenho, não queremos receber várias solicitações para criar o mesmo usuário. No entanto, se o usuário não aparecer eventualmente na Organização do Cliente após uma resposta de 200 OK, ele pode indicar que a criação do usuário falhou no upstream dos serviços Webex do serviço de provisionamento. Você precisa escalar uma falha de provisionamento que tem uma resposta de 200 OK.

400 Solicitação ruim

Verifique a resposta HTTP, que deve ter mais detalhes sobre possíveis problemas que podem causar essa resposta do serviço de provisionamento. Alguns exemplos do nó:

  • "Não é possível confiar no e-mail BroadWorks com a API de provisionamento herdada." O endereço de e-mail associado à falha da solicitação de provisionamento do usuário não é válido ou está inconsateido, mas você afirmou no modelo que os endereços de e-mail podem ser confiáveis. Verifique os perfis de usuários no BroadWorks, especificamente a ID de e-mail.
  • A organização do cliente não foi encontrada no banco de dados e o sinalizador de criação de nova organização não está habilitado.” Essa solicitação de provisionamento com falha deve estar criando uma nova Organização do Cliente em Webex, mas seu modelo está configurado para impedir que novas Organizações de Clientes sejam criadas. Se você deseja permitir que novas organizações, para domínios de e-mail que não combinam com os clientes existentes no Webex, você pode reconfigurar seu modelo no Hub do parceiro e teste novamente a solicitação de provisionamento. No entanto, se você não está esperando que uma nova organização seja criada para este usuário, talvez o endereço de e-mail esteja misto (especificamente a parte do domínio). Verifique a ID de e-mail do usuário em BroadWorks.

403 Proibido

A solicitação de provisionamento não tem chance de ser bem-sucedida. Você precisará investigar a solicitação e resposta neste caso. Por exemplo, se você vir um endereço de IP como o alvo da solicitação de provisionamento - em vez da URL de ponte de provisionamento apropriada para sua organização (consulte os tópicos de configuração do firewall no Guia de Solução) - ele pode indicar que o servidor de aplicativo está faltando um patch necessário (ap373197).

Verifique se todos os patches necessários foram aplicados ao Servidor de aplicativo e se você concluiu a configuração relacionada para provisionamento fluxo mais bem sucedido.

Conflito 409

A solicitação de provisionamento não pode prosseguir porque há um usuário existente no Webex que corresponde ao endereço de e-mail na solicitação.

Usuário já está em CI

Receba o e-mail do assinante da solicitação HTTP POST e pesquise-o Suporte técnico. Você pode não ver o usuário se não for permitido, mas você também pode ver que o usuário está em uma organização "gratuita", por exemplo, "Consumidor". Você pode solicitar que esse usuário exclua sua conta gratuita ou você pode usar um endereço de e-mail diferente para provisioná-lo. Consulte .https://help.webex.com/ndta402

Problemas de login do usuário

O Portal de Ativação do Usuário não carrega

O fluxo de login normal do Webex para o Cisco BroadWorks inclui um Portal de Ativação de Usuário onde os usuários insem suas senhas. Às vezes, este portal não é carregado depois que o usuário forneceu o seu endereço de e-mail na tela de início de inscrição do aplicativo Webex. Esse problema pode ser causado no lado do cliente ou no lado do serviço. No lado do cliente, normalmente, isso é causado pelo navegador nativo do cliente ser incompatível de alguma forma com o serviço.

Falha no único ponto de partida

  • No BroadWorks, verifique se o usuário foi atribuído aos tipos de dispositivos para o aplicativo Webex (consulte a seção Perfis de dispositivos na seção Preparar seu ambiente do Guia de soluções).
  • Verifique se o usuário está usando a senha correta. Se o modelo que você usou para provisionar a Organização do Cliente do usuário (no Partner Hub) estiver configurado para autenticação do BroadWorks, o usuário deverá inserir sua senha de "Acesso Web" do BroadWorks. O usuário também pode precisar inserir seu ID de usuário do BroadWorks se seu endereço de e-mail não estiver configurado como um ID de usuário alternativo. Certifique-se de que o usuário digitou letras maiúsculas e minúsculas corretamente.

Problemas de configuração e registro de chamadas

Depois que um usuário foi provisionado no Webex e ele se registrou com êxito no aplicativo Webex, o aplicativo é registrado no BroadWorks. A seguir estão a sequência de registros esperadas e os sinais resultantes de um registro saudável (como visto do aplicativo Webex):

Sequência de registro esperada

  1. O cliente chama XSI para obter um token de gerenciamento de dispositivos e a URL para o DMS.
  2. O cliente solicita seu perfil de dispositivo a partir de DMS, apresentando o token do passo 1.
  3. O cliente lê o perfil do dispositivo e recupera as credenciais SIP, endereços e portas.
  4. O cliente envia um SIP REGISTER para SBC usando as informações do passo 3.
  5. O SBC envia o REGISTRO SIP para o AS (o SBC pode executar uma consulta no NS para localizar um AS se o SBC ainda não conhecer o usuário SIP).

Sinais esperados de registro de cliente bem-sucedido

O ícone Opções de chamada é exibido na interface Webex.

Na guia de serviços telefônicos do aplicativo Webex (por exemplo, Configurações > Serviços de telefone no Windows, Preferências > Serviços de telefone no Mac), a mensagem “Sessão SSO: Você está registrado" significa que o aplicativo foi registrado com êxito (para BroadWorks neste caso).

O cliente não tem ícone de chamada

Na maioria das vezes, isso significa que o usuário não tem a licença/autorizações corretas.

O cliente mostra a guia Serviços de telefone, mas nenhuma sessão SSO

O cliente Webex mostra a guia de serviços telefônicos, mas nenhuma sessão SSO

Este é um registro sem sucesso. Há várias razões pelas quais um cliente de aplicativo Webex falhava no registro com o BroadWorks:

Vários serviços de chamadas sendo testados com os mesmos clientes

Esse problema conhecido pode ser causado pela alteração do cliente entre os diferentes terminais do retorno de chamada. Provavelmente, isso ocorre durante os testes de diferentes serviços de chamada oferecidos através (os mesmos) clientes do aplicativo Webex. Você pode redefinir o banco de dados do cliente (link) para solucionar esse problema.

Configuração incorreta do serviço de autenticação

Verifique o(s) XSP(s) que hospedam o serviço de autenticação em relação ao Guia de solução (consulte Configurar serviços no seu Webex para Cisco BroadWorks XSPs). Especificamente:

  • As teclas RSA (que você gera em um XSP) são copiadas para todos os XSPs
  • A URL do serviço de autenticação foi fornecida ao recipiente da web em todos os XSPs e inserida corretamente no grupo no Hub do parceiro
  • Autenticação externa por certificados está configurada:

    XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication>get

    allowUserApp = false

    allowClientApp = true

  • Ao usar o MTLS, você deve carregar o certificado do cliente Webex nos XSPs (você pode obter o certificado no Partner Hub, na página Configurações do BroadWorks).

Configuração insatisfatório das tags BroadWorks

Verifique se você configurou as tags BroadWorks necessárias para o aplicativo Webex. Consulte o Guia de Configuração do Webex para Cisco BroadWorks para obter informações sobre as tags de configuração. Certifique-se de que não haja conflitos ou valores incorretos. Especificamente, a tag %SBC_ADDRESS_WXT% deve ser o SBC para seu registrador SIP para clientes do aplicativo Webex.

O cliente de desktop desconecta os serviços telefônicos após a conexão SSO bem-sucedida

Esse problema pode ser causado pelo mesmo usuário que está inando a vários clientes no mesmo tipo de plataforma. Por exemplo, se um usuário fizer login com sucesso no aplicativo Webex no Windows e depois fizer login no aplicativo Webex em uma máquina Windows diferente, haverá apenas uma sessão SSO ativa em uma das máquinas. Isso é por design. Se você absolutamente precisar trabalhar em torno deste problema, você pode configurar o BroadWorks para ter várias instâncias do mesmo tipo de dispositivo, mas elas devem ter endereços SIP exclusivos. Esta configuração está fora do escopo do Webex para Cisco BroadWorks.

Dispositivo de desktop não provisionado para o usuário

Esta assinatura é vista no log do cliente:

[0x70000476b000] BroadWorksConfigDownloader.cpp:106

onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload - the device profile 'Business Communicator - PC' is not found.

Problemas com a visualização da web nas configurações de chamada

Autocuidados button/link não aparece no aplicativo Webex

Um sintoma diferente deste problema é quando o botão/link é mostrado, mas clicar nele abre um navegador externo.

  • Verifique se o modelo de configuração do cliente necessário está implantado e se as tags CSW estão definidas corretamente. (Consulte a seção Configurações de chamada Webview no Guia de soluções Webex para Cisco BroadWorks).
  • Verifique se o aplicativo Webex está registrado para ligar para o BroadWorks.
  • Verifique se o aplicativo Webex é uma versão recente que suporta CSWV.

Página em branco ou erro após clicar em Autoatendimento button/link

Geralmente, esse comportamento no aplicativo Webex indica um problema de configuração ou implantação com o aplicativo CSWV no BroadWorks XSP. Colete detalhes para uma investigação mais recente, incluindo registros CSWV, registros de acesso, repositório de config-wxt.xml e arquivo de modelo e, em seguida, levante um caso.

Problemas de reivindicação de domínio

Erros de registro do usuário podem ocorrer como resultado de erros que são feitos na reivindicação de domínios. Antes de reivindicar quaisquer domínios, certifique-se de entender o seguinte:

  • Os provedores de serviços não devem reivindicar os domínios das organizações clientes que eles gerenciam. Eles devem reivindicar apenas os domínios dos usuários que estão na provedor de serviços da organização interna do usuário. Reivindicar o domínio de usuários em uma organização separada (mesmo que a provedor de serviços gerencie) pode resultar em erros de registro para os usuários na organização do cliente conforme as solicitações de autenticação de usuário são encaminhados através do provedor de serviços em vez da organização do cliente.
  • Se duas organizações de clientes (Empresa A e Empresa B) compartilharem o mesmo domínio e a Empresa A tiver reivindicado o domínio, o registro dos usuários da Empresa B poderá falhar devido ao fato de que as solicitações de autenticação de usuário são roteados através da organização que tem o domínio reivindicado (Empresa A).

    Se você reivindicar quaisquer domínios por erro e precisar remover uma reivindicação, consulte o artigo Gerenciar seus domínios Webex.

Códigos de erro do usuário final

A tabela a seguir descreve os códigos de erro do usuário final que podem ser vistos no portal de ativação do usuário do cliente.

Esta não é uma lista exaustiva de códigos de erros. A tabela lista apenas códigos de erro existentes para os quais o aplicativo Webex atualmente não fornece direção clara ao usuário.

Tabela 1. Tabela 1: Códigos de erro do usuário final

Código de erro

Mensagem de erro

Ação sugerida

100006

Falha no login: Usuário ID/Password está incorreto.

Verifique se o usuário está usando a senha correta. Se o modelo que você usou para provisionar a Organização do Cliente do usuário (no Partner Hub) estiver configurado para autenticação do BroadWorks, o usuário deverá inserir sua senha de "Acesso Web" do BroadWorks. O usuário também pode precisar inserir seu ID de usuário do BroadWorks se seu endereço de e-mail não estiver configurado como um ID de usuário alternativo.

Certifique-se de que o usuário digitou letras maiúsculas e minúsculas corretamente.

200010

Falha na validação de credenciais, pois usuário do BroadWorks não está autorizado.

O usuário deve tentar uma combinação diferente de nome de usuário e senha.

Caso contrário, o administrador deve redefinir a senha no BroadWorks.

200013

Desculpe, você não pode participar do <name of SP offer> com o Webex agora. Tente novamente em alguns minutos. Se o problema persistir, entre em contato com seu <customer organization administrator>.

Falha ao atualizar as informações do usuário no Common Identity. Atualize o usuário novamente usando a API do usuário.

200014

Entre em contato com seu <Service Provider> administrador.

Verifique se sua configuração está correta e se o ID de provisionamento está correto na solicitação.
200016Falha na validação de credenciais, pois sessão não encontrada.O usuário deve atualizar o navegador e tentar novamente o nome de usuário/senha.
200018Falha na validação de credenciais porque o usuário está bloqueado.O usuário deve esperar 10 minutos e depois tentar novamente.
200019Falha na validação de credenciais, pois a adição de usuário falhou na autoativação.O administrador deve verificar as configurações de autoativação no Control Hub.
200022Falha ao enviar e-mail porque o usuário não está autenticado.O usuário deve tentar novamente a integração e inserir credenciais.
200025Desculpe, você não pode participar da Autoativação neste momento. Tente novamente em alguns minutos. Se o problema persistir, entre em contato com o administrador do sistema.Peça para o usuário tentar novamente após alguns minutos. Se isso não funcionar, consulte o Suporte da Cisco.
200026Falha na validação do e-mail devido a falha na pré-verificação ou estado incorreto do usuário pendente para PartnerOrgUUID : {partnerOrgUUID} , BroadoworksUUID : {broadworksUUID} , ConfigSetUUID : {configSetUUID}O administrador deve informar o usuário que ele deu o endereço de e-mail errado já que o endereço de e-mail está associado a uma organização diferente.
200039Falha na validação do e-mail, pois o emailId já está em uso em uma organização diferente.O usuário deve tentar integração novamente no mesmo link de verificação, mas usando uma ID de usuário BroadWorks diferente.

Caso contrário, o administrador da organização do cliente da organização diferente deve excluir o administrador conta de usuário.

200040Falha na validação do e-mail, pois o configSet não corresponde ao configSet em customerConfig.O administrador deve comparar o link de verificação que o usuário usou com o link que está configurado no Control Hub. Os dois links e configSets devem corresponder.
200041Falha na validação do e-mail, pois o usuário já tem direito a outro serviço conflitante e direitos conflitantes.O usuário deve tentar a integração novamente no mesmo link de verificação usando uma ID de usuário broadworks diferente.

Caso contrário, o administrador da organização do cliente que gerencia o serviço conflitante deve excluir o serviço ou direitos conflitantes.

200042Falha na validação do e-mail, pois o e-mail já está associado a outro UserId do BroadWorks.O usuário deve tentar novamente com um endereço de e-mail diferente.

Caso contrário, o administrador deve excluir o outro usuário que usa este endereço de e-mail.

200043Falha na validação do e-mail, pois o mapeamento da configuração do cliente do usuário está incorreto.O usuário deve tentar novamente com um endereço de e-mail diferente. Caso contrário, o administrador deve excluir o outro usuário que usa este endereço de e-mail.
200044Falha na validação do e-mail, pois o userId já está em uso neste cluster do BroadWorks.O usuário deve tentar novamente com um endereço de e-mail diferente. Caso contrário, o administrador da organização do cliente que gerencia o sistema conta de usuário que usa esse endereço de e-mail deve excluir essa conta de usuário.
200045Falha ao adicionar o usuário por meio de autoativação, pois este já faz parte de uma organização diferente.O usuário deve tentar a integração novamente, mas com um endereço de e-mail diferente. Caso contrário, o administrador da organização do cliente que administrar a organização diferente deve excluir a conta existente.
200046Falha ao adicionar usuário por meio de autoativação, pois existem vários usuários pendentes com o mesmo broadworksUserId no mesmo cluster BroadWorks.O administrador deve excluir os usuários pendentes do Control Hub.
200047Falha ao adicionar usuário por meio de autoativação, pois o userId já está em uso neste cluster BroadWorks.O usuário deve tentar novamente com um endereço de e-mail diferente. Caso contrário, o administrador da organização do cliente que gerencia o sistema conta de usuário existente deverá excluir os direitos conta de usuário existentes ou remover outros direitos.
200048Falha ao adicionar o usuário por meio de autoativação, pois o endereço de e-mail já foi fornecido com um userId do BroadWorks diferente.O usuário deve tentar novamente com um endereço de e-mail diferente.
200049Falha ao adicionar usuário por meio de autoativação, pois o userId já está em uso neste cluster BroadWorks.O usuário deve tentar novamente com um endereço de e-mail diferente. Caso contrário, o administrador da organização do cliente que gerencia o sistema conta de usuário existente deverá excluir os direitos conta de usuário existentes ou remover outros direitos.
200050Falha ao adicionar usuário por meio de autoativação, pois o provisioningID não corresponde ao provisioningID esperado da empresa do assinante.O administrador deve comparar o link de verificação que o usuário usou com o link que está configurado no Control Hub. Os dois links e configSets devem corresponder.
200051Falha ao adicionar usuário por meio de autoativação, pois o spEnterpriseId especificado nesta solicitação entra em conflito com um Provedor de Serviços ou Empresa já provisionado deste Cluster BroadWorks.O administrador deve verificar as organizações existentes no Control Hub e certificar-se de que elas não estão criando uma organização com um nome que já existe.
200054Falha na validação do e-mail, pois a região da organização do cliente e a organização parceira não correspondem.O administrador deve verificar as configurações da organização do parceiro e da organização do cliente no Control Hub e certificar-se de que as regiões combinam.
300005Falha na pré-verificação porque o usuário já está na fila e no processo de provisionamento.O provisionamento de usuários ainda está em andamento. Aguarde alguns minutos e verifique novamente.

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

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

Código de 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.

600004A Sincronização do usuário do diretório externo do BroadWorks não está habilitada no ConfigSet.
600005A Sincronização do usuário do diretório externo do BroadWorks está em andamento no ConfigSet.
600006As 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.
600007A Organização da identidade do CustomerConfig não foi encontrada.
600008O CustomerConfig não foi encontrado na organização parceira.
600009A sincronização de usuário do diretório externo do Broadworks não pode ser executada porque o cluster do Broadworks associado ao CustomerConfig está ocupado.
600010A sincronização de usuário do diretório externo do Broadworks não pode ser executada porque não há nenhum cluster do Broadworks associado ao CustomerConfig.
600011A Sincronização do usuário do diretório externo do BroadWorks não está ativada no CustomerConfig.
600012A 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.
600013A 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.
600014Falha de Sincronização do Usuário do Diretório Externo do Broadworks ao tentar conectar ao grupo Bradworks. Erro da Broadworks - %s.
600015A Sincronização do Usuário do Diretório Externo do Broadworks não encontrou nenhum usuário correspondente no armazenamento de identidade.
600017A sincronização da lista de telefones BroadWorks falhou ao sincronizar todos os contatos de usuários e empresas/organizações.
600018A sincronização da lista de telefones BroadWorks falhou para usuários na empresa/organização.
600019A sincronização da lista de telefones BroadWorks falhou ao sincronizar contatos de empresas/organizações.
600020A sincronização de usuários do diretório externo BroadWorks não pode ser desativada porque a sincronização deconfiguração do cliente está em andamento.
600022A sincronização de usuários individuais do diretório externo BroadWorks não é possível, uma vez que a empresa não tem usuário provisionado.
600023A sincronização de usuários individuais do diretório externo BroadWorks não é possível porque o usuário já existe nesta organização.
600024Não é possível sincronização de usuários individuais do Diretório externo BroadWorks porque nenhum usuário correspondente foi encontrado no BroadWorks.
600025A sincronização de usuários do diretório externo BroadWorks falhou ao atualizar o conta de usuário em CI.
600026A sincronização de usuários do diretório externo BroadWorks falhou ao atualizar a conta de máquina em CI.
600027Não é possível sincronização de usuários individuais do Diretório externo BroadWorks porque vários usuários foram encontrados no BroadWorks.
600028O BroadWorks External Directory Single UserSync não é possível porque pelo menos uma sincronização de diretório empresarial deveria ter sido concluída.
600029A sincronização de usuários do diretório externo BroadWorks falhou, uma vez que a empresa não possui usuários provisionados.

Histórico de alterações

A tabela tem o histórico de alterações deste guia.

DataAlterar
23 de abril de 2025Pasta bwc removida da fonte de log do aplicativo BroadWorks Calling Webex .
29 de julho de 2023Referência adicionada ao Aplicativo Webex | Relatar um problema (para gerar logs) na seção Recuperar logs do usuário do Partner Hub e Obter logs ou feedback do cliente .
27 de junho de 2022Lista de leitura atualizada com link ausente no método de procedimento Migração do Connect (Android) para o Firebase.
21 de junho de 2022Os links ReadingList foram atualizados para apontar para novos URLs no Cisco.com. Atualizado Problemas de configuração e registro de chamadas adicionando um link para o Guia de configuração do Webex para Cisco BroadWorks para problemas com tags BroadWorks.
14 de abril de 2022Adicionadas instruções de contexto para Verificar detalhes do usuário no Help Desk e para Exibir organização do cliente no Help Desk para esclarecer os requisitos de função do Help Desk.
26 de março de 2022Adicionados novos códigos de erro para Códigos de erro para sincronização de diretório.
15 de novembro de 2021Adicionados os códigos de erro 200013, 200014, 200025 e 300005 aos Códigos de erro do usuário final.
28 de setembro de 2021Adicionados Códigos de erro para sincronização de diretório.
15 de julho de 2021Adicionada a mensagem de erro 100006 em Códigos de erro do usuário final. Também foi atualizado Problemas de login de usuários.
14 de julho de 2021Tópico adicionado com link para o artigo Problemas e limitações conhecidos .
02 de julho de 2021Nome do produto atualizado para nova marca do Webex.
18 de junho de 2021Logotipo do Webex atualizado nos gráficos.
08 de junho de 2021Adicionada a coluna Ação sugerida à tabela Códigos de erro do usuário final.
4 de junho de 2021Correção na tabela Códigos de erro do usuário final.
19 de maio de 2021Adicionada a seção Problemas de reivindicação de domínio.
22 de abril de 2021Atualizados Códigos de erro do usuário final com dois códigos adicionais: 200016 e 200054.
13 de abril de 2021Adicionadas informações sobre a conexão de manutenção do Webex.
08 de dezembro de 2020Documento atualizado. A marca Webex Teams para o Webex (aplicativo). Adicionados códigos de erro do usuário final.
03 de novembro de 2020Configurações de chamada adicionadas no Webview.
22 de outubro de 2020Novo documento introduzido.