Como configurar um ramal SIP via WebSocket seguro (WSS)

Última atualização: 25/05/2026

Este manual orienta a configuração de uma aplicação WebRTC ou softphone compatível para registrar um ramal Nvoip usando WebSocket seguro.

A conexão via WSS usa a mesma conta SIP do ramal. Ou seja, usuário, senha, permissões, limites, gravação, saldo, regras de discagem e bilhetagem continuam sendo aplicados pela Nvoip como em uma conexão SIP comum.

Quando usar

Use WSS quando sua aplicação precisar registrar um ramal Nvoip em um navegador, webphone, softphone WebRTC ou SDK compatível com SIP over WebSocket.

Não use WSS para integrar PABX, tronco SIP, gateway ou central IP tradicional. Para esses casos, use a configuração SIP normal ou fale com o suporte Nvoip para validar o cenário correto.

Dados de configuração

Substitua SEU_RAMAL pelo número do ramal da sua conta.

Exemplo de configuração

Se o ramal for 12345001, use:

Configuração em aplicação WebRTC

Em bibliotecas WebRTC/SIP, configure o transporte como WSS e informe o endereço wss://app.nvoip.com.br:7443 como servidor WebSocket.

Depois, use a identidade SIP do ramal:

• uri: sip:SEU_RAMAL@app.nvoip.com.br
• authorizationUser ou authUser: SEU_RAMAL
• password: senha SIP do ramal
• displayName: nome que deseja exibir para o usuário

Os nomes dos campos podem variar conforme a biblioteca usada. Em geral, eles aparecem como WebSocket server, SIP URI, authorization username, SIP password e SIP domain.

Regras aplicadas pela Nvoip

Chamadas feitas por WSS seguem as mesmas regras de uma conta SIP normal:

• autenticação do ramal;
• permissões de discagem;
• limite de chamadas simultâneas;
• limite de chamadas por segundo;
• bloqueios temporários de abuso;
• regras de gravação;
• saldo e billing;
• CDR e histórico de chamadas;
• transferência, DTMF e recursos configurados para o ramal.

Se a chamada for bloqueada por permissão, saldo, limite ou status da conta, a aplicação receberá uma resposta SIP de erro, da mesma forma que aconteceria em um softphone comum.

Boas práticas de segurança

• Use apenas wss://.
• Não use conexão sem TLS.
• Não compartilhe a mesma credencial SIP entre vários usuários finais.
• Evite deixar a senha SIP fixa em código JavaScript público.
• Se sua aplicação for web, prefira autenticar o usuário no seu backend e entregar credenciais de forma controlada.
• Troque a senha do ramal se ela for exposta.
• Use um ramal separado para cada operador ou dispositivo.

Cuidados com navegador e rede

Aplicações WebRTC dependem da rede do usuário e do navegador. Se houver falha de áudio, verifique:

• permissão de microfone no navegador;
• bloqueio de firewall corporativo;
• VPN ou proxy interferindo na mídia;
• compatibilidade da biblioteca SIP/WebRTC;
• uso correto de WSS em vez de WS;
• codec OPUS habilitado no cliente.

Em redes corporativas restritivas, pode ser necessário liberar tráfego WebRTC de mídia. Se o áudio continuar falhando, envie ao suporte Nvoip o horário do teste, ramal usado, destino chamado e navegador utilizado.

O que não configurar

Não configure:

• ws:// sem criptografia;
• IP direto do servidor;
• porta SIP UDP como WebSocket;
• usuário diferente do ramal no campo de autenticação;
• headers internos da Nvoip na aplicação do cliente;
• credenciais de administrador ou de outro ramal.

Teste recomendado

Depois de configurar, faça estes testes:

1. Registre o ramal e confirme que ele aparece online.
2. Faça uma ligação de saída para um número controlado.
3. Receba uma ligação nesse ramal.
4. Teste áudio nos dois sentidos.
5. Teste DTMF, se a aplicação usar URA, pesquisa ou transferência.
6. Confira se a chamada aparece no relatório da conta.

Se todos os testes funcionarem, a conexão WSS está pronta para uso.

Perguntas frequentes

WSS substitui minha conta SIP?

Não. WSS é apenas outro transporte para registrar o mesmo ramal SIP. A conta, as permissões e as regras continuam as mesmas.

Posso usar a mesma senha do meu softphone?

Sim, desde que seja a senha SIP do ramal. Por segurança, evite compartilhar a mesma credencial entre vários usuários.

Posso usar WSS em um PABX?

Normalmente não é o cenário recomendado. Para PABX, tronco SIP ou gateway, use a configuração SIP tradicional e valide o direcionamento com o suporte Nvoip.

Preciso pedir liberação especial?

Na maioria dos casos, não. Basta usar um ramal SIP ativo da conta e configurar o transporte WSS corretamente. Se houver bloqueio por política de rede ou necessidade de volume alto, fale com o suporte Nvoip antes de colocar em produção.