Como configurar o Xlite para um ramal sip no Elastix ou operadora voip

Um ramal SIP é o número lógico de um telefone dentro de uma central VoIP — e um softfone é o aplicativo que transforma o computador ou o celular nesse telefone. Configurar o X-Lite (ou qualquer softfone atual) para registrar um ramal no Elastix, no Issabel, no Asterisk puro ou direto numa operadora VoIP é uma das primeiras tarefas de quem monta uma rede de telefonia IP — e este guia mostra o passo a passo completo: o que pedir ao servidor, onde digitar cada credencial, como resolver o clássico problema do áudio que não passa e quais erros de registro significam cada código de falha.

O que você precisa antes de começar

Independente do software escolhido, registrar um ramal SIP exige sempre o mesmo conjunto de credenciais, que quem administra a central (ou a operadora VoIP) deve fornecer:

• Ramal (user ID / extension): o número ou nome de usuário da extensão, por exemplo 1001;
• Senha (password / secret): a senha SIP do ramal, definida na criação da extensão;
• Domínio ou servidor (domain / proxy): o endereço IP ou nome DNS da central — por exemplo 192.168.1.10 na rede local, ou voip.suaoperadora.com.br para operadora;
• Porta: quase sempre 5060 UDP (o padrão SIP); 5061 é a porta do SIP sobre TLS;
• Nome de exibição (display name): o nome que aparece no visor de quem recebe a ligação.

Se a ideia de “telefone pela internet” ainda é novidade, vale ler primeiro o guia o que é VoIP e como funciona, que explica o caminho da voz em pacotes IP antes de qualquer configuração.

E o Elastix: ainda existe?

Honestidade primeiro: o Elastix foi descontinuado. O projeto, que nasceu como a distribuição Linux mais amigável para Asterisk (a central VoIP open source mais usada no mundo), foi comprado pela 3CX e abandonou a versão livre por volta de 2016. O sucessor comunitário direto é o Issabel — um fork que segue o mesmo visual e a mesma lógica — mas por baixo dos dois continua existindo o mesmo Asterisk.

E é exatamente por isso que este tutorial continua 100% válido: o softfone não fala com o Elastix, ele fala SIP com o Asterisk. Quem aprende a registrar um ramal aqui sabe registrar em qualquer plataforma baseada em Asterisk (Issabel, Asterisk puro em modo texto, FreePBX) e também em operadoras VoIP — que no fundo entregam as mesmas credenciais SIP. A mesma lógica vale para entender por que existem protocolos diferentes de sinalização, tema do guia qual a diferença entre SIP e IAX.

Qual softfone usar hoje

O X-Lite, da CounterPath, foi por anos o softfone gratuito mais usado em tutoriais — e também foi descontinuado, substituído pelo Bria Solo (gratuito, com cadastro). Nada muda na prática: todos os softfones usam o mesmo padrão SIP e pedem os mesmos campos. Opções atuais e gratuitas:

Nos exemplos abaixo usamos a nomenclatura do X-Lite (User ID, Domain, Password), mas os mesmos valores vão nos campos equivalentes de qualquer um deles.

Passo 1 — Criar o ramal no servidor (Elastix/Issabel/Asterisk)

Antes de abrir o softfone, o ramal precisa existir na central. No Elastix e no Issabel o caminho é o mesmo:

