consultoria-as/voip-freepbx-setup
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4e4a120e9ba1025d83df52a3220f02df3b94a41a
voip-freepbx-setup/docs/DOCUMENTACION_VOIP.md

6.5 KiB
Raw Blame History

Documentación del Sistema VoIP - FreePBX 17

Información General

  • Servidor: Ubuntu 24.04 LTS
  • IP del Servidor: 192.168.10.114
  • PBX: FreePBX 17.0.28
  • Asterisk: 21.12.2
  • Empresas: Horux360, Consultoria-AS, Nexus

Accesos Principales

Panel Web FreePBX (Administración)

Panel de Usuario (UCP - User Control Panel)

Extensiones Configuradas

Extensión Empresa Nombre Contraseña SIP Grabación
100 Horux360 Horux360 - Admin Horux100! Siempre
200 Consultoria AS Consultoria AS - Admin Consult200! Siempre
300 Nexus Nexus - Admin Nexus300! Siempre

Softphones Recomendados

  • Windows: MicroSIP (https://www.microsip.org)
  • Mac: Telephone (App Store)
  • Móvil: Zoiper (iOS/Android)
  • WebRTC: UCP incluye teléfono web

Configuración de Softphone

  • Servidor/SIP Domain: 192.168.10.114
  • Puerto: 5060 (UDP)
  • Transporte: UDP
  • Usuario: Número de extensión (ej. 100)
  • Contraseña: Según tabla arriba

IVR (Menú Principal)

  • Nombre: MenuPrincipal
  • Contexto Asterisk: ivr-1
  • Opciones:
    • 1 → Horux360 (Extensión 100)
    • 2 → Consultoria AS (Extensión 200)
    • 3 → Nexus (Extensión 300)

Para asignar una llamada entrante al IVR, configura la ruta entrante (Inbound Route) con destino IVR → MenuPrincipal.

Grabación de Llamadas

  • Estado: Activada para todas las extensiones
  • Almacenamiento: /var/spool/asterisk/monitor/
  • Formato: WAV (por defecto)
  • Acceso: Panel web FreePBX → Reports → CDR Reports (incluye link a grabaciones)
  • Retención: Configurable en FreePBX. Actualmente sin límite de rotación.

Dashboard de Métricas (CDR)

  • URL: http://192.168.10.114/admin → Reports → CDR Reports
  • Datos disponibles:
    • Historial de llamadas (entrantes/salientes)
    • Duración
    • Estado (contestada, perdida, ocupada)
    • Grabaciones asociadas
    • Filtrado por fecha, extensión, número, etc.

Base de Datos

MariaDB

  • Root Password: FreePBXRoot2026!
  • FreePBX User: asteriskuser
  • FreePBX Password: AsteriskDB2026!
  • Bases de datos: asterisk (configuración), asteriskcdrdb (registro de llamadas)

Firewall (UFW)

Puertos abiertos:

  • 22/tcp - SSH
  • 80/tcp - HTTP (FreePBX)
  • 443/tcp - HTTPS
  • 5060/tcp+udp - SIP
  • 5061/tcp+udp - SIPS
  • 10000-20000/udp - RTP (audio de llamadas)
  • 8088/tcp - Asterisk HTTP
  • 8089/tcp - Asterisk HTTPS
  • 5038/tcp - AMI (Asterisk Manager Interface)

Seguridad

Fail2Ban

  • Estado: Activo
  • Jails: sshd, asterisk, apache-auth, apache-badbots
  • Bantime: 3600 segundos (1 hora)
  • Max retry: 5 intentos

AMI (Integración Odoo)

  • Usuario AMI: odoo
  • Contraseña AMI: OdooAMI2026!
  • Permisos: Lectura/Escritura completa
  • Acceso permitido: Red local 192.168.10.0/24
  • Puerto: 5038

Integración con Odoo

Módulos Requeridos (Odoo Community)

  1. Instalar desde https://github.com/OCA/connector-telephony:
    • base_phone
    • asterisk_click2dial
    • crm_phone (opcional, para pop-up en CRM)

Configuración en Odoo

  1. Ir a Settings → Asterisk Server
  2. Agregar servidor:
    • Name: FreePBX VoIP
    • IP: 192.168.10.114
    • Port: 5038
    • Login: odoo
    • Password: OdooAMI2026!
  3. Configurar prefijo de marcado si es necesario

Funcionalidades

  • Click-to-Call: Click en cualquier número de teléfono en Odoo para llamar
  • Pop-up de Cliente: Al recibir llamada, Odoo busca el número y abre la ficha
  • Historial: Registro de llamadas en la ficha del cliente

Troncal SIP (PSTN)

  • Estado actual: No configurado
  • Próximo paso: Contratar troncal SIP con proveedor recomendado

Proveedores Recomendados

Proveedor Ventaja
Twilio Confiable, fácil API, soporte global
Telnyx Precios bajos, buena calidad
VozTelecom Si operan en España
OVH Buena cobertura Europa/Latam

Configuración General

  1. FreePBX → Connectivity → Trunks → Add Trunk → Add SIP (chan_pjsip) Trunk
  2. Ingresar datos del proveedor (host, usuario, contraseña)
  3. Configurar Outbound Routes (rutas salientes)
  4. Configurar Inbound Routes (rutas entrantes) → apuntar a IVR

Comandos Útiles

# Estado de Asterisk
asterisk -rvx "core show uptime"

# Estado de extensiones PJSIP
asterisk -rvx "pjsip show endpoints"

# Recargar configuración FreePBX
fwconsole reload

# Reiniciar todo el servicio
fwconsole restart

# Estado de Fail2Ban
fail2ban-client status

# Ver logs de Asterisk
tail -f /var/log/asterisk/messages.log

# Ver logs de FreePBX/web
tail -f /var/log/apache2/freepbx-error.log

Multi-Tenant (3 Empresas)

  • Enfoque: Un solo FreePBX con prefijos de extensión por empresa
    • 100-199 → Horux360
    • 200-299 → Consultoria AS
    • 300-399 → Nexus
  • IVR: Un menú principal con opciones por empresa
  • CID Saliente: Configurable por ruta/trunk cuando se contrate troncal

Respaldo y Mantenimiento

Backup Automático

  • Instalar módulo backup en FreePBX (ya instalado)
  • Configurar en Admin → Backup & Restore
  • Recomendado: Backup diario de configuración + grabaciones

Actualizaciones

# Actualizar módulos FreePBX
fwconsole ma updateall
fwconsole reload

# Actualizar sistema operativo
apt update && apt upgrade

Notas Importantes

  1. Cambiar contraseñas por defecto antes de poner en producción pública
  2. Configurar HTTPS (Let's Encrypt) para acceso seguro al panel
  3. NAT: Si el servidor está detrás de router/firewall, configurar "NAT = Yes" en Settings → Asterisk SIP Settings
  4. RTP: Asegurar que el rango UDP 10000-20000 esté abierto en el router/firewall externo
  5. Sonidos: Los sonidos en inglés están instalados. Para español, instalar sounds-es desde FreePBX → Admin → Sound Languages

Soporte

Documento generado el 2026-04-29 Implementación realizada por Kimi Code CLI

Reference in New Issue View Git Blame Copy Permalink