VOIP

...

Image Removed

Nombre: Nombre del Proveedor (Carrier).

Contraseña: Asignada por el Proveedor.

Contexto: Agrupación donde se dirigirán los intentos de llamadas que realice el carrier, esto depende de los creados en el dialplan.

Host: IP del Proveedor.

Desde Usuario: Depende si requerido por el proveedor.

Desde Dominio: Depende si requerido por el proveedor.

Puerto: Puerto usado para establecer la conexión.

DTMF: Modo de envío de los DTMFs.

Qualify: Si se monitorea la conectividad con el proveedor.

Insecure: Específica cómo manejar las conexiones con el proveedor, no: autentifica todas las conexiones.

Transporte: Permite ingresar el tipo de transporte que se usara (UDP,TCP, TLS).

Encriptado: Indica si la comunicación estará encriptada o no (usado en conjunto con el transporte TLS), en caso de encriptar la voz.

Tipo: Tipo de proveedor si es de protocolo SIP o IAX.

Codecs:  Codecs utilizados por el proveedor (relacionado al audio). 

Configuración de Troncal

...

1. Configuración

Menú Administrador > Proveedores > VOIP

• El nombre es el nombre identificador del troncal en el sistema.
• Ingresar los datos correspondientes (IP, pwd ,Protocolos,etc)
• Contexto Entrantes (No importa si es únicamente para llamadas salientes)
• Activar opciones ULAW, ALAW y QUALIFY si el proveedor confirma que lo trabajan de esa manera.
• Si la troncal esta conectada directamente en el servidor se debe de agregar en el archivo /etc/asterisk/SIP.conf bajo la sección [general] agregar un nuevo localnet=XXX.XXX.XXX.XXX/255.255.0.0 para que no haya problemas con el trafico

Si se necesita registro, el mismo se realiza en el archivo /etc/asterisk/SIP.conf en el servidor de telefonía de acuerdo al siguiente formato:

...

2.Validación:

• Verificar en Menú Supervisión > Estado > VOIP (filtrar por nombre, si está OK y verificar latencia. Una latencia alta, por encima de los 250 Ms, puede impactar en la calidad de las llamadas)
• Si tiene registro, ejecutar "sip show registry" en consola de asterisk (previamente habiendo ejecutado integraconsole). desde la linea de comandos en el server de telefonía.
• Realizar una llamada de prueba por ese troncal y recibir por el DID entrante asignado.

3.Puesta en producción:

Para campañas salientes y marcadores con configuración estandar:

• En configuración de campaña o marcador poner cadena de marcado SIP/NOMBREPROVEEDORNUEVO (donde "NOMBREPROVEEDORNUEVO", es el nombre que se le dio al troncal configurado).
• Para probar que el troncal quedo correctamente configurado, realizar una llamada saliente desde un agente que tenga la campaña asociada.  

Para campañas entrantes

• Crear un flujo (O modificar uno existente) en el contexto entrantes que la extensión coincida con el DID que envía el proveedor.
• Si el flujo es por defecto, el flujo va a buscar la campaña con el DID que envía el proveedor.

4.Verificación de problemas:

• Siempre validar que el troncal esté activo.
• Identificar la llamada en el log de telefonía (/var/log/asterisk/full.log).
• Hay proveedores que no aceptan que en la llamada saliente se especifica que SetCallerID(name) quitar esa propiedad del flujo.
• Llamada entrante: Filtrar por lo que el proveedor envía como DID. Hay log? Hay error?
  Si hay log, validar porque no tiene el comportamiento deseado en base al workflow configurado en el sistema.
  Si hay error, puede ser que el DID enviado por el proveedor no coincide con el esperado en el workflow.
• Llamada saliente: Encontrar el nodo "Dial" ("Dial" es el nodito correspondiente al flujo en cuestión),
  - Comprobar que envía el DIAL al SIP correcto.
  - Verificar que se esté enviando el prefijo correcto.
  - Verificar la respuesta del proveedor (Errores, etc).
• Hacer captura SIP (En el servidor de telefonía, en linea de comandos, ejecutar "sngrep"). Esto abre una aplicación  como la siguiente:

Image Removed

Al dar enter sobre cada una de las lineas, se despliega la siguiente pantalla (es la captura que devuelve info sobre errores):

Image Removed

- Verificar RTP y que el ruteo de paquetes sea correcto.
- Validar si la llamada la finaliza uContact o el proveedor.
- Validad errores.

Digital

...

...

...

Image Added

...

...

...

...

...

...

...

...

...

Image Added Obtener

...

...

...

...

...

...

SMS

Opción para configurar los distintos proveedores de SMS.

Al ingresar veremos dos secciones:

Image Removed

Proveedores SMS: Aquí deberemos seleccionar el tipo de api para cada proveedor mediante el menú desplegable. Cabe destacar que las opciones desplegadas son las actualmente compatibles con uContact.

• DinstarWeb: Comunicación por web service.
• Quality: Api desarrollada para Quality Telecom.
• GMG: Comunicación con Api CMG SMS.
• Twilio: Comunicación con Api Twilio SMS.
• Nexmo: Comunicación con Api Nexmo SMS.
• InfoBip:  Comunicación con Api InfoBip SMS {Para recibir SMS, solicitar a INFOBIP que habilite PULL method}
• URLSMS:  Comunicación por URL GET
• URLSMSAuth: Comunicación por URL GET con basic Autenticación
• SMSMasivo:  Comunicación por URL GET
• URLPOSTSMS: Comunicación por URL POST
• URLPOSTSMSAuth: Comunicación por URL POST con basic Autenticación

