¿Qué es SimmBook y cómo funciona?

SimmBook es una aplicación web que permite mantener actualizados y organizados todos los contactos corporativos en un solo lugar. Cada usuario podrá organizar y compartir los datos de sus contactos mediante listas públicas o privadas de forma sencilla y eficaz. Cuenta con identificador de llamantes, para una mejor identificación de las llamadas recibidas y la posibilidad de iniciar una llamada desde el directorio sin necesidad de marcar el número de teléfono.

Descarga e Instalación

Para poder instalar SimmBook es imprescindible que haya una solución basada en Asterisk en funcionamiento, en la cual se va a instalar la aplicación. La versión actual de SimmBook, no puede ser instalada en otro equipo que no sea nuestra máquina Asterisk. (ver manual de instalación)

Puede descargar el instalador de SimmBook haciendo click AQUÍ. Todos los productos de SimmLine cuentan con una versión de prueba por 15 días, sin ningún tipo de restricciones.

Accediendo a SimmBook

Para acceder a SimmBook es necesario abrir un navegador web y en la barra de direcciones ingresar http://your.server.ip/simmbook.

La primera vez que se accede, se solicitará la clave de activación del producto. Esta clave será enviada por email al comprar la licencia, o al activar la versión de prueba.

Inicio de Sesión

Al iniciar SimmBook podremos consultar todas las extensiones registradas en la PBX  y contar con la posibilidad de llamar a cualquier extensión haciendo click en el botón .

Los usuarios que deseen acceder con un usuario personal para ver los contactos creados, las listas y demás funcionalidades de la aplicació, deberán hacer click en el botón Login y acceder con las credenciales correspondientes.

Por defecto SimmBook provee un usuario Administrador que cuenta con acceso a todas las funcionalidades del sistema y cuyas credenciales son: Usuario: admin / Password: admin

Por mayor seguridad, se recomienda modificar el password provisto por defecto.

Panel Principal

Después de iniciar sesión correctamente, se le presentará la ventana del panel principal.

Aquí podrán consultar: todos los contactos creado por el usuario, los contactos marcados como favoritos, las extensiones de la PBX y los contactos agrupados por listas.

Pestaña «Contactos por Lista«, aquí cada usuario podrá consultar las listas personales y las listas creadas por otros usuarios del programas que fueron definidas como públicas.

Llamar a un contacto es tan sencillo como hacer click sobre el número de teléfono. también es posible consultar los datos personales del contacto mediante el botón .

Menú Configuración

Parámetros Generales

Una vez que seleccione ‘Parámetros Generales’, se le presentará la Ventana de Parámetros, como se muestra a continuación:

Desde los parámetros generales los usuarios podrán cargar los datos de la empresa y definir el prefijo a sugerir en la creación de los contactos.

La mayoría de los campos son auto explicativos, como nombre, dirección, etc.

El campo Idioma, define el idioma se visualizará el sistema  de forma global (para todos los usuarios del sistema). Actualmente está disponible en tres idiomas: Español, Inglés y Portugués.

Prefijo, define que ruta saliente debe tomar asterisk para realizar la llamada al número del contacto. Este valor se muestra al momento de crear un nuevo contacto y puede ser modificado.

Datos Asterisk, por defecto cuando se instala SimmAgents se crea un usuario AMI con los valores que se muestran en los campos, Host, User y Password. Si se desea cambiar el usaario AMI o el Password, se debe modificar primero aquí y luego seguir los pasos detallados AQUÍ para la creación o modificación del usuario de Asterisk Manager Interface.

Perfiles de Usuarios

Es una agrupación de permisos que determina qué accesos y acciones podrá realizar cada usuario dentro de SimmBook. Cada usuario puede pertenecer a un grupo y cada grupo puede ser compartido por varios usuarios.

Por defecto SimmBook traer creado un Perfil de Usuarios Administrador que no puede ser eliminado y que tiene acceso a todas las funcionalidades de la plataforma.

El uso es directo. Puede hacer clic en el botón + Crear Perfil para insertar nuevos registros o hacer clic en los botones de acción de cada registro para editarlos, eliminarlos o definir los permisos. Hay un cuadro de búsqueda que le permite buscar cualquier cadena o número.

Definición de Permisos

Al hacer click en el botón  es posible establecer que accesos y acciones estarán habilitadas para el perfil seleccionado.

Usuarios

Los usuarios son todas las personas que necesitan acceder al sistema y de quienes se desea tener un registro personalizado de los accesos y acciones que podrá realizar.

El uso es directo. Puede hacer clic en el botón + Crear Usuario para insertar nuevos registros o hacer clic en los botones de acción de cada registro para editarlos o eliminarlos. Hay un cuadro de búsqueda que le permite buscar cualquier cadena o número.

El usuario administrador al igual que el Perfil Administrador, está creado por defecto y no puede ser eliminado.

El campo caducidad determina el período durante un usuario estará activo. Cada vez que el usuario ingrese, el sistema chequeará si el usuario está dentro del período determinado. En caso de dejar el campo en blanco, el usuario no caducará.

Menú Contactos, Listas de Contactos, Categorías y Contactos Ocultos

Esta sección permite crear, modificar y eliminar contactos, listas, categorías y blacklist. Para una mejor experiencia al configurar la plataforma, se recomienda primero crear las Listas de Contactos, las Categorías  y luego los Contactos.

Listas de Contactos

Las listas de Contactos permiten agrupar los contactos para una mejor identificación y para poder compartirlos con los demás usuarios de la aplicación. Las listas pueden ser Privadas o Públicas.

Privadas: las listas privadas y los contactos que la integran solo pueden ser visualizados por el usuario que las creo (propietario).

Públicas: las listas públicas y los contactos que la integran pueden ser visualizadas por todos los usuarios del sistema, desde la pestaña Contactos por Lista del panel principal.

El uso es directo. Puede hacer clic en el botón + Crear Lista para insertar nuevos registros o hacer clic en los botones de acción de cada registro para editarlos, eliminarlos o asignar contactos a la lista de forma masiva. Hay un cuadro de búsqueda que le permite buscar cualquier cadena o número.

 Asignar Contactos a una Lista

SimmBook provee 2 formas de vincular o desvincular contactos a una lista:

1- Desde la interfaz de creación de un contacto, al momento de dar de alta cada contacto el sistema nos permitirá indicar a que lista pertenece.

2 – O desde el botón de cada Lista, en la cual se mostrarán todos los contactos que creó el usuario y mediante la selección, estaremos indicando que contactos deseamos agregar a la lista seleccionada.

Categoría de Contactos

Las categorías de Contactos son junto con las Listas otra forma de agrupación, su uso está pensado para complementar las listas, pero también puede utilizarse de forma independiente. Supongamos que se crea una lista Funcionarios que contiene todos los funcionarios de la empresa, y a su vez se desea agrupar los contactos por departamento, mediante la creación de los departamentos como categorías, contaríamos con un filtro que es la lista Funcionarios y otro por departamento / categoría.

El uso es directo. Puede hacer clic en el botón + Crear Categoría para insertar nuevos registros o hacer clic en los botones de acción de cada registro para editarlos o eliminarlos. Hay un cuadro de búsqueda que le permite buscar cualquier cadena o número.

Contactos

Un contacto es toda persona o empresa de la cual se desea tener un registro de los datos personales o de contacto. El uso es directo. Puede hacer clic en el botón + Crear Contacto para insertar nuevos registros o hacer clic en los botones de acción de cada registro para editarlos o eliminarlos. Hay un cuadro de búsqueda que le permite buscar cualquier cadena o número.

Los contactos son privados y solo pueden ser modificados, eliminados o consultados por el usuario que lo creo. El único caso en que un contacto es visible para los demás usuarios de SimmBook es cuando se lo vincula a una Lista de Contactos definida como pública.

La mayoría de los campos son auto explicativos, como nombre, dirección, etc, en el caso del Prefijo, define que ruta saliente debe tomar asterisk para realizar la llamada al número del contacto.

Contactos Ocultos

Los contactos ocultos funciona igual que una blacklist, los números de teléfonos que se ingresen en este campo no serán visualizados en ninguna parte del sistema. El uso es directo. Puede hacer clic en el botón + Crear Contacto Oculto para insertar nuevos registros o hacer clic en los botones de acción de cada registro para editarlos o eliminarlos. Hay un cuadro de búsqueda que le permite buscar cualquier cadena o número.

Herramientas

Dentro del menú herramientas disponemos de dos opciones: Importación Contactos y Agenda Remota Yealink.

Importar Contactos

Desde un archivo externo en formato .Txt o .Csv.  la herramienta permite crear un Contacto o modificarlo en caso de que exista un registro con el mismo Nombre o igual nombre de empresa.

Al hacer clic en el botón Seleccionar Archivo, le mostrará una ventana para buscar el archivo txt o csv a importar. La primera línea del archivo ya debe contener el primer registro que desea insertar. Los campos que debe contener el archivo son: Nombre Completo; Empresa; Razón Social; Teléfono 1; Teléfono 2; Email; Dirección; Localidad;

En caso de que alguno de los campos no se desee completar se debe dejar vacío pero respetando que todos los registros tengan 8 valores definidos.

Este es un archivo de muestra con el formato que debe tener el archivo para una correcta importación:

funcionarios.csv
Diego Pereira ;SimmLine ;SimmLine Inc. ;11223344 ;55669977 ;info@simmline.com ;  ;Montevideo;
Carolina Alustiza; SimmLine;  ;88552200 ;  ;info@simmline.com ;  ;  ;

Agenda Remota Yealink

Esta herramienta genera la URL necesaria para que los teléfonos Yealink con soporte para Agenda Remota, importen de forma automática los contactos en el teléfono. Para conocer si su modelo cuenta con dicha capacidad y como configurar la agenda remota consulte la información en la página del fabricante.

Ante cualquier consulta sobre los pasos detallados en este documento, contáctenos a la casilla support@simmline.com que con gusto lo ayudaremos.

Equipo SimmLine.

Asterisk Manager Iinterface (AMI) Conexión Fallida

Esta falla se origina cuando SimmBook intenta establecer la conexión con Asterisk Manager Interface.

Para resolver el problema es necesario verificar si en el fichero manager.conf ubicado en /etc/asterisk/ ( en instalaciones basadas en Issabel, es posible que el archivo se llame manager_custom.conf en lugar de manager.conf), fue agregada la línea #include manager_custom_simmline.conf, si no se encuentra agregarla al final del archivo.

A continuación verificar si fue creado el fichero manager_custom_simmline.conf, en el directorio /etc/asterisk/. Si no existe crearlo agregando los datos que se describen a continuación que definen el nombre, password y los permisos que tendrá el usuario AMI.

Dentro del directorio /etc/asterisk/ agregue un nuevo archivo con el nombre manager_custom_simmline.conf  y añada la siguiente información. En caso de existir el fichero verifique si la información en él coincide con la detallada.

[simmline]
secret = simmLine1763
deny= 0.0.0.0/0.0.0.0
permit =127.0.0.1/255.255.255.0
read = all
write = all
writetimeout = 1000

Una vez editado el fichero es necesario reiniciar el módulo de Asterisk para que los cambios surtan efecto, ejecutando desde la consola de linux el comando asterisk -rx ‘module reload manager’.

Si el usuario se creó o modificó correctamente se mostrará un mensaje similar al que se muestra en la imagen a continuación.

Personalizar Usuario o Password de Asterisk Manager Iinterface (AMI)

Si se desea configurar un usuario o contraseña de AMI distinto al provisto por defecto, debe seguir los siguientes pasos en el orden establecido sin excepción.

1 – Ingresar como administrador a SimmBook, ir a la opción del menú  Configuración / Parámetros Generales.

Los valores que se puede modificar son: host, user y password. Modifique los valores deseados y confirme.

2 – A continuación edite el fichero manager_custom_simmline.conf ubicado en el servidor Asterisk en el directorio /etc/asterisk/.

Ingrese los nuevos valores, guarde los cambios y reinicie el módulo de Asterisk para que los cambios surtan efecto, ejecutando desde la consola de linux el comando asterisk -rx ‘module reload manager’.

MySql Conexión Fallida

Esta falla se origina cuando SimmBook intenta establecer la conexión con la base de datos simmbook y asterisk de Mysql o MariaDB. Las causas posibles son que no exista la base de datos «simmbook», que no esté creado el usuario «simmline» en el servidor SQL o que esté creado pero no cuente con los permisos necesarios para acceder la base de datos simmbook y asterisk.

Verificar base de datos SimmBook

1 – En el equipo donde se instalo SimmBook, ingresar al servidor SQL.
2 – Ejecutar el comando show databases, se debe visualizar una base de datos con el nombre asterisk y otra con el nombre simmbook
3 – En caso de no visualizarse la base de datos simmbook ejecutando el comando «create schema simmbook«, podrá crearla.
4 – Por último es necesario hacer un restore de la información, escribanos a support@simmline.com para que le sea proporcionado el archivo .sql que debe levantar.

Verificar usuario y permisos

1 – En el equipo donde se instalo SimmBook, ingresar al servidor SQL con el usuario simmline y el password SimmLine
2 – Ejecutar el comando show databases, se debe visualizar una base de datos con el nombre asterisk y otra con el nombre simmbook

Si no se visualizan las bases de datos simmbook y asterisk o si falló el ingreso con el usuario y password provisto.

Ingrese con el usuario root al servidor SQL y ejecute las siguientes sentencias.

GRANT ALL PRIVILEGES ON simmbook.* TO «simmline»@»localhost» IDENTIFIED BY «SimmLine» WiTH GRANT OPTION;
GRANT ALL PRIVILEGES ON asterisk.* TO «simmline»@»localhost» IDENTIFIED BY «SimmLine» WiTH GRANT OPTION;

Consideraciones: 

La versión actual de SimmBook no permite que la base de datos «simmbook» se instale en un equipo distinto al servidor de asterisk
No es posible modificar el usuario y password provisto por uno personalizado.
Estamos trabajando para liberar un versión futura que permita instalar la aplicación y su base de datos en equipos distintos.

ionCube PHP Loader

Si al iniciar SimmBook se presenta el error igual al descrito en la imagen, es originado por una diferencia entre la versión de PHP que está instalada en el servidor Asterisk y la versión en la que está protegido SimmBook (php 5.3).

Para solucionarlo es necesario editar el fichero 00-ioncube.ini, ubicado en el directorio /etc/php.d/, en él encontraremos una línea igual a la detallada a continuación:

zend_extension=/usr/local/ioncubeloader/ioncube_loader_lin_5.3.so

La versión por defecto que viene configurada es la 5.3, si en el servidor Asterisk se está ejecutando una versión distinta modifique dicho valor para que coincida con el del servidor y reinicie el servidor HTTP Apache ejecutando en la consola de linux el comando «service httpd restart«.

Si desconoce que versión de PHP se está ejecutando en el servidor, puede ejecutar desde la consulta el comando php -v para confirmar dicha información.

Ante cualquier consulta sobre los pasos detallados en este documento contáctenos a la casilla support@simmline.com que con gusto lo ayudaremos.

Equipo SimmLine.

Requisitos del sistema

El software consta de dos componentes, un componente del lado del servidor que se ejecuta en su Pbx y una aplicación web que es servida por su servidor web.

El componente del servidor se ejecuta actualmente en versiones de 64 bits de Centos / Fedora.

Es necesario que haya una solución basada en Asterisk en funcionamiento en la cual se va a instalar la aplicación. La versión actual de SimmBook, no puede ser instalada en otro equipo que no sea nuestra máquina Asterisk.

Requisitos del servidor

• Sistema operativo  Centos / Fedora 64 bits
• PHP 5.1 o superior
• MySQL Server 5 o superior, o MariaDB

Requisitos del cliente

• Navegador web (IE10 o superior, Google Chrome, Safari, Firefox, Opera)

IMPORTANTE:
Todos los sistemas de la familia SimmLine requieren para su funcionamiento que la PBX en donde se instale el software, cuente con acceso a Internet o como mínimo a la URL:  https://simmlicenses.com/

Obtener Instalador

Puede descargar de forma gratuita el software desde AQUÍ. Todos los productos de SimmLine cuentan con una una versión de prueba por 15 días, sin ningún tipo de restricción.

También es posible descargar el instalador de SimmBook desde el mail que se envía al adquirir el producto o al activar la versión de prueba, o si lo prefiere directamente desde la consola de su PBX ejecutando el siguiente comando de shell:

wget  https://simmlicenses.com/download/simmbook_installer_64bits

Si su plataforma no admite el instalador, por favor háganoslo saber (support@simmline.com) , que seguro encontraremos una alternativa para que pueda disfrutar nuestros productos.

Si adquirió una licencia o activo un trial de SimmBook y no recibió ningún email, revise la carpeta spam de su aplicación de correo electrónico o contáctenos a la casilla  sales@simmline.com.

Instalación

Una vez descargado el instalador, debemos asegurarnos que tenemos permisos de lectura y ejecución sobre el archivo. Nos posicionamos en el directorio donde se descargó el instalador y ejecutamos el siguiente comando de shell:

chmod +x simmbook_installer_64bits

Ahora puede comenzar la instalación ejecutando directamente desde la consola el siguiente comando:

./simmbook_installer_64bits

Finalizada la instalación para acceder a SimmBook es necesario abrir un navegador web y en la barra de direcciones ingresar http://your.server.ip/simmbook/

Configuración Búsqueda Llamante

Para poder utilizar la función de identificación de Llamante, es necesario realizar algunas configuraciones a nivel de la PBX, a continuación se detallan los pasos a seguir para configurar en FreePBX e Issabel dicha funcionalidad.

FreePBX

Acceder como administrador a FreePBX, ir a: Menú Admin/ CalerID Lookup Sources y agregar un nuevo CIDLookup Source con los datos que se muestran en la imagen a continuación.

Una vez configurado el CIDLookup Source, es necesario asociarlo a las rutas entrantes que se hayan configurado en la PBX, para ello ir a Menu / Connectivity / Inbound Routes

Click en el botón Editar, seleccionamos la pestaña Other y en el campo CID Lookup Source seleccionamos SimmBook.

Este proceso debe realizarse para todas las Rutas entrantes en las que se desee contar con el identificador de llamante.

Accediendo a SimmBook

Finalizada la instalación y luego de realizar las configuraciones antes descritas, iniciamos un navegador web y en la barra de direcciones ingresamos: http://your.server.ip/simmbook

Descargo de Responsabilidad de Terceros

Todos los nombres de productos y empresas son marcas comerciales ™ o registradas® de sus respectivos propietarios. El uso de ellos no implica ninguna afiliación o endoso por parte de ellos.

LINUX es la marca registrada de Linus Torvalds en los EE. UU. Y otros países.

ASTERISK es una marca registrada de Digium, Inc.

FREEPBX es una marca registrada de Sangoma Technologies

Ante cualquier consulta sobre los pasos detallados en este documento o si tiene problemas para iniciar el sistema correctamente, contáctenos a la casilla support@simmline.com que con gusto lo ayudaremos.

Equipo SimmLine.

Error de Conexión

Las posibles causas que originan este error son:

1. El servidor Asterisk donde se instalo el sistema no tenga acceso a Internet o la la URL: https://simmlicenses.com/
2. El servidor de licencias se encuentra temporalmente fuera de servicio.

Escenario 1 si por seguridad no desea habilitar el acceso a internet de la Pbx, solo es necesario que tenga acceso a la URL https://simmlicenses.com/, la comunicación con el servidor de licencias es cifrada y solo se utilizar para conectarse a los web services de licenciamiento.

Escenario 2 nuestro servidor de licencias está alojado en Amazon AWS y cuenta con redundancia ante fallas que garantiza una disponibilidad del 99%, lo que se traduce en una probabilidad casi nula de que los sistemas dejen de operar por una falla en la plataforma de licencias.

Licencia Caducada 

Todos los productos de la familia SimmLine se comercializan bajo la modalidad de arrendamiento, si el plan contratado llega a su fin y no es renovado el sistema dejará de funcionar. Cada producto se licencia de forma independiente por lo cual el vencimiento de un contrato no afecta el resto de las licencias que tenga contratadas.

Para administrar sus licencias y renovar las suscripciones debe acceder a www.simmlicenses.com.

Licencia Inválida

Cada licencia puede ser utilizada para activar un único servidor/equipo, si está migrando la licencia de servidor o fue necesario reinstalar el sistema, es necesario realizar un Revoke de la licencia desde la plataforma SimmLicenses. Para ello debe realizar los siguiente pasos:

1. Ingresar a www.simmlicenses.com.
2. Ir a Menú / Mis Licencias.
3. Seleccionar la licencia que se desea Revocar.
4. Hacer click en el botón .

Una vez realizado el proceso de Revocación de la licencia, podrá activar el nuevo servidor sin problemas.

Licencia Suspendida

La suspensión de una licencia es un proceso administrativo de SimmLine, por ello para conocer la razón de la suspensión en necesario contarse con support@simmline.com.

Ante cualquier consulta sobre los pasos detallados en este documento contáctenos a la casilla support@simmline.com que con gusto lo ayudaremos.

Equipo SimmLine.

Si al momento de activar el sistema no cuenta con una Clave de Activación, es necesario que se registre en nuestra plataforma www.simmlicenses.com.

El proceso de activación es muy sencillo e intuitivo solo es necesario ingresar la clave obtenida al activar el Trial o al Adquirir la licencia y hacer click en el botón Activar.

Las posibles fallas que pueden surgir al momento de activar un producto son:

1 – Se origina cuando se ingresa una clave Inválida o que no corresponde al mismo producto.  Verifique en el cuerpo del mail que recibió al adquirir la licencia, a que producto corresponde la licencia y que la misma coincida con la que está ingresando en el campo Clave de Activación, el campo es sensible a las mayúsculas y minúsculas. Si los datos que está ingresando son correctos y el problema persiste contáctenos a la casilla support@simmline.com.

2 – Se origina cuando la clave que se está ingresando figura en nuestros registros como Activa, si está migrando la licencia de servidor o reinstaló el sistema, es necesario realizar un Revoke de la licencia desde la plataforma SimmLicenses. Para ello debe realizar los siguiente pasos:

1. Ingresar a www.simmlicenses.com.
2. Ir a Menú / Mis Licencias.
3. Seleccionar la licencia que se desea Revocar.
4. Hacer click en el botón .

