Softfones: Zoiper, MicroSIP, Linphone

Softfone é um telefone-programa: no computador do operador de caixa, no notebook do administrador ou no smartphone do gerente. Para a central telefônica, ele não é diferente de um aparelho de mesa: você concede ao funcionário um ramal no painel de administração e insere os mesmos cinco valores — servidor SIP, login, senha, porta 5060, transporte UDP. Onde encontrá-los e o que significam — no guia «Configuração de telefones SIP».

Resumindo, o que escolher:

Depois de configurar — disque imediatamente *43: a central telefônica devolverá sua própria voz. É a única verificação de que o áudio passa, e não apenas o registro (detalhes — abaixo).

Quando usar softfone e quando usar telefone de mesa#

O softfone é bom onde a pessoa já está sentada ao computador ou segura o telefone na mão: administrador, gerente, operador de delivery, contador. Ele é gratuito ou quase gratuito, não exige tomada nem cabo e mostra os contatos na hora.

Um telefone de mesa ou DECT é necessário onde a chamada não pode ser perdida:

• Balcão, bar, recepção. O computador entra em suspensão, atualiza, alguém fecha o programa — e as chamadas silenciosamente não chegam. O aparelho na mesa toca sempre.
• Garçons no salão. O smartphone no bolso recebe chamadas em segundo plano de forma pouco confiável (veja «Recebimento de chamadas em segundo plano»), enquanto o telefone DECT é um telefone que não faz mais nada além disso.
• Salão barulhento e cozinha. O alto-falante do notebook e o microfone embutido geram eco e ruído; o aparelho de mesa tem um fone adequado.

Um mesmo ramal pode ser mantido em vários dispositivos ao mesmo tempo (até 5): por exemplo, o telefone de mesa no balcão e o softfone no smartphone do administrador. A chamada recebida tocará em todos, e atenderá quem pegar o fone primeiro.

Zoiper#

Plataformas: Windows, macOS, Linux, Android, iOS. Baixe somente do site oficial zoiper.com ou da loja de aplicativos.

Configuração no computador (Zoiper 5)#

1. Instale e abra o Zoiper. Na primeira tela «Username and password», insira:
   • no campo superior — o login da janela, o sinal @ e o servidor SIP, por exemplo sip-a1b2c3d4-101@sip.example.com (é o que o próprio Zoiper sugere: «user@sip.example.com»);
   • no campo Password — a senha da janela.
2. Clique em Login. Se o Zoiper perguntar o endereço do servidor (Hostname) — insira o servidor SIP da janela. Deixe os campos «Authentication» e «Outbound proxy» vazios.
3. O Zoiper verificará quais métodos de conexão funcionam (SIP TLS, SIP TCP, SIP UDP, IAX UDP). SIP TLS e IAX não serão encontrados no nosso caso — isso é normal. Escolha SIP UDP (ou SIP TCP, se o UDP não passar na sua rede) e clique em Next.
4. Em seguida, o assistente vai propor testar o microfone e o alto-falante — faça isso com o headset que você vai usar para falar.

Captura de tela: Zoiper 5 User Guide v.1.0.7, p. 10 («Activation»), https://www.zoiper.com/pdf/User%20Guide%20Zoiper%205%20v.1.0.7.pdf.

Configuração manual: qual campo vai onde#

Se a conta já foi criada ou o assistente não deu conta, abra Settings → Accounts → sua conta e confira os campos:

Deixe as caixas Use auth. username e Use outbound proxy desmarcadas. Use STUN pode ser desmarcado: nossa central telefônica lida sozinha com o NAT, não precisa de STUN.

Captura de tela: Zoiper 5 User Guide v.1.0.7, p. 30 («Accounts / SIP Accounts»), https://www.zoiper.com/pdf/User%20Guide%20Zoiper%205%20v.1.0.7.pdf.

Configuração no smartphone (Zoiper para Android e iOS)#

Os campos são os mesmos: ao criar a conta, escolha a configuração manual da conta SIP e preencha Hostname (servidor SIP), Username (login por inteiro), Password. O check verde ao lado da conta aparece em cerca de 30 segundos — significa que o registro foi concluído. Sobre o QR code — seção separada abaixo.

MicroSIP#

Somente Windows, gratuito e de código aberto. Instala-se em um minuto, fica na bandeja do sistema e quase não ocupa memória — uma boa escolha para o computador do caixa. Não lê QR: a configuração é feita por campos.

1. Baixe do site oficial microsip.org (versão comum ou portable).
2. Menu principal do MicroSIP → Add Account.
3. Preencha os campos conforme a tabela e clique em Save. Verifique o registro no painel administrativo: ao lado do operador acenderá um ponto verde.

