Os seguintes pré-requisitos devem ser concluídos para o provisionamento de BYoPSTN. Os pré-requisitos indicados abaixo assumem que o Parceiro tem uma implantação Webex para Cisco BroadWorks que inclui:

• Funcionando o sistema BroadWorks – conforme documentado no Guia de soluções Webex para Cisco BroadWorks

• BroadWorks COMO licença com o serviço "VoiceXML" em quantidade suficiente (1 por número PSTN)

• Patches BroadWorks necessários:

  Para R22:

  • AP.xsp.22.0.1123.ap376935

  • AP.as.22.0.1123.ap376935

  Para R23:

  • AP.xsp.23.0.1075.ap376935

  • AP.as.23.0.1075.ap376935

  Para R24

  • AP.as.24.0.944.ap376935

• Cisco CUBE System implantado (IOS versão 16.12.2 ou superior): https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/voice/cube/configuration/cube-book.html

  O CUBE virtual e baseado em hardware é compatível. O CUBE baseado em hardware é recomendado para escalabilidade e tratamento de números maiores de chamadas.

• Organização de parceiros Webex – conforme descrito no Guia de soluções Webex para Cisco BroadWorks

O procedimento que o parceiro da Cisco usa para adicionar os números de telefone de chamada de entrada da reunião Webex é o seguinte:

1. Faça logon no Cisco Partner Hub.

2. Vá para Configurações.

3. Role até BroadWorks Calling .

4. Em Configuração de entrada na reunião (BYoPSTN), selecione Criar número de telefone de chamada de entrada Grou p.

5. Insira o nome Grupo de números de telefone e selecione Próximo .

6. Insira os detalhes do Número de telefone e selecione Próximo .

7. Revise o resumo dos detalhes do grupo de números de telefone e selecione Salvar .

8. Repita este procedimento para que cada grupo de números de telefone seja adicionado.

As capturas de tela abaixo ilustram o procedimento.

Esta etapa só deve ser concluída se você quiser implantar a opção Entrar na reunião através do retorno de chamada. Caso contrário, você pode pular esta etapa.

Se você não configurar essa opção, os usuários poderão usar a opção Chamada de entrada para entrar em reuniões ou poderão entrar com o áudio do computador.

Quando você usa a opção Retorno de chamada de reunião, um grupo SRV DNS de retorno de chamada é necessário para rotear chamadas do Webex para o CUBE. O procedimento que o parceiro da Cisco usa para adicionar seus registros SRV DNS do CUBE ao Webex é o seguinte:

1. Faça logon no Hub de parceiros.

2. Vá para Configurações.

3. Role até BroadWorks Calling .

4. Em Configuração de entrada na reunião (BYoPSTN), selecione Criar grupo SRV DNS de retorno de chamada .

5. Insira o nome do grupo DNS SRV de retorno de chamada .

6. Selecione Próximo.

7. Insira os detalhes do SRV DNS de retorno de chamada.

8. Selecione Próximo.

9. Revise o resumo de detalhes do DNS SRV de retorno de chamada.

10. Selecione Salvar.

11. Provisione todas as atualizações do DNS para refletir os novos registros no grupo SRV DNS.

12. Repita este procedimento para cada grupo SRV DNS de retorno de chamada a ser adicionado.

As capturas de tela abaixo ilustram o procedimento.

A configuração inicial e a verificação da solução BYoPSTN exigem uma organização de sementes para cada combinação exclusiva de Grupo de números de telefone e Grupo DNS SRV de retorno de chamada (se for necessário o retorno de chamada). Portanto, é recomendável que os Parceiros da Cisco criem de forma semelhante um novo Modelo de cliente para cada combinação exclusiva de Grupo de números de telefone e Grupo SRV DNS de retorno de chamada. Cada modelo de cliente deve ser usado para gerar uma organização de seed correspondente.

Uma vez que a configuração BYoPSTN é semeada e verificada usando as organizações seed, os Grupos de números de telefone e os Grupos SRV DNS de retorno de chamada podem ser aplicados aos Modelos de clientes existentes conforme necessário.

Observe que os Modelos de Clientes recém-criados não estão em uso por clientes não-teste existentes e, portanto, podem ser usados com segurança para verificação manual da configuração BYoPSTN.

Se você não estiver implantando a Entrada na reunião através do retorno de chamada, você não precisa associar os grupos DNS SRV de retorno de chamada ao modelo do cliente. No entanto, você precisa selecionar Desativar retorno de chamada .

Para adicionar a um novo modelo de cliente, faça o seguinte:

1. Faça logon no Cisco Partner Hub.

2. Vá para Configurações.

3. Role até BroadWorks Calling .

4. Em Modelos , selecione Adicionar modelo .

5. Insira os detalhes do modelo. No estágio Tipo de pacote :

   • Selecione Tipo de pacote como Padrão .

   • Selecione Configuração de entrada na reunião como Números de chamada de entrada fornecidos pelo parceiro (BYoPSTN).

   • Selecione um grupo de números de telefone provisionado .

   • Para o grupo SRV DNS de retorno de chamada, se você quiser ativar a opção Retorno de chamada de reunião, selecione um grupo SRV DNS de retorno de chamada provisionado. Caso contrário, selecione Desativar retorno de chamada .

6. Selecione Próximo.

7. Insira os detalhes restantes do modelo.

8. Revise o resumo dos detalhes do modelo.

9. Clique em Salvar.

10. Repita este procedimento para cada modelo de cliente que deve ser adicionado

A captura de tela abaixo ilustra o procedimento.

Para atualizar um modelo de cliente existente, faça o seguinte:

1. Faça logon no Cisco Partner Hub.

2. Vá para Configurações.

3. Role até a seção Chamadas BroadWorks .

4. Em Modelos , selecione Exibir modelo .

5. Selecione o Modelo a ser atualizado.

6. Role até a seção Configuração de entrada na reunião :

   • Selecione Números de chamada de entrada fornecidos pelo parceiro (BYoPSTN).

   • Selecione um grupo de números de telefone configurado anteriormente .

   • Para Grupo SRV DNS de retorno de chamada , se você quiser ativar a opção Retorno de chamada de reunião, selecione um grupo SRV DNS de retorno de chamada provisionado. Caso contrário, selecione Desativar retorno de chamada .

7. Selecione Salvar.

   A captura de tela abaixo ilustra o procedimento.

A solução BYoPSTN tem vários componentes diferentes, cada um dos quais deve ser configurado corretamente para que a solução funcione com êxito. Uma das duas finalidades das organizações de soluções de sementes é gerar o número de telefone para os mapeamentos de códigos de acesso de reuniões e um identificador universal exclusivo do site de reunião (UUID do site) que são necessários para a operação contínua da solução. A outra finalidade é a verificação de configuração.

Para cada combinação exclusiva de grupo de números de telefone e grupo SRV DNS de retorno de chamada a ser usada, um modelo de cliente correspondente deve ser criado anteriormente. Para cada um desses Modelos de cliente, uma organização de solução de sementes deve ser provisionada. O provisionamento dessas organizações de seed gera o número de telefone para os mapeamentos de códigos de acesso de reunião e um UUID de site de reunião que é necessário para configurar o BroadWorks.

Usando cada um dos modelos de cliente configurados anteriormente, forneça um assinante para um novo provedor de serviços BroadWorks de teste ou novo BroadWorks Enterprise com um usuário Pacote padrão . O site da reunião Standard resultante deve estar usando a opção de entrada na reunião de números de chamada de entrada do Provedor de parceiros. Qualquer um dos seguintes métodos pode ser usado para provisionar o assinante:

1. Provisionar o assinante de teste usando APIs de assinantes BroadWorks conforme documentado em developer.webex.com.

2. Ative o assinante de teste para o serviço IM&P em um BroadWorks configurado para usar o modelo de cliente. Certifique-se de que o Modelo de cliente esteja usando o pacote Standard como padrão para garantir que o assinante de teste receba um pacote Standard. Alternativamente, o assinante de teste deve ser posteriormente atualizado para ter o pacote Padrão.

Observe que é recomendado que as organizações de soluções de sementes estejam associadas a um provedor de serviços BroadWorks de teste ou a uma empresa BroadWorks de teste.

É fundamental que este site de reunião permaneça provisionado, pois este UUID do site é enviado em cada solicitação de entrada de reunião de chamada de entrada como um token de autenticação. Você não deve excluir a organização de sementes, pois o site de reuniões associado também será excluído. Se a organização seed for removida, você precisará provisionar uma nova e reconfigurar o Broadworks com o novo site UUID.

As organizações de soluções primárias e secundárias de sementes podem ser excluídas, se desejado antes do conjunto de números de telefone e registros SRV DNS de retorno de chamada que estão sendo atribuídos a clientes não testados. Quando o conjunto de números de telefone e registros SRV DNS de retorno de chamada são atribuídos a qualquer cliente que não seja de teste, esses números de telefone e registros de retorno de chamada são associados aos sites de reunião para esses clientes e estão em uso para entrar na reunião usando a chamada de entrada e o retorno de chamada. Quaisquer alterações devem ser consideradas como impacto no serviço.

Para selecionar a Organização de Solução de Sementes Primárias, faça o seguinte:

1. Faça logon no Cisco Partner Hub.

2. Vá para Configurações.

3. Role até a seção Chamadas BroadWorks .

4. Na seção Validação de configuração (BYoPSTN) , selecione Atribuir .

5. Na tela Atribuir organização , pesquise e selecione uma das organizações de sementes previamente configuradas

6. Selecione Atribuir.

   A organização de sementes selecionada é a organização de sementes primária.

As capturas de tela abaixo ilustram o procedimento.

A organização principal da solução de sementes, os grupos de números de telefone e os detalhes do grupo SRV DNS de retorno de chamada para um determinado grupo BroadWorks estão disponíveis em um único local, o arquivo JSON de configuração BroadWorks (BYoPSTN). Essas informações são necessárias para configurar o BroadWorks para BYoPSTN.

Observe que o arquivo de configuração JSON está disponível apenas para visualização/download após a organização da solução de seed primária ser selecionada.

O procedimento para visualizar/baixar o arquivo de configuração JSON é o seguinte:

1. Faça logon no Cisco Partner Hub.

2. Vá para Configurações.

3. Role até BroadWorks Calling .

4. Em Clusters , selecione Exibir grupo .

5. Selecione o grupo associado aos modelos de cliente que estão configurados para BYoPSTN.

6. Role até a seção Configuração do BroadWorks para BYoPSTN.

7. Clique em Baixar o arquivo de configuração JSON .

8. Repita este procedimento para quaisquer outros grupos BroadWorks.

As capturas de tela abaixo ilustram o procedimento.

Consulte o exemplo do arquivo de configuração JSON abaixo. O arquivo contém informações complementares em cada grupo de números de telefone, grupo SRV DNS de retorno de chamada, os seguintes itens de configuração principais que devem ser inseridos no BroadWorks são marcados em negrito.

• siteUUID: O BroadWorks deve enviar esse valor nas mensagens SIP, é um token que o Áudio Webex Edge usa para confirmar a identidade do BroadWorks do parceiro da Cisco e seu acesso a sites de reuniões gerenciados por este parceiro da Cisco.

• Número de telefone -para- mapeamento do código de acesso: Os números de telefone e os códigos de acesso Webex associados devem ser configurados no BroadWorks.

  • número de telefone

  • Código de acesso

• LocaleTag: O idioma do anúncio desejado associado ao número de telefone deve ser configurado no BroadWorks.

• dnsSrv: O SRV DNS de retorno de chamada deve ser configurado no DNS e consulte as ocorrências do CUBE desejadas.