Default: Esta opción permite seleccionar el proveedor de SMS como por defecto para recibir las notificaciones del sistema.*

*Si no se selecciona uno el sistema tomará el primero de la lista, al igual que si se elimina el que esté por Default. Si tenemos varios y seleccionamos otro como Default el sistema quitará como tal el anterior y marcará el nuevo.

A la derecha se encuentra una tabla con los proveedores ya creados.

Luego de seleccionar un Proveedor de SMS veremos los campos para configurar el proveedor, estos campos pueden variar según requiera la api, pantalla de ejemplo:

Image Removed

En este caso se seleccionó la api de DinstarWeb la cual para acceder al proveedor requiere: URL, Puertos, SMS Encoding, Nombre de Usuario, Contraseña y SMS RegExp. Los datos antes mencionados serán brindados por el proveedor de SMS del que disponga la compañía.*

Posibles parámetros:

URL (SMSEndpoint): 

• URLSMS: Se debe de agregar la dirección a ejecutar para enviar el SMS teniendo en cuenta las siguiente variables:  ${phone}, ${message}, ${id},  (ej:  http://www.celularsoft.com/smsin/microfin.php?celular=${phone}&mensaje=${message}&id={id}).
• Dinstar:  (WEB y común):  Dirección IP del GW.
• DinstarWeb: HTTP API for dinstar
• DinstarWebPush: Same as Dinstar web but incoming SMS are Pushed to URL (https://INTEGRASERVER/Integra/resources/InboundSMS/DinstarInboundSMS)
• Twilio:  No lleva información.
• Quality: Dirección IP del servicio
• InfoBip: Usuario y contraseña de la cuenta de infoBip
• SMSMasivo: Usuario y contraseña de la cuenta de SMSMasivos

Usuario (SMSUsername): Ingresa el usuario para el servicio de envío de SMS.

Contraseña (SMSPassword): Ingresa la contraseña para el servicio de envío de SMS.

SMS Form: (En el caso que la api o hardware permita) Nombre saliente del SMS.

Puertos: Número del puerto del cual sale el SMS.

SMS RegExp (SMSNumberRegexp): Propiedad que valida el formato de los números celulares a los que se envían, con el fin de tener un control más practico de si se envía o no, por ejemplo ^(09\d{7})$  esta función validará que el número a celular sea 09XXXXXXX.

En esta tabla se pueden ver la forma de editar las expresiones regulares de control:

.   Punto, cualquier carácter (puede o no coincidir con terminadores de línea, continuar leyendo).

\d   Un dígito: [0-9].

\D   Carácter que no sea un dígito: [^0-9].

\s   Un carácter en blanco: [ \t\n\x0B\f\r].

\S   Carácter que no es un espacio en blanco: [^\s].

\w   Caracteres del alfabeto: [a-zA-Z_0-9].

\W   Caracteres que no están en el alfabeto: [^\w].

*      Coincidir 0 o mas veces

+      Coincidir 1 o mas veces

?      Coincidir 1 o 0 veces

{n}    Coincidir exactamente n veces

{n,}   Coincidir al menos n veces

{n,m}  Coincidir al menos n pero no mas de m veces

\    Pasar al siguiente metacaráter (se convierte en un carácter normal/literal).

^    Coincidir con el comienzo de la línea.

.    Coincidir con cualquier carácter (con excepción de nueva línea).

$    Coincidir con final de linea (o antes del salto de línea al final).

|    Alternancia ("o" Declaración).

()   Agrupamiento.

[]   Clase de caracteres personalizada.

SMS Encoding: Tipo de codificación del proveedor, determinara como se visualizara el texto.

Luego de completar los campos presionamos el botón "Guardar" y el proveedor será agregado a la lista.

*La configuración del proveedor debe ser realizada por un usuario con acceso a estos datos debido a que la falta o el error en alguno de ellos no permitirá su correcto funcionamiento.

Eliminar: Para Eliminar un Proveedor simplemente lo seleccionamos de la lista y una vez que vemos sus datos cargados, presionamos el botón "Eliminar".

Proveedores y Tarifas

Menú para gestión de proveedores y tarifas del sistema.

...

Image Added  Nombre: Nombre del proveedor.  Límite: Indica si hay un límite de saldo en el uso del carrier.  Balance: Indica el balance de la cuenta del proveedor de los minutos  usados.  Nota: Comentario sobre el proveedor.  Habilitado: Indica si el proveedor está habilitado o no. Tarifas El segundo Menú está enfocado a la gestión tarifas de los proveedores.

...

Image Added  Proveedor: Selección del proveedor.  Prefijo: Indica una expresión regular el prefijo de uso.  Costo: Indica el costo real del minuto al destino del prefijo.  Tarifa: Indica la tarifa del minuto al destino del prefijo que se cobrara al cliente.  Nota: Comentario sobre el proveedor.  Filtros: Permite filtrar dentro de las tarifas por proveedor y prefijo.   Icono Subir: Permite seleccionar un archivo .csv para cargar tarifas en forma masiva.

...