Ir al contenido
Documentación de Connecto
connecto.lat
Guía de usuarioCall center y telefonía

Servidor y líneas

Para qué sirve#

Aquí conectas Connecto con tu servidor de telefonía (FreeSWITCH), enciendes la telefonía propia y das de alta las líneas VoIP de tu proveedor de telefonía. Es la base de todo: sin esto no hay softphone, ni llamadas, ni grabaciones.

Quién puede usarlo y cómo llegar#

  • Quién: solo administradores («Solo un administrador puede cambiar esta configuración.»).
  • Cómo llegar: menú lateral → Configuración → Telefonía y llamadas → pestaña Servidor y líneas.

La pantalla «Telefonía y llamadas» tiene siete pestañas: Servidor y líneas, Extensiones, Grabación y transcripción, Atención de llamadas, Campañas de llamadas, Lista de «no llamar» y Proveedor externo. Recuerda la última que visitaste.

El servidor de telefonía lo monta el equipo técnico con la guía de instalación del proyecto. Al terminar, el instalador entrega un «bloque de conexión» que se pega aquí. Esta página explica solo lo que ves en Connecto.

Telefonía propia (PBX)#

Encabezado de la pestaña, con el interruptor Telefonía activa y su etiqueta ENCENDIDA / APAGADA. Está apagada por defecto. Al cambiarlo se guarda al instante.

Debajo, un cuadro de resumen que se actualiza cada 30 segundos:

DatoQué significa
ServidorEl dominio configurado, o «sin configurar».
SincronizaciónNUNCA (el servidor aún no se ha conectado), AL DÍA (con «hace X s / min») o SIN NOTICIAS (más de 3 minutos sin sincronizar).
Líneas registradas«N de M»: las líneas registradas en el proveedor sobre las activas.
ExtensionesExtensiones activas con agente.
Llamadas en cursoCuántas llamadas hay ahora en el servidor.

Conexión con el servidor FreeSWITCH#

Botón Pegar datos de conexión: abre una ventana donde pegas el contenido del archivo que deja el instalador en el servidor. Rellena el dominio, el socket de eventos y los secretos. Luego enciende la telefonía y pulsa «Probar conexión».

CampoQué haceValores / reglasPor defecto
Dominio del servidor *Dirección del servidor; se usa para el softphone (WSS) y como dominio SIP. Debe apuntar al servidor (si usas Cloudflare, en «solo DNS», nube gris).Un dominio como pbx.miempresa.com. Si pegas «https://…» se limpia solo. Mensaje: «Escribe el dominio del servidor de telefonía (por ejemplo pbx.miempresa.com).»Vacío
Puerto WSS del softphonePuerto seguro por el que se conecta el navegador.1–655357443
Dirección del socket de eventos (ESL)Por donde Connecto controla el servidor (llamadas en vivo, supervisión). Puede ser la IP.Dominio o IPIgual al dominio
Puerto ESL1–655358021
Contraseña ESLClave del socket de eventos.Mínimo 8 caracteres.Sin poner
Dirección de las grabacionesDónde se escuchan las grabaciones.https://dominio sin ruta («La dirección de las grabaciones debe ser https://dominio (sin ruta).»)https:// + el dominio
Secreto de las grabacionesFirma los enlaces temporales de las grabaciones.Mínimo 8 caracteres.Sin poner
Secreto de sincronizaciónAutentica la sincronización entre Connecto y el servidor.Mínimo 8 caracteres.Sin poner

Los secretos nunca se muestran: una etiqueta junto a cada uno dice GUARDADO o SIN PONER. Escribe uno nuevo solo si quieres cambiarlo (error: «Los secretos deben tener al menos 8 caracteres.»). Si cambias de servidor, IP o contraseñas, actualízalos aquí.

Red del softphone (calidad de audio)#

CampoQué hacePor defecto
Servidor STUNAyuda al navegador a encontrar su ruta de audio. Formato stun:servidor:3478.stun:stun.l.google.com:19302
Servidor TURN (opcional)Solo si hay agentes detrás de firewalls que bloquean el audio. Formato turn:servidor:3478.Vacío
Usuario / clave TURNCredenciales del TURN.Vacío

Botones#

BotónQué hace
Guardar conexiónGuarda los campos («Conexión guardada»).
Probar conexiónHace cinco comprobaciones y muestra ✔/✖ con detalle: Dominio (resuelve), Socket de eventos (ESL), WebSocket seguro (WSS) para el softphone, Servidor de grabaciones y Sincronización (pbx-sync).
Sincronizar ahoraAvisa al servidor para que descargue la configuración ya («Servidor avisado: se sincroniza ahora.»). Si no se puede, lo hace solo en menos de un minuto.

Cada cambio de líneas, extensiones o configuración se envía al servidor automáticamente; las llamadas en curso no se tocan.

Líneas VoIP#

Cada línea es una cuenta de tu proveedor de telefonía (servidor, usuario y contraseña). Connecto la registra en el servidor de telefonía, que convierte los códecs entre el navegador (Opus) y el proveedor (G.711/G.722).

