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.
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:
| Dato | Qué significa |
|---|---|
| Servidor | El dominio configurado, o «sin configurar». |
| Sincronización | NUNCA (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. |
| Extensiones | Extensiones activas con agente. |
| Llamadas en curso | Cuá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».
| Campo | Qué hace | Valores / reglas | Por 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 softphone | Puerto seguro por el que se conecta el navegador. | 1–65535 | 7443 |
| Dirección del socket de eventos (ESL) | Por donde Connecto controla el servidor (llamadas en vivo, supervisión). Puede ser la IP. | Dominio o IP | Igual al dominio |
| Puerto ESL | 1–65535 | 8021 | |
| Contraseña ESL | Clave del socket de eventos. | Mínimo 8 caracteres. | Sin poner |
| Dirección de las grabaciones | Dó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 grabaciones | Firma los enlaces temporales de las grabaciones. | Mínimo 8 caracteres. | Sin poner |
| Secreto de sincronización | Autentica 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)#
| Campo | Qué hace | Por defecto |
|---|---|---|
| Servidor STUN | Ayuda 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 TURN | Credenciales del TURN. | Vacío |
Botones#
| Botón | Qué hace |
|---|---|
| Guardar conexión | Guarda los campos («Conexión guardada»). |
| Probar conexión | Hace 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 ahora | Avisa 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.
| Estado | Significado |
|---|---|
| REGISTRADA | Registrada correctamente en el proveedor. |
| POR IP | La línea no se registra (el proveedor autentica por IP). |
| SIN REGISTRO / NO REGISTRADA | No está registrada. |
| REGISTRANDO… | En proceso. |
| FALLÓ / FALLÓ, REINTENTANDO | El proveedor rechazó o no respondió. |
| INACTIVA | La 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.
| Campo | Qué hace | Valores / reglas | Por 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 / transporte | Puerto 1–65535; UDP, TCP o TLS | 5060 / UDP | |
| Usuario * | Usuario SIP que te dio el proveedor. | Sin espacios ni símbolos como < > " ' &. | — |
| Contraseña | Clave 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 llamada | Identificador de llamada saliente. | Dígitos y «+». | El DID (o el usuario) |
| Nombre que ve quien recibe la llamada | Hasta 60 caracteres. | Vacío | |
| Indicativo del país | Código de país de la línea. | Hasta 4 dígitos | 57 |
| Cómo se marca al proveedor | Formato 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 marcado | Se antepone al número, por ejemplo 9 o 00. | Dígitos, #, * (hasta 10) | Ninguno |
| Línea predeterminada | La que usan las extensiones sin línea propia. | Sí / No | La primera línea creada es la predeterminada |
| Línea activa | Si la apagas, deja de usarse. | Sí / No | Activa |
Datos avanzados del proveedor (despliega «solo si te los piden»):
| Campo | Qué hace | Por defecto |
|---|---|---|
| Usuario de autenticación | Si es distinto del usuario. | Vacío |
| Dominio / realm | Vacío | |
| Proxy de salida | Ej. proxy.proveedor.com:5060. | Vacío |
| Renovar registro cada (seg) | 600 (rango 60–3600) | |
| La línea se registra en el proveedor | Desmárcalo si el proveedor te autentica por IP. | Marcado |
Llamadas entrantes de la línea:
| Campo | Qué hace | Por 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 sonando | Cuá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:
servidor, usuario, contraseña, número
usuario:contraseña@servidor:puerto, númeroSe 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#
- Pide al equipo técnico el bloque de conexión del servidor (o los datos).
- Pulsa Pegar datos de conexión y pega el contenido; pulsa Importar.
- Revisa los campos y pulsa Guardar conexión.
- Enciende Telefonía activa.
- Pulsa Probar conexión y verifica que todo esté en verde (la primera sincronización puede tardar hasta un minuto).
- Agrega tus líneas en Agregar línea.
- Crea las extensiones de tus asesores.
<!-- 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 -->