Cómo subir un listado de registros a una campaña Preview en wolkvox Manager

Descubre cómo cargar tu lista de clientes en campañas predictivas o progresivas para optimizar tus estrategias de marketing en Colombia.

Written by Jhon Bairon Figueroa

Updated at September 16th, 2026

Table of Contents

Introducción ¿Cómo subir un listado de registros a una campaña Preview? Acceder a la administración de la campaña Descargar la plantilla para preparar el archivo CSV Preparar el archivo con los registros Campos que debes tener especialmente en cuenta Límites de caracteres de los campos Subir el archivo CSV a la campaña Revisar el resultado de la carga Actualizar y verificar los registros cargados Consideraciones importantes

Introducción

Las campañas de tipo Preview permiten que cada agente gestione manualmente los registros que tiene asignados y decida cuándo iniciar la llamada. Para utilizar este tipo de campaña, es necesario cargar previamente la información de los clientes mediante un archivo CSV, respetando la estructura de campos admitida por wolkvox Manager.

A diferencia de otros tipos de marcación, en una campaña Preview es especialmente importante identificar el agente responsable de cada registro, ya que será quien gestione e inicie manualmente la llamada correspondiente.

Para facilitar la preparación del archivo, puedes exportar desde la propia campaña una plantilla con las columnas requeridas y utilizarla como base para cargar tus registros. El proceso de exportar una plantilla, preparar el CSV y posteriormente cargarlo sigue una lógica similar a la utilizada en campañas predictivas o progresivas.

¿Cómo subir un listado de registros a una campaña Preview?

Acceder a la administración de la campaña

En wolkvox Manager:

Ingresa a la sección “Campañas” desde el menú lateral izquierdo.
Ve a la pestaña “Campañas”.
Ubica la campaña de tipo Preview en la que deseas cargar los registros. Haz clic derecho sobre la campaña.
Selecciona la opción “Admin Preview”.

Se abrirá la ventana desde la cual puedes consultar y administrar los registros asociados a la campaña.

Descargar la plantilla para preparar el archivo CSV

Antes de cargar los registros, puedes exportar la estructura de la campaña para utilizarla como plantilla:

Dentro de “Admin Preview”, haz clic en el botón “Exportar lista”.
En la ventana “Exportar”, selecciona la opción “Todo”.
Haz clic en “Exportar”. Dependiendo de la configuración de tu navegador, el archivo se descargará automáticamente o podrás seleccionar dónde guardarlo en tu equipo.

Es recomendable realizar esta exportación cuando la campaña todavía no contiene registros, de manera que obtengas únicamente la estructura de columnas que necesitas completar. Este mismo criterio se utiliza en el proceso de preparación de archivos para otros tipos de campañas.

Preparar el archivo con los registros

Abre el archivo descargado y agrega la información de los registros desde la primera columna, NOMBRE, hasta la columna AGENTE.

La plantilla contiene los siguientes grupos de información:

Datos del cliente: NOMBRE, APELLIDO, TIPOID, ID, EDAD y SEXO.
Ubicación: PAIS, DEPARTAMENTO, CIUDAD, ZONA y DIRECCION.
Campos adicionales: OPT1 hasta OPT12, que pueden utilizarse para almacenar información adicional relacionada con el cliente o la gestión.
Teléfonos: TEL1 hasta TEL10 y OTROSTEL.
Asignación: AGENTE, donde debes ingresar el número de identificación del agente dentro de wolkvox.

Las columnas que aparezcan a la derecha de AGENTE deben eliminarse antes de cargar el archivo.

Campos que debes tener especialmente en cuenta

El campo TEL1 debe contener el número principal del cliente. Si únicamente cuentas con un número telefónico, debes ingresarlo obligatoriamente en TEL1.

El campo AGENTE debe contener el ID del agente de wolkvox al que se asignará el registro. Este dato es fundamental en campañas Preview, debido a que la marcación es manual y es el agente quien inicia la llamada.

Los números telefónicos deben contener una cantidad válida de dígitos. Si un registro contiene un número con menos de 7 dígitos, puede ser rechazado durante la carga.

Cuando termines de completar la información, guarda el archivo en formato CSV separado por comas.

Límites de caracteres de los campos

Al preparar los registros, debes respetar el número máximo de caracteres admitido por cada campo:

