Configurar la troncal SIP de Claro Guatemala en Issabel y Elastix

Antes de empezar

• Tu central debe estar homologada por Claro con la versión que tiene instalada. No actualices mientras configuras.
• Esta configuración la usé en Elastix 2.4 y funciona igual en Issabel, que usa la misma interfaz de configuración de troncales.
• Usa el driver chan_sip (troncal "SIP"). Las versiones recientes de FreePBX usan PJSIP y cambian los formularios.
• Los valores entre MAYÚSCULAS son de ejemplo: reemplázalos por los que te entregue Claro.

Datos que te entrega Claro

La central también debe llegar al proxy por el enlace de Claro, con la IP, máscara y gateway que te asignen. Compruébalo con un ping IP_DEL_PROXY desde la consola antes de seguir.

Paso 1: crear la troncal SIP

En PBX → PBX Configuration → Trunks → Add SIP Trunk:

En PEER Details pega esto, reemplazando los valores de ejemplo:

username=+5022XXXXXXX
type=friend
secret=CLAVE
qualify=no
outboundproxy=IP_DEL_PROXY
nat=never
insecure=very
host=IP_DEL_PROXY
fromdomain=DOMINIO_DE_CLARO
dtmfmode=inband
disallow=all
canreinvite=yes
context=from-trunk
allow=ulaw&alaw

Deja vacíos USER Context y USER Details.

Qué hace cada línea importante

• username: tu número piloto con +502. Sin el +502 la troncal no se registra.
• host y outboundproxy: ambos apuntan al proxy de Claro.
• fromdomain: el dominio de Claro, que va en los mensajes SIP que envía tu central.
• nat=never: la central está en la misma red que el proxy de Claro, sin NAT de por medio.
• dtmfmode=inband: las teclas que marcan tus clientes (por ejemplo en el IVR) viajan dentro del audio.
• qualify=no: la central no envía mensajes periódicos para comprobar que el proxy responde.

Paso 2: string de registro

En el campo Register String de la misma troncal:

+5022XXXXXXX@DOMINIO_DE_CLARO:CLAVE:+5022XXXXXXX@DOMINIO_DE_CLARO@IP_DEL_PROXY:5060/+5022XXXXXXX

Se lee así:

Guarda con Submit Changes y aplica la configuración con Apply Config.

Paso 3: extensiones y Outbound CID

En PBX Configuration → Extensions, en cada extensión:

• Outbound CID: el número directo de esa extensión en formato +502, por ejemplo +5022XXXXXXX. Usa solo números de tu rango asignado. Si la extensión no tiene número directo, déjalo vacío y saldrá con el Outbound Caller ID de la troncal.
• dtmfmode: rfc2833.
• nat: yes, si los teléfonos están en otra red que la central.
• secret: una contraseña fuerte, distinta en cada extensión.

En los teléfonos IP, en la configuración de audio de la cuenta, pon G.711 (PCMU y PCMA) como primeros códecs.

Paso 4: rutas de entrada (DIDs)

Los números llegan de Claro en formato +502, así que tus rutas de entrada deben usar ese mismo formato. En PBX Configuration → Inbound Routes → Add Incoming Route:

Crea una ruta por cada número de tu rango. Si un número directo es de una sola persona, también puedes asignarlo desde la extensión, en Add Inbound DID.

Paso 5: rutas de salida

En PBX Configuration → Outbound Routes, crea una ruta que use la troncal Claro con patrones como:

Pon las llamadas internacionales en una ruta aparte y protégela con un PIN Set o limítala a las extensiones que la necesiten. Es la puerta de entrada más común del fraude telefónico.

Fax y POS en adaptadores analógicos

Si conectas un fax o un POS a un adaptador analógico (por ejemplo un Grandstream HT502), configura en el puerto FXS el códec PCMU como primera opción y PCMA como segunda, y no uses códecs comprimidos como G.729 en ese puerto. Fax y POS necesitan G.711 para funcionar de forma confiable.

Opcional: usar un nombre en lugar de la IP del proxy

Puedes registrar la troncal usando un nombre en lugar de la IP del proxy. Así, si Claro te indica otra IP, solo cambias un archivo.

1. Agrega el nombre al archivo /etc/hosts de la central:

   IP_DEL_PROXY    proxy-claro.local

2. En PEER Details, cambia host y outboundproxy:

   outboundproxy=proxy-claro.local
   host=proxy-claro.local

3. En el string de registro, reemplaza la IP por el nombre:

   +5022XXXXXXX@DOMINIO_DE_CLARO:CLAVE:+5022XXXXXXX@DOMINIO_DE_CLARO@proxy-claro.local:5060/+5022XXXXXXX

Proteger la administración

Permite el acceso a la administración web y a SSH solo desde las IP de confianza. En Elastix lo hice con el firewall CSF, agregando las IP autorizadas al archivo /etc/csf/csf.allow. En Issabel puedes hacerlo desde el módulo Security → Firewall. Pruébalo desde una IP que no esté en la lista: no debe poder abrir la página de administración.

Verificar que funciona

Entra a la consola de Asterisk:

asterisk -rvvv
sip show registry

La troncal debe aparecer con el estado Registered. Si Claro te asignó varios números piloto, verás un registro por cada uno. Después:

1. Llama a un fijo y a un celular desde una extensión, y comprueba el audio en ambos sentidos.
2. Llama a cada DID desde un celular y verifica que entra a donde debe.
3. Pide a quien recibe tu llamada que confirme qué número le aparece.
4. Marca opciones en tu IVR desde afuera para comprobar el DTMF.

Con core show channels ves las llamadas activas en ese momento.

Problemas comunes

Esta guía se basa en una configuración real que instalé y homologué en Guatemala. No soy representante de Claro, y el operador puede cambiar sus parámetros: usa siempre los datos que te entregue Claro para tu servicio. ¿Tu central es Grandstream? Mira la guía para Grandstream UCM.