05 de junho de 2025 | 35 visualização(ões) | 0 pessoas acharam que isso foi útil

Configurar notificações push de chamadas para Webex BroadWorks

list-menuComentários?
Aprenda a configurar notificações push de chamadas para o Webex para BroadWorks usando o NPS para Android e iOS.

Neste documento, usamos o termo Servidor para push de notificações de chamada (CNPS) para descrever um aplicativo hospedado por XSP ou hospedado por ADP que seja executado no seu ambiente. Seu CNPS trabalha com seu sistema BroadWorks para estar ciente das chamadas recebidas para seus usuários e enviará notificações delas para os serviços de notificação do Google Firebase Cloud Messaging (FCM) ou do serviço de notificação push da Apple (APNs).

Esses serviços notificam os dispositivos móveis do Webex para assinantes do Cisco BroadWorks que eles têm chamadas recebidas no Webex.

Para obter mais informações sobre o NPS, consulte a Descrição do recurso Servidor push de notificação.

Um mecanismo semelhante no Webex funciona com serviços de mensagens e presença do Webex para enviar notificações para os serviços de notificação do Google (FCM) ou Apple (APNS). Esses serviços por sua vez notificam os usuários Webex móveis sobre as mensagens recebidas ou as alterações de presença.

Esta seção descreve como configurar o NPS para proxy de autenticação quando o NPS ainda não oferece suporte a outros aplicativos. Se você precisar migrar um NPS compartilhado para usar o proxy NPS, consulte Atualizando o Cisco BroadWorks NPS para usar o proxy NPS.

Visão geral do proxy NPS

Para compatibilidade com o Webex com o Cisco BroadWorks, seu CNPS deve ser correção para suportar o recurso de Proxy NPS, Servidor Push para VoIP em UCaaS.

O recurso implementa um novo design no Servidor de Push de Notificação para resolver a vulnerabilidade de segurança do compartilhamento das chaves privadas do certificado de notificação com os provedores de serviços para clientes móveis. Em vez de compartilhar os certificados de notificação por push e chaves com o provedor de serviços, o NPS usa uma nova API para obter um token de notificação push curto do Webex para o backend do Cisco BroadWorks, e usa esse token para autenticação com os serviços Apple APNs e Google FCM.

O recurso também aprimora a capacidade do Servidor de Envio de Notificação para enviar notificações para dispositivos Android através da nova API do Google Firebase Cloud Messaging (FCM) HTTPv1.

Considerações sobre APNS

A Apple não suportará mais o protocolo binário baseado em HTTP/1 no serviço de Notificação Push da Apple após 31 de março de 2021. Recomendamos que você configure seu XSP|ADP para usar o HTTP/2-based interface para APNs. Esta atualização requer que seu XSP|ADP que hospeda o NPS esteja executando R22 ou posterior.

Prepare seu NPS para o Webex para o Cisco BroadWorks

1

Instale e configure um XSP dedicado (versão mínima R22) ou a Plataforma de entrega de aplicativos (ADP).

2

Instale os patches do proxy de autenticação NPS:

Patches XSP R22:

Patches XSP R23:

3

Ative o aplicativo Servidor push de notificação.

4

(Para notificações do Android) Habilita a API FCM v1 no NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Para as notificações do iOS da Apple) Habilita o HTTP/2 no NPS.

XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true

Isto é exclusivo para a versão 22 e versões anteriores; não está disponível na versão 23 e versões superiores, que suportam apenas HTTP/2.

6

Anexe um suporte técnico do NPS XSP/ADP.

7

Em cada servidor AS, o arquivo namedefs em /usr/local/broadworks/bw_base/conf deve ser configurado com registros SRV e A para o Notification Push Server (XSP/ADP) pesquisa, se houver vários XSP/ADP em seguida, adicione uma entrada para cada um, conforme necessário.

Exemplo: _pushnotification-cliente._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com EM A 10.193.78.149

Uma vez definido, um dos seguintes é necessário para aplicar as alterações:

  1. Uma reinicialização pode ser executada em uma janela de manutenção.

  2. Por meio do Cisco BroadWorks CLI:

    R24 e mais velhos

    AS_CLI/ASDiagnostic/DNS> recarregar

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> recarregar

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> recarregar

