Configurar o Linphone com um código QR

Entroncamentos SIP · 4 min de leitura Softphone Linphone
Configure um softphone em segundos. Em vez de escrever manualmente o endereço do servidor, o nome de utilizador e a palavra-passe no Linphone, basta ler um código QR a partir do seu portal Cliqtel e a aplicação configura-se sozinha — encriptada e pronta para fazer e receber chamadas.

Visão geral

O Linphone é um softphone gratuito e de código aberto para iOS, Android e computador. A Cliqtel pode gerar um código QR que contém tudo o que o Linphone precisa para se registar no seu entroncamento SIP. Lê-o uma vez e a conta é configurada automaticamente — sem copiar e colar credenciais e sem o risco de um erro de escrita no servidor ou na palavra-passe.

Isto funciona com qualquer um dos seus entroncamentos SIP: o seu softphone web pessoal, um entroncamento de telefone de secretária ou um entroncamento dedicado que crie só para o seu telemóvel.

O que vai precisar

  • Uma conta Cliqtel com, pelo menos, um entroncamento SIP. Se ainda não tiver nenhum, vá a Os Meus Números → Entroncamentos SIP e clique em Criar Entroncamento.
  • A aplicação Linphone no dispositivo a partir do qual quer fazer chamadas (telemóvel, tablet ou computador).
  • Uma ligação à internet nesse dispositivo (Wi-Fi ou dados móveis).

Passo 1 — Instalar o Linphone

1Obter a aplicação

Instale o Linphone a partir da App Store (iPhone/iPad) ou da Google Play (Android). Existe uma versão para computador em linphone.org, caso prefira fazer chamadas a partir do seu computador. Abra a aplicação, mas não preencha ainda nenhum dado da conta — o código QR faz isso por si.

Passo 2 — Abrir o código QR no seu portal

2Gerar o seu código de configuração
  1. Inicie sessão no seu portal Cliqtel e vá a Entroncamentos SIP (menu à esquerda, em Infraestrutura).
  2. Clique no entroncamento que pretende usar para abrir o respetivo painel.
  3. Clique em Configurar o Linphone (QR). Surge um código QR. (Também pode abrir Mostrar Configuração do Softphone — o mesmo código aparece aí, acima das definições manuais.)
Um código, um dispositivo. Cada código QR é de utilização única e expira ao fim de cerca de 15 minutos. Se caducar, ou se quiser configurar outro dispositivo, basta reabrir o painel para obter um novo.

Passo 3 — Lê-lo no Linphone

3Aponte a câmara para o código
  1. No ecrã de boas-vindas do Linphone, escolha "Usar um código QR" (em algumas versões: Assistente → Ler código QR).
  2. Aponte a câmara para o código QR no seu ecrã.
  3. O Linphone lê o código e configura a conta automaticamente.
É tudo. Em poucos segundos, o Linphone mostra a sua conta como ligada / registada. De volta ao portal, o Estado de Registo do entroncamento fica verde — o seu dispositivo está agora pronto para receber chamadas.

Passo 4 — Fazer uma chamada de teste

4Confirmar áudio em ambos os sentidos

Se este entroncamento tiver um número de telefone atribuído, ligue para ele a partir de outro telefone — o Linphone deve tocar. Para testar as chamadas de saída, marque a partir do Linphone um número que consiga atender (por exemplo, o seu próprio telemóvel) e confirme que se ouvem mutuamente em ambos os sentidos.

Não consegue ler? Opções manuais

Se já estiver no portal no mesmo dispositivo em que está o Linphone (não havendo, por isso, um segundo ecrã para ler), use o botão Copiar ligação junto ao código QR e, depois, no Linphone abra Assistente → Obter configuração remota e cole a ligação. O Linphone descarrega a mesma configuração.

Também pode configurar o Linphone totalmente à mão, usando os valores em Mostrar Configuração do Softphone:

Definições SIP manuais
SIP Server:   sip.cliqtel.com
Transport:    TLS (port 5061) — recomendado
Username:     (exibido no painel do trunk)
Password:     (exibido uma única vez ao criar ou regenerar o trunk)
Porque é que o QR é mais simples: a via manual exige a palavra-passe em texto simples, que só é mostrada uma vez, no momento da criação do entroncamento. O código QR configura a conta usando, em vez disso, um digest seguro, pelo que nunca precisa de recuperar ou voltar a escrever a palavra-passe.

Resolução de problemas

SintomaO que fazer
O código não é gerado, ou indica que as credenciais estão desatualizadas Abra o entroncamento, clique em Regenerar Palavra-passe e, em seguida, crie um novo código QR e leia esse.
O Linphone diz que o código é inválido ou expirou O código é de utilização única e dura cerca de 15 minutos. Reabra o painel do entroncamento para gerar um novo.
O Linphone nunca mostra "registado" Verifique se o dispositivo tem internet. Em redes restritivas, permita SIP sobre TLS (porta TCP 5061) e UDP 10000–20000 para o áudio.
As chamadas ligam-se mas não há áudio num dos sentidos Trata-se quase sempre de uma firewall/NAT a bloquear as portas de áudio (RTP) acima indicadas. Experimente usar dados móveis para confirmar e, depois, ajuste a rede.

Segurança & privacidade

  • Nenhuma palavra-passe em texto simples sai do portal. O QR codifica uma ligação de utilização única para uma configuração que se autentica com um digest seguro, e não com a sua palavra-passe em bruto.
  • A ligação é de utilização única e de curta duração (cerca de 15 minutos), pelo que um código que não leia simplesmente expira.
  • A sinalização é encriptada — por predefinição, a configuração regista-se sobre TLS.
  • Se alguma vez achar que um código foi visto por outra pessoa, basta abrir o entroncamento e clicar em Regenerar Palavra-passe; qualquer configuração antiga deixa de funcionar de imediato.

Pronto para ligar o seu softphone?

Abra Entroncamentos SIP no seu portal, escolha um entroncamento e leia o código. Está com dificuldades? Contacte o suporte.

Ir para Entroncamentos SIP →