Una vez realizado el proceso de Revocación de la licencia, podrá activar el nuevo servidor sin problemas.

3 – Este error puede presentarse si el producto se instaló en una distribución de linux que no sean las actualmente homologadas por SimmLine para sus productos. Consulté la sección requerimientos técnicos en el Manual de Instalación de cada producto, en nuestra WIKI.

Ante cualquier consulta sobre los pasos detallados en este documento contáctenos a la casilla support@simmline.com que con gusto lo ayudaremos.

Equipo SimmLine.

Asterisk Manager Iinterface (AMI) Conexión Fallida

Esta falla se origina cuando SimmAgents intenta establecer la conexión con Asterisk Manager Interface.

Para resolver el problema es necesario verificar si en el fichero manager.conf ubicado en /etc/asterisk/ ( en instalaciones basadas en Issabel, es posible que el archivo se llame manager_custom.conf en lugar de manager.conf), fue agregada la línea #include manager_custom_simmline.conf, si no se encuentra agregarla al final del archivo.

A continuación verificar si fue creado el fichero manager_custom_simmline.conf, en el directorio /etc/asterisk/. Si no existe crearlo agregando los datos que se describen a continuación que definen el nombre, password y los permisos que tendrá el usuario AMI.

Dentro del directorio /etc/asterisk/ agregue un nuevo archivo con el nombre manager_custom_simmline.conf  y añada la siguiente información. En caso de existir el fichero verifique si la información en él coincide con la detallada.

[simmline]
secret = simmLine1763
deny= 0.0.0.0/0.0.0.0
permit =127.0.0.1/255.255.255.0
read = all
write = all
writetimeout = 1000

Una vez editado el fichero es necesario reiniciar el módulo de Asterisk para que los cambios surtan efecto, ejecutando desde la consola de linux el comando asterisk -rx ‘module reload manager’.

Si el usuario se creó o modificó correctamente se mostrará un mensaje similar al que se muestra en la imagen a continuación.

Personalizar Usuario o Password de Asterisk Manager Iinterface (AMI)

Si se desea configurar un usuario o contraseña de AMI distinto al provisto por defecto, debe seguir los siguientes pasos en el orden establecido sin excepción.

1 – Ingresar como administrador a SimmAgents, ir a la opción del menú  Configuración / Parámetros Generales.

Los valores que se puede modificar son: host, user y password. Modifique los valores deseados y confirme.

2 – A continuación edite el fichero manager_custom_simmline.conf ubicado en el servidor Asterisk en el directorio /etc/asterisk/.

Ingrese los nuevos valores, guarde los cambios y reinicie el módulo de Asterisk para que los cambios surtan efecto, ejecutando desde la consola de linux el comando asterisk -rx ‘module reload manager’.

MySql Conexión Fallida

Esta falla se origina cuando SimmAgents intenta establecer la conexión con la base de datos simmagents y asterisk de Mysql o MariaDB. Las causas posibles son que no exista la base de datos «simmagents», que no esté creado el usuario «simmline» en el servidor SQL o que esté creado pero no cuente con los permisos necesarios para acceder la base de datos simmagents y asterisk.

Verificar base de datos SimmAgents

1 – En el equipo donde se instalo SimmAgents, ingresar al servidor SQL.
2 – Ejecutar el comando show databases, se debe visualizar una base de datos con el nombre asterisk y otra con el nombre simmagents
3 – En caso de no visualizarse la base de datos simmagents ejecutando el comando «create schema simmagents«, podrá crearla.
4 – Por último es necesario hacer un restore de la información, escribanos a support@simmline.com para que le sea proporcionado el archivo .sql que debe levantar.

Verificar usuario y permisos

1 – En el equipo donde se instalo SimmAgents, ingresar al servidor SQL con el usuario simmline y el password SimmLine
2 – Ejecutar el comando show databases, se debe visualizar una base de datos con el nombre asterisk y otra con el nombre simmagents

Si no se visualizan las bases de datos simmagents y asterisk o si falló el ingreso con el usuario y password provisto.

Ingrese con el usuario root al servidor SQL y ejecute las siguientes sentencias.

GRANT ALL PRIVILEGES ON simmagents.* TO «simmline»@»localhost» IDENTIFIED BY «SimmLine» WiTH GRANT OPTION;
GRANT ALL PRIVILEGES ON asterisk.* TO «simmline»@»localhost» IDENTIFIED BY «SimmLine» WiTH GRANT OPTION;

Consideraciones: 

La versión actual de SimmAgents no permite que la base de datos «simmagents» se instale en un equipo distinto al servidor de asterisk
No es posible modificar el usuario y password provisto por uno personalizado.
Estamos trabajando para liberar un versión futura que permita instalar la aplicación y su base de datos en equipos distintos.

ionCube PHP Loader

Si al iniciar SimmAgents se presenta el error igual al descrito en la imagen, es originado por una diferencia entre la versión de PHP que está instalada en el servidor Asterisk y la versión en la que está protegido SimmAgents (php 5.3).

Para solucionarlo es necesario editar el fichero 00-ioncube.ini, ubicado en el directorio /etc/php.d/, en él encontraremos una línea igual a la detallada a continuación:

zend_extension=/usr/local/ioncubeloader/ioncube_loader_lin_5.3.so

La versión por defecto que viene configurada es la 5.3, si en el servidor Asterisk se está ejecutando una versión distinta modifique dicho valor para que coincida con el del servidor y reinicie el servidor HTTP Apache ejecutando en la consola de linux el comando ‘service httpd restart’

Si desconoce que versión de PHP se está ejecutando en el servidor, puede ejecutar desde la consulta el comando php -v para confirmar dicha información.

Ante cualquier consulta sobre los pasos detallados en este documento contáctenos a la casilla support@simmline.com que con gusto lo ayudaremos.