O que fazer em seguida

Para novas instalações de um NPS, vá para Configurar o NPS para usar o proxy de autenticação

Para migrar uma implantação existente do Android para o FCMv1, acesse Migrar NPS para FCMv1

Configurar o NPS para usar proxy de autenticação

Esta tarefa se aplica a uma nova instalação do NPS, dedicado à Webex para Cisco BroadWorks.

Se você quiser configurar o proxy de autenticação em um NPS compartilhado com outros aplicativos móveis, consulte Atualizando o Cisco BroadWorks NPS para usar o proxy NPS.

1

Obtendo credenciais OAuth para seu Webex para Cisco BroadWorks.

2

Crie a conta do cliente no NPS:

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientId client-Id-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Para verificar se os valores que você entrou está de acordo com o que você recebeu, execute XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

O CiscoCI issuerUrl SEMPRE deve ser o cluster US CI, independentemente da sua localização, e o padrão deve ser: 

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI> get issuerUrl = https://idbroker.webex.com/idb

3

Insira a URL do proxy NPS e de definida o intervalo de atualização do token (30 minutos recomendado):

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://nps.uc-one.broadsoft.com/nps/

Para melhorar a velocidade de resolução do DNS, em vez do FQDN atual nps.uc-one.broadsoft.com, recomendamos que você use o FQDN apropriado com base na sua região.

FQDNs baseados em região:

Leste dos EUA:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-a.wbx2.com/nps/

Oeste dos EUA:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-r.wbx2.com/nps/

Europa:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

Se as notificações push expirarem devido a um atraso na resolução do DNS, aumente o valor do tempo limite em "/etc/resolv.conf" arquivo no servidor BroadWorks.

4

(Para notificações do Android) Adicione a ID do aplicativo Android ao contexto de aplicativos FCM no NPS.

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.cisco.wx2.android

5

(Para as notificações do iOS da Apple) Adicione a ID do aplicativo ao contexto dos aplicativos APNS, certifique-se de omitir a tecla Auth - de definida como vazia.

XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

6

Configure as seguintes URLs NPS:

Contexto XSP|ADP CLI

Parâmetro

Valor

  • XSP|ADP_CLI/Applications/NotificationPushServer/FCM>

authURL

https://www.googleapis.com/oauth2/v4/token

pushURL

https://fcm.googleapis.com/v1/projects/PROJECT-ID/messages:send

scope

https://www.googleapis.com/auth/firebase.messaging

  • XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production>

url

https://api.push.apple.com/3/device

7

Configure os seguintes parâmetros de conexão NPS para os valores recomendados mostrados:

Contexto XSP|ADP CLI

Parâmetro

Valor

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Verifique se o Servidor de Aplicação está solicitando IDs de aplicativos, porque você pode precisar adicionar os aplicativos Webex à lista de permitir:

  1. Execute AS_CLI/System/PushNotification> get e verifique o valor de enforceAllowedApplicationList. Se for true, você precisa concluir esta subtarefa. Caso contrário, pule o resto da sub tarefa.

  2. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.wx2.android “Webex Android”

  3. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.squared “Webex iOS”

9

Reinicie o XSP|ADP: bwrestart

10

Teste as notificações de chamadas fazendo chamadas de um assinante do BroadWorks para dois usuários móveis Webex. Verifique se a notificação de chamada aparece em dispositivos iOS e Android.

Migrar NPS para FCMv1

Este tópico contém procedimentos opcionais que você pode usar no Google FCM Console quando você tiver uma implantação NPS existente que você precisa migrar para FCMv1. Existem três procedimentos:

Migrar clientes UC-One para FCMv1

Use as etapas abaixo no Google FCM Console para migrar clientes UC-One para o Google FCM HTTPv1.

Se a marca for aplicada ao cliente, o cliente deve ter a ID de Remetente. No console do FCM, consulte Configurações do Projeto > em Nuvem De Mensagens. A configuração aparece na tabela de credenciais do Projeto.

