Conectar VitalPBX con IllyVoIP: troncal PJSIP y rutas de llamadas
Configura una troncal PJSIP en VitalPBX, las llamadas entrantes y salientes, el identificador de llamada y el audio, y revisa cada etapa de la conexión.
Esta guía sigue el flujo PJSIP de VitalPBX 4/4.5 y la documentación oficial revisada el 7 de octubre de 2026. Los nombres de los menús pueden variar según la versión. Se parte de una central ya instalada que utiliza autenticación IllyVoIP por contraseña. La instalación, la migración a autenticación IP y las llamadas de emergencia requieren una planificación independiente.
Registrar la troncal establece la conexión entre tu central e IllyVoIP. Para usarla también necesitas una ruta saliente autorizada para tus extensiones y una ruta entrante para el número de la empresa. Comprueba estas tres etapas por separado; así, un problema de rutas no te llevará a cambiar una contraseña que ya era correcta.
Antes de empezar
Necesitas acceso de administrador, una copia de seguridad privada, una extensión interna que funcione y permiso para utilizar la cuenta IllyVoIP. Mantén disponible la ruta actual de la oficina mientras preparas la nueva. Antes de una prueba real, revisa el saldo, las tarifas del destino y los límites de la línea o del paquete: la llamada de prueba puede tener coste. No hace falta comprar un número para registrar la troncal; recibir llamadas públicas sí requiere un número activo dirigido a ella.
1. Reúne los datos de conexión de IllyVoIP
Abre SIP Lines en el Portal y selecciona la línea prevista. Obtén su usuario SIP, contraseña SIP, nombre del servidor, puerto de destino y transporte. No son el correo ni la contraseña con los que accedes al Portal. Si la línea usa autenticación IP, sigue las instrucciones de esa conexión. Activar el registro o cambiar de modo puede interrumpir los dispositivos que ya la utilizan.
Usa los valores facilitados para tu cuenta. No copies servidores, contraseñas, puertos ni cabeceras específicas de otro operador de un tutorial ajeno. Guarda las credenciales en un gestor de contraseñas privado y no las incluyas en capturas ni publicaciones de soporte.
2. Crea la troncal PJSIP en VitalPBX
En VitalPBX, abre PBX → Calls Routing → Trunks. Elige PJSIP y una Description reconocible, como IllyVoIP. Mantén la troncal habilitada. Introduce la conexión remota en General y el registro en Outbound Registration Settings. PJSIP es el controlador de canales de Asterisk utilizado aquí; IllyVoIP sigue empleando el protocolo SIP.
| Campo de VitalPBX | Qué introducir o comprobar |
|---|---|
| Description | Una etiqueta local, como IllyVoIP; no es el usuario de autenticación. |
| Remote Host / Remote Port | Servidor SIP y puerto de destino facilitados para tu conexión IllyVoIP. |
| Remote Username / Remote Secret | Usuario SIP y contraseña SIP de la línea. |
| Require Registration | Actívalo para el registro mediante contraseña que explica esta guía. |
| Transport | El transporte SIP indicado. Para TLS, utiliza el nombre del servidor y la verificación válida del certificado. |
| Local Username / Local Secret | Campos de identidad o autenticación del lado local; no los confundas con las credenciales remotas. |
| Contacts / Match / From Domain | Campos avanzados que dependen de la conexión. Usa requisitos verificados, no IP supuestas, rangos demasiado amplios ni valores de otro operador. |
Deja sin cambios las opciones avanzadas que no sean necesarias. Si hacen falta ajustes adicionales de identidad o de origen de las llamadas entrantes, confírmalos con Soporte de IllyVoIP. Revisa los datos y utiliza Save y Apply Changes. El nombre de la troncal, el usuario de autenticación y el número presentado tienen funciones diferentes y no se sustituyen entre sí.
3. Comprueba el registro antes de configurar llamadas
Consulta Reports → PBX Reports → PJSIP Endpoints → Trunks. Responder a una comprobación de disponibilidad no equivale a completar el registro saliente. Un administrador con acceso CLI autorizado también puede consultar pjsip show registrations. Es una operación de lectura, no una indicación para editar archivos generados de Asterisk. El registro de la extensión y el de la troncal se comprueban por separado.
Una solicitud de autenticación seguida de una respuesta correcta puede ser normal. Los fallos repetidos, los registros rechazados y los tiempos de espera agotados necesitan investigación. Revisa primero usuario, contraseña, modo de autenticación, DNS, puerto y transporte. Evita reintentos rápidos y cambios continuos de contraseña. No amplíes el cortafuegos para resolver una credencial mal escrita.
4. Crea una ruta saliente con acceso controlado
Abre PBX → Calls Routing → Outbound Routes. Añade una descripción clara y selecciona la troncal IllyVoIP. Empieza con un patrón limitado a un destino que controles y permite únicamente la extensión de prueba mediante Class of Service y los permisos de rutas correspondientes. Revisa la prioridad de las rutas y el orden de las troncales para que otro proveedor no curse la prueba sin que lo adviertas.
Pattern identifica los dígitos marcados. Prefix elimina un prefijo de acceso exterior y Prepend añade dígitos antes de enviar el número. Si el personal marca un 9 adicional para salir, elimínalo una sola vez: no pertenece al código del país. No añadas de nuevo el código del país si ya se ha marcado. Revisa el número final enviado a IllyVoIP y usa el formato internacional requerido por tu conexión. Evita una regla que admita cualquier destino durante la configuración.
5. Dirige un número entrante de IllyVoIP
En IllyVoIP, dirige primero el número activo a la línea SIP de esta central. Después abre PBX → Calls Routing → Inbound Routes en VitalPBX. Selecciona Default, identifica la ruta e introduce el número llamado esperado en DID Pattern. Elige una extensión que funcione como Inbound Destination. Deja CID Pattern vacío salvo que quieras restringir la ruta a determinados llamantes.
DID es el número al que llaman; CID identifica a quien llama. El patrón DID debe coincidir con el formato recibido, incluido el signo más u otro identificador. Si no coincide con lo previsto, revisa los datos entrantes antes de cambiar la extracción de cabeceras o añadir una regla general. Dejar ambos patrones vacíos crea una ruta Any/Any. Cuando la extensión de prueba suene correctamente, incorpora el grupo de timbrado, la cola, el IVR o el horario necesarios. No permitas que llamadas públicas sin coincidencia accedan a marcación externa sin restricciones.
6. Ajusta el identificador de llamada, el audio y la red
Selecciona un identificador saliente permitido por la línea y el paquete IllyVoIP. VitalPBX puede sobrescribirlo en la extensión, la ruta o la troncal; evita ajustes contradictorios durante la preparación. Escribir un número en Trunk CID no verifica su propiedad ni autoriza su presentación. Registrarse correctamente tampoco garantiza saldo suficiente, acceso al destino o capacidad de llamadas disponible.
Haz coincidir el modo multimedia de la central y la línea SIP: Standard RTP no cifra el audio; SDES-SRTP y DTLS-SRTP son modos cifrados diferentes. TLS protege la señalización SIP, pero no activa automáticamente el cifrado del audio. Elige un códec y un método DTMF compatibles en ambos extremos. No selecciones una opción orientada al navegador solo porque la use el Webphone IllyVoIP.
Si la central está detrás de NAT, revisa su dirección externa, redes locales y configuración RTP real según la versión de VitalPBX instalada. El audio en una sola dirección suele exigir revisar la ruta multimedia independientemente del registro. Mantén el cortafuegos activo y permite solo fuentes y puertos necesarios y verificados. Si cambia la IP pública o el router, revisa NAT y las restricciones IP en lugar de cambiar credenciales al azar.
Localiza la etapa que está fallando
| Qué ocurre | Dónde mirar primero |
|---|---|
| La troncal no se registra | Credenciales remotas, modo de autenticación, resolución del servidor, puerto, transporte y respuesta exacta. |
| Está registrada, pero la llamada no sale de la central | Patrón de marcado, permisos de la extensión, prioridad de rutas y troncal elegida. |
| IllyVoIP rechaza la llamada saliente | Formato final del destino, identificador autorizado, saldo, acceso del paquete, capacidad y respuesta SIP registrada. |
| El número no hace sonar ningún teléfono | Asignación del número a la línea en IllyVoIP, DID recibido, destino entrante, horario y estado de la extensión. |
| La llamada conecta sin audio o solo en una dirección | Accesibilidad RTP, NAT, códec negociado y coincidencia del cifrado multimedia. |
| Las teclas no funcionan en un menú telefónico | Método DTMF negociado entre teléfono, central y troncal; prueba con un menú que controles. |
Comprobaciones antes de dar acceso al equipo
Confirma el registro y realiza una llamada saliente autorizada y otra entrante a tu propio número. Comprueba la troncal utilizada, el audio en ambas direcciones, el número mostrado, las teclas y la finalización de la llamada. Verifica que una extensión sin permiso no pueda usar la nueva ruta. Después amplía el acceso a los usuarios y destinos previstos.
Si falla una comprobación, cambia un ajuste cada vez y conserva su valor anterior. Facilita a Soporte la versión de la central, hora y zona horaria, dirección de la llamada, error sin datos privados y referencia pública de la llamada del Portal, si existe. Nunca publiques contraseñas SIP ni registros de cuenta sin depurar. Las instrucciones se han contrastado con la documentación y el comportamiento del Portal; no constituyen una certificación mediante llamadas reales con VitalPBX. Emergencias, fax y usos especiales requieren verificaciones independientes.