Síntoma o Necesidad

El cliente requiere configurar un prefijo / indicativo para asegurar que la gestión de llamadas salientes sea exitosa. Existe la necesidad de normalizar la marcación para que el sistema reconozca los destinos y los entregue correctamente al proveedor de telefonía.

Contexto / Escenarios

La configuración de prefijos e indicativos garantiza la correcta gestión, normalización y enrutamiento de números telefónicos. 
Este tipo de solicitud es común en los siguientes escenarios:
•    Implementaciones de telefonía (VoIP / Contact center):
Cuando se requiere agregar automáticamente indicativos de país, configurar reglas de marcación iniciales y prefijos de salida automáticos.
•    Operaciones con alcance internacional:
En casos donde el cliente requiere estandarizar números en formato internacional para gestionar contactos en múltiples países. 
•    Integraciones con canales de comunicación (WhatsApp, SMS, CRM):
Cuando el cliente requiere incluir indicativos de país para asegurar la entrega de mensajes o la correcta identificación de los contactos en bases de datos externas.
•    Carga o migración de bases de datos:
Se requiere normalizar los números durante procesos de importación para evitar duplicidades, inconsistencias o errores de marcado.
•    Automatización y Enrutamiento:
Cuando el sistema utiliza el indicativo como variable para segmentar contactos, enrutar interacciones o aplicar reglas de negocio según la ubicación geográfica del usuario.

Respuesta o Solución

Requisito previo: Debe existir una troncal de salida establecida y funcional.

1.    Validaciones iniciales
Antes de configurar la ruta, identifique el tipo de troncal:
•    Para troncales básicas: 
Si no tiene troncal establecida: el cliente debe suministrar:
o    Nombre de la troncal
o    Usuario y contraseña (si se requieren)
o    El Proxy o Host
o    Códecs para la negociación del RTP. 

Troncal establecida: Validar que el estado de la troncal sea Activa. 

•    Para troncales avanzadas: 
o    Se debe validar el script de configuración directamente con el cliente.

2.    Configuración de ruta y prefijo

Paso A: Agregar la ruta: 
1.    En el módulo de configuración, procede a agregar la ruta.
2.    Valida con el cliente y diligencia el campo Tipo de ruta (usualmente lcrs).
3.    Verifica con el cliente y asigna un Nombre de la ruta que sea fácilmente identificable. 
4.    Da clic en el botón Adicionar ruta.

Paso B: Agregar el prefijo (Dial Plan)

Nota importante: Todos los prefijos creados en wolkvox deben iniciar obligatoriamente con el número 9, sin importar si la telefonía es propia o del cliente.
Diligencie los siguientes campos:
o    Prefijo: Ejemplo: 9, 905, 901, etc.
o    Destino: Asigna el nombre requerido (puede usar el mismo nombre de la ruta. Ejemplo: Salida wolkvox). 
o    Tarifa:  Este campo puede dejarse por defecto.
o    ID de ruta: Se muestra una lista desplegable con las rutas previamente creadas. Selecciona de la lista la ruta creada en el Paso A.  
 

Paso C: Finalización y Vinculación de Troncal

Una vez creado el prefijo:
1.    Ve a la pestaña de Rutas.
2.    Selecciona la ruta creada y haz clic derecho sobre ella.
3.    Selecciona la opción Adicionar troncal en la ruta.
4.    Campo Troncal: Selecciona la troncal física (existente o recién creada) de la lista desplegable.
5.   Campo Adicionar prefijo: Agrega aquí el indicativo de país o el prefijo que el cliente informó para su dial plan (este es el número que recibirá la planta telefónica final). 
Nota: Puede dejarse en blanco si la planta no requiere prefijos adicionales. 
6.    Campo Remover prefijo: Ingresa el prefijo seleccionado en el Paso B (ejemplo: 9, 905, 901). El sistema eliminará este dígito para enviar la llamada limpia al proveedor. 
7.    Campos Complementarios:
o    Costo: Por defecto (opcional según el requerimiento del cliente).
o    Caller ID: Dilig4encia solo si el cliente requiere mostrar un número específico.
o    SIP Header / Active token ID Call: Dejar por defecto.

Posibles Causas

•    Falla en el enrutamiento: El prefijo configurado no inicia con el número 9.
•    Llamadas rechazadas por el carrier: No se configuró correctamente el campo "Remover prefijo", enviando el dígito interno (9) hacia la red pública.
•    Error de negociación: Los Códecs configurados en la troncal no coinciden con los del proveedor.

Consideraciones

•    La correcta configuración de estos parámetros asegura la interoperabilidad entre sistemas y mejora la calidad de los datos operativos.
•    El prefijo 9 es una regla de arquitectura de la plataforma wolkvox para diferenciar el tráfico interno del enrutamiento de salida.

Recomendaciones

•    Realizar pruebas de marcación manual desde el wolkvox Agent tras finalizar la configuración para confirmar que el audio y la señalización son correctos.
•    Verificar que el Prefijo de País sea añadido solo cuando la regulación del destino o el carrier lo exijan estrictamente.
•    Mantener un registro de los prefijos utilizados para evitar solapamientos en operaciones con múltiples troncales.