Para obter detalhes, consulte o Guia de Branding do Connect Mobile em https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Consulte o parâmetro gcm_defaultSenderId, que está localizado no Kit de Marca, pasta Recursos, arquivo branding.xml com a sintaxe abaixo:

xxxxxxxxxxxxx

  1. Faça logoff no SDK do administrador FCM em http://console.firebase.google.com.

  2. Selecione o aplicativo Android apropriado.

  3. Na guia Geral, grave a ID do projeto

  4. Navegue até a guia de contas de serviço para configurar uma conta de serviço. Você pode criar uma nova conta de serviço ou configurar uma existente.

    Para criar uma nova Conta de Serviço:

    1. Clique no botão azul para criar uma nova conta de serviço

    2. Clique no botão azul para gerar uma nova chave privada

    3. Baixar chave para um local seguro

    Para reutilizar uma conta de serviço existente:

    1. Clique no texto azul para visualizar contas de serviço existentes.

    2. Identifique a conta de serviço a ser usada. A conta de serviço precisa de permissão firebaseadmin-sdk.

    3. À direita, clique no menu hamburguer e crie uma nova chave privada.

    4. Baixe o arquivo json que contém a chave e salve em um local seguro.

  5. Copie o arquivo json para o XSP|ADP.

  6. Configure a ID do projeto e :

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add

  7. Configure o aplicativo:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add  projectId 
...Done

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
  Application ID    Project ID
==============================
          my_app    my_project

  8. Ativar FCMv1:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

  9. Execute o comando bwrestart para reiniciar o XSP|ADP.

Migrar clientes SaaS para FCMv1

Use as etapas abaixo no Console do Google FCM se você quiser migrar clientes SaaS para FCMv1.

Certifique-se que você já concluiu o procedimento "Configurar o NPS para usar o proxy de autenticação".

  1. Desativar FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
...Done

  2. Execute o comando bwrestart para reiniciar o XSP|ADP.

  3. Ativar FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

  4. Execute o comando bwrestart para reiniciar o XSP|ADP.

Atualizar servidor ADP

Use as etapas abaixo no Console do Google FCM se você estiver migrando o NPS para usar um servidor ADP.

  1. Obter o arquivo JSON do Google Cloud Console:

    1. No Google Cloud Console, vá para a página Contas de serviço.

    2. Clique em Selecionar umprojeto, escolha seu projeto e clique em Abrir.

    3. Localize a linha da conta de serviço para a qual deseja criar uma chave, clique no botão vertical Mais e, em seguida, clique em Criar chave.

    4. Selecione um tipo de Chave e clique em Criar

      O arquivo é baixado.

  2. Adicionar FCM ao servidor ADP:

    1. Importe o arquivo JSON para o servidor ADP usando o comando /bw/install.

    2. Faça logon ao ADP CLI e adicione as chaves de Projeto e API:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON :

    3. Em seguida, adicione o aplicativo e a chave:

      ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done

    4. Verifique a configuração:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g
Project ID Accountkey
========================
connect-ucaas ********

ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas
Este artigo foi útil?
Este artigo foi útil?
PreçosAplicativo WebexMeetingsCallingMensagensCompartilhamento de tela
Webex SuiteCallingMeetingsMensagensSlidoWebinarsEventosContact CenterCPaaSSegurançaControl Hub
Fones de ouvidoCâmerasSérie de mesaSérie de salasSérie de placasSérie de telefoneAcessórios
EducaçãoAssistência médicaGovernoFinanceiroEsportes e entretenimentoLinha de frenteOrganizações sem fins lucrativosInicializaçõesTrabalho híbrido
DownloadsEntrar em uma reunião de testeAulas on-lineIntegraçõesAcessibilidadeInclusividadeWebinars ao vivo e sob demandaComunidade WebexDesenvolvedores WebexNotícias e inovações
CiscoEntrar em contato com o suporteDepartamento de vendasWebex BlogLiderança inovadora WebexLoja de produtos WebexCarreiras
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
Termos e CondiçõesDeclaração de PrivacidadeCookiesMarcas registradas
©2026 Cisco e/ou suas afiliadas. Todos os direitos reservados.
Termos e CondiçõesDeclaração de PrivacidadeCookiesMarcas registradas