Configurar Linphone con un código QR

Troncales SIP · 4 min de lectura Softphone Linphone

            Configura un softphone en segundos. En lugar de escribir a mano la dirección del servidor, el usuario y la contraseña en Linphone, escaneas un código QR desde tu portal de Cliqtel y la aplicación se configura sola — cifrada y lista para hacer y recibir llamadas.
        

Resumen

Linphone es un softphone gratuito y de código abierto para iOS, Android y escritorio. Cliqtel puede generar un código QR que contiene todo lo que Linphone necesita para registrarse en tu troncal SIP. Lo escaneas una vez y la cuenta se configura automáticamente — sin copiar y pegar credenciales, y sin riesgo de errores al escribir el servidor o la contraseña.

Esto funciona con cualquiera de tus troncales SIP: tu softphone web personal, un troncal para un teléfono de escritorio o un troncal dedicado que crees solo para tu móvil.

Qué necesitarás

Una cuenta de Cliqtel con al menos un troncal SIP. Si todavía no tienes uno, ve a Mis números → Troncales SIP y haz clic en Crear troncal.
La aplicación Linphone en el dispositivo desde el que quieres llamar (teléfono, tableta u ordenador).
Una conexión a internet en ese dispositivo (Wi-Fi o datos móviles).

Paso 1 — Instalar Linphone

1Consigue la aplicación

Instala Linphone desde la App Store (iPhone/iPad) o Google Play (Android). También hay una versión de escritorio disponible en linphone.org si prefieres llamar desde tu ordenador. Abre la aplicación, pero no introduzcas todavía ningún dato de la cuenta — el código QR lo hace por ti.

Paso 2 — Abrir el código QR en tu portal

2Genera tu código de configuración

Inicia sesión en tu portal de Cliqtel y ve a Troncales SIP (menú izquierdo, en Infraestructura).
Haz clic en el troncal que quieras usar para abrir su panel.
Haz clic en Configurar Linphone (QR). Aparecerá un código QR. (También puedes abrir Mostrar configuración del softphone — el mismo código se muestra ahí, encima de los ajustes manuales.)

Un código, un dispositivo. Cada código QR es de un solo uso y caduca al cabo de unos 15 minutos. Si caduca, o quieres configurar otro dispositivo, simplemente vuelve a abrir el panel para obtener uno nuevo.

Paso 3 — Escanearlo en Linphone

3Apunta la cámara al código

En la pantalla de bienvenida de Linphone, elige "Usar un código QR" (en algunas versiones: Asistente → Escanear código QR).
Apunta la cámara al código QR en tu pantalla.
Linphone lee el código y configura la cuenta automáticamente.

Eso es todo. En unos segundos Linphone muestra tu cuenta como conectada / registrada. De vuelta en el portal, el Estado de registro del troncal se pone en verde — tu dispositivo ya está listo para recibir llamadas.

Paso 4 — Hacer una llamada de prueba

4Confirma el audio en ambos sentidos

Si hay un número de teléfono asignado a este troncal, llámalo desde otro teléfono — Linphone debería sonar. Para probar las llamadas salientes, marca desde Linphone un número al que puedas acceder (por ejemplo tu propio móvil) y confirma que os oís en ambas direcciones.

¿No puedes escanear? Opciones manuales

Si ya estás en el portal en el mismo dispositivo que Linphone (de modo que no hay una segunda pantalla que escanear), usa el botón Copiar enlace junto al código QR, y luego en Linphone abre Asistente → Obtener configuración remota y pega el enlace. Linphone descarga la misma configuración.

También puedes configurar Linphone completamente a mano usando los valores que aparecen en Mostrar configuración del softphone:

Ajustes SIP manuales

SIP Server:   sip.cliqtel.com
Transport:    TLS (port 5061) — recomendado
Username:     (se muestra en el panel del trunk)
Password:     (se muestra una sola vez al crear o regenerar el trunk)

Por qué el QR es más fácil: la opción manual necesita la contraseña en texto plano, que solo se muestra una vez al crear el troncal. El código QR configura la cuenta usando en su lugar un resumen seguro (digest), por lo que nunca tienes que recuperar ni volver a escribir la contraseña.

Solución de problemas

Síntoma	Qué hacer
El código no se genera, o dice que las credenciales están desactualizadas	Abre el troncal, haz clic en Regenerar contraseña, luego crea un código QR nuevo y escanéalo.
Linphone dice que el código no es válido o ha caducado	El código es de un solo uso y dura unos 15 minutos. Vuelve a abrir el panel del troncal para generar uno nuevo.
Linphone nunca muestra "registrado"	Comprueba que el dispositivo tenga internet. En redes restrictivas, permite SIP sobre TLS (puerto TCP 5061) más UDP 10000–20000 para el audio.
Las llamadas se conectan pero no hay audio en un sentido	Casi siempre se debe a un firewall/NAT que bloquea los puertos de audio (RTP) indicados arriba. Prueba con datos móviles para confirmarlo y luego ajusta la red.

Seguridad & privacidad

Ninguna contraseña en texto plano sale del portal. El QR codifica un enlace de un solo uso a una configuración que se autentica con un resumen seguro (digest), no con tu contraseña en bruto.
El enlace es de un solo uso y de corta duración (unos 15 minutos), de modo que un código que no escanees simplemente caduca.
La señalización está cifrada — la configuración se registra sobre TLS de forma predeterminada.
Si alguna vez crees que otra persona ha visto un código, simplemente abre el troncal y haz clic en Regenerar contraseña; cualquier configuración antigua deja de funcionar de inmediato.

¿Listo para conectar tu softphone?

Abre Troncales SIP en tu portal, elige un troncal y escanea. ¿Tienes problemas? Contacta con soporte.

Ir a Troncales SIP →