Configurar a2billing en menos de 10 minutos

Ya sabemos como instalar a2billing, viene algo que al inicio no se nos hara muy amigable y es configurarlo para que empieze a controlar las tarifas de las llamadas que se realizen desde asterisk.

Una de las cosas que se tornan mas difíciles (instalarlo es super fácil) es entender como manejar el sistema de facturación. Sabemos que puede mostrarnos el consumo monetario de una llamada realizada por alguna de nuestras extensiones (clientes), pero configurarlo desde su amigable interfaz web es algo confuso las primeras veces.

No hay mejor manera de explicar un procedimiento que con la práctica, voy a explicar como lograr que a2billing funcione para tarificación del consumo telefónico. Para esto voy a asumir lo siguiente:

- Tengo instalado y configurado Asterisk;
- Tengo configurado un proveedor de minutos que usa SIP al que llamare proveedorsip;
- Mi proveedor NO requiere que se agregen 00 ó 011 antes del código de país;
- Tengo instalado a2billing y su interfaz de usuario;
- Para hacer llamadas internacionales mis extensiones agregan el 00 antes del código de país.

En nuestro archivo de configuracion sip.conf debemos tener las líneas para la configuración del proveedor:

El procedimiento:
1.- Crear un proveedor:

He creado el Proveedor ProveedorSIP en donde ingreso detalles informativos del proveedor.

2.- Agregar un Trunk:

Un trunk es el canal por donde saldrán las llamadas, podemos tener varios trunks por ejemplo uno para llamadas internacionales, otro para llamadas locales, etc. Estos trunks pueden usar el mismo proveedor pero se diferencian entre ellos por los dígitos que se agregan o eliminan al marcado que envia el cliente, así en este ejemplo debemos agregar 00 para llamadas inernacionales; agregar 5935(yo estoy en Manabí) para las llamadas locales.

Se ingresan los detalles de la troncal, por ejemplo que prefijo se debe agregar a cada llamada que por esta troncal salga, para ilustrar el ejemplo estos son los datos que ingreso para el Trunk que llamaré internacional-proveedorsip, debo tener en cuenta que a este proveedor enviarle el codigo de pais y el numero de telefono, por ejemplo si voy a llamar a Venezuela el debera recibir 582121234567 y no 00582121234567, el prefijo de marcado varía entre los diferentes proveedores, otros requieren que envies un 011 ó 00 antes del codigo de pais para poder terminar la llamada.

Mis usuarios marcarán:

El proveedor podra terminar la llamada si el marcado le llega como:

Así debería de quedar el trunk en a2billing para que se cumplan los requerimientos anteriores:

La última opción es bastante útil si tenemos mas de un proveedor. Podemos tener varios trunks que hagan terminación a un mismo destino pero con diferentes proveedores, asi si el proveedor A esta sin servicio la llamada puede ser terminada por el proveedor B.

3.- Creamos un grupo de tarifas (TariffGroup)

Podemos tener varios grupos de tarifas que contendran diferentes precios, por ejemplo podemos tener 3 grupos de tarifas Oro, Plata y Bronce. En Oro van tarifas bien bajas, y en Bronce las altas. Los grupos de tarifas contienen las Ratecard y estas últimas los precios de los destinos. Los grupos de tarifas pueden tener tambien LCR o LCD.

LCR es Low Cost Routing que quiere decir que escogera de las tarifas que existan a un destino la que nos cuesta menos. LCD es Low Cost Dialing que quiere decir que escogerá la tarifa de venta mas económica para el usuario.

4.- Crear RATECARD

Ratecard va a contener Rates (precios) para cada destino, en el ejemplo se ha creado la tarifa llamada Internacional que usara el trunk internacional-proveedorsip para terminar las llamadas.

5.- Crear tarifas

Seguimos el procedimiento para cada destino que queramos agregar. Hacerlo para todos los paises del mundo sería bastante tedios, para ello existe la opcion de importar un archivo separado por comas (CSV) que hallamos editado en nuestra hoja de calculo favorita. Esta tarea se la logra en:
RATECARD --> Import RateCard