{
   "siteUUID": "491db0821791441a96c233fefb6c6dfc",
   "siteURL": " seedtestenterpriseabc.webex.com ",
   "partnerOrgId": "1da175de-3651-4467-b26b-b0d85a2cb3ad",
   "solutionValidationOrgId": "d927ac4d-3d73-4d7f-8506-a1bc0a221934",
   "customerTemplates": [
      {
         "name": "US West Std",
         "id": "27fe1337-ab1d-44b0-8b5e-ff1d32f6e3f8",
         "phoneNumberGroupId": "1bcb05bd-b919-45fd-b30e-71d2abb59e26",
         "callbackDnsSrvGroupId": "25392686-a390-49b9-bad5-cb47159c3e992"
      },
      {
         "name": "US East Std",
         "id": "070d6682-b64f-46ea-bc4b-b2e1218ba4bb",
         "phoneNumberGroupId": "12bc0b8f-ea1d-457f-8fe2-069ccf78907e",
         "callbackDnsSrvGroupId": "25392686-a390-49b9-bad5-cb47159c3e992"
      }
   ],
   "phoneNumberGroups": [
   {
         "name": "US West",
         "id": "1bcb05bd-b919-45fd-b30e-71d2abb59e26",
         "phonenumbers": [
            {
               "id": "617c5faa-1721-45c7-bc70-e6d7c20ccc29",
               "name": "US Palo Alto",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "TollFree",
               "defaultPhoneNumberType": "NONE",
               "phoneNumber": "9863502478",
               "accessCode": "88672693772924908359"
            },
            {
               "id": "48fa7c50-9da0-4c8b-9b2f-307ff435c7c7",
               "name": "US Toll San Francisco",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "PRIMARY",
               "phoneNumber": "4156551000",
               "accessCode": "88652789466280320324"
            }
         ]
      },
      {
         "name": "US East",
         "id": "12bc0b8f-ea1d-457f-8fe2-069ccf78907e",
         "phonenumbers": [
            {
               "id": "ca0c622a-8621-4477-91e0-b3e214833568",
               "name": "US Maryland",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "PRIMARY",
               "phoneNumber": "2403332200",
               "accessCode": "88631321777971704941"
            },
            {
               "id": "00875574-9a46-4447-a967-350b6176755a",
               "name": "US Florida",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "SECONDARY",
               "phoneNumber": "9049002303",
               "accessCode": "88632627551145646175"
            },
            {
               "id": "a2c10316-9266-4423-a669-d67949f99d33",
               "name": "US New York",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "TollFree",
               "defaultPhoneNumberType": "NONE",
               "phoneNumber": "8056504578",
               "accessCode": "88649679020033567943"
            }
         ]
      }
   ],
   "callbackDnsSrvGroups": [
      {
         "name": "CB US",
         "callbackDnsSrvs": [
            {
               "name": "Callback US",
               "countryCode": "US",
               "dnsSrv": "cube.us.example.com",
               "id": "c5209d17-7c2f-45b3-95a6-65d7f5f53c7e"
            }
         ],
         "id": "25392686-a390-49b9-bad5-cb47159c3e992"
      },
      {
         "name": "CB MX",
         "callbackDnsSrvs": [
            {
               "name": "Callback MX",
               "countryCode": "MX",
               "dnsSrv": "cube.mx.example.com",
               "id": "cca0e4c3-5cff-412c-a854-bfb719f603a2"
            }
         ],
         "id": "36403797-b401-50c0-cbe5-dc58260d4f003"
      }
   ]
}

O domínio SRV DNS do áudio Webex Edge deve ser configurado no BroadWorks. Use o procedimento a seguir para determinar o valor.

1. Faça logon no Cisco Partner Hub.

2. Vá para Clientes .

3. Selecione a empresa de validação de BYoPSTN.

4. Selecione Visualizar cliente.

5. Vá para Serviços/Reuniões .

6. Selecione o site de reunião do pacote Padrão.

7. Role até a parte inferior do painel lateral, selecione Configurar site .

8. Selecione Configurações comuns / Configurações de áudio .

9. Na seção Números de chamada de entrada global personalizados do Edge Audio , selecione Gerar Lua Script .

10. Na janela pop-up, procure o valor "-- Atualizar Para cabeçalho com URL CCAX".

     
    -- Update To header with CCAX URL
     local oldTo1 = msg:getHeader("To")
     local newTo1 = string.gsub(oldTo1, "<sip:(.+)@(.*)>", "<sip:%1@ecccx.amer.webex.com>")
     msg:modifyHeader("To", newTo1)
    

11. Extraia o valor em negrito, por exemplo, ecccx.amer.webex.com.

Este é o domínio SRV DNS do áudio Webex Edge que deve ser configurado no BroadWorks.

Esta seção descreve a configuração do BroadWorks necessária para implementar os cenários de Chamada de entrada e Retorno de chamada de reunião mostrados nos diagramas abaixo. Os exemplos de configuração são baseados nos dados no arquivo JSON mostrado na seção anterior. Números, domínios, nomes de empresas/grupos, tipos de dispositivos, políticas, perfis, etc. devem variar de acordo com o parceiro.

Fluxo de chamadas:

1. O usuário solicita o retorno de chamada, o Webex inicia um retorno de chamada.
2. A chamada é roteada para o BroadWorks OTT.
3. A chamada atinge o CUBE provisionado na CH. O CUBE encaminha a chamada para o BroadWorks.
4. O BroadWorks identifica a chamada como origem do organizador da reunião e cria uma sessão para o usuário organizador da reunião e processa a chamada.
5. A sessão do usuário organizador da reunião processa a chamada e traduz o número discado. Além disso, um registro de cobrança é gerado em nome do usuário organizador da reunião.
6. O BroadWorks roteia a chamada para o usuário associado ao dispositivo (7) ou para o PSTN (8).

Antes de Começar

A comunicação SIP entre o BroadWorks e o CUBE pode ser através de UDP ou TCP, dependendo dos requisitos de rede. Por exemplo, se alguns dispositivos de rede ou de acesso (por exemplo, gateways ou terminais) nos fluxos de chamada de entrada ou de retorno de chamada BYoPSTN não suportarem TCP, o UDP deverá ser usado.

A configuração e os exemplos mostrados neste guia usam TCP como o protocolo de transporte. Para usar o TCP, certifique-se de que o servidor de aplicativos BroadWorks e o servidor de rede estejam configurados para TCP:

_CLI/Interface/SIP> get
networkProxyTransport = unspecified
accessProxyTransport = unspecified
supportDnsSrv = true
supportTcp = true

Servidor da aplicação

Tipo de perfil de identificação/dispositivo

Um novo tipo de perfil de identidade/dispositivo deve ser criado para representar o CUBE. Certifique-se de definir as seguintes propriedades abaixo, enquanto outras podem ser deixadas em valores padrão:

• Tipo de endereço de sinalização— Definir para endereçamento de proxy inteligente

• Autenticação —Definida como Ativada

• Identidade de suporte em ATUALIZAÇÃO e reconvite —Marcada

• Registro estático habilitado —Definido para Ativado

• Capaz de vídeo —Definido para Desativado

No exemplo abaixo, o novo tipo de perfil de identidade/dispositivo "VXML _profile" é criado para representar o CUBE.

Assinante virtual de voz XML

Criar uma instância de VoiceXML

Cada número PSTN do Webex Meetings é representado por um assinante virtual no BroadWorks e a funcionalidade de assinante virtual VoiceXML pode ser usada. Recomenda-se que uma empresa e um grupo dedicados sejam usados para todos os assinantes virtuais VoiceXML. Observe que na verdade não estamos explorando nenhuma capacidade do VoiceXML, mas esse tipo de usuário virtual é adequado para interagir com o CUBE.

Para usar o serviço VoiceXML, certifique-se de que a licença tenha quantidades suficientes de "VoiceXML" e que o serviço seja autorizado nos níveis da empresa e do grupo, e que o serviço VoiceXML seja atribuído ao grupo conforme mostrado na imagem de exemplo abaixo.

Sob Grupo > Serviços , selecione VoiceXML e crie uma instância para cada número PSTN.

Configurar endereços VoiceXML

Para cada instância de VoiceXML, forneça o seguinte sob os Endereços de VoiceXML:

• Número de telefone —Insira o número de discagem do site Webex Meetings (por exemplo, 2403332200).

• Ramal

• Perfil de identidade/dispositivo —Crie uma instância (por exemplo, VXML _device Prof) com base no tipo de dispositivo criado na seção anterior (VXML _profile no exemplo) e insira a seguinte configuração.

• Linha/porta —Insira no formato <access number="">@<domain> , onde

  • <access number=""> é o número do código de acesso para o site Webex Meetings (disponível no arquivo JSON) (por exemplo, 88631321777971704941)

  • <domain> é o domínio do áudio Webex Edge para este site de reunião (por exemplo, ecccspx.amer.pub.webex.com)

• sip de contato —Para chamadas de entrada da reunião para o número de acesso, o INVITE será enviado com uma URI de solicitação definida para o valor deste campo. Insira o contato SIP neste formato <sip contact="">;<Locale>;<Meetings Site="" UUID="">;<SIP transport="">, onde:

  • <sip contact=""> é o <number> campo da linha/porta, mas com o domínio como o SRV que resolve para o endereço do CUBE (por exemplo, 88631321777971704941@cube.internal.local)

  • <Locale> representa a configuração do idioma de acordo com a localidade do usuário (por exemplo, locale=en_ US)

  • <Meetings Site="" UUID=""> é UUID do site do arquivo JSON (por exemplo, x-cisco-site-uuid=abbd70f6c519fb1ee053ad06fc0a038b)

  • <SIP transport=""> deve ser transport=tcp para ter o AS use TCP para enviar mensagens para o CUBE.

Veja abaixo um exemplo das configurações de Endereços VoiceXML.

Para cada número de acesso de Reunião adicional a ser usado, um assinante virtual VoiceXML adicional deve ser criado análogo ao acima. O mesmo perfil de dispositivo pode ser usado, mas os campos Porta de linha e Contato devem ser criados a partir das informações do número de acesso, conforme mostrado acima.

Certifique-se de verificar se os limites da Política de processamento de chamadas que você configura no assinante virtual BroadWorks são suficientes para lidar com as chamadas BYoPSTN extras no seu grupo de números de telefone.

Atribuir autenticação SIP à instância de VoiceXML

Atribua o serviço de autenticação ao assinante virtual VoiceXML. Isso será usado para autenticar mensagens de CONVITE SIP do CUBE no cenário de Retorno de chamada. Ele também impede que o assinante virtual VoiceXML aceite chamadas de partes diferentes do CUBE

Vá para a página de Autenticação do assinante virtual em Utilitários e insira o nome de usuário e a senha SIP, conforme mostrado abaixo:

o CUBE deve ser configurado com o mesmo nome de usuário e senha para autenticar corretamente as mensagens INVITE enviadas para o AS. Um exemplo do comando para configurar a autenticação SIP no CUBE é o seguinte: sip-ua authentication username VSUB password 0 <unencrypted password> (See the CUBE onfiguration/datafill for more details).

Arquivo Namedefs

O campo de contato SIP do assinante virtual VoiceXML contém a URL onde a parte do domínio resolve para o endereço CUBE. Este é um SRV interno e o arquivo namedefs no AS pode ser usado para resolver o SRV interno para o IP do CUBE.

Em nosso exemplo, o SRV de contato SIP é cube.internal.local e resolve abordar a porta 10.165.196.30 5060 para alcançar o CUBE. No AS, o /usr/local/broadworks/bw_base/conf/namedefs o arquivo é atualizado da seguinte forma:

_sip.tcp.cube.internal.local SRV 1 99 5060 10.165.196.30

Tipo de chamada do Webex Meetings

As opções de configuração de processamento de chamadas do Webex Meetings estão disponíveis para controlar como as chamadas de entrada da reunião são tratadas. Por padrão, as chamadas de entrada da reunião são processadas como chamadas externas, pois os números de chamada de entrada são hospedados em uma empresa ou provedor de serviços dedicado. As chamadas externas são normalmente incluídas nas contagens da sessão de controle de admissão de sessão e sinalizadas para carregamento no campo CDR chargeIndicator .