Equipo SimmLine.

Requisitos del sistema

El software consta de dos componentes, un componente del lado del servidor que se ejecuta en su Pbx y una aplicación web que es servida por su servidor web.

El componente del servidor se ejecuta actualmente en versiones de 64 bits de Centos / Fedora.

Es necesario que haya una solución basada en Asterisk en funcionamiento en la cual se va a instalar la aplicación y un sistema de Colas configurada a nivel de la PBX. La versión actual de SimmAgents, no puede ser instalada en otro equipo que no sea nuestra máquina Asterisk.

Requisitos del servidor

• Sistema operativo  Centos / Fedora 64 bits
• PHP 5.1 o superior
• MySQL Server 5 o superior, o MariaDB

Requisitos del cliente

• Navegador web (IE10 o superior, Google Chrome, Safari, Firefox, Opera)

IMPORTANTE:
Todos los sistemas de la familia SimmLine requieren para su funcionamiento que la PBX en donde se instale el software, cuente con acceso a Internet o como mínimo a la URL:  https://simmlicenses.com/

Obtener Instalador

Puede descargar de forma gratuita el software desde AQUÍ. Todos los productos de SimmLine cuentan con una una versión de prueba por 15 días, sin ningún tipo de restricción.

También es posible descargar el instalador de SimmAgents desde el mail que se envía al adquirir el producto o al activar la versión de prueba, o si lo prefiere directamente desde la consola de su PBX ejecutando el siguiente comando de shell:

wget  https://simmlicenses.com/download/simmagents_installer_64bits

Si su plataforma no admite el instalador, por favor háganoslo saber (support@simmline.com) , que seguro encontraremos una alternativa para que pueda disfrutar nuestros productos.

Si adquirió una licencia o activo un trial de SimmAgents y no recibió ningún email, revise la carpeta spam de su aplicación de correo electrónico o contáctenos a la casilla  sales@simmline.com.

Instalación

Una vez descargado el instalador, debemos asegurarnos que tenemos permisos de lectura y ejecución sobre el archivo. Nos posicionamos en el directorio donde se descargó el instalador y ejecutamos el siguiente comando de shell:

chmod +x simmagents_installer_64bits

Ahora puede comenzar la instalación ejecutando directamente desde la consola el siguiente comando:

./simmagents_installer_64bits

Finalizada la instalación para acceder a SimmAgents es necesario abrir un navegador web y en la barra de direcciones ingresar http://your.server.ip/simmagents/

Configuración Extensions_custom.conf

Finalizada la instalación y antes de iniciar SimmAgents es necesario realizar alguna configuración básica en el archivo  /etc/asterisk/extensions_custom.conf.

Debemos modificara el fichero, para que incluya el archivo extensions_custom_simmagents.conf y el contexto SimmAgents, el cual almacena la parte de la lógica del sistema.

Editamos el archivo y en la primer linea agregamos el siguiente texto:

#include extensions_custom_simmagents.conf

Y dentro del macro [from-internal-custom] agregar la siguiente línea:

include => SimmAgents

En el caso de que el macro [from-internal-custom] no esté creado, debe ser agregado antes de la línea include => SimmAgents, quedando de la siguiente manera.

[from-internal-custom]
include => SimmAgents

Realizado el cambio solo resta ejecutar el siguiente comando desde la consola de linux: asterisk -rx ‘dialplan reload’

Configuración extensions_custom_simmagents.conf 

Éste fichero contiene la lógica que permite al SimmAgents determinar a que agente / interno debe derivar las llamadas recibidas, también habilita las funcionalidades de logueo, deslogueo, pausa y unpausa desde un teléfono/interno, si no se desea utilizar la interfaz web que provee el sistema.

El archivo está ubicado dentro de /etc/asterisk/extension_custom_simmagents.conf y por defecto está configurado para agentes cuyo número está comprendido entre el 4000 y el 4999.

¿Como le indicamos a SimmAgents que numeración van a tener nuestros agentes?, mediante la definición de una expresión regular como se indica en la línea 4 de la imagen a continuación.

El valor ingresado dentro de los paréntesis rectos [ ] determina con que dígito comienzan los número de los agentes y las X a continuación la cantidad de dígitos que conforman el número. No existen restricciones en cuanto a la numeración que se desee utilizar, pueden crear agentes cuyo número sea de 3 dígitos [X]XX , 4 [X]XXX, 5 [X]XXXX o lo que se ajuste a las necesidades de la empresa.

Si tiene dudas sobre cual es la expresión que corresponde utilizar, no dude en contactarnos que con gusto le ayudaremos a  configurar su SimmAgents.

Configuración en PBX

A nivel de la PBX recomendamos configurar la propiedad Skip Busy Agents en YES + (ringinuser=no) para cada Cola que se vaya a utilizar con SimmAgents.

FreePBX

Una vez logueado en FreePBX, debemos ir a: Menú Applications / Queues, editamos las colas que se utilizaran desde SimmAgents y seleccionamos la opción YES + (ringinuser=no).

Accediendo a SimmAgents

Finalizada la instalación y luego de realizar las configuraciones antes descritas, iniciamos un navegador web y en la barra de direcciones ingresamos: http://your.server.ip/simmagents

Descargo de Responsabilidad de Terceros

Todos los nombres de productos y empresas son marcas comerciales ™ o registradas® de sus respectivos propietarios. El uso de ellos no implica ninguna afiliación o endoso por parte de ellos.

LINUX es la marca registrada de Linus Torvalds en los EE. UU. Y otros países.

ASTERISK es una marca registrada de Digium, Inc.

FREEPBX es una marca registrada de Sangoma Technologies

