Resolvendo problemas comuns no Voice Gateway

Dica: é possível usar as Informações de mensagens do sistema Voice Gateway para ajudar a resolver mensagens de erro e de aviso. Cada mensagem inclui uma explicação do problema e detalhes das ações que você pode tomar.

• As chamadas estão falhando: as chamadas podem falhar por muitos motivos, incluindo configuração incorreta de um dos serviços do Watson, problemas de roteamento de IP, problemas de firewall, etc.
  1. Primeiramente, verifique se os contêineres do SIP Orchestrator e do Media Relay estão em execução e se os serviços do Watson estão configurados adequadamente.
  2. Em seguida, verifique os logs do SIP Orchestrator para ver se a mensagem SIP INVITE que inicia a chamada está acessando o contêiner. Se estiver, siga o fluxo da chamada no rastreio até o ponto em que o erro ocorre, que é onde a resposta de erro do SIP é enviada de volta para o responsável pela chamada.
  3. Se o SIP INVITE não estiver acessando o Voice Gateway (ou seja, ele não aparece nos logs), é possível que o firewall esteja bloqueando a porta SIP (5060) ou o tronco SIP pode não estar adequadamente configurado para fazer o roteamento para o endereço IP correto do contêiner do SIP Orchestrator.
• Eu ouço o Watson, mas o Watson não me ouve: esse quase sempre é um problema de firewall ou um problema com o tronco SIP ou com o cliente SIP que está sendo usado. Como a mídia de áudio pode fluir por um amplo intervalo de portas, é possível que o firewall não esteja configurado para receber a mídia pelo fluxo de portas definido. Verifique a configuração do Media Relay para ver qual é o intervalo de portas de mídia e certifique-se de que o firewall esteja configurado para acomodar esse intervalo de portas. Se estiver tentando usar um cliente SIP para se conectar ao gateway, verifique também se há conflitos de porta.
• Há muita latência entre as perguntas do responsável pela chamada e as respostas do Watson: esse problema provavelmente provém da latência causada por um dos serviços do Watson. É possível verificar os logs de auditoria para determinar qual serviço está apresentando um comportamento inadequado.
• As transferências de chamada estão falhando: as transferências de chamada são suportadas pelo voice gateway, mas requerem uma entidade que entenda as mensagens SIP REFER para permanecerem no caminho da chamada e ancorarem a chamada durante o tempo de chamada com o Watson, como um session border controller (SBC). Caso queira suportar a transferência de chamada, é necessário usar um fornecedor de entroncamento SIP que suporte mensagens SIP REFER (por exemplo, Twilio) ou fornecer sua própria âncora de chamada que possa manipular mensagens SIP REFER.
• Recebi um erro CWSMR0050E ou CWSMR0048E informando que a conexão foi encerrada com um erro unexpected server response (401): o Voice Gateway provavelmente não pode entrar em contato com o serviço Watson especificado porque as credenciais não foram aceitas. Verifique se as credenciais para o serviço Watson estão configuradas corretamente. Para obter informações sobre como localizar credenciais de serviço do Watson, veja Credenciais de serviço para serviços do Watson na documentação do Watson.
• Estou enfrentando um grande número de vgwPostResponseTimeouts ou latência alta em chamadas: Ativando relatórios de rede RTCP pode ajudar a indicar se a causa dos tempos limite ou da latência é um problema de VoIP ou um problema de reconhecimento de voz. Se o relatório de rede RTCP estiver ativado, os avisos serão impressos; por exemplo:

   CWSMR0035W: The inbound RTP audio stream packet loss of 9 percent exceeds the maximum packet loss threshold of 5 percent.

• Uma mensagem de erro CWSMR0048E informa que o serviço do Watson Speech to Text foi fechado devido a um erro com o certificado autoassinado na cadeia de certificados: este provavelmente é um problema de firewall na infraestrutura. É provável que o firewall esteja interceptando a solicitação e colocando-a em seu próprio certificado. Como o certificado não é confiável para a implementação, ocorre um erro de certificado autoassinado.

  Para verificar essa situação, conclua as etapas a seguir:

  1. Emita um comando curl para o serviço do Watson a partir da MV na qual esse IBM Voice Gateway está sendo executado. Use o comando de exemplo a seguir:

     curl --insecure -v https://<Watson Speech-To-Text endpoint hostname>/speech-to-text 2>&1
     

     Substitua o texto https://<Watson Speech-To-Text endpoint hostname> no comando pela URL de sua instância do Watson Speech-To-Text, como a URL https://stream.watsonplatform.net/speech-to-text/api.

  2. Procure na saída uma seção que diz Server Certificate. Se o texto na saída NÃO corresponder ao texto a seguir, o firewall está interceptando a conexão:

     * Certificado do servidor:
     *  subject: C=US; ST=New York; L=Armonk; O=INTERNATIONAL BUSINESS MACHINES CORPORATION; CN=*.watsonplatform.net
     *  start date: Jan  9 00:00:00 2018 GMT
     *  expire date: Mar  9 12:00:00 2020 GMT
     *  issuer: C=US; O=DigiCert Inc; OU=www.digicert.com; CN=GeoTrust RSA CA 2018
     *  SSL certificate verify ok.
     

  Talvez seja possível resolver o problema de uma das seguintes maneiras:

  • Entre em contato com o administrador do firewall para incluir o nome do host na lista de desbloqueio, para que o firewall não intercepte o certificado.
  • Configure o Voice Gateway para confiar no certificado trocado pelo firewall. Para obter mais informações, consulte Configurando a criptografia SSL e TLS.