La tabla muestra: Línea (con la etiqueta PREDETERMINADA y el número), Servidor (con puerto y transporte), Usuario, Estado y Llamadas entrantes, más botones para editar y eliminar.

EstadoSignificado
REGISTRADARegistrada correctamente en el proveedor.
POR IPLa línea no se registra (el proveedor autentica por IP).
SIN REGISTRO / NO REGISTRADANo está registrada.
REGISTRANDO…En proceso.
FALLÓ / FALLÓ, REINTENTANDOEl proveedor rechazó o no respondió.
INACTIVALa línea está desactivada.

El estado lo informa el servidor en cada sincronización; después de guardar una línea puede tardar unos segundos en actualizarse.

Agregar o editar una línea#

Botones Agregar línea (ventana «Agregar línea») o el lápiz en la fila.

CampoQué haceValores / reglasPor defecto
Nombre *Cómo la reconoces (hasta 80 caracteres).Obligatorio.—
Número o extensión de la línea (DID)Sirve para reconocer las llamadas que llegan y como identificador de salida.Solo dígitos y «+».Vacío
Servidor del proveedor *Ej. sip.proveedor.com.Letras, números, puntos y guiones; sin «sip:» ni puerto (el puerto va aparte).—
Puerto / transportePuerto 1–65535; UDP, TCP o TLS5060 / UDP
Usuario *Usuario SIP que te dio el proveedor.Sin espacios ni símbolos como < > " ' &.—
ContraseñaClave de la línea. Etiqueta GUARDADA / SIN PONER.Obligatoria al crear una línea que se registra («Escribe la contraseña de la línea.»); al editar, déjala vacía para conservar la actual.—
Número que ve quien recibe la llamadaIdentificador de llamada saliente.Dígitos y «+».El DID (o el usuario)
Nombre que ve quien recibe la llamadaHasta 60 caracteres.Vacío
Indicativo del paísCódigo de país de la línea.Hasta 4 dígitos57
Cómo se marca al proveedorFormato del número saliente.«Con indicativo del país (57300…)» · «Nacional (300…)» · «Tal como lo escribe el agente»Con indicativo del país
Prefijo de marcadoSe antepone al número, por ejemplo 9 o 00.Dígitos, #, * (hasta 10)Ninguno
Línea predeterminadaLa que usan las extensiones sin línea propia.Sí / NoLa primera línea creada es la predeterminada
Línea activaSi la apagas, deja de usarse.Sí / NoActiva

Datos avanzados del proveedor (despliega «solo si te los piden»):

CampoQué hacePor defecto
Usuario de autenticaciónSi es distinto del usuario.Vacío
Dominio / realmVacío
Proxy de salidaEj. proxy.proveedor.com:5060.Vacío
Renovar registro cada (seg)600 (rango 60–3600)
La línea se registra en el proveedorDesmárcalo si el proveedor te autentica por IP.Marcado

Llamadas entrantes de la línea:

CampoQué hacePor defecto
Quién las recibe«Suenan a todos los agentes de la línea» · «Solo a estas extensiones» · «No recibir llamadas en esta línea».Todos los agentes de la línea
Segundos sonandoCuánto suena antes de pasar a «nadie contesta».25 (rango 5–120)
Extensiones (separadas por coma)Solo con «Solo a estas extensiones»; ej. 1001, 1002. Obligatorio en ese modo («Indica las extensiones que reciben las llamadas de esta línea.»).Vacío

Pegar varias líneas#

Botón Pegar varias líneas: una línea por renglón, separadas por coma, punto y coma, tabulador o barra |.

Formatos aceptados:

Texto
servidor, usuario, contraseña, número
usuario:contraseña@servidor:puerto, número

Se crean con el nombre «usuario@servidor»; después ajusta cada una (identificador, prefijo, etc.). Si un renglón no se entiende: «No se entendió el renglón N.».

Eliminar una línea#

Icono de papelera y confirmación «¿Eliminar la línea …? Las llamadas dejarán de entrar y salir por ella.». Si borras la predeterminada, otra línea activa pasa a serlo.

Paso a paso: dejar la telefonía funcionando#

  1. Pide al equipo técnico el bloque de conexión del servidor (o los datos).
  2. Pulsa Pegar datos de conexión y pega el contenido; pulsa Importar.
  3. Revisa los campos y pulsa Guardar conexión.
  4. Enciende Telefonía activa.
  5. Pulsa Probar conexión y verifica que todo esté en verde (la primera sincronización puede tardar hasta un minuto).
  6. Agrega tus líneas en Agregar línea.
  7. Crea las extensiones de tus asesores.
La telefonía apagada no recibe ni hace llamadas. Al apagarla, el softphone no se muestra y el monitor avisa que no está activada. Los datos de conexión, líneas y extensiones se conservan.

<!-- Fuente: tenant-app/views/partials/cfg_pbx.php, tenant-app/public/api/pbx_cfg.php, shared/src/Core/Pbx.php, tenant-app/public/configuracion/index.php, db/migrations/0110_pbx_telefonia.sql, docs/pbx/GUIA_INSTALACION_FREESWITCH.md -->

¿Te fue útil esta página?
Última actualización: 14/11/2026