O exemplo a seguir adiciona a configuração recomendada para processar as Chamadas de entrada da reunião como chamadas internas, de modo que elas sejam excluídas do carregamento e excluídas das contagens do Controle de admissão da sessão.

Ao definir Aplicar campo de carga NS como verdadeiro, a população do campo CDR chargeIndicator é baseada no atributo de carga configurado do tipo de chamada do servidor de rede.

AS_CLI/System/CallP/WebexMeetings/WebexCallTypes> add "Webex Meetings" WXM true true

AS_CLI/System/CallP/WebexMeetings/WebexCallTypes> get
      Name    NS Call Type    Enforce NS Charge Field  Process As Internal For SAC-Subscriber
  ==========================================================================================
  Webex Meetings       WXM               true                                true

Assinante virtual de retorno de chamada de reunião VoiceXML

Criar um assinante de retorno de chamada de reunião VoiceXML

Um assinante virtual VoiceXML dedicado com uma opção especial de retorno de chamada de reunião Webex (doravante chamado de assinante de retorno de chamada de reunião VoiceXML) precisa ser configurado no servidor de aplicativos BroadWorks (AS) para lidar com as chamadas de retorno de chamada Webex Meetings. Apenas uma única ocorrência deste assinante pode ser configurada no AS.

Para ativar o recurso, defina o recurso ativável 102074 como verdadeiro via CLI.

AS_CLI/System/ActivatableFeature> activate 102074
***** Warning *****:
This activity should only be done during a maintenance window because
this may cause large amounts of data to be added/modified/deleted and
it may take some time to execute. Features that have web page impacts
require that users and administrators log out and log back in.
Are you sure you want to continue?

Please confirm (Yes, Y, No, N): y
...Done

AS_CLI/System/ActivatableFeature> get

      Id                                               Description  Activated  Last Modified Timestamp
=============================================================================================
  102746                            BroadWorks Support for CI UUID       true
  102074          BYO PSTN Billing support for CallBack and CallIn       true      
  104256                          Weak Password Validation Service      false
  104073  Add FAC Support for Call Center Agent Join-Unjoin in CDR      false
  103542   Configurable Endpoint For Auto-Answer And Forced Answer      false
  104255    Control password usage and behavior to ensure security      false

Uma vez que o recurso "BYO PSTN Billing support for CallBack and CallIn" depende do recurso "BroadWorks Support for CI UUID", antes de ativar (102074), você também precisa ativar (102746). Para obter mais detalhes, consulte a seção "Sincronização de UUID do Usuário CI (Suporte do Broadworks para UUID do CI)".

O assinante de retorno de chamada da reunião VoiceXML é semelhante ao assinante virtual BYOPSTN VXML existente, mas marcou-o com um novo sinalizador de "Retorno de chamada de reunião Webex". Este assinante de retorno de chamada de reunião VoiceXML é configurado com o mesmo perfil de dispositivo do assinante virtual BYOPSTN VXML existente, bem como o serviço de Autenticação com as mesmas credenciais.

Um exemplo é mostrado abaixo:

O assinante de retorno de chamada da reunião VoiceXML deve existir no AS hospedando o usuário organizador da reunião. Quando o AS recebe a solicitação de CONVITE de retorno de chamada da reunião, ele tenta localizar o usuário de retorno de chamada da reunião VoiceXML e o usuário organizador da reunião no AS durante a configuração da chamada. Se nenhum desses usuários for encontrado, a chamada será rejeitada.

Sessão do organizador da reunião

No cenário de retorno de chamada com o cabeçalho X-Cisco-Meet-Info, o servidor de aplicativos do Cisco BroadWorks recebe uma solicitação de CONVITE SIP e identifica o usuário do organizador da reunião usando o parâmetro UUID do usuário CI do organizador do cabeçalho SIP X-Cisco-Meet-Info. Uma sessão de chamada é criada em nome do usuário organizador da reunião, criada para processar a chamada e executar o perfil de serviço do usuário. Além disso, um registro de cobrança é gerado em nome do usuário organizador da reunião. A ID da reunião e as informações UUID do site do cabeçalho SIP X-Cisco-Meet-Info são capturadas no registro de cobrança.

Um exemplo do cabeçalho SIP X-Cisco-Meet-Info é mostrado abaixo:

X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab
-04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec

Plataforma de entrega de aplicativos

Sincronização UUID do usuário CI (Suporte do Broadworks para UUID CI)

O UUID CI do usuário é um identificador exclusivo para identificar usuários dentro do ambiente Webex.

Este aplicativo Webex Provisioning Sync na Plataforma de entrega de aplicativos (ADP) do Cisco BroadWorks é usado para sincronizar, mapear e armazenar o UUID do CI do usuário na infraestrutura do BroadWorks de modo que ele possa ser usado em várias interações com o serviço Webex e Webex para BroadWorks.

Consulte " Ativar o retorno de chamada de reunião Webex" sobre como a associação CI User UUID é usada pelo servidor de rede do Cisco BroadWorks e pelo servidor de aplicativos Cisco BroadWorks.

As etapas a seguir configuram o aplicativo Webex Provisioning Sync para sondar e atualizar periodicamente os usuários do BroadWork com o UUID CI.

O aplicativo Webex Provisioning Sync requer credenciais OAuth com o spark-admin:broadworks_subscribers_read escopo para o provedor de identidade da Cisco e pode ser obtido levantando uma solicitação de serviço com o seu agente de integração.

Verifique a seção "Obtendo credenciais OAuth do seu Webex para Cisco BroadWorks" para obter mais detalhes sobre a solicitação de serviço em: https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cloudCollaboration/wx4bwks/Solution_Guide/wbxbw_b_solution-guide/wbxbw_b_SolutionGuide-PDF_chapter_01.html?bookSearch=true#Cisco_Generic_Topic.dita_0e1beabc-80ae-4e8d-b177-17108ec5daed

Adicione o token com um nome de parceiro apropriado da seguinte forma:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> add custBYO refreshToken
      New Password:
      Re-type New Password:
      ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> get
       Partner Name  Refresh Token
==================================
  FederationPartner       ********
           custPart       ********
            custBYO       ********

Adicione o nome do parceiro associado ao token OAuth à lista de parceiros a serem monitorados pelo aplicativo Webex Provisioning Sync com o sinalizador "habilitado" definido como "verdadeiro".

Este aplicativo de sincronização de provisionamento Webex começará a fazer a sincronização UUID do usuário CI no intervalo de sondagem definido.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> add custBYO true

Depois que o parceiro for incluído, o aplicativo Webex Provisioning Sync agora poderá executar a associação do UUID CI aos usuários do BroadWorks.

Altere o tempo limite da conexão usando os seguintes comandos:

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> set requestTimeout 30000
...Done

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> get
requestTimeout = 30000

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> cd http

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller/Http> set connectionTimeout 300
*** Warning: BroadWorks needs to be restarted for the changes to take effect ***

ADP_CLI/Application/WebexProvisioningSync/GeneralSetting/Controller/HTTP > get
connectionPoolSize = 5
connectionTimeout = 300
connectionIdleTimeOut = 300
maxConcurrentRequests = 10
maxCookieAgeInHours = 24

Essa associação pode ser feita de forma automática ou manual. O comando CLI manualSync pode acionar instantaneamente a associação para ocorrer.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> manualSync custBYO

Parceiros com "Ativado" definido como "verdadeiro" executam o associado no intervalo de sondagem. Durante a associação inicial, o aplicativo Webex Provisioning Sync consulta a API do assinante Webex para recuperar os dados que contêm o UUID CI para todos os usuários hospedados pelo parceiro. A ID externa do usuário BroadWorks é atualizada com o UUID do CI associado. As associações subsequentes afetam os usuários adicionados ao parceiro. O comando de status pode ser usado para ver se a sincronização está concluída.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> status
  Partner Name         Status                 Last Sync Time
============================================================
       custBYO  synchronizing
      custPart     monitoring  2023-01-29T15:36:43.873-05:00
2 entries found.

Depois que a sincronização for concluída, o status será alterado de volta para monitoramento. A sincronização subsequente é executada nos usuários adicionados ao parceiro após a "Hora da última sincronização".

A figura a seguir mostra o UUID do CI definido na ID externa:

Servidor de Rede

Tipo de chamada

Para fins de faturamento e relatório, pode ser desejável marcar CDRs para chamadas de entrada do Meetings. Isso pode ser feito usando a política de preCallTyping do servidor de rede.

Primeiro, no CLI NS em /System/CallP/CallType, adicione um novo tipo de chamada. O exemplo a seguir adiciona o novo tipo de chamada "WXM":

NS_CLI/System/CallP/CallTypes> add WXM LOCAL true false "Webex Meetings"
NS_CLI/System/CallP/CallTypes> get calltype WXM    
  CallType     Description  Category         Scope  SupportE164  Charge      
=======================================================================    
  WXM          Webex Meetings  LOCAL  User Defined         true   false

O tipo de chamada pode ser usado em uma ocorrência de PreCallTyping que faz parte do perfil de roteamento do usuário BroadWorks. Neste exemplo, uma nova ocorrência de PreCallTyping "wxm" foi adicionada no contexto de CLI de /Policy/PreCallTyping, mas pode ser uma ocorrência de PreCallTyping existente já em uso:

NS_CLI/Policy/PreCallTyping> add wxm true CallTypes ALL

NS_CLI/Policy/PreCallTyping> get wxm                        
Policy: PreCallTyping  Instance: wxm                        
  CallTypes:                                
    Selection = {ALL}                                
    From = {PCS, ALL, TRMT, LO, GNT, DP, WXM, LPS, OA, TPS, EA, FGB, POA, SV, SVCD, IN, MS, CSV, EM, SVCO, SMC, ZD, NIL, CT, TF, GAN, TO, DA, OAP}        
  supportLCABasedNormalization = false                        
  Enable = true 

O próximo passo é adicionar entradas à instância de PreCallTyping para todos os números de discagem no contexto de CLI /Policy/PreCallTyping/DialPlan. Por exemplo:

NS_CLI/Policy/PreCallTyping/DialPlan> add wxm 1 dflt 12403332200 12403332200 exact 11 11 WXM 0 0 Webex Meetings
NS_CLI/Policy/PreCallTyping/DialPlan> add wxm 1 dflt_e164 12403332200 12403332200 exact 11 11 WXM 0 0 Webex Meetings

NS_CLI/Policy/PreCallTyping/DialPlan> get wxm 1                
Policy: PreCallTyping  Instance: wxm  Table: DialPlan                
CC Dial Plan   From     To          Match Min Max Call Type Prefix Action  Call Ind  Description                  
================================================================================================
1 dflt      12403332200 12403332200 {exact} 11 11 {WXM}     0                      Webex Weetings
1 dflt_e164 12403332200 12403332200 {exact} 11 11 {WXM}     0                      Webex Meetings

A instância de PreCallTyping é então adicionada (desde que ainda não exista) ao perfil de roteamento aplicável do usuário de origem, conforme mostrado no exemplo abaixo:

NS_CLI/Policy/Profile> add Profall PreCallTyping wxm
NS_CLI/Policy/Profile> get profile Profall
Profile:  Profall
                 Policy              Instance
   ==========================================
             CallTyping           DefaultInst
          CallScreening           DefaultInst
            SubLocation           DefaultInst
              FarEndRtg           DefaultInst
             NearEndRtg           DefaultInst
             UrlDialing           DefaultInst
            MediaSrvSel           DefaultInst
                 SIMPLE           DefaultInst
              DstSvcRtg           DefaultInst
      NumberPortability           DefaultInst
             RCBasedRtg           DefaultInst
      NetVoicePortalRtg           DefaultInst
          PreCallTyping                   wxm    

BroadWorks originando CDR's são gerados apenas por chamadas originadas de assinantes BW. As chamadas originadas de PSTN do lado "rede" do AS não gerarão CDR's originários. Haverá um CDR de encerramento para o assinante virtual VoiceXML em qualquer um dos casos.

RoutingNE

Uma RoutingNE é necessária no NS no contexto de /System/Device/RoutingNE CLI para representar o CUBE. Dessa forma, quando o NS receber o CONVITE do CUBE, ele corresponderá ao cabeçalho via à entrada RoutingNE provisionada no NS. Consulte o Guia de administração da interface de linha de comando do servidor de rede do Cisco BroadWorks para obter detalhes sobre como adicionar um RoutingNE.

Veja abaixo um exemplo dos comandos para adicionar o RoutingNE "WebexMeetings", onde o endereço IP do CUBE = 10.165.196.30. O exemplo também mostra comandos para criar novas instâncias do OrigRedirect e do Profile a serem associadas ao RoutingNE, mas as instâncias existentes também podem ser usadas.

NS_CLI/Policy/OrigRedirect> add wxm_Inst true CallTypes ALL supportTrunkGroupLookups disable applyAccessSideRules enableRestrictive

NS_CLI/Policy/OrigRedirect> get  wxm_Inst
Policy: OrigRedirect  Instance: wxm_Inst
  Enable = true
  CallTypes:
    Selection = {ALL}
    From = {PCS, ALL, TRMT, LO, GNT, DP, WXM, LPS, OA, TPS, EA, FGB, POA, SV, SVCD, IN, MS, CSV, EM, SVCO, SMC, ZD, NIL, CT, TF, GAN, TO, DA, OAP}
  supportTrunkGroupLookups:
    Selection = {disable}
    From = {disable, enablePermissive, enableRestrictive}
  applyAccessSideRules:
    Selection = {enableRestrictive}
    From = {disable, enablePermissive, enableRestrictive}

NS_CLI/Policy/Profile> add wxm_routing

NS_CLI/Policy/Profile> add wmx_routing OrigRedirect wxm_Inst

NS_CLI/Policy/Profile> add wmx_routing SubLocation  DefaultInst

NS_CLI/Policy/Profile> get profile wxm_routing 
Profile:  wxm_routing
                 Policy              Instance
   ==========================================
           OrigRedirect           wxm_Inst
            SubLocation           DefaultInst

NS_CLI/System/Device/RoutingNE> add  WebexMeetings 1240364 1 99 wxm_routing false OnLine AccessRoutingNE

NS_CLI/System/Device/RoutingNE/Address> add WebexMeetings 10.165.196.30 1 99 tcp

NS_CLI/System/Device/RoutingNE> get
Network Element  WebexMeetings
   Location      =  1240364
   Static Cost   =  1
   Static Weight =  99
   Poll          =  false
   OpState       =  enabled
   State         =  OnLine
   Profile       =  wxm_routing
   Signaling Attributes=  AccessRoutingNE
 
NS_CLI/System/Device/RoutingNE/Address> get
Routing NE   Address     Cost    Weight     Port    Transport Route  
WebexMeetings   10.165.196.30     1      99     -          tcp

Com a configuração de exemplo, o CUBE envia ao NS um INVITE semelhante ao seguinte (campos importantes em negrito):

INVITE sip:+19991111111@domain.com:5060 SIP/2.0
Via:SIP/2.0/TCP 10.10.10.10:5060;branch=z9hG4bK7C7B9EB
Remote-Party-ID:" BroadWorks
"<sip:886222222222@domain.com>;screen=no;party=calling;privacy=off
From:" BroadWorks "<sip:+12403333333@10.20.20.20>;tag=958BDDF4-1AB
To:<sip:+19991111111@domain.com>
Date:Thu, 03 Nov 2022 12:39:58 GMT
Call-ID:75D3B642-5AAB11ED-AC82BA3C-276254A1@10.20.20.30
Supported:100rel,timer,resource-priority,replaces,sdp-anat
Min-SE:14400
Cisco-Guid: 1976459008-1521160685-2893855292-0660755617
X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec"
X-Cisco-Org-Id:82e2eb35-1610-44e7-9b20-ab607e026270
User-Agent: Cisco-SIPGateway/IOS-16.12.2s
Timestamp: 1667479198
Session-ID:
e13cc71f24ae400669d5247d8306ac23;remote=00000000000000000000000000000000
Allow:INVITE,OPTIONS,BYE,CANCEL,ACK,PRACK,UPDATE,REFER,SUBSCRIBE,NOTIFY,INFO,REGSTER
CSeq:101 INVITE
Contact:<sip:+12403333333@10.20.20.20:5060;transport=tcp>
Expires:180
Allow-Events:telephone-event
Max-Forwards:68

Onde:

• A URI de solicitação de convite contém o número de retorno de chamada

• Via cabeçalho: contém o endereço IP do CUBE que será usado para selecionar o perfil RoutingNE.

• Cabeçalho X-Cisco-Info-Meet: usado para identificar hostCIUserUuid, meetingid e siteUUID.

Ao receber o INVITE, o NS usa o cabeçalho Via para corresponder ao RoutingNE “WebexMeetings”. Isso, por sua vez, selecionará o perfil de roteamento "wxm_routing" que contém a instância "wxm_ Inst" do OrigRedirect.

A política do NS OrigRedirect corresponderá ao cabeçalho do X-CISCO-MEET-INFO:

X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec

com a Porta de linha configurada no assinante virtual VoiceXML e enviar um redirecionamento 302 para o par AS que hospeda esse assinante. A mensagem 302 é semelhante ao seguinte:

SIP/2.0 302 Moved temporarily
Via:SIP/2.0/TCP 10.165.196.30:5060;branch=z9hG4bK5452684
From:" Webex "<sip:+12403332200@10.165.196.30>;tag=8EEAA586-1675
To:<sip:+14519615001@10.155.6.172>;tag=394411970-1602687588994
Call-ID:ABC5CCA2-D6411EB-8AD6D92D-EE20F768@10.165.196.30
CSeq:101 INVITE
Contact:<sip:+14519615001@hs2-bwks-v-as01-alpha.bwlab.org:5060;user=phone> ;q=0.5, <sip:+14519615001@hs2-bwks-v-as02-alpha.bwlab.org:5060;user=phone>;q=0.25
Content-Length:0

Alias

O domínio no INVITE URI (no exemplo, é bw.myenterprise.com) enviado pelo CUBE para o NS tem que ser reconhecido pelo NS. Isso pode ser feito adicionando o domínio no contexto NS _ CLI/System/Alias, por exemplo:

NS_CLI/System/Alias> add bw.myenterprise.com

O comando para configurar o domínio INVITE URI no CUBE pode ser encontrado na próxima seção, em dial-peer/session target, por exemplo:

dial-peer voice 23401 voip
session target dns:bw.myenterprise.com

HostingNE

Para oferecer suporte às opções de configuração de processamento de chamadas Webex Meetings para controle de admissão de sessão e cobrança, os atributos de sinalização NE de hospedagem do servidor de aplicativos CallTypeInfoRequired e RequiresChargeIndication devem estar ativados no contexto NS_CLI/System/Device/HostingNE._ Por exemplo:

NS_CLI/System/Device/HostingNE> set broadworksASHostNe signaling E164Compliant,
 CallTypeInfoRequired, SourceId, RequiresNetworkIndication RequiresChargeIndication;

Ativar o retorno de chamada da reunião Webex

No cenário de retorno de chamada com o cabeçalho SIP X-Cisco-Meet-Info, o CUBE envia a chamada para o servidor de rede para o redirecionamento do originador para o par AS. O par AS é determinado com base no parâmetro do sistema enableWebexMeetingHoostLookup .

NS_CLI/System/CallP/Options> get
  accessSideRoutingNeDeterminedViaSignaling = false
  disableNdcValidationForCalledNumbers = true
  forceRoutingNEProfile = false
  skipPrivatePoliciesOnEmergency = true
  maxReturnedContacts = 10
  enableWebexMeetingHostLookup = true

Quando enableWebexMeetingHoostLookup o parâmetro do sistema está definido como verdadeiro, o UUID do CI do usuário do organizador da reunião no cabeçalho X-Cisco-Meet-Info é usado para identificar o par AS que hospeda o usuário organizador da reunião.

INVITE sip:+19991111111@domain.com:5060 SIP/2.0
Via:SIP/2.0/TCP 10.10.10.10:5060;branch=z9hG4bK7C7B9EB
Remote-Party-ID:" BroadWorks "<sip:886222222222@domain.com>;screen=no;party=calling;privacy=off
From:" BroadWorks "<sip:+12403333333@10.20.20.20>;tag=958BDDF4-1AB
To:<sip:+19991111111@domain.com>
Date:Thu, 03 Nov 2022 12:39:58 GMT
Call-ID:75D3B642-5AAB11ED-AC82BA3C-276254A1@10.20.20.30
Supported:100rel,timer,resource-priority,replaces,sdp-anat
Min-SE:14400
Cisco-Guid: 1976459008-1521160685-2893855292-0660755617
X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab-04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec"
X-Cisco-Org-Id:82e2eb35-1610-44e7-9b20-ab607e026270
User-Agent: Cisco-SIPGateway/IOS-16.12.2s
Timestamp: 1667479198
Session-ID: e13cc71f24ae400669d5247d8306ac23;remote=00000000000000000000000000000000
Allow:INVITE,OPTIONS,BYE,CANCEL,ACK,PRACK,UPDATE,REFER,SUBSCRIBE,NOTIFY,INFO,REGISTER
CSeq:101 INVITE
Contact:<sip:+12403333333@10.20.20.20:5060;transport=tcp>
Expires:180
Allow-Events:telephone-event
Max-Forwards:68

Esta seção fornece uma configuração validada de como implantar o Cisco Unified Border Element (CUBE) como o Session Border Controller (SBC) para a solução Bring Your Own PSTN.

Esta seção concentra-se nas configurações do CUBE que são necessárias para interfuncionar com o exemplo Webex para a configuração do Cisco BroadWorks mostrado na seção anterior. Para uma discussão mais geral sobre a implantação e configuração inicial do CUBE, consulte os seguintes guias: https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/voice/cube/configuration/cube-book/voi-cube-overview.html

https://help.webex.com/en-us/b6vrdc/Cisco-Webex-Edge-Audio-for-CUBE-Customer-Configuration-Guide

Implantar nossa própria opção SBC

Se você não quiser implantar o CUBE, você tem a opção de implantar seu próprio SBC. No entanto, observe que este documento não fornece uma configuração validada para SBCs que não seja o CUBE.

Se você implantar seu próprio SBC, poderá seguir os requisitos de configuração de alto nível do CUBE (por exemplo, atribuições como domínio, interfaces públicas e privadas e gateways) para orientar sua configuração. No entanto, consulte a documentação do SBC para obter ajuda detalhada da linha de comando, pois os comandos reais do seu próprio SBC provavelmente serão diferentes do CUBE.

A menos que especificado de outra forma, os requisitos de configuração restantes na Etapa 10 se aplicam independentemente do SBC que você implantar. No entanto, os exemplos de linha de comando são apenas para CUBE, a menos que especificado que o exemplo se aplica para outros SBCs. Para outros SBCs, consulte a documentação do SBC para obter comandos de configuração.

Após a conclusão da configuração e provisionamento da solução BYoPSTN, o Parceiro é obrigado a executar um conjunto de casos de teste de aceitação para certificar sua solução. Esta é uma etapa necessária para que o Parceiro BYoPSTN seja aprovado e habilitado.

Os casos de teste de aceitação são descritos no documento Trazer seu próprio procedimento de aceitação PSTN Webex Para Cisco BroadWorks em: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cloudCollaboration/wx4bwks/BYoPSTN/BYoPSTN_Acceptance.pdf .

O parceiro deve fornecer os resultados dos testes de aceitação executados com sucesso para as equipes de integração e certificação.

Perguntas, problemas e resultados da execução dos casos de teste de aceitação devem ser relatados e compartilhados no espaço Webex atribuído para a integração do Parceiro.

Os seguintes pré-requisitos devem ser concluídos para o provisionamento de BYoPSTN. Os pré-requisitos indicados abaixo assumem que o Parceiro tem uma implantação Webex para Cisco BroadWorks que inclui:

• Funcionando o sistema BroadWorks – conforme documentado no Guia de soluções Webex para Cisco BroadWorks

• BroadWorks COMO licença com o serviço "VoiceXML" em quantidade suficiente (1 por número PSTN)

• Patches BroadWorks necessários:

  Para R22:

  • AP.xsp.22.0.1123.ap376935

  • AP.as.22.0.1123.ap376935

  Para R23:

  • AP.xsp.23.0.1075.ap376935

  • AP.as.23.0.1075.ap376935

  Para R24

  • AP.as.24.0.944.ap376935

• Cisco CUBE System implantado (IOS versão 16.12.2 ou superior): https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/voice/cube/configuration/cube-book.html

  O CUBE virtual e baseado em hardware é compatível. O CUBE baseado em hardware é recomendado para escalabilidade e tratamento de números maiores de chamadas.

• Organização de parceiros Webex – conforme descrito no Guia de soluções Webex para Cisco BroadWorks

O procedimento que o parceiro da Cisco usa para adicionar os números de telefone de chamada de entrada da reunião Webex é o seguinte:

1. Faça logon no Cisco Partner Hub.

2. Vá para Configurações.

3. Role até BroadWorks Calling .

4. Em Configuração de entrada na reunião (BYoPSTN), selecione Criar número de telefone de chamada de entrada Grou p.

5. Insira o nome Grupo de números de telefone e selecione Próximo .

6. Insira os detalhes do Número de telefone e selecione Próximo .

7. Revise o resumo dos detalhes do grupo de números de telefone e selecione Salvar .

8. Repita este procedimento para que cada grupo de números de telefone seja adicionado.

As capturas de tela abaixo ilustram o procedimento.

Esta etapa só deve ser concluída se você quiser implantar a opção Entrar na reunião através do retorno de chamada. Caso contrário, você pode pular esta etapa.

Se você não configurar essa opção, os usuários poderão usar a opção Chamada de entrada para entrar em reuniões ou poderão entrar com o áudio do computador.

Quando você usa a opção Retorno de chamada de reunião, um grupo SRV DNS de retorno de chamada é necessário para rotear chamadas do Webex para o CUBE. O procedimento que o parceiro da Cisco usa para adicionar seus registros SRV DNS do CUBE ao Webex é o seguinte:

1. Faça logon no Hub de parceiros.

2. Vá para Configurações.

3. Role até BroadWorks Calling .

4. Em Configuração de entrada na reunião (BYoPSTN), selecione Criar grupo SRV DNS de retorno de chamada .

5. Insira o nome do grupo DNS SRV de retorno de chamada .

6. Selecione Próximo.

7. Insira os detalhes do SRV DNS de retorno de chamada.

8. Selecione Próximo.

9. Revise o resumo de detalhes do DNS SRV de retorno de chamada.

10. Selecione Salvar.

11. Provisione todas as atualizações do DNS para refletir os novos registros no grupo SRV DNS.

12. Repita este procedimento para cada grupo SRV DNS de retorno de chamada a ser adicionado.

As capturas de tela abaixo ilustram o procedimento.

A configuração inicial e a verificação da solução BYoPSTN exigem uma organização de sementes para cada combinação exclusiva de Grupo de números de telefone e Grupo DNS SRV de retorno de chamada (se for necessário o retorno de chamada). Portanto, é recomendável que os Parceiros da Cisco criem de forma semelhante um novo Modelo de cliente para cada combinação exclusiva de Grupo de números de telefone e Grupo SRV DNS de retorno de chamada. Cada modelo de cliente deve ser usado para gerar uma organização de seed correspondente.

Uma vez que a configuração BYoPSTN é semeada e verificada usando as organizações seed, os Grupos de números de telefone e os Grupos SRV DNS de retorno de chamada podem ser aplicados aos Modelos de clientes existentes conforme necessário.

Observe que os Modelos de Clientes recém-criados não estão em uso por clientes não-teste existentes e, portanto, podem ser usados com segurança para verificação manual da configuração BYoPSTN.

Se você não estiver implantando a Entrada na reunião através do retorno de chamada, você não precisa associar os grupos DNS SRV de retorno de chamada ao modelo do cliente. No entanto, você precisa selecionar Desativar retorno de chamada .

Para adicionar a um novo modelo de cliente, faça o seguinte:

1. Faça logon no Cisco Partner Hub.

2. Vá para Configurações.

3. Role até BroadWorks Calling .

4. Em Modelos , selecione Adicionar modelo .

5. Insira os detalhes do modelo. No estágio Tipo de pacote :

   • Selecione Tipo de pacote como Padrão .

   • Selecione Configuração de entrada na reunião como Números de chamada de entrada fornecidos pelo parceiro (BYoPSTN).

   • Selecione um grupo de números de telefone provisionado .

   • Para o grupo SRV DNS de retorno de chamada, se você quiser ativar a opção Retorno de chamada de reunião, selecione um grupo SRV DNS de retorno de chamada provisionado. Caso contrário, selecione Desativar retorno de chamada .

6. Selecione Próximo.

7. Insira os detalhes restantes do modelo.

8. Revise o resumo dos detalhes do modelo.

9. Clique em Salvar.

10. Repita este procedimento para cada modelo de cliente que deve ser adicionado

A captura de tela abaixo ilustra o procedimento.

Para atualizar um modelo de cliente existente, faça o seguinte:

1. Faça logon no Cisco Partner Hub.

2. Vá para Configurações.

3. Role até a seção Chamadas BroadWorks .

4. Em Modelos , selecione Exibir modelo .

5. Selecione o Modelo a ser atualizado.

6. Role até a seção Configuração de entrada na reunião :

   • Selecione Números de chamada de entrada fornecidos pelo parceiro (BYoPSTN).

   • Selecione um grupo de números de telefone configurado anteriormente .

   • Para Grupo SRV DNS de retorno de chamada , se você quiser ativar a opção Retorno de chamada de reunião, selecione um grupo SRV DNS de retorno de chamada provisionado. Caso contrário, selecione Desativar retorno de chamada .

7. Selecione Salvar.

   A captura de tela abaixo ilustra o procedimento.

A solução BYoPSTN tem vários componentes diferentes, cada um dos quais deve ser configurado corretamente para que a solução funcione com êxito. Uma das duas finalidades das organizações de soluções de sementes é gerar o número de telefone para os mapeamentos de códigos de acesso de reuniões e um identificador universal exclusivo do site de reunião (UUID do site) que são necessários para a operação contínua da solução. A outra finalidade é a verificação de configuração.

Para cada combinação exclusiva de grupo de números de telefone e grupo SRV DNS de retorno de chamada a ser usada, um modelo de cliente correspondente deve ser criado anteriormente. Para cada um desses Modelos de cliente, uma organização de solução de sementes deve ser provisionada. O provisionamento dessas organizações de seed gera o número de telefone para os mapeamentos de códigos de acesso de reunião e um UUID de site de reunião que é necessário para configurar o BroadWorks.

Usando cada um dos modelos de cliente configurados anteriormente, forneça um assinante para um novo provedor de serviços BroadWorks de teste ou novo BroadWorks Enterprise com um usuário Pacote padrão . O site da reunião Standard resultante deve estar usando a opção de entrada na reunião de números de chamada de entrada do Provedor de parceiros. Qualquer um dos seguintes métodos pode ser usado para provisionar o assinante:

1. Provisionar o assinante de teste usando APIs de assinantes BroadWorks conforme documentado em developer.webex.com.

2. Ative o assinante de teste para o serviço IM&P em um BroadWorks configurado para usar o modelo de cliente. Certifique-se de que o Modelo de cliente esteja usando o pacote Standard como padrão para garantir que o assinante de teste receba um pacote Standard. Alternativamente, o assinante de teste deve ser posteriormente atualizado para ter o pacote Padrão.

Observe que é recomendado que as organizações de soluções de sementes estejam associadas a um provedor de serviços BroadWorks de teste ou a uma empresa BroadWorks de teste.

É fundamental que este site de reunião permaneça provisionado, pois este UUID do site é enviado em cada solicitação de entrada de reunião de chamada de entrada como um token de autenticação. Você não deve excluir a organização de sementes, pois o site de reuniões associado também será excluído. Se a organização seed for removida, você precisará provisionar uma nova e reconfigurar o Broadworks com o novo site UUID.

As organizações de soluções primárias e secundárias de sementes podem ser excluídas, se desejado antes do conjunto de números de telefone e registros SRV DNS de retorno de chamada que estão sendo atribuídos a clientes não testados. Quando o conjunto de números de telefone e registros SRV DNS de retorno de chamada são atribuídos a qualquer cliente que não seja de teste, esses números de telefone e registros de retorno de chamada são associados aos sites de reunião para esses clientes e estão em uso para entrar na reunião usando a chamada de entrada e o retorno de chamada. Quaisquer alterações devem ser consideradas como impacto no serviço.

Para selecionar a Organização de Solução de Sementes Primárias, faça o seguinte:

1. Faça logon no Cisco Partner Hub.

2. Vá para Configurações.

3. Role até a seção Chamadas BroadWorks .

4. Na seção Validação de configuração (BYoPSTN) , selecione Atribuir .

5. Na tela Atribuir organização , pesquise e selecione uma das organizações de sementes previamente configuradas

6. Selecione Atribuir.

   A organização de sementes selecionada é a organização de sementes primária.

As capturas de tela abaixo ilustram o procedimento.

A organização principal da solução de sementes, os grupos de números de telefone e os detalhes do grupo SRV DNS de retorno de chamada para um determinado grupo BroadWorks estão disponíveis em um único local, o arquivo JSON de configuração BroadWorks (BYoPSTN). Essas informações são necessárias para configurar o BroadWorks para BYoPSTN.

Observe que o arquivo de configuração JSON está disponível apenas para visualização/download após a organização da solução de seed primária ser selecionada.

O procedimento para visualizar/baixar o arquivo de configuração JSON é o seguinte:

1. Faça logon no Cisco Partner Hub.

2. Vá para Configurações.

3. Role até BroadWorks Calling .

4. Em Clusters , selecione Exibir grupo .

5. Selecione o grupo associado aos modelos de cliente que estão configurados para BYoPSTN.

6. Role até a seção Configuração do BroadWorks para BYoPSTN.

7. Clique em Baixar o arquivo de configuração JSON .

8. Repita este procedimento para quaisquer outros grupos BroadWorks.

As capturas de tela abaixo ilustram o procedimento.

Consulte o exemplo do arquivo de configuração JSON abaixo. O arquivo contém informações complementares em cada grupo de números de telefone, grupo SRV DNS de retorno de chamada, os seguintes itens de configuração principais que devem ser inseridos no BroadWorks são marcados em negrito.

• siteUUID: O BroadWorks deve enviar esse valor nas mensagens SIP, é um token que o Áudio Webex Edge usa para confirmar a identidade do BroadWorks do parceiro da Cisco e seu acesso a sites de reuniões gerenciados por este parceiro da Cisco.

• Número de telefone -para- mapeamento do código de acesso: Os números de telefone e os códigos de acesso Webex associados devem ser configurados no BroadWorks.

  • número de telefone

  • Código de acesso

• LocaleTag: O idioma do anúncio desejado associado ao número de telefone deve ser configurado no BroadWorks.

• dnsSrv: O SRV DNS de retorno de chamada deve ser configurado no DNS e consulte as ocorrências do CUBE desejadas.

{
   "siteUUID": "491db0821791441a96c233fefb6c6dfc",
   "siteURL": " seedtestenterpriseabc.webex.com ",
   "partnerOrgId": "1da175de-3651-4467-b26b-b0d85a2cb3ad",
   "solutionValidationOrgId": "d927ac4d-3d73-4d7f-8506-a1bc0a221934",
   "customerTemplates": [
      {
         "name": "US West Std",
         "id": "27fe1337-ab1d-44b0-8b5e-ff1d32f6e3f8",
         "phoneNumberGroupId": "1bcb05bd-b919-45fd-b30e-71d2abb59e26",
         "callbackDnsSrvGroupId": "25392686-a390-49b9-bad5-cb47159c3e992"
      },
      {
         "name": "US East Std",
         "id": "070d6682-b64f-46ea-bc4b-b2e1218ba4bb",
         "phoneNumberGroupId": "12bc0b8f-ea1d-457f-8fe2-069ccf78907e",
         "callbackDnsSrvGroupId": "25392686-a390-49b9-bad5-cb47159c3e992"
      }
   ],
   "phoneNumberGroups": [
   {
         "name": "US West",
         "id": "1bcb05bd-b919-45fd-b30e-71d2abb59e26",
         "phonenumbers": [
            {
               "id": "617c5faa-1721-45c7-bc70-e6d7c20ccc29",
               "name": "US Palo Alto",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "TollFree",
               "defaultPhoneNumberType": "NONE",
               "phoneNumber": "9863502478",
               "accessCode": "88672693772924908359"
            },
            {
               "id": "48fa7c50-9da0-4c8b-9b2f-307ff435c7c7",
               "name": "US Toll San Francisco",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "PRIMARY",
               "phoneNumber": "4156551000",
               "accessCode": "88652789466280320324"
            }
         ]
      },
      {
         "name": "US East",
         "id": "12bc0b8f-ea1d-457f-8fe2-069ccf78907e",
         "phonenumbers": [
            {
               "id": "ca0c622a-8621-4477-91e0-b3e214833568",
               "name": "US Maryland",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "PRIMARY",
               "phoneNumber": "2403332200",
               "accessCode": "88631321777971704941"
            },
            {
               "id": "00875574-9a46-4447-a967-350b6176755a",
               "name": "US Florida",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "SECONDARY",
               "phoneNumber": "9049002303",
               "accessCode": "88632627551145646175"
            },
            {
               "id": "a2c10316-9266-4423-a669-d67949f99d33",
               "name": "US New York",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "TollFree",
               "defaultPhoneNumberType": "NONE",
               "phoneNumber": "8056504578",
               "accessCode": "88649679020033567943"
            }
         ]
      }
   ],
   "callbackDnsSrvGroups": [
      {
         "name": "CB US",
         "callbackDnsSrvs": [
            {
               "name": "Callback US",
               "countryCode": "US",
               "dnsSrv": "cube.us.example.com",
               "id": "c5209d17-7c2f-45b3-95a6-65d7f5f53c7e"
            }
         ],
         "id": "25392686-a390-49b9-bad5-cb47159c3e992"
      },
      {
         "name": "CB MX",
         "callbackDnsSrvs": [
            {
               "name": "Callback MX",
               "countryCode": "MX",
               "dnsSrv": "cube.mx.example.com",
               "id": "cca0e4c3-5cff-412c-a854-bfb719f603a2"
            }
         ],
         "id": "36403797-b401-50c0-cbe5-dc58260d4f003"
      }
   ]
}

O domínio SRV DNS do áudio Webex Edge deve ser configurado no BroadWorks. Use o procedimento a seguir para determinar o valor.

1. Faça logon no Cisco Partner Hub.

2. Vá para Clientes .

3. Selecione a empresa de validação de BYoPSTN.

4. Selecione Visualizar cliente.

5. Vá para Serviços/Reuniões .

6. Selecione o site de reunião do pacote Padrão.

7. Role até a parte inferior do painel lateral, selecione Configurar site .

8. Selecione Configurações comuns / Configurações de áudio .

9. Na seção Números de chamada de entrada global personalizados do Edge Audio , selecione Gerar Lua Script .

10. Na janela pop-up, procure o valor "-- Atualizar Para cabeçalho com URL CCAX".

     
    -- Update To header with CCAX URL
     local oldTo1 = msg:getHeader("To")
     local newTo1 = string.gsub(oldTo1, "<sip:(.+)@(.*)>", "<sip:%1@ecccx.amer.webex.com>")
     msg:modifyHeader("To", newTo1)
    

11. Extraia o valor em negrito, por exemplo, ecccx.amer.webex.com.

Este é o domínio SRV DNS do áudio Webex Edge que deve ser configurado no BroadWorks.

Esta seção descreve a configuração do BroadWorks necessária para implementar os cenários de Chamada de entrada e Retorno de chamada de reunião mostrados nos diagramas abaixo. Os exemplos de configuração são baseados nos dados no arquivo JSON mostrado na seção anterior. Números, domínios, nomes de empresas/grupos, tipos de dispositivos, políticas, perfis, etc. devem variar de acordo com o parceiro.

Fluxo de chamadas:

1. O usuário solicita o retorno de chamada, o Webex inicia um retorno de chamada.
2. A chamada é roteada para o BroadWorks OTT.
3. A chamada atinge o CUBE provisionado na CH. O CUBE encaminha a chamada para o BroadWorks.
4. O BroadWorks identifica a chamada como origem do organizador da reunião e cria uma sessão para o usuário organizador da reunião e processa a chamada.
5. A sessão do usuário organizador da reunião processa a chamada e traduz o número discado. Além disso, um registro de cobrança é gerado em nome do usuário organizador da reunião.
6. O BroadWorks roteia a chamada para o usuário associado ao dispositivo (7) ou para o PSTN (8).

Antes de Começar

A comunicação SIP entre o BroadWorks e o CUBE pode ser através de UDP ou TCP, dependendo dos requisitos de rede. Por exemplo, se alguns dispositivos de rede ou de acesso (por exemplo, gateways ou terminais) nos fluxos de chamada de entrada ou de retorno de chamada BYoPSTN não suportarem TCP, o UDP deverá ser usado.

A configuração e os exemplos mostrados neste guia usam TCP como o protocolo de transporte. Para usar o TCP, certifique-se de que o servidor de aplicativos BroadWorks e o servidor de rede estejam configurados para TCP:

_CLI/Interface/SIP> get
networkProxyTransport = unspecified
accessProxyTransport = unspecified
supportDnsSrv = true
supportTcp = true

Servidor da aplicação

Tipo de perfil de identificação/dispositivo

Um novo tipo de perfil de identidade/dispositivo deve ser criado para representar o CUBE. Certifique-se de definir as seguintes propriedades abaixo, enquanto outras podem ser deixadas em valores padrão:

• Tipo de endereço de sinalização— Definir para endereçamento de proxy inteligente

• Autenticação —Definida como Ativada

• Identidade de suporte em ATUALIZAÇÃO e reconvite —Marcada

• Registro estático habilitado —Definido para Ativado

• Capaz de vídeo —Definido para Desativado

No exemplo abaixo, o novo tipo de perfil de identidade/dispositivo "VXML _profile" é criado para representar o CUBE.

Assinante virtual de voz XML

Criar uma instância de VoiceXML

Cada número PSTN do Webex Meetings é representado por um assinante virtual no BroadWorks e a funcionalidade de assinante virtual VoiceXML pode ser usada. Recomenda-se que uma empresa e um grupo dedicados sejam usados para todos os assinantes virtuais VoiceXML. Observe que na verdade não estamos explorando nenhuma capacidade do VoiceXML, mas esse tipo de usuário virtual é adequado para interagir com o CUBE.

Para usar o serviço VoiceXML, certifique-se de que a licença tenha quantidades suficientes de "VoiceXML" e que o serviço seja autorizado nos níveis da empresa e do grupo, e que o serviço VoiceXML seja atribuído ao grupo conforme mostrado na imagem de exemplo abaixo.

Sob Grupo > Serviços , selecione VoiceXML e crie uma instância para cada número PSTN.

Configurar endereços VoiceXML

Para cada instância de VoiceXML, forneça o seguinte sob os Endereços de VoiceXML:

• Número de telefone —Insira o número de discagem do site Webex Meetings (por exemplo, 2403332200).

• Ramal

• Perfil de identidade/dispositivo —Crie uma instância (por exemplo, VXML _device Prof) com base no tipo de dispositivo criado na seção anterior (VXML _profile no exemplo) e insira a seguinte configuração.

• Linha/porta —Insira no formato <access number="">@<domain> , onde

  • <access number=""> é o número do código de acesso para o site Webex Meetings (disponível no arquivo JSON) (por exemplo, 88631321777971704941)

  • <domain> é o domínio do áudio Webex Edge para este site de reunião (por exemplo, ecccspx.amer.pub.webex.com)

• sip de contato —Para chamadas de entrada da reunião para o número de acesso, o INVITE será enviado com uma URI de solicitação definida para o valor deste campo. Insira o contato SIP neste formato <sip contact="">;<Locale>;<Meetings Site="" UUID="">;<SIP transport="">, onde:

  • <sip contact=""> é o <number> campo da linha/porta, mas com o domínio como o SRV que resolve para o endereço do CUBE (por exemplo, 88631321777971704941@cube.internal.local)

  • <Locale> representa a configuração do idioma de acordo com a localidade do usuário (por exemplo, locale=en_ US)

  • <Meetings Site="" UUID=""> é UUID do site do arquivo JSON (por exemplo, x-cisco-site-uuid=abbd70f6c519fb1ee053ad06fc0a038b)

  • <SIP transport=""> deve ser transport=tcp para ter o AS use TCP para enviar mensagens para o CUBE.

Veja abaixo um exemplo das configurações de Endereços VoiceXML.

Para cada número de acesso de Reunião adicional a ser usado, um assinante virtual VoiceXML adicional deve ser criado análogo ao acima. O mesmo perfil de dispositivo pode ser usado, mas os campos Porta de linha e Contato devem ser criados a partir das informações do número de acesso, conforme mostrado acima.

Certifique-se de verificar se os limites da Política de processamento de chamadas que você configura no assinante virtual BroadWorks são suficientes para lidar com as chamadas BYoPSTN extras no seu grupo de números de telefone.

Atribuir autenticação SIP à instância de VoiceXML

Atribua o serviço de autenticação ao assinante virtual VoiceXML. Isso será usado para autenticar mensagens de CONVITE SIP do CUBE no cenário de Retorno de chamada. Ele também impede que o assinante virtual VoiceXML aceite chamadas de partes diferentes do CUBE

Vá para a página de Autenticação do assinante virtual em Utilitários e insira o nome de usuário e a senha SIP, conforme mostrado abaixo:

o CUBE deve ser configurado com o mesmo nome de usuário e senha para autenticar corretamente as mensagens INVITE enviadas para o AS. Um exemplo do comando para configurar a autenticação SIP no CUBE é o seguinte: sip-ua authentication username VSUB password 0 <unencrypted password> (See the CUBE onfiguration/datafill for more details).

Arquivo Namedefs

O campo de contato SIP do assinante virtual VoiceXML contém a URL onde a parte do domínio resolve para o endereço CUBE. Este é um SRV interno e o arquivo namedefs no AS pode ser usado para resolver o SRV interno para o IP do CUBE.

Em nosso exemplo, o SRV de contato SIP é cube.internal.local e resolve abordar a porta 10.165.196.30 5060 para alcançar o CUBE. No AS, o /usr/local/broadworks/bw_base/conf/namedefs o arquivo é atualizado da seguinte forma:

_sip.tcp.cube.internal.local SRV 1 99 5060 10.165.196.30

Tipo de chamada do Webex Meetings

As opções de configuração de processamento de chamadas do Webex Meetings estão disponíveis para controlar como as chamadas de entrada da reunião são tratadas. Por padrão, as chamadas de entrada da reunião são processadas como chamadas externas, pois os números de chamada de entrada são hospedados em uma empresa ou provedor de serviços dedicado. As chamadas externas são normalmente incluídas nas contagens da sessão de controle de admissão de sessão e sinalizadas para carregamento no campo CDR chargeIndicator .

O exemplo a seguir adiciona a configuração recomendada para processar as Chamadas de entrada da reunião como chamadas internas, de modo que elas sejam excluídas do carregamento e excluídas das contagens do Controle de admissão da sessão.

Ao definir Aplicar campo de carga NS como verdadeiro, a população do campo CDR chargeIndicator é baseada no atributo de carga configurado do tipo de chamada do servidor de rede.

AS_CLI/System/CallP/WebexMeetings/WebexCallTypes> add "Webex Meetings" WXM true true

AS_CLI/System/CallP/WebexMeetings/WebexCallTypes> get
      Name    NS Call Type    Enforce NS Charge Field  Process As Internal For SAC-Subscriber
  ==========================================================================================
  Webex Meetings       WXM               true                                true

Assinante virtual de retorno de chamada de reunião VoiceXML

Criar um assinante de retorno de chamada de reunião VoiceXML

Um assinante virtual VoiceXML dedicado com uma opção especial de retorno de chamada de reunião Webex (doravante chamado de assinante de retorno de chamada de reunião VoiceXML) precisa ser configurado no servidor de aplicativos BroadWorks (AS) para lidar com as chamadas de retorno de chamada Webex Meetings. Apenas uma única ocorrência deste assinante pode ser configurada no AS.

Para ativar o recurso, defina o recurso ativável 102074 como verdadeiro via CLI.

AS_CLI/System/ActivatableFeature> activate 102074
***** Warning *****:
This activity should only be done during a maintenance window because
this may cause large amounts of data to be added/modified/deleted and
it may take some time to execute. Features that have web page impacts
require that users and administrators log out and log back in.
Are you sure you want to continue?

Please confirm (Yes, Y, No, N): y
...Done

AS_CLI/System/ActivatableFeature> get

      Id                                               Description  Activated  Last Modified Timestamp
=============================================================================================
  102746                            BroadWorks Support for CI UUID       true
  102074          BYO PSTN Billing support for CallBack and CallIn       true      
  104256                          Weak Password Validation Service      false
  104073  Add FAC Support for Call Center Agent Join-Unjoin in CDR      false
  103542   Configurable Endpoint For Auto-Answer And Forced Answer      false
  104255    Control password usage and behavior to ensure security      false

Uma vez que o recurso "BYO PSTN Billing support for CallBack and CallIn" depende do recurso "BroadWorks Support for CI UUID", antes de ativar (102074), você também precisa ativar (102746). Para obter mais detalhes, consulte a seção "Sincronização de UUID do Usuário CI (Suporte do Broadworks para UUID do CI)".

O assinante de retorno de chamada da reunião VoiceXML é semelhante ao assinante virtual BYOPSTN VXML existente, mas marcou-o com um novo sinalizador de "Retorno de chamada de reunião Webex". Este assinante de retorno de chamada de reunião VoiceXML é configurado com o mesmo perfil de dispositivo do assinante virtual BYOPSTN VXML existente, bem como o serviço de Autenticação com as mesmas credenciais.

Um exemplo é mostrado abaixo:

O assinante de retorno de chamada da reunião VoiceXML deve existir no AS hospedando o usuário organizador da reunião. Quando o AS recebe a solicitação de CONVITE de retorno de chamada da reunião, ele tenta localizar o usuário de retorno de chamada da reunião VoiceXML e o usuário organizador da reunião no AS durante a configuração da chamada. Se nenhum desses usuários for encontrado, a chamada será rejeitada.

Sessão do organizador da reunião

No cenário de retorno de chamada com o cabeçalho X-Cisco-Meet-Info, o servidor de aplicativos do Cisco BroadWorks recebe uma solicitação de CONVITE SIP e identifica o usuário do organizador da reunião usando o parâmetro UUID do usuário CI do organizador do cabeçalho SIP X-Cisco-Meet-Info. Uma sessão de chamada é criada em nome do usuário organizador da reunião, criada para processar a chamada e executar o perfil de serviço do usuário. Além disso, um registro de cobrança é gerado em nome do usuário organizador da reunião. A ID da reunião e as informações UUID do site do cabeçalho SIP X-Cisco-Meet-Info são capturadas no registro de cobrança.

Um exemplo do cabeçalho SIP X-Cisco-Meet-Info é mostrado abaixo:

X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab
-04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec

Plataforma de entrega de aplicativos

Sincronização UUID do usuário CI (Suporte do Broadworks para UUID CI)

O UUID CI do usuário é um identificador exclusivo para identificar usuários dentro do ambiente Webex.

Este aplicativo Webex Provisioning Sync na Plataforma de entrega de aplicativos (ADP) do Cisco BroadWorks é usado para sincronizar, mapear e armazenar o UUID do CI do usuário na infraestrutura do BroadWorks de modo que ele possa ser usado em várias interações com o serviço Webex e Webex para BroadWorks.

Consulte " Ativar o retorno de chamada de reunião Webex" sobre como a associação CI User UUID é usada pelo servidor de rede do Cisco BroadWorks e pelo servidor de aplicativos Cisco BroadWorks.

As etapas a seguir configuram o aplicativo Webex Provisioning Sync para sondar e atualizar periodicamente os usuários do BroadWork com o UUID CI.

O aplicativo Webex Provisioning Sync requer credenciais OAuth com o spark-admin:broadworks_subscribers_read escopo para o provedor de identidade da Cisco e pode ser obtido levantando uma solicitação de serviço com o seu agente de integração.

Verifique a seção "Obtendo credenciais OAuth do seu Webex para Cisco BroadWorks" para obter mais detalhes sobre a solicitação de serviço em: https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cloudCollaboration/wx4bwks/Solution_Guide/wbxbw_b_solution-guide/wbxbw_b_SolutionGuide-PDF_chapter_01.html?bookSearch=true#Cisco_Generic_Topic.dita_0e1beabc-80ae-4e8d-b177-17108ec5daed

Adicione o token com um nome de parceiro apropriado da seguinte forma:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> add custBYO refreshToken
      New Password:
      Re-type New Password:
      ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> get
       Partner Name  Refresh Token
==================================
  FederationPartner       ********
           custPart       ********
            custBYO       ********

Adicione o nome do parceiro associado ao token OAuth à lista de parceiros a serem monitorados pelo aplicativo Webex Provisioning Sync com o sinalizador "habilitado" definido como "verdadeiro".

Este aplicativo de sincronização de provisionamento Webex começará a fazer a sincronização UUID do usuário CI no intervalo de sondagem definido.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> add custBYO true

Depois que o parceiro for incluído, o aplicativo Webex Provisioning Sync agora poderá executar a associação do UUID CI aos usuários do BroadWorks.

Altere o tempo limite da conexão usando os seguintes comandos:

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> set requestTimeout 30000
...Done

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> get
requestTimeout = 30000

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> cd http

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller/Http> set connectionTimeout 300
*** Warning: BroadWorks needs to be restarted for the changes to take effect ***

ADP_CLI/Application/WebexProvisioningSync/GeneralSetting/Controller/HTTP > get
connectionPoolSize = 5
connectionTimeout = 300
connectionIdleTimeOut = 300
maxConcurrentRequests = 10
maxCookieAgeInHours = 24

Essa associação pode ser feita de forma automática ou manual. O comando CLI manualSync pode acionar instantaneamente a associação para ocorrer.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> manualSync custBYO

Parceiros com "Ativado" definido como "verdadeiro" executam o associado no intervalo de sondagem. Durante a associação inicial, o aplicativo Webex Provisioning Sync consulta a API do assinante Webex para recuperar os dados que contêm o UUID CI para todos os usuários hospedados pelo parceiro. A ID externa do usuário BroadWorks é atualizada com o UUID do CI associado. As associações subsequentes afetam os usuários adicionados ao parceiro. O comando de status pode ser usado para ver se a sincronização está concluída.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> status
  Partner Name         Status                 Last Sync Time
============================================================
       custBYO  synchronizing
      custPart     monitoring  2023-01-29T15:36:43.873-05:00
2 entries found.

Depois que a sincronização for concluída, o status será alterado de volta para monitoramento. A sincronização subsequente é executada nos usuários adicionados ao parceiro após a "Hora da última sincronização".

A figura a seguir mostra o UUID do CI definido na ID externa:

Servidor de Rede

Tipo de chamada

Para fins de faturamento e relatório, pode ser desejável marcar CDRs para chamadas de entrada do Meetings. Isso pode ser feito usando a política de preCallTyping do servidor de rede.

Primeiro, no CLI NS em /System/CallP/CallType, adicione um novo tipo de chamada. O exemplo a seguir adiciona o novo tipo de chamada "WXM":

NS_CLI/System/CallP/CallTypes> add WXM LOCAL true false "Webex Meetings"
NS_CLI/System/CallP/CallTypes> get calltype WXM    
  CallType     Description  Category         Scope  SupportE164  Charge      
=======================================================================    
  WXM          Webex Meetings  LOCAL  User Defined         true   false

O tipo de chamada pode ser usado em uma ocorrência de PreCallTyping que faz parte do perfil de roteamento do usuário BroadWorks. Neste exemplo, uma nova ocorrência de PreCallTyping "wxm" foi adicionada no contexto de CLI de /Policy/PreCallTyping, mas pode ser uma ocorrência de PreCallTyping existente já em uso:

NS_CLI/Policy/PreCallTyping> add wxm true CallTypes ALL

NS_CLI/Policy/PreCallTyping> get wxm                        
Policy: PreCallTyping  Instance: wxm                        
  CallTypes:                                
    Selection = {ALL}                                
    From = {PCS, ALL, TRMT, LO, GNT, DP, WXM, LPS, OA, TPS, EA, FGB, POA, SV, SVCD, IN, MS, CSV, EM, SVCO, SMC, ZD, NIL, CT, TF, GAN, TO, DA, OAP}        
  supportLCABasedNormalization = false                        
  Enable = true 

O próximo passo é adicionar entradas à instância de PreCallTyping para todos os números de discagem no contexto de CLI /Policy/PreCallTyping/DialPlan. Por exemplo:

NS_CLI/Policy/PreCallTyping/DialPlan> add wxm 1 dflt 12403332200 12403332200 exact 11 11 WXM 0 0 Webex Meetings
NS_CLI/Policy/PreCallTyping/DialPlan> add wxm 1 dflt_e164 12403332200 12403332200 exact 11 11 WXM 0 0 Webex Meetings

NS_CLI/Policy/PreCallTyping/DialPlan> get wxm 1                
Policy: PreCallTyping  Instance: wxm  Table: DialPlan                
CC Dial Plan   From     To          Match Min Max Call Type Prefix Action  Call Ind  Description                  
================================================================================================
1 dflt      12403332200 12403332200 {exact} 11 11 {WXM}     0                      Webex Weetings
1 dflt_e164 12403332200 12403332200 {exact} 11 11 {WXM}     0                      Webex Meetings

A instância de PreCallTyping é então adicionada (desde que ainda não exista) ao perfil de roteamento aplicável do usuário de origem, conforme mostrado no exemplo abaixo:

NS_CLI/Policy/Profile> add Profall PreCallTyping wxm
NS_CLI/Policy/Profile> get profile Profall
Profile:  Profall
                 Policy              Instance
   ==========================================
             CallTyping           DefaultInst
          CallScreening           DefaultInst
            SubLocation           DefaultInst
              FarEndRtg           DefaultInst
             NearEndRtg           DefaultInst
             UrlDialing           DefaultInst
            MediaSrvSel           DefaultInst
                 SIMPLE           DefaultInst
              DstSvcRtg           DefaultInst
      NumberPortability           DefaultInst
             RCBasedRtg           DefaultInst
      NetVoicePortalRtg           DefaultInst
          PreCallTyping                   wxm    

BroadWorks originando CDR's são gerados apenas por chamadas originadas de assinantes BW. As chamadas originadas de PSTN do lado "rede" do AS não gerarão CDR's originários. Haverá um CDR de encerramento para o assinante virtual VoiceXML em qualquer um dos casos.