El separador de columnas debe ser el ; (punto y coma) ya que si usamos , nos dará error al importar.

6.- Crear clientes

A2billing nos genera automáticamente el numero de tarjeta, si quieremos darle a nuestro usuario un número que sea más fácil de recordar para el podemos usar el campo CARD ALIAS. En este ejemplo el usuario tiene un crédito de US$10,00 y la cuenta no puede ser usada simultáneamente.

A cada tarjeta podemos agregarles usuarios adicionales SIP e IAX. Esto se lo logra listando las tarjetas y dando click al botón respectivo (SIP, IAX) en el resultado de listar las tarjetas:

Dar click en SIP para crear un usuario SIP
Dar click en IAX para crear un usuario IAX

7.- Agregar RATECARD al TARIFFGROUP

Escoger el tariffgroup Oro y agregar el ratecard internacional

Ahora debemos probar si nuestra configuración surte efecto. Configuramos un dispositivo SIP o IAX2 para que se registre con los datos de usuario sip ó iax friend y marcamos un número de USA. Si todo esta bien en el CDR veremos registrada la llamada, su Duración y precio.

T-R-U-C-O-S - Y - T-I-P-S:
Esta seccion la voy a actualizar constantemente de acuerdo al avance que vaya teniendo asi que no dejen de revisarla, puede que algo que necesiten hacer y no sepan como lograrlo ya este publicado en esta parte

**** Modificar el campo Card Number del Cliente
Al editar un cliente no puedes modificar el número de tarjeta porque este campo esta protegido contra escritura, esto implica que una llamada entre usuarios del mismo servidor pueda ser hecha entre números de tarjeta y no entre alias de tarjetas, los números que se aprenden mis usuarios son los alias porque son más sencillos de aprender. Por otra parte en lo personal se me hace mas fácil asignar manualmente el número de tarjeta que será el número de usuario. Para lograrlo debemos editar la linea 199 y eliminar la palabra readonly en el archivo /var/www/a2billing//Public/form_data/FG_var_card.inc la línea en mención nos quedaría mas o menos así:
Antes:

Despues:

**** Escuchar saldo desde cualquier extension registrada
Muchos clientes quieren conocersu saldo en dinero sin necesidad de tener una computadora cerca, para esto realizamos el siguiente hack:

Editamos balance.php y cambiamos todas las referencias de libs_a2billing a balance, de igual manera hacemos con /var/lib/asterisk/agi-bin/balance/Class.A2Billing.php y reemplazamos a2billing.conf por balance.conf

Editamos las siguientes opciones en balance.conf

Finalmente se agrega la siguiente linea en extensions.conf en el contexto que usamos para a2billing:

Al marcar *0 desde cualquier equipo registrado en el sistema escucharemos el saldo de la cuenta.

**** Habilitar VoiceMail entre usuarios SIP/IAX2 de a2billing
Esta es una opcion que no viene por defecto pero que se puede lograr modificando algunos parametros de configuracion.

Si la extension esta no esta registrada se hacen estas modificaciones:

Buscar:

Reemplazarlo por:

Cuando la extension no es contestada buscamos todas las concurrencias (hay dos) para:

Y lo dejamos asi:

Y cuando la extension esta ocupada modificamos de la siguiente manera:

Dejandolo asi:

Luego debemos crear una entrada en /etc/asterisk/voicemail.conf para nuestros usuarios que deben tener voicemail en el contexto respectivo:

ACTUALIZACION: Utilizando realtime.

Es cierto que modificar a mano el archivo /etc/asterisk/voicemail.conf cada vez que creas un usuario se torna tedioso , pero existe una solución y esta es utilizando realtime que no es mas que ingresar los usuarios en una tabla en la base de datos de a2billing, así cuando creamos un usuario este tiene por defecto habilitado el voicemail. El procedimiento anterior de reemplazar las líneas en el archivo Class.A2Billing.php también es necesario para este método.