Ante cualquier consulta sobre los pasos detallados en este documento o si tiene problemas para iniciar el sistema correctamente, contáctenos a la casilla support@simmline.com que con gusto lo ayudaremos.

Equipo SimmLine.

¿Qué es SimmAgents y cómo funciona?

SimmAgents es una aplicación web que permite a los Agentes del call center  utilizar un interno/extensión sin exclusividad. Cada Agente se loguea con su propio usuario desde la interfaz web del sistema para recibir llamadas o pausar el usuario. Una vez que finaliza, simplemente se desloguea para que el interno quede disponible para otro Agente o si se loguea en otro teléfono, es deslogueado automáticamente del interno original.

Descarga e Instalación

La instalación del sistema SimmAgents requiere que haya una solución basada en Asterisk en funcionamiento, en la cual se va a instalar la aplicación y un sistema de Colas configurada a nivel de la PBX. La versión actual de SimmAgents, no puede ser instalada en otro equipo que no sea nuestra máquina Asterisk. (ver manual de instalación)

Puede descargar el instalador de SimmAgents haciendo click AQUÍ. Todos los productos de SimmLine cuentan con una versión de prueba por 15 días, sin ningún tipo de restricciones.

Accediendo a SimmAgents

Para acceder a SimmAgents es necesario abrir un navegador web y en la barra de direcciones ingresar http://your.server.ip/simmagents.

La primera vez que se accede, se solicitará la clave de activación del producto. Esta clave será enviada por email al comprar la licencia, o al activar la versión de prueba.

Inicio de Sesión

SimmAgents está compuesto por dos secciones, una para el login de los agentes y otra para el login de los administradores. Si es la primera vez que inicia SimmAgents solo podrá loguearse en la sección de administradores, dado que no se cuenta con agentes creado aún.

Acceso Administradores

Por defecto SimmAgents provee un usuario Administrador que cuenta con acceso a todas las funcionalidades del sistema y cuyas credenciales son: Usuario: admin / Password: admin

Por mayor seguridad, se recomienda modificar el password provisto por defecto.

Panel Principal Administradores

Después de iniciar sesión correctamente, se le presentará la ventana del panel principal.

Los usuarios podrán visualizar a la izquierda de la pantalla el menú de opciones de la plataforma, y una vista general del estado actual de cada agente. Los estado posibles son deslogueado, logueado y en pausa, cada estado está representado por un recuadro.

Los usuarios que tengan habilitado el permiso («Acceso a Logueo, Deslogueo, Pausa y Unpausa de agentes») podrán modificar el estado de los agentes haciendo click  en los botones correspondientes.

 LOGIN: al hacer click, se solicitará ingrese en que extensión se está logueando el agente y en que colas. Es posible loguear a un agente en más de una cola, ingresando el número de cola separado por punto y coma (;).

 PAUSA: al hacer click, se modificará el estado del agente pasando a estar en Pausa. Por el tiempo que el agente esté pausado no recibirá llamadas.

 UNPAUSA: al hacer click, el agente volverá a estar activo y comenzará a recibir llamadas nuevamente.

 LOGOUT: Al hacer click, el agente es deslogueado de las colas.

Menú Configuración

Desde el menú configuración, los usuarios podrán configurar los parámetros generales del sistema y acceder a la gestión de usuarios y perfiles de usuarios.

Parámetros Generales

Una vez que seleccione ‘Parámetros Generales’, se le presentará la Ventana de Parámetros, como se muestra a continuación:

Desde los parámetros generales los usuarios podrán establecer los datos de la empresa, definir un rango de numeración para la creación de agentes y colas, y definir los datos para la conexión con Asterisk Manager Interface.

La mayoría de los campos son auto explicativos, como nombre, dirección, etc.

El campo Idioma, define el idioma se visualizará el sistema  de forma global (para todos los usuarios del sistema). Actualmente está disponible en tres idiomas: Español, Inglés y Portugués.

Creación de Agentes y Colas, al establecer un rango para la numeración de los agentes y las colas respectivamente, se está acotando los números disponibles, de ésta forma se busca evitar que al momento de crear un agente o una cola se ingrese por error un número que esté siendo utilizado con una extensión o grupo de la PBX.

Mostrar Estado de otros Agentes, si esta opción está seleccionada, cuando los agentes se logueen podrán ver el estado de los demás agentes logueado en SimmAgents, de forma análoga si no se está seleccionada la opción se mostrarán los agentes logueado pero no es estado de los mismos.

Datos Asterisk, por defecto cuando se instala SimmAgents se crea un usuario AMI con los valores que se muestran en los campos, Host, User y Password. Si se desea cambiar el usaario AMI o el Password, se debe modificar primero aquí y luego seguir los pasos detallados AQUÍ para la creación o modificación del usuario de Asterisk Manager Interface.

Perfiles de Usuarios

Es una agrupación de permisos que determina qué accesos y acciones podrá realizar cada usuario dentro de SimmAgents. Cada usuario puede pertenecer a un grupo y cada grupo puede ser compartido por varios usuarios.

Por defecto SimmAgents traer creado un Perfil de Usuarios Administrador que no puede ser eliminado y que tiene acceso a todas las funcionalidades de la plataforma.

El uso es directo. Puede hacer clic en el botón + Crear Perfil de Usuario para insertar nuevos registros o hacer clic en los botones de acción de cada registro para editarlos, eliminarlos o definir los permisos. Hay un cuadro de búsqueda que le permite buscar cualquier cadena o número.

Definición de Permisos

Al hacer click en el botón  es posible establecer que accesos y acciones estarán habilitadas para el perfil seleccionado.

Usuarios

Los usuarios son todas las personas que necesitan acceder al sistema y de quienes se desea tener un registro personalizado de los accesos y acciones que podrá realizar.