RoutingNE

Uma RoutingNE é necessária no NS no contexto de /System/Device/RoutingNE CLI para representar o CUBE. Dessa forma, quando o NS receber o CONVITE do CUBE, ele corresponderá ao cabeçalho via à entrada RoutingNE provisionada no NS. Consulte o Guia de administração da interface de linha de comando do servidor de rede do Cisco BroadWorks para obter detalhes sobre como adicionar um RoutingNE.

Veja abaixo um exemplo dos comandos para adicionar o RoutingNE "WebexMeetings", onde o endereço IP do CUBE = 10.165.196.30. O exemplo também mostra comandos para criar novas instâncias do OrigRedirect e do Profile a serem associadas ao RoutingNE, mas as instâncias existentes também podem ser usadas.

NS_CLI/Policy/OrigRedirect> add wxm_Inst true CallTypes ALL supportTrunkGroupLookups disable applyAccessSideRules enableRestrictive

NS_CLI/Policy/OrigRedirect> get  wxm_Inst
Policy: OrigRedirect  Instance: wxm_Inst
  Enable = true
  CallTypes:
    Selection = {ALL}
    From = {PCS, ALL, TRMT, LO, GNT, DP, WXM, LPS, OA, TPS, EA, FGB, POA, SV, SVCD, IN, MS, CSV, EM, SVCO, SMC, ZD, NIL, CT, TF, GAN, TO, DA, OAP}
  supportTrunkGroupLookups:
    Selection = {disable}
    From = {disable, enablePermissive, enableRestrictive}
  applyAccessSideRules:
    Selection = {enableRestrictive}
    From = {disable, enablePermissive, enableRestrictive}

NS_CLI/Policy/Profile> add wxm_routing

NS_CLI/Policy/Profile> add wmx_routing OrigRedirect wxm_Inst

NS_CLI/Policy/Profile> add wmx_routing SubLocation  DefaultInst

NS_CLI/Policy/Profile> get profile wxm_routing 
Profile:  wxm_routing
                 Policy              Instance
   ==========================================
           OrigRedirect           wxm_Inst
            SubLocation           DefaultInst

NS_CLI/System/Device/RoutingNE> add  WebexMeetings 1240364 1 99 wxm_routing false OnLine AccessRoutingNE

NS_CLI/System/Device/RoutingNE/Address> add WebexMeetings 10.165.196.30 1 99 tcp

NS_CLI/System/Device/RoutingNE> get
Network Element  WebexMeetings
   Location      =  1240364
   Static Cost   =  1
   Static Weight =  99
   Poll          =  false
   OpState       =  enabled
   State         =  OnLine
   Profile       =  wxm_routing
   Signaling Attributes=  AccessRoutingNE
 
NS_CLI/System/Device/RoutingNE/Address> get
Routing NE   Address     Cost    Weight     Port    Transport Route  
WebexMeetings   10.165.196.30     1      99     -          tcp

Com a configuração de exemplo, o CUBE envia ao NS um INVITE semelhante ao seguinte (campos importantes em negrito):

INVITE sip:+19991111111@domain.com:5060 SIP/2.0
Via:SIP/2.0/TCP 10.10.10.10:5060;branch=z9hG4bK7C7B9EB
Remote-Party-ID:" BroadWorks
"<sip:886222222222@domain.com>;screen=no;party=calling;privacy=off
From:" BroadWorks "<sip:+12403333333@10.20.20.20>;tag=958BDDF4-1AB
To:<sip:+19991111111@domain.com>
Date:Thu, 03 Nov 2022 12:39:58 GMT
Call-ID:75D3B642-5AAB11ED-AC82BA3C-276254A1@10.20.20.30
Supported:100rel,timer,resource-priority,replaces,sdp-anat
Min-SE:14400
Cisco-Guid: 1976459008-1521160685-2893855292-0660755617
X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec"
X-Cisco-Org-Id:82e2eb35-1610-44e7-9b20-ab607e026270
User-Agent: Cisco-SIPGateway/IOS-16.12.2s
Timestamp: 1667479198
Session-ID:
e13cc71f24ae400669d5247d8306ac23;remote=00000000000000000000000000000000
Allow:INVITE,OPTIONS,BYE,CANCEL,ACK,PRACK,UPDATE,REFER,SUBSCRIBE,NOTIFY,INFO,REGSTER
CSeq:101 INVITE
Contact:<sip:+12403333333@10.20.20.20:5060;transport=tcp>
Expires:180
Allow-Events:telephone-event
Max-Forwards:68

Onde:

• A URI de solicitação de convite contém o número de retorno de chamada

• Via cabeçalho: contém o endereço IP do CUBE que será usado para selecionar o perfil RoutingNE.

• Cabeçalho X-Cisco-Info-Meet: usado para identificar hostCIUserUuid, meetingid e siteUUID.

Ao receber o INVITE, o NS usa o cabeçalho Via para corresponder ao RoutingNE “WebexMeetings”. Isso, por sua vez, selecionará o perfil de roteamento "wxm_routing" que contém a instância "wxm_ Inst" do OrigRedirect.

A política do NS OrigRedirect corresponderá ao cabeçalho do X-CISCO-MEET-INFO:

X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec

com a Porta de linha configurada no assinante virtual VoiceXML e enviar um redirecionamento 302 para o par AS que hospeda esse assinante. A mensagem 302 é semelhante ao seguinte:

SIP/2.0 302 Moved temporarily
Via:SIP/2.0/TCP 10.165.196.30:5060;branch=z9hG4bK5452684
From:" Webex "<sip:+12403332200@10.165.196.30>;tag=8EEAA586-1675
To:<sip:+14519615001@10.155.6.172>;tag=394411970-1602687588994
Call-ID:ABC5CCA2-D6411EB-8AD6D92D-EE20F768@10.165.196.30
CSeq:101 INVITE
Contact:<sip:+14519615001@hs2-bwks-v-as01-alpha.bwlab.org:5060;user=phone> ;q=0.5, <sip:+14519615001@hs2-bwks-v-as02-alpha.bwlab.org:5060;user=phone>;q=0.25
Content-Length:0

Alias

O domínio no INVITE URI (no exemplo, é bw.myenterprise.com) enviado pelo CUBE para o NS tem que ser reconhecido pelo NS. Isso pode ser feito adicionando o domínio no contexto NS _ CLI/System/Alias, por exemplo:

NS_CLI/System/Alias> add bw.myenterprise.com

O comando para configurar o domínio INVITE URI no CUBE pode ser encontrado na próxima seção, em dial-peer/session target, por exemplo:

dial-peer voice 23401 voip
session target dns:bw.myenterprise.com

HostingNE

Para oferecer suporte às opções de configuração de processamento de chamadas Webex Meetings para controle de admissão de sessão e cobrança, os atributos de sinalização NE de hospedagem do servidor de aplicativos CallTypeInfoRequired e RequiresChargeIndication devem estar ativados no contexto NS_CLI/System/Device/HostingNE._ Por exemplo:

NS_CLI/System/Device/HostingNE> set broadworksASHostNe signaling E164Compliant,
 CallTypeInfoRequired, SourceId, RequiresNetworkIndication RequiresChargeIndication;

Ativar o retorno de chamada da reunião Webex

No cenário de retorno de chamada com o cabeçalho SIP X-Cisco-Meet-Info, o CUBE envia a chamada para o servidor de rede para o redirecionamento do originador para o par AS. O par AS é determinado com base no parâmetro do sistema enableWebexMeetingHoostLookup .

NS_CLI/System/CallP/Options> get
  accessSideRoutingNeDeterminedViaSignaling = false
  disableNdcValidationForCalledNumbers = true
  forceRoutingNEProfile = false
  skipPrivatePoliciesOnEmergency = true
  maxReturnedContacts = 10
  enableWebexMeetingHostLookup = true

Quando enableWebexMeetingHoostLookup o parâmetro do sistema está definido como verdadeiro, o UUID do CI do usuário do organizador da reunião no cabeçalho X-Cisco-Meet-Info é usado para identificar o par AS que hospeda o usuário organizador da reunião.

INVITE sip:+19991111111@domain.com:5060 SIP/2.0
Via:SIP/2.0/TCP 10.10.10.10:5060;branch=z9hG4bK7C7B9EB
Remote-Party-ID:" BroadWorks "<sip:886222222222@domain.com>;screen=no;party=calling;privacy=off
From:" BroadWorks "<sip:+12403333333@10.20.20.20>;tag=958BDDF4-1AB
To:<sip:+19991111111@domain.com>
Date:Thu, 03 Nov 2022 12:39:58 GMT
Call-ID:75D3B642-5AAB11ED-AC82BA3C-276254A1@10.20.20.30
Supported:100rel,timer,resource-priority,replaces,sdp-anat
Min-SE:14400
Cisco-Guid: 1976459008-1521160685-2893855292-0660755617
X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab-04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec"
X-Cisco-Org-Id:82e2eb35-1610-44e7-9b20-ab607e026270
User-Agent: Cisco-SIPGateway/IOS-16.12.2s
Timestamp: 1667479198
Session-ID: e13cc71f24ae400669d5247d8306ac23;remote=00000000000000000000000000000000
Allow:INVITE,OPTIONS,BYE,CANCEL,ACK,PRACK,UPDATE,REFER,SUBSCRIBE,NOTIFY,INFO,REGISTER
CSeq:101 INVITE
Contact:<sip:+12403333333@10.20.20.20:5060;transport=tcp>
Expires:180
Allow-Events:telephone-event
Max-Forwards:68

Esta seção fornece uma configuração validada de como implantar o Cisco Unified Border Element (CUBE) como o Session Border Controller (SBC) para a solução Bring Your Own PSTN.

Esta seção concentra-se nas configurações do CUBE que são necessárias para interfuncionar com o exemplo Webex para a configuração do Cisco BroadWorks mostrado na seção anterior. Para uma discussão mais geral sobre a implantação e configuração inicial do CUBE, consulte os seguintes guias: https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/voice/cube/configuration/cube-book/voi-cube-overview.html

https://help.webex.com/en-us/b6vrdc/Cisco-Webex-Edge-Audio-for-CUBE-Customer-Configuration-Guide

Implantar nossa própria opção SBC

Se você não quiser implantar o CUBE, você tem a opção de implantar seu próprio SBC. No entanto, observe que este documento não fornece uma configuração validada para SBCs que não seja o CUBE.

Se você implantar seu próprio SBC, poderá seguir os requisitos de configuração de alto nível do CUBE (por exemplo, atribuições como domínio, interfaces públicas e privadas e gateways) para orientar sua configuração. No entanto, consulte a documentação do SBC para obter ajuda detalhada da linha de comando, pois os comandos reais do seu próprio SBC provavelmente serão diferentes do CUBE.

A menos que especificado de outra forma, os requisitos de configuração restantes na Etapa 10 se aplicam independentemente do SBC que você implantar. No entanto, os exemplos de linha de comando são apenas para CUBE, a menos que especificado que o exemplo se aplica para outros SBCs. Para outros SBCs, consulte a documentação do SBC para obter comandos de configuração.

Após a conclusão da configuração e provisionamento da solução BYoPSTN, o Parceiro é obrigado a executar um conjunto de casos de teste de aceitação para certificar sua solução. Esta é uma etapa necessária para que o Parceiro BYoPSTN seja aprovado e habilitado.

Os casos de teste de aceitação são descritos no documento Trazer seu próprio procedimento de aceitação PSTN Webex Para Cisco BroadWorks em: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cloudCollaboration/wx4bwks/BYoPSTN/BYoPSTN_Acceptance.pdf .

O parceiro deve fornecer os resultados dos testes de aceitação executados com sucesso para as equipes de integração e certificação.

Perguntas, problemas e resultados da execução dos casos de teste de aceitação devem ser relatados e compartilhados no espaço Webex atribuído para a integração do Parceiro.