Configurar la troncal SIP de Claro Guatemala en Grandstream UCM
- La troncal de Claro es con registro: el usuario es tu número piloto en formato +502 y se usa un outbound proxy.
- Usa solo el códec PCMA (G.711 ley A) en la troncal y en las extensiones.
- En la troncal: DID Mode = Request-line, DTMF = Inband, TEL URI = User=Phone y NAT desactivado.
- Antes de conectar, tu central debe estar homologada con Claro.
Antes de empezar
- Tu central debe estar homologada por Claro con la misma versión de firmware que tiene instalada. No actualices el firmware mientras configuras.
- Las capturas de referencia de esta guía son de una UCM6102 (firmware 1.0.11). En las UCM6300 los menús cambian de lugar, pero los campos se llaman igual.
- Los valores entre
MAYÚSCULASson de ejemplo: reemplázalos por los que te entregue Claro.
Datos que te entrega Claro
| Dato | Ejemplo | Para qué sirve |
|---|---|---|
| GDN (número piloto) | 2XXXXXXX | Usuario de registro de la troncal |
| Contraseña | Cadena larga de letras y números | Autenticación de la troncal |
| Proxy primario | IP_DEL_PROXY | Outbound proxy |
| Dominio | DOMINIO_DE_CLARO | Host Name, From Domain y AuthID |
| Datos de red para la central | IP, máscara y gateway | Puerto WAN de la UCM |
| Rango de DID | Números directos asignados | Rutas de entrada e identificador de llamadas |
Copia la contraseña con cuidado. Es muy larga y un solo carácter equivocado impide el registro. Pégala, no la escribas a mano, y no la compartas por chats o correos sin necesidad.
Paso 1: red de la UCM
La troncal de Claro llega por el puerto WAN de la UCM, con el direccionamiento que te asigne Claro. Tus teléfonos quedan en el puerto LAN, en otra red.
Ve a Settings → Network Settings → Basic Settings (en UCM6300: System Settings → Network Settings):
| Campo | Valor |
|---|---|
| Method | Route |
| WAN · IP Method | Static |
| WAN · IP Address / Subnet Mask / Gateway IP | Los que te asignó Claro |
| WAN · DNS Server 1 | El que te indique Claro |
| LAN · IP Address | Tu red interna, por ejemplo 192.168.2.1 |
| LAN · DHCP Server Enable | Activado, si la UCM entregará IP a los teléfonos |
Guarda, aplica los cambios y comprueba con un ping desde la UCM que llegas al proxy de Claro.
Paso 2: crear la troncal
Ve a PBX → Basic/Call Routes → VoIP Trunks (en UCM6300: Extension/Trunk → VoIP Trunks) y crea una troncal SIP. En la pestaña Basic Settings:
| Campo | Valor |
|---|---|
| Provider Name | ClaroSipTrunk (el nombre que quieras) |
| Host Name | DOMINIO_DE_CLARO |
| Transport | UDP |
| Keep Original CID / Keep Trunk CID | Desactivados |
| NAT | Desactivado |
| TEL URI | User=Phone |
| Need Registration | Activado |
| From Domain | DOMINIO_DE_CLARO |
| From User | Vacío |
| Username | +502 + tu GDN, por ejemplo +5022XXXXXXX |
| Password | La contraseña de Claro |
| AuthID | +5022XXXXXXX@DOMINIO_DE_CLARO |
Fíjate en el formato: el usuario lleva el +502 delante del número, y el AuthID es ese mismo usuario seguido de @ y el dominio. Es el detalle que más registros fallidos provoca.
Paso 3: configuración avanzada de la troncal
En la pestaña Advanced Settings de la misma troncal:
| Campo | Valor |
|---|---|
| Codec Preference | Solo PCMA. Quita los demás de la lista de seleccionados. |
| Send PPI Header / Send PAI Header | Desactivados |
| Outbound Proxy Support | Activado |
| Outbound Proxy | IP_DEL_PROXY |
| Remove OBP from Route | Desactivado |
| DID Mode | Request-line |
| DTMF Mode | Inband |
| Enable Qualify | Desactivado |
| Fax Mode | None |
| SRTP | Disabled |
Paso 4: extensiones
En cada extensión (PBX → Basic/Call Routes → Extensions, o Extension/Trunk → Extensions en UCM6300):
Pestaña Basic Settings
- Permission: según lo que pueda marcar el usuario (local, nacional o internacional).
- CallerID Number: si Claro te asignó números directos, pon aquí el número de esa extensión. Usa solo números de tu rango asignado: con un número que no te pertenece, la llamada no se completa.
- SIP/IAX Password: una contraseña fuerte, distinta en cada extensión.
Pestaña Media
| Campo | Valor |
|---|---|
| NAT | Activado |
| DTMF Mode | RFC2833 |
| Can Direct Media | No |
| TEL URI | Disabled |
| Codec Preference | Solo PCMA |
Con PCMA en ambos lados, la central no tiene que convertir el audio entre códecs y evitas cortes o llamadas sin audio.
Paso 5: rutas de entrada y de salida
Ruta de entrada
Como el DID Mode es Request-line, la UCM toma el número marcado por quien te llama. Crea una ruta de entrada para la troncal de Claro y envía las llamadas a tu IVR, a un grupo de timbrado o, si tienes números directos, a la extensión correspondiente de cada DID.
Ruta de salida
Crea rutas de salida por la troncal de Claro con patrones como estos:
| Tipo de llamada | Patrón |
|---|---|
| Fijos y celulares de Guatemala (8 dígitos) | _XXXXXXXX |
| Internacional | _00. |
Restringe la ruta internacional solo a las extensiones que la necesiten. Es la puerta de entrada más común del fraude telefónico.
Paso 6: proteger la administración
Permite el acceso a la administración web de la UCM solo desde las IP de confianza. En Settings → Security Settings → Static Defense crea una regla que acepte el puerto de administración (por defecto 8089/TCP) solo desde la IP de tu equipo de administración, y bloquea el resto. Cambia también la contraseña del usuario admin si la UCM te avisa que es débil.
Verificar que funciona
- En Status → PBX Status → Trunks, la troncal debe aparecer como Registered.
- Llama desde una extensión a un fijo y a un celular. Comprueba que hay audio en ambos sentidos.
- Llama a tu número desde un celular y verifica que entra a donde debe y que ves el número de quien llama.
- Pide a quien recibe tu llamada que confirme qué número le aparece.
- Llega a tu IVR desde afuera y marca opciones: si responde a las teclas, el DTMF está bien.
Problemas comunes
La troncal no se registra
Revisa, en este orden: el formato del usuario (+502 + GDN), el AuthID con @DOMINIO_DE_CLARO, la contraseña completa, que el outbound proxy esté activado con la IP correcta, y que la UCM llegue al proxy por la WAN (IP, máscara y gateway).
Las llamadas entran pero no hay audio, o solo se oye de un lado
Confirma que la troncal y las extensiones usan solo PCMA, que el NAT de la troncal esté desactivado y que el gateway de la WAN sea el que te dio Claro.
El IVR no reconoce las teclas que marcan los clientes
Revisa que el DTMF Mode de la troncal esté en Inband y el de las extensiones en RFC2833.
Las llamadas entrantes no llegan a la extensión correcta
Comprueba que el DID Mode sea Request-line y que tus rutas de entrada usen el mismo formato de número que llega de Claro.
Las llamadas salientes no se completan
Revisa el patrón de la ruta de salida y que el CallerID Number de la extensión pertenezca a tu rango asignado.
Para ver qué está pasando, usa Maintenance → Troubleshooting → Ethernet Capture en la UCM y abre la captura con Wireshark.
¿Tu troncal de Claro no funciona?
La reviso contigo en una sesión remota: registro, audio, rutas e identificador de llamadas. También configuro la central completa si estás empezando.
Esta guía se basa en configuraciones reales que he instalado 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. Para Issabel y FreePBX publicaré una guía aparte.