Columna del archivo	Campo	Tipo de dato	Máximo de caracteres
`NOMBRE`	`nombre_cliente`	`char(100)`	100
`APELLIDO`	`apellido_cliente`	`char(100)`	100
`TIPOID`	`tipo_doc`	`char(20)`	20
`ID`	`id_cliente`	`char(100)`	100
`EDAD`	`edad`	`char(10)`	10
`SEXO`	`sexo`	`char(10)`	10
`PAIS`	`pais`	`char(100)`	100
`DEPARTAMENTO`	`departamento`	`char(100)`	100
`CIUDAD`	`ciudad`	`char(100)`	100
`ZONA`	`zona`	`char(100)`	100
`DIRECCION`	`direccion`	`char(100)`	100
`OPT1`	`opt1`	`char(200)`	200
`OPT2`	`opt2`	`char(200)`	200
`OPT3`	`opt3`	`char(200)`	200
`OPT4`	`opt4`	`char(200)`	200
`OPT5`	`opt5`	`char(200)`	200
`OPT6`	`opt6`	`char(200)`	200
`OPT7`	`opt7`	`char(200)`	200
`OPT8`	`opt8`	`char(200)`	200
`OPT9`	`opt9`	`char(200)`	200
`OPT10`	`opt10`	`char(200)`	200
`OPT11`	`opt11`	`char(200)`	200
`OPT12`	`opt12`	`char(200)`	200
`TEL1`	`tel1`	`char(20)`	20
`TEL2`	`tel2`	`char(20)`	20
`TEL3`	`tel3`	`char(20)`	20
`TEL4`	`tel4`	`char(20)`	20
`TEL5`	`tel5`	`char(20)`	20
`TEL6`	`tel6`	`char(20)`	20
`TEL7`	`tel7`	`char(20)`	20
`TEL8`	`tel8`	`char(20)`	20
`TEL9`	`tel9`	`char(20)`	20
`TEL10`	`tel10`	`char(20)`	20
`OTROSTEL`	`tel_extra`	`char(100)`	100
`AGENTE`	`id_agent`	`char(10)`	10

Subir el archivo CSV a la campaña

Una vez preparado el archivo:

Regresa a la ventana “Admin Preview”. Haz clic en el botón “Subir lista”.
En la ventana que aparece, haz clic en “Elegir archivo”. Se abrirá el explorador de archivos de tu equipo.
Ubica y selecciona el archivo CSV preparado previamente. Puedes hacer doble clic sobre el archivo o seleccionarlo y hacer clic en Abrir.
- Verifica que el nombre del archivo aparezca junto al selector.
Haz clic en “Upload csv file to the campaign”.

El sistema procesará el contenido del archivo y validará cada uno de los registros.

Revisar el resultado de la carga

Cuando finalice el procesamiento, wolkvox Manager mostrará un resumen con el resultado de la importación.

Podrás consultar, entre otros datos:

Loaded records: cantidad de registros cargados correctamente.
Rejected records: cantidad de registros rechazados.
Total records: cantidad total de registros procesados.

Si existen registros rechazados, el sistema mostrará información sobre el motivo del rechazo. Por ejemplo, un registro puede ser rechazado si el teléfono del cliente contiene menos de la cantidad mínima de dígitos requerida.

Revisa estos mensajes antes de cerrar la ventana, ya que te permiten identificar qué información debes corregir en el archivo antes de intentar cargar nuevamente los registros.

Actualizar y verificar los registros cargados

Después de finalizar la carga:

Cierra la ventana con el resultado de la importación. Haz clic en el botón “Actualizar” dentro de “Admin Preview”.
La tabla mostrará los registros que fueron cargados correctamente. Revisa que la información se encuentre distribuida en las columnas correspondientes.

En la columna “Resultado”, los registros que todavía no han sido gestionados aparecen con el estado “CLEAN”. Esto indica que el registro se encuentra disponible y todavía no se ha realizado una llamada sobre él.

También puedes consultar en la parte superior de la tabla la cantidad total de registros y su estado dentro de la campaña.

Consideraciones importantes

Antes de realizar la carga, verifica que el archivo esté guardado en formato CSV separado por comas, que TEL1 contenga el teléfono principal del cliente y que AGENTE tenga el ID correcto del agente asignado. Respeta además los límites de caracteres de cada campo y elimina todas las columnas ubicadas después de AGENTE.

Una correcta preparación del archivo evita rechazos durante la importación y permite que cada registro quede disponible para que el agente asignado pueda gestionarlo manualmente desde la campaña Preview.