Deixe SIP Proxy em branco. Media Encryption — Disabled: a criptografia de áudio (SRTP) não é oferecida pela nossa central telefônica; com ela a ligação não conecta. ICE — desligado.

Captura de tela: MicroSIP Help, seção Account, https://www.microsip.org/help.

Linphone#

Cliente aberto e gratuito da Belledonne Communications: Windows, macOS, Linux, Android, iOS. Seu assistente, na primeira execução, oferece criar uma conta no serviço próprio deles — não precisamos dela.

1. Na tela inicial, escolha Third Party SIP Account ("Use a third party SIP account"). O aplicativo avisará que parte dos recursos do Linphone (chats em grupo, videoconferências) não está disponível com uma conta de terceiros — clique em I understand.
2. Preencha os campos conforme a tabela e clique em Login.

Deixe Authentication ID (if different) e Outbound proxy em branco.

As notificações push do Linphone funcionam por um servidor intermediário da Belledonne (Flexisip); uma conta de terceiros, como a nossa, não o tem — por isso, no smartphone, o Linphone recebe chamadas em segundo plano pior do que em um aplicativo aberto. Veja "Recebimento de chamadas em segundo plano".

Grandstream Wave Lite#

Cliente SIP gratuito da Grandstream para Android e iOS. Não confundir com o Wave (sem Lite): este é voltado para as centrais Grandstream UCM e entra por convite delas — não se conecta à nossa central telefônica. No Wave Lite, adicione a conta SIP manualmente com os mesmos valores: servidor — o servidor SIP da janela, login — completo (e também no campo de identificador de autenticação, se for separado), senha, transporte UDP. O Wave Lite não lê o QR do painel administrativo: a Grandstream tem formato próprio.

QR do painel administrativo#

Na janela "Credenciais do ramal" há o botão "Mostrar QR". Dentro do código há uma linha no formato

sip:<login>:<senha>@<servidor-SIP>:5060;transport=udp

ou seja, todos os dados, incluindo a senha. Por isso:

• mostre o QR apenas a quem você está entregando o ramal; não o fotografe nem o encaminhe — é o mesmo que encaminhar a senha;
• depois de fechar a janela, o QR não pode ser recuperado (não armazenamos a senha) — apenas "Redefinir senha" e um novo QR.

Quem vai entendê-lo. Os leitores de QR integrados do Zoiper e do Linphone são feitos antes de tudo para um link de autoconfiguração (provisioning), e não para uma linha como essa: o Zoiper descreve seu leitor para códigos gerados no serviço dele, e nas versões atuais do Linphone (6.x para Android e iOS) o leitor, pelo código de origem, aceita apenas um link web para um arquivo de configuração — a nossa linha ele rejeitará com a mensagem "Invalid QR code!". Vale tentar o QR no Zoiper; se a conta não foi criada — digite os campos, são dois minutos. O mais prático é clicar em "Copiar todas as configurações" e enviar o texto ao colaborador em um mensageiro pessoal: ele o abrirá no mesmo smartphone e copiará login e senha no aplicativo sem erros.

Recebimento de chamadas em segundo plano no smartphone#

Vamos ser honestos: ninguém pode garantir que o smartphone com softphone vai tocar quando o aplicativo estiver minimizado ou a tela apagada — nem nós, nem os fabricantes de softphones. A razão está nos próprios sistemas operacionais:

• O Android suspende os aplicativos em segundo plano (modo Doze e "otimização de bateria") e, ao passar do Wi-Fi para a internet móvel, derruba as conexões deles. O registro se perde silenciosamente — no painel administrativo a unidade ainda fica verde por um tempo, mas a chamada já não chega ao telefone. Em algumas interfaces (Xiaomi MIUI/HyperOS, Huawei EMUI), os aplicativos são descarregados de forma ainda mais agressiva.
• O iOS simplesmente não permite que um aplicativo comum mantenha a conexão em segundo plano: a chamada recebida só desperta o aplicativo por meio de uma notificação push (serviço da Apple) e, para isso, o softphone precisa ter seu próprio servidor push intermediário.

O que dá para fazer para reduzir o risco:

1. Android: Configurações → Aplicativos → seu softphone → Bateria → "Sem restrições" (ou desativar a "otimização de bateria"); permitir trabalho em segundo plano, exibição sobre outros aplicativos e notificações. No Xiaomi — também a "Inicialização automática".
2. O Zoiper oferece seu próprio serviço Push Proxy (Firebase no Android, APNs no iOS) — segundo a documentação do Zoiper, essa é a única forma confiável de receber chamadas em segundo plano. Conecta-se no aplicativo; condições e preço — com o Zoiper. A exigência do serviço para a central telefônica é permitir o reregistro por um prazo a partir de 1 hora: nossa central aceita o prazo de até 3600 segundos, ou seja, exatamente esse mínimo.
3. O Linphone com uma conta de terceiros não recebe push (é necessário o servidor Flexisip deles) — mantenha o aplicativo aberto.
4. Mantenha o aplicativo aberto na tela quando estiver esperando uma chamada (por exemplo, o smartphone em um suporte perto do caixa).

E o mais importante: onde não se pode perder a chamada — coloque um telefone de mesa ou DECT, e deixe o smartphone como segundo dispositivo no mesmo ramal.

Headset e som#

• O headset é obrigatório para trabalhar no computador. Os alto-falantes e o microfone embutidos do notebook no viva-voz geram eco para o interlocutor: seu alto-falante entra no seu próprio microfone. O Zoiper escreve diretamente na documentação que é tecnicamente impossível eliminar o eco que vem do outro lado — ele é eliminado por quem o cria.
• Um headset USB é mais confiável que o Bluetooth: não tem atraso nem falhas com sinal fraco, não é "capturado" pelo smartphone e não muda sozinho para o modo "fones sem microfone". O headset Bluetooth funciona, mas no modo de conversa o som fica visivelmente pior do que ao ouvir música.
• Escolha o dispositivo explicitamente nas configurações do softphone: Zoiper — Settings → Audio (microfone, alto-falante, um Ringing device separado), MicroSIP — Settings → Ring Device / Speaker / Microphone. É prático direcionar o toque para os alto-falantes do computador e a conversa para o headset. No Zoiper há a caixa de seleção "Ring also through PC speakerphone" — o toque é audível mesmo se o headset não estiver sendo usado.
• Não desative o cancelamento de eco (Echo cancellation / EC) — é o que o Zoiper recomenda; no MicroSIP é a caixa de seleção EC em Settings.
• Botões de atender no headset: MicroSIP — caixa de seleção Handle Media Buttons em Settings (botões do headset e do teclado multimídia), Zoiper — Settings → Audio → Use generic HID (além de modos separados para Jabra e Plantronics).

Verificação de som *43#

O ponto verde ao lado do operador no painel administrativo indica apenas o registro (porta 5060). A voz vai em um fluxo separado e quebra separadamente. Por isso, logo após a configuração, disque no softphone *43 e pressione o botão de chamada:

1. A central atenderá e dará um sinal de chamada curto;
2. depois fale por uns dez segundos — você ouvirá sua própria voz.

A verificação é gratuita e não liga para lugar nenhum. Os números (perdas, jitter, atraso) entram no histórico de chamadas — em detalhes na visão geral: «Verificação da qualidade da conexão». Análise de problemas de som — «Sem som, ouve-se em um só sentido, eco».

Se o softphone não se registra#

Primeiro — as causas gerais, da mais comum à mais rara (elas são as mesmas para qualquer aparelho):

1. Login incompleto. É necessário sip-…-<número>, e não "101".
2. Senha desatualizada. Alguém clicou em "Redefinir senha" — a antiga não funciona. Gere uma nova.
3. Endereço de servidor errado. O estabelecimento com máquina dedicada tem endereço próprio — copie da janela.
4. Linphone em TLS. Mude o Transport para UDP.
5. A rede bloqueia UDP 5060 (Wi-Fi de hóspedes, algumas redes móveis, VPN corporativa): tente TCP ou outra rede — a mesma conta em casa ou pela internet móvel.

O que significam as mensagens do Zoiper (conforme a documentação dele):

Análise completa dos códigos e mensagens de diferentes aparelhos — «Não se registra: mensagens e códigos de erro», todos os sintomas — «Diagnóstico por sintomas».

Perguntas frequentes#

É possível manter um mesmo ramal tanto no telefone de mesa quanto no softphone?#

Sim. Uma conta se registra simultaneamente em vários dispositivos (até cinco), a chamada recebida toca em todos, atende quem pegar o fone primeiro. Uma combinação prática: aparelho de mesa na recepção + softphone no smartphone do administrador.

O Zoiper gratuito é suficiente?#

Tecnicamente, para fazer chamadas — sim, mas a versão gratuita do Zoiper, conforme a licença dele, é apenas para uso não comercial. O estabelecimento precisa do Premium (compra única por dispositivo) — ou use os gratuitos MicroSIP (Windows) e Linphone.

