Servidores VoIP
Conecta servidores VoIP para gestionar líneas y planes de voz.
Esta guía registra un Servidor VoIP desde cero. El catálogo alimenta el campo Servidor VoIP de los planes de voz.
Antes de empezar:
- IP/hostname del softswitch o PBX, puerto (suele ser 5060 para SIP o el de tu API HTTP) y credenciales si aplican.
- Permiso
voip_server_access(Servidor VoIP en roles).
1. Abrir el módulo
Menú Ajustes → Infraestructura → Servidores VoIP → /voip-servers.

En pantalla verás:
- Título Servidores VoIP y subtítulo Administra los endpoints de integración con plataformas de voz.
- Breadcrumb Ajustes > Servidores VoIP.
- KPIs: Total Servidores, Activos, Inactivos.
- Sección Lista de Servidores VoIP — columnas: ID, Nombre, Endpoint, Estado, Acciones.
- Botón Nuevo Servidor.
Badges de estado: Activo / Inactivo. Vacío: No hay servidores registrados.
2. Crear el servidor
- Pulsa Nuevo Servidor → modal Nuevo Servidor VoIP.
- Completa los campos y pulsa Guardar.
| Campo UI | Obligatorio | Detalle |
|---|---|---|
| Nombre | Sí | Máx. 100; único por empresa |
| Host / IP | Sí | Host del softswitch / API |
| Puerto | Sí | 1–65535; por defecto 5060 |
| URL API (opcional) | No | Preferida por Probar conexión |
| Usuario | No | |
| Contraseña | No | Vacío en edición = no cambia |
| Descripción | No | |
| Servidor activo | No | Marcado por defecto |
Ejemplo: Nombre Asterisk Principal, Host voip.miwisp.local, Puerto 5060, URL API https://voip.miwisp.local:8088/ari.
Éxito: Servidor VoIP creado correctamente.
3. Probar, editar y eliminar
En Acciones:
| Acción | Qué hace |
|---|---|
| Probar conexión | HTTP a URL API o http://host:puerto |
| Editar | Modal Editar Servidor VoIP → Actualizar |
| Eliminar | Confirma ¿Eliminar servidor "{nombre}"? |
Mensajes: Servidor VoIP actualizado correctamente / Servidor VoIP eliminado correctamente.
4. Enlazar con Plan Voz
Ve a Ajustes → Servicios → Plan Voz. Al crear el plan, en Servidor VoIP elige este servidor o deja Sin servidor.
5. Tips
- El puerto por defecto es 5060 (SIP). Si tu integración es HTTP/API, cambia el puerto y llena URL API.
- Un servidor Inactivo no debería usarse en planes nuevos; desmárcalo con Servidor activo.
- Nombres únicos evitan confusión al facturar líneas (
VoIP-Core,VoIP-Backup).
6. Checklist rápido
- Ajustes → Infraestructura → Servidores VoIP → Nuevo Servidor
- Nombre, Host / IP, Puerto (5060 o el de tu API)
- Guardar → Probar conexión
- Asignar el servidor en un Plan Voz