El uso es directo. Puede hacer clic en el botón + Crear Usuario para insertar nuevos registros o hacer clic en los botones de acción de cada registro para editarlos o eliminarlos. Hay un cuadro de búsqueda que le permite buscar cualquier cadena o número.

El usuario administrador al igual que el Perfil Administrador, está creado por defecto y no puede ser eliminado.

El campo caducidad determina el período durante un usuario estará activo. Cada vez que el usuario ingrese, el sistema chequeará si el usuario está dentro del período determinado. En caso de dejar el campo en blanco, el usuario no caducará.

Menú Agentes, Colas y Pausas

Esta sección permite crear, modificar y eliminar agentes, colas y pausas. Para una mejor experiencia al configurar la plataforma, se recomienda primero crear las colas y luego los agentes.

Colas

Las colas deben ser creadas respetando la misma numeración con que fueron creadas en la PBX. Las colas creadas en SimmAgents no se crean automáticamente en la PBX, ni viceversa.

El uso es directo. Puede hacer clic en el botón + Crear Colas para insertar nuevos registros o hacer clic en los botones de acción de cada registro para editarlos, eliminarlos o asignar agentes a la cola de forma masiva. Hay un cuadro de búsqueda que le permite buscar cualquier cadena o número.

Asignar Agentes a una Cola

SimmAgents provee 2 formas de vincular o desvincular un agente a una cola:

1- Desde la interfaz de creación de un agente, al momento de dar de alta cada agente el sistema nos permitirá indicar en que colas se podrá loguear.

2 – O desde la acción  Asignar Agentes a la Cola, en la cual se mostrarán todos los agentes que hay creados en el sistema y mediante la selección o desmarcación, estaremos indicando que agentes se podrán loguear a la cola seleccionada previamente.

Agentes

El uso es directo. Puede hacer clic en el botón + Crear Agente para insertar nuevos registros o hacer clic en los botones de acción de cada registro para editarlos o eliminarlos. Hay un cuadro de búsqueda que le permite buscar cualquier cadena o número.

Para la creación de cada agente, es necesario definir un número (único para cada agente, y no puede coincidir con ninguna extensión, grupo o cola de la PBX), un nombre, una clave y en qué colas se va a registrar cuando se loguee en la plataforma.

Pausas

El uso es directo. Puede hacer clic en el botón + Crear Pausa para insertar nuevos registros o hacer clic en los botones de acción de cada registro para editarlos o eliminarlos. Hay un cuadro de búsqueda que le permite buscar cualquier cadena o número.

Las pausas permite a los usuarios establece la razón por la cual dejo de estar activo el usuario para la cola en un determinado período. Cuando un agente entra en pausa, las llamados entrantes dejan de ser asignadas por asterisk a dicho agente.

Reportes

El reporte Registros por Agente muestra la actividad de cada agente, en un período determinado.

Si se analiza una de las líneas de Login, se puede observar: fecha y hora del logueo, a qué colas se logueó, y desde qué extensión lo hizo.

Herramientas

Dentro del menú herramientas podemos acceder a la Importación de Agentes desde un archivo externo en formato .Txt o .Csv.  La herramienta permite crear un agente o modificarlo en caso de que exista un registro con el mismo número.

Al hacer clic en el botón Seleccionar Archivo, le mostrará una ventana para buscar el archivo txt o csv a importar. La primera línea del archivo ya debe contener el primer registro que desea insertar. Los campos que debe contener el archivo son: Número de Agente;Nombre del Agente;Clave de Logueo;

Este es un archivo de muestra con el formato que debe tener el archivo para una correcta importación:

agentes.csv
4500;Diego Pereira;1234
4501;Carolina Alustiza;1234

Acceso Agentes

El logueo de los Agentes se realiza mediante la selección del agente y la extensión donde está ubicado al momento de loguearse. La contraseña es propia de cada Agente y se define durante la creación de cada agente.

Las extensiones disponibles son tomadas de la PBX, y corresponden a los teléfonos que están registrados y activos en la central. SimmAgents realizará una llamada a la extensión y reproducirá un mensaje de audio indicando “Agente logueado”, confirmando así el correcto logueo del agente.

Panel Principal Agentes

Después de iniciar sesión correctamente, se le presentará la ventana del panel principal.

El dashboard es el panel del agente con la información principal del mismo: se visualiza el nombre y número del agente, en qué extensión está logueado, el estado (que puede ser logueado o en pausa), a que colas se logueo, la hora del log in y la posibilidad de pausar o desloguearse.

En la parte derecha de la pantalla, se puede ver cuáles agentes están logueados, en que extensión y el estado actual de cada uno. Si no se desea mostrar el esto de los agentes recuerde que accediendo a la sección de Administradores Menú Configuración / Preferencias, es posible modificar la propiedad Mostrar Estado de otros Agentes.

También se cuenta con la posibilidad de llamar al agente haciendo click en el botón  ubicado a la derecha de cada agente.

Historial de Actividad

Además del Dashboard, los agentes pueden acceder al historial de actividad, donde se señala en qué momentos se loguearon, las pausas realizadas y las extensiones en donde se registraron.

Mi Perfil y Cerrar Sesión

En la esquina superior derecha de la ventana se destaca el nombre del agente y se puede acceder al Perfil desde donde se pueden modificar la contraseña de acceso a la plataforma o cerrar la sesión, que además de cerrar la plataforma desloguea al agente de la cola.

Si se desea cerrar la aplicación pero no desloguear el agente solo debe cerrar la pestaña del navegador correspondiente a SimmAgents.

Ante cualquier consulta sobre los pasos detallados en este documento, contáctenos a la casilla support@simmline.com que con gusto lo ayudaremos.

Equipo SimmLine.