Que es lo que debemos hacer?

1.- Añadir la tabla voicemail_users en la base de datos mya2billing:

Para hacerlo mas sencillo, copiamos las líneas del párrafo anterior en un archivo que llamaremos voicemail_users.sql y luego ejecutamos:

mysql -u a2billinguser -pa2billing mya2billing < voicemail_users.sql

2.- Debemos sincronizar las tablas de la base de datos mya2billing para que esta contenga los datos para el funcionamiento del voicemail de los usuarios, y esto hay que hacerlo con una tarea programada, yo lo estoy haciendo cada 5 minutos.

Esta es la sentencia que debe ser ejecutada cada 5 minutos por el usuario a2billinguser en la base de datos mya2billing:

Para hacerlo mas sencillo creamos un archivo de texto en /etc/asterisk llamado a2billingvoicemail.sql que contenga las líneas del párrafo anterior, luego creamos un archivo en /etc/asterisk llamado a2billingvoicemail.sh que debe contener esto:

Le damos permisos de ejecución:

Y programamos la tarea para que se ejecute cada 5 minutos:

Agregamos las siguientes líneas:

3.- Configurar realtime en /etc/asterisk/extconfig.conf debemos agregar:

Y en /etc/asterisk/res_mysql.conf :

4.- Configuramos nuestro contexto para a2billing para que luzca de esta manera:

Esto quiere decir que si un usuario digita 9999 va a ir a su centro de mensajes. La contraseña por defecto para cada usuario es 1234, él deberá cambiarla desde el mismo centro de mensajes de voz.

**** A2billing esta facturando la llamada desde que el telefono timbra y no desde que contestan.
Por defecto a2billing.conf muestra el consumo desde que marcas el numero hasta que cuelgas, muchos al igual que yo deben querer que sea facturado solo el tiempo hablado, es decir desde que la llamada es contestada. Esto se logra ademas modificando el parámetro dialcommand_param para agregar la letra C

Tambien debemos decirle a a2billing que no se encargue de contestar la llamada y quitar el comando Answer en el contexto a2billing:

En /etc/asterisk/a2billing.conf buscamos el parametro answer_call en la seccion agi-conf y lo seteamos en NO:

En /etc/asterisk/extensions.conf modificamos el contexto a2billing para que luzca asi:

**** La interfaz de mis usuarios sale en ingles, cuando doy cliente en la bandera de Espana el lenguaje no cambia. Estoy usando Debian.
Lo solucionamos de la siguiente manera:

Seleccionamos:

Y luego:

Lo que sucede es que Debian instala solo el local que se define en la instalacion, si instalamos el sistema base en espanol no habria este problema.

**** Aumentar decimales en el registro de llamadas
Por defecto la interfaz de usuario de A2billing muestra solo 2 decimales, asi que si aun cliente le dices que el minuto es a 0.055 el va a mirar en su interfaz 0.06 y a la larga esto va a causar molestias en el usuario.

Para solucionarlo se debe proceder de la siguiente manera:
Editar /var/www/html/consumos/lib/Misc.php en la linea 77:

Debe quedar asi:

**** Si tengo poco saldo y hago una llamada a2billing permite que yo termine la llamada y me da saldo en contra
Esto no seria un problema si hay pocos usuarios, pero supongamos que alguien realiza una llamada a un destino que es muy caro y se queda hablando por una hora? Para evitar que esto sucede y que la llamada sea cortada cuando al usuario se le termine el saldo debemos modificar el parametro dialcommand_param en /etc/asterisk/a2billing.conf:

**** Permitir a los usuarios loguearse en la interfaz de administracion usando su e-mail o el numero de tarjeta
Este tip es bastante util puesto que permite usar o bien el numero de tarjeta o la direccion de correo electronica que el usuario tenga registrada en el sistema.

Buscar en /var/www/consumos/lib/module.access.php:

Reemplazar por:

Buscar:

Reemplazar por: