FreeSWITCH (gateway Sofia)
Configurar SIP Trunk en FreeSWITCH
Gateway SIP hacia PortalPBX en el perfil external de FreeSWITCH, con dialplan de entrada y salida.
Antes de empezar
- FreeSWITCH 1.10+ y acceso a fs_cli.
- Datos del troncal entregados por PortalPBX.
Datos de tu troncal
PortalPBX los entrega al activar el troncal. Reemplaza cada marcador por tu valor real.
- Servidor SIP (host o dominio)
- <servidor-sip>
- Puerto y transporte
- <puerto> · UDP / TCP / TLS
- Usuario SIP
- <usuario>
- Contraseña SIP
- <contraseña>
- Número(s) DID asignados
- <DID>
- Modo de autenticación
- Registro / IP
- Códecs habilitados
- G.711 (alaw/ulaw) · G.729*
* G.729 solo si está habilitado en tu troncal.
Paso a paso
- 1
Crear el gateway
Crea conf/sip_profiles/external/portalpbx.xml:
<include> <gateway name="portalpbx"> <param name="realm" value="<servidor-sip>"/> <param name="proxy" value="<servidor-sip>"/> <param name="username" value="<usuario>"/> <param name="password" value="<contraseña>"/> <param name="register" value="true"/> <param name="caller-id-in-from" value="true"/> <param name="ping" value="60"/> </gateway> </include> - 2
Llamadas entrantes
En conf/dialplan/public agrega el DID hacia tu anexo o IVR:
<extension name="portalpbx-did"> <condition field="destination_number" expression="^<DID>$"> <action application="transfer" data="1000 XML default"/> </condition> </extension> - 3
Llamadas salientes
En el contexto default:
<extension name="salida-portalpbx"> <condition field="destination_number" expression="^(\d{7,15})$"> <action application="set" data="effective_caller_id_number=<DID>"/> <action application="bridge" data="sofia/gateway/portalpbx/$1"/> </condition> </extension> - 4
Recargar y verificar
En fs_cli:
reloadxml sofia profile external rescan sofia status gateway portalpbx
Recomendaciones
- En vars.xml revisa external_rtp_ip y external_sip_ip si estás detrás de NAT.
- Prioriza G.711 alaw/ulaw; usa G.729 solo si está habilitado en tu troncal y tu equipo lo soporta.
- Desactiva SIP ALG en el router o firewall: es la causa más común de audio en una sola vía y registros que caen.
- Si tu central está detrás de NAT, declara la IP pública y la red local, y abre el rango RTP que use tu equipo.
- Restringe el acceso SIP por firewall y usa contraseñas largas en anexos: evita fraude telefónico.
- Envía el número en el formato indicado en tu ficha de alta (nacional o internacional) y verifica el caller ID.
Errores comunes
FAIL_WAIT / NOREG
El gateway no registra: credenciales, realm o conectividad.
INCOMPATIBLE_DESTINATION
Códecs: incluye PCMA/PCMU en global_codec_prefs.
¿Necesitas ayuda?
Lo configuramos contigo, en remoto
Si la configuración manual no funciona, contacta a soporte o abre un ticket. Revisamos contigo registro, rutas, códecs y NAT por sesión remota segura.