1. Acesse a interface web da central (por padrão https://IP-do-servidor) e entre como administrador;
2. Vá em PBX → Extensões (Extensions) → Adicionar extensão SIP;
3. Em User Extension, defina o número do ramal (1001, por exemplo);
4. Preencha Display Name com o nome do usuário;
5. Em secret, defina a senha do ramal — anote, ela será a Password do softfone;
6. Se o softfone vai operar fora da rede local (internet), deixe NAT Mode = yes — detalhe que evita metade dos problemas de áudio;
7. Salve e aplique as mudanças (o botão Apply Changes grava a configuração no Asterisk).

Para o lado do servidor em produção com operadora, o próximo passo natural é o tronco SIP de operadoras VoIP — o vídeo original deste post recomenda exatamente esse tutorial como sequência, pois ramal + tronco são as duas metades de uma central que liga para a rede pública. Quem opera bilhetagem costuma integrar o A2Billing, como no passo a passo de provedor e tronco no A2Billing.

Passo 2 — Configurar o softfone

Com o ramal criado, abra o softfone. No X-Lite (e no Bria):

1. Menu Softphone → Account Settings (ou Account Wizard);
2. Account name: um apelido qualquer, por exemplo “Ramal 1001”;
3. User ID: o número do ramal (1001);
4. Domain: o IP ou domínio da central — na rede local, o IP do servidor Elastix (ex.: 192.168.1.10); pela internet, o domínio ou IP público com a porta (ex.: voip.meudominio.com.br:5060);
5. Password: o secret definido no passo 1;
6. Display name: seu nome, como aparecerá para quem receber chamadas;
7. Avance e salve. O softfone tenta o registro imediatamente.

Em poucos segundos o status deve mudar para Available/Pronto — isso significa que o registro SIP foi aceito pela central. Para operadora VoIP, o procedimento é idêntico: User ID e Password vêm do painel da operadora, e o Domain é o endereço que ela informa (algumas exigem o número completo com DDI e DDD como usuário).

NAT e firewall: quando “liga mas não escuta”

O problema mais comum — e o que mais faz gente desistir do VoIP — é o registro funcionar perfeitamente, a chamada completar, e o áudio ficar mudo ou ir só numa direção. A causa é quase sempre o NAT (a tradução de endereços do roteador) escondendo o caminho do áudio. O SIP só negocia a ligação; a voz em si viaja por outro protocolo, o RTP, em portas diferentes. Checklist de resolução:

1. NAT Mode = yes no cadastro do ramal (lado servidor) — obrigatório para ramais fora da rede local;
2. Desligue o SIP ALG do roteador. Esse “ajudante” de NAT da maioria dos roteadores quebra pacotes SIP em vez de consertá-los. Desative-o na interface do roteador;
3. Redirecione as portas UDP no firewall do servidor para a faixa RTP do Asterisk (por padrão 10000–20000) e a porta SIP 5060, quando a central está atrás de NAT;
4. No softfone remoto, ative STUN (servidores públicos como stun.l.google.com:19302) para ele descobrir seu endereço público real;
5. Evite duplo NAT (roteador atrás de roteador) no caminho do servidor.

Este é o mesmo universo do post sobre o bloqueio oculto de portas pelas operadoras de telefonia: em algumas conexões, a própria operadora de internet filtra portas SIP e a solução passa por mudar a porta de escuta ou usar TLS. Para montar a rede local do servidor, o guia de configuração de rede no Linux CentOS cobre o passo a passo de IP fixo no servidor da central — e, se a dúvida é qual sistema usar no servidor, há ainda o comparativo Windows ou Linux.

Testando o ramal

Com o registro ativo, valide em três níveis:

1. Teste de eco do Asterisk: discar *43 acessa o echo test — fale e ouça sua voz de volta, comprovando áudio nos dois sentidos;
2. Chamada entre ramais: registre um segundo softfone (celular com Zoiper, por exemplo) no ramal 1002 e discar de um para o outro;
3. Teste de qualidade: durante uma chamada, observe se há picotes — se houver, force o codec G.711 (PCM) no cadastro do ramal e verifique a largura de banda.

Para entender melhor o cenário completo — com telefones IP físicos e adaptadores ATA — o guia ATAs e telefones IP em uma rede de telefonia IP mostra como esses aparelhos convivem com os softfones na mesma central.

Erros comuns e o que significam

Quando o softfone NÃO é a solução

Por mais prático que seja, o softfone tem limites honestos:

• Operação intensiva (call center, recepção): tela e fone de computador não substituem um telefone IP ou um ATA com telefone comum — estabilidade e qualidade de áudio são superiores no hardware dedicado;
• Computador desligado = ramal fora do ar: para ramais críticos use telefone IP com PoE, que liga independente do PC;
• Segurança: nunca deixe o secret padrão nem exponha a porta 5060 sem necessidade; em produção, prefira TLS (5061) e SRTP e mantenha fail2ban ativo contra brute force;
• Chamadas de emergência: operadoras VoIP nem sempre entregam localização para serviços de emergência — não substitua a linha fixa para esse fim.

Resumindo

Configurar um ramal SIP é juntar cinco credenciais (ramal, senha, domínio, porta e nome) no softfone — e 90% dos problemas acontecem depois, na camada de NAT/RTP: registro aceito mas áudio mudo se resolve com NAT Mode yes, SIP ALG desligado e a faixa RTP 10000–20000 UDP liberada. O Elastix e o próprio X-Lite foram descontinuados, mas o conhecimento é atemporal porque o protocolo continua o mesmo — vale para Issabel, Asterisk, 3CX e qualquer operadora VoIP. Se o assunto telefonia IP te interessa de verdade, o caminho é estudar redes e eletrônica com base sólida — comece pelo nosso guia de cursos e acompanhe a demonstração original do Wagner no vídeo abaixo:

Perguntas frequentes

O X-Lite ainda pode ser baixado e usado?

O X-Lite foi descontinuado pela CounterPath e não tem mais download oficial — o sucessor gratuito é o Bria Solo. A boa notícia é que a configuração ensinada neste guia vale para qualquer softfone moderno (MicroSIP, Zoiper, Linphone, Bria), pois todos usam os mesmos campos SIP: usuário, senha, domínio e porta.

O Elastix ainda existe? O que usar no lugar?

O Elastix foi descontinuado após a aquisição pela 3CX, por volta de 2016. O substituto comunitário direto é o Issabel, um fork com a mesma interface, e existe ainda o FreePBX e o Asterisk puro (até em modo texto). Como todos rodam Asterisk por baixo, o registro de ramais SIP segue idêntico.

O que é um ramal SIP?

É a extensão lógica de uma central VoIP (IP-PBX), identificada por um número e uma senha, que pode ser associada a um softfone (aplicativo), a um telefone IP ou a um adaptador ATA. É o equivalente digital do ramal de uma central telefônica convencional, só que a chamada trafega em pacotes IP.

O registro falha com erro 401 ou 403. O que fazer?

Erro 401 quase sempre significa senha (secret) errada ou usuário diferente do número do ramal — confira os dois na extensão da central. Erro 403 costuma ser IP bloqueado pelo firewall da central (fail2ban) após tentativas erradas, ou conta desabilitada pela operadora; desbloqueie o IP ou contate a operadora.

Registra normal, mas não tem áudio (ou só numa direção). Como resolver?

É o problema clássico de NAT/RTP: o SIP negocia a chamada, mas a voz viaja em outras portas. Marque NAT Mode = yes no ramal, desligue o SIP ALG do roteador, redirecione a faixa UDP 10000–20000 para o servidor e, no softfone remoto, ative um servidor STUN. Teste discando *43 (eco do Asterisk).