Este artigo orienta a integração e configuração de ramais do Sonax PABX em CRMs, discadores e WebPhones RTC operados via navegador web.
A utilização da conexão segura via WSS (WebSocket Secure) garante estabilidade na sinalização SIP, dispensa a instalação de softphones desktop terceiros e assegura conformidade com as exigências de segurança (HTTPS) dos navegadores modernos.
1. Mapeamento de Campos e Exemplo Prático de Configuração
Com base nas telas padrão de configuração de WebPhones WebRTC utilizadas no mercado, veja como preencher corretamente os dados do seu ramal Sonax PABX:
📸 Exemplo de Preenchimento na Interface do CRM
Nota de Configuração Real:
- Account Name: 11155555 (Código/Identificador da conta do ramal Sonax)
- Extension: 11155555 (Número do Ramal Sonax)
- Domain: ws-sip.sonax.net.br (Domínio do Servidor de Sinalização)
- WebSocket Server: wss://ws-sip.sonax.net.br/ws (Endpoint WSS completo com o path /ws)
- Password: XXXXXXXX (Senha do ramal gerada no painel Sonax)
- Display Name (Optional): 11155555 (Nome do ramal ou operador)
2. Detalhamento dos Campos para Ramais Sonax PABX
Para garantir que o seu ramal registre com status ONLINE no Sonax PABX, atente-se ao papel de cada campo:
- Account Name / Auth Username: Insira o identificador do seu ramal Sonax (ex: 29926253). Esse campo é indispensável para o processo de autenticação Digest SIP no servidor.
- Extension (Ramal): O número do ramal cadastrado na sua central Sonax PABX. Na maioria das configurações Sonax, é o mesmo valor do Account Name.
- Domain (Domínio): Defina como ws-sip.sonax.net.br. Este é o domínio que autentica as solicitações SIP do cliente.
- WebSocket Server (URI WSS): wss://ws-sip.sonax.net.br/ws
⚠️ Atenção: Em diversos WebPhones WebRTC, é obrigatório incluir o sufixo /ws no final do endereço WebSocket. O protocolo wss:// (porta 443) é indispensável para garantir a criptografia TLS exigida pelos navegadores.
- Password (Senha): A senha individual do ramal Sonax. Certifique-se de que não haja espaços em branco antes ou depois da senha.
- Display Name (Nome de Exibição): Campo opcional. Identifica o nome do atendente ou o número do ramal que aparecerá no visor da chamada.
3. Por que a configuração funciona nativamente no Sonax PABX?
A infraestrutura do Sonax PABX foi projetada para suportar chamadas via navegador através da convergência das tecnologias SIP + WebRTC:
- Atravessamento Seguro de NAT/Firewall: Ao utilizar a porta HTTPS padrão (443) via wss://, as requisições do ramal contornam bloqueios de redes corporativas que costumam fechar portas SIP padrão (5060 UDP).
- Qualidade de Áudio Adaptativa: O Sonax PABX negocia automaticamente codecs de alta definição otimizados para a Web (como G722 e G.711 / PCMU), garantindo clareza na voz mesmo sob oscilações de banda da internet.
- Compatibilidade Multi-CRM: Seguindo o padrão demonstrado acima, o ramal Sonax funciona perfeitamente em sistemas como Bitrix24, Exact Sales, Vtiger, CRMs proprietários e extensão de navegadores.
4. Checklist para Solução de Problemas (Troubleshooting)
Sintoma | Causa Provável | Solução Recomendada |
Status "Disconnected" / "Connection Error" | Esqueceu de colocar o /ws no final ou usou ws:// em vez de wss://. | Ajuste o servidor WebSocket para exatamente: wss://ws-sip.sonax.net.br/ws. |
Erro "401 Unauthorized" / "Auth Failed" | Account Name ou Password incorretos. | Confirme as credenciais no painel do Sonax PABX. Verifique se o Account Name é idêntico ao Extension. |
Sem som ao atender (Áudio Unilateral) | Bloqueio de porta de mídia UDP ou permissão do navegador. | 1. Verifique se o navegador tem permissão de Microfone liberada. |
O toque da chamada não toca | Política de Autoplay do navegador. | Clique em qualquer lugar dentro da página do CRM para autorizar a reprodução de áudio pelo browser. |