Por que o QR code do painel de administração não funcionou?#

Dentro do QR há a string sip:login:senha@servidor:porta. Os scanners do Zoiper e do Linphone esperam, em primeiro lugar, um link de autoconfiguração do próprio serviço, e o Linphone 6.x aceita apenas esse tipo de link. Preencha os campos manualmente ou envie ao colaborador o texto pelo botão "Copiar todas as configurações".

O softphone no smartphone não toca quando a tela está desligada#

Esse é o comportamento do Android e do iOS, e não um defeito da central: o sistema suspende o aplicativo e o registro se perde. Desative a otimização de bateria e permita a execução em segundo plano; no Zoiper, ative o Push Proxy. Se as chamadas continuarem se perdendo — é preciso um telefone de mesa ou DECT.

O interlocutor ouve eco quando eu falo do notebook#

É o seu alto-falante entrando no seu microfone. Coloque um headset e verifique se o cancelamento de eco está ativado nas configurações do softphone. Se quem ouve o eco é você — ele nasce no lado do interlocutor, não é possível corrigi-lo do seu lado.

É possível criptografar as chamadas no softphone (TLS, SRTP, ZRTP)?#

No momento, não: a central aceita UDP e TCP na porta 5060 e áudio aberto. TLS ou criptografia de áudio ativados no softphone farão com que a conta não se registre ou a chamada não se complete.

Seções relacionadas#

• Visão geral: conectar o telefone à central — credenciais, teste de eco *43, redefinição
• Rede, roteador e internet para telefonia — SIP ALG, NAT, quanta internet é necessária
• Diagnóstico por sintomas
• Não se registra: mensagens e códigos de erro
• Sem áudio, som em uma só direção, eco
• A chamada cai

Fontes#

• Zoiper 5 User Guide v.1.0.7 (assistente "Username and password" e seleção de SIP TLS/TCP/UDP — p. 9–10; Accounts → SIP Accounts: Domain, Username, Password, Use auth. username, Outbound proxy — p. 30; Transport, Keep alive, rport, STUN — p. 34–35; som, Echo cancellation, Ringing device, headsets HID — p. 41–42) — https://www.zoiper.com/pdf/User%20Guide%20Zoiper%205%20v.1.0.7.pdf
• Zoiper: Informational and error messages (SIP 401, 403, 408, 503 Transport Failure, 923 No DNS results) — https://www.zoiper.com/en/support/answer/for/android/80/Informational_and_error_messages ; Error SIP 923 — https://www.zoiper.com/en/support/home/article/20/Error%20SIP%20923
• Zoiper Push Proxy FAQ (chamadas recebidas em segundo plano no iOS/Android somente via push, prazo de reregistro a partir de 1 hora) — https://www.zoiper.com/en/support/home/article/205/Zoiper_Push_Proxy
• Zoiper: How to generate QR codes on Zoiper OEM (os QR são gerados no serviço Zoiper, valem por 48 horas, são escaneados uma vez) — https://www.zoiper.com/en/support/home/article/218/How%20to%20generate%20QR%20codes%20on%20Zoiper%20OEM
• Zoiper 5 download (plataformas; versão gratuita — "non-commercial use only") — https://www.zoiper.com/en/voip-softphone/download/current
• MicroSIP Help (campos da janela Account, Settings: dispositivos de som, codecs, Handle Media Buttons) — https://www.microsip.org/help
• Linphone: Log in with Third-Party SIP Account — https://www.linphone.org/en/docs/login-sip-account/ ; QR Code / Provisioning Link Login — https://www.linphone.org/en/docs/login-with-qrcode/
• Código-fonte do linphone-android: QrCodeViewModel.kt (o QR é aceito somente como link de autoconfiguração), ThirdPartySipAccountLoginViewModel.kt e CorePreferences.kt (transporte padrão — TLS), strings.xml (nomes dos campos) — https://github.com/BelledonneCommunications/linphone-android
• Grandstream: Wave Application FAQ (Wave — para UCM; cliente SIP comum — Wave Lite) — https://documentation.grandstream.com/knowledge-base/wave-application-faq/
• Android Developers: Optimize for Doze and App Standby — https://developer.android.com/training/monitoring-device-state/doze-standby
• Código da central telefônica: formato do QR e do texto "Copiar todas as configurações" — admin/lib/sip-provisioning.ts; janela "Credenciais do ramal" — admin/components/integrations/SipOperatorRevealModal.tsx; prazo de registro 60–3600 s, codecs, NAT — shared/sip/advanced-options.json