VICIfast
ENES

Consultar su base de datos y copiar grabaciones por SSH

Conecte una herramienta de reportes a la base de datos de su marcador mediante un túnel SSH seguro, con un usuario que solo puede leer, y copie sus grabaciones de llamadas a su propio archivo.

Avanzado · 4 min de lectura

Consultar su base de datos y copiar grabaciones por SSH

Su marcador guarda sus datos en una base de datos (MariaDB) y sus grabaciones de llamadas como archivos MP3, ambos en su propio servidor. Los reportes y la Búsqueda de grabaciones del panel cubren la mayoría de las necesidades. Cuando su responsable de TI quiere conectar una herramienta de reportes como Metabase, Power BI o Excel a los datos sin procesar, o mantener su propio archivo de grabaciones, lo hace por SSH. Esta guía muestra cómo hacerlo de forma segura.

Qué necesita

  • Una clave SSH en su servidor para la computadora desde la que trabaja (en un servidor que alojamos nosotros, pida primero a soporte que habilite las claves SSH), con su dirección permitida en el firewall con el perfil Admin. Consulte Acceso root a su servidor: consola y claves SSH.
  • Para todo lo que se ejecuta por sí solo, como una herramienta de reportes o una copia nocturna: una clave de automatización, que solo el propietario de la cuenta puede agregar, en un servidor BYOI o una vez que soporte haya habilitado las claves SSH sin fecha de vencimiento (Paso 6 de esa guía).
  • Alguien que se sienta cómodo con la línea de comandos. Todo lo que sigue usa el acceso root de su servidor.

Por qué la base de datos no está abierta a internet

El puerto 3306, el puerto de la base de datos, está cerrado en todos los perfiles del firewall, por lo que ninguna herramienta externa puede acceder directamente a la base de datos. Esto es intencional. En su lugar, su herramienta se conecta a través de una conexión SSH (un túnel): la herramienta se comunica con su propia computadora y SSH transporta el tráfico hasta la base de datos de su servidor.

Paso 1: Encontrar el nombre de su base de datos

  1. Conéctese por SSH con el comando de conexión que aparece en la página de claves SSH de su servidor.
  2. Escriba mysql y presione Enter. Como root en su servidor, se abre sin contraseña.
  3. Escriba SHOW DATABASES; y presione Enter. El nombre de su base de datos empieza con vici_ y es distinto en cada servidor. Anótelo.

Paso 2: Crear un usuario que solo pueda leer

Nunca le dé a una herramienta de reportes un usuario que pueda modificar datos. Todavía dentro de mysql, cree uno que solo pueda leer, con su propia contraseña larga y el nombre de su base de datos:

CREATE USER 'reporting'@'127.0.0.1' IDENTIFIED BY 'a-long-random-password';

GRANT SELECT ON vici_yourname.* TO 'reporting'@'127.0.0.1';

Luego escriba exit. El usuario solo funciona a través del túnel, porque 127.0.0.1 significa "desde el propio servidor".

Paso 3: Abrir un túnel y conectar su herramienta

  1. En la computadora donde se ejecuta la herramienta, ejecute ssh -N -L 3307:127.0.0.1:3306 root@ seguido de la dirección de su servidor. No muestra nada y sigue ejecutándose. Eso es normal.
  2. En su herramienta, agregue una conexión MySQL o MariaDB con host 127.0.0.1, puerto 3307, su base de datos vici_, usuario reporting y la contraseña del Paso 2.
  3. Muchas herramientas de reportes tienen su propia opción de túnel SSH. Si la suya la tiene, indíquele la dirección de su servidor, el usuario root y su clave privada, además de los mismos datos de la base de datos.

Tablas que conviene conocer, todas estándar de VICIdial:

  • vicidial_log: todas las llamadas salientes.
  • vicidial_closer_log: todas las llamadas que pasan por sus colas entrantes (in-groups).
  • vicidial_agent_log: el tiempo y los resultados de los agentes, llamada por llamada.
  • vicidial_list: sus leads.
  • recording_log: sus grabaciones, con el nombre de archivo de cada una.
  • vicidial_dnc: la lista de no llamar.
Una consulta grande puede hacer esperar a su marcador. La mayoría de las tablas de VICIdial no se pueden escribir mientras una consulta larga las está leyendo, por lo que los agentes y el marcador se detienen. Ejecute los reportes grandes fuera del horario de llamadas y siempre limítelos a un rango de fechas.

Paso 4: Copiar las grabaciones fuera de su servidor

Las grabaciones permanecen en el disco de su servidor hasta que alguien las elimina (consulte Grabar, buscar y reproducir llamadas). Para mantener su propio archivo:

  1. Los archivos MP3 están en /var/spool/asterisk/monitorDONE/MP3/. Un nombre como SALES_261005192811_4155550145-all.mp3 corresponde a la campaña, la fecha y la hora, y luego el número de teléfono. Sigue el Patrón del nombre de grabación de la campaña, en su pestaña Troncal / Enrutamiento. Las llamadas que pasan por sus colas entrantes (in-groups) siguen el patrón propio de la cola, por lo que sus nombres se ven distintos.
  2. Para copiarlas todas, ejecute scp -r en su computadora, con root@, la dirección de su servidor, luego :/var/spool/asterisk/monitorDONE/MP3/ y una carpeta local como ./recordings/.
  3. Para una copia nocturna, rsync descarga solo los archivos que aún no tiene. Si su servidor indica que falta rsync, instálelo allí con apt install rsync.
El Patrón del nombre de grabación de la campaña determina el nombre de cada archivo
El Patrón del nombre de grabación de la campaña determina el nombre de cada archivo
Copie, no mueva. El reproductor y la Búsqueda de grabaciones del panel reproducen los archivos de esa carpeta, y un archivo que ya no está aparece como eliminado del disco por rotación.

Los originales sin procesar de la carpeta ORIG, junto a MP3, se eliminan después de aproximadamente un día. Solo se conservan los MP3.

Si algo sale mal

Preguntas frecuentes

› Mi herramienta no puede acceder al puerto 3306 de mi servidor.
La base de datos no está abierta a internet. Abra el túnel del Paso 3 y conéctese a 127.0.0.1, puerto 3307, en su lugar.
› Access denied for user 'reporting'.
Cree el usuario para 127.0.0.1 exactamente como en el Paso 2 y conéctese a través del túnel. Un usuario creado para localhost no coincidirá con una conexión por túnel.
› El túnel se detiene después de media hora.
Las claves normales vencen después de 30 minutos, por lo que, una vez que la conexión se cae, no puede volver a conectarse. Una herramienta que se conecta por sí sola necesita una clave de automatización, que el propietario de la cuenta agrega en un servidor BYOI o una vez que soporte haya habilitado las claves SSH sin fecha de vencimiento.
› ssh se queda esperando y luego se agota el tiempo.
La dirección de su computadora no está permitida con el perfil Admin. Haga clic en el chip Firewall de la página del servidor y luego en Permitir mi IP.
› Mi marcador se volvió lento mientras se ejecutaba un reporte.
Detenga el reporte y ejecútelo fuera del horario de llamadas, limitado a un rango de fechas.

Artículos relacionados