Administración de listas de Hubs

Los Hubs Salientes necesitan de listas con contactos para poder procesar las interacciones, estas se deben subir a través del dashboard del Hub. ¡Te mostramos cómo hacerlo!

¿Qué encontrarás en esta guía?

A continuación te mostramos qué aprenderás a hacer en esta guía.

Subir listas para Hubs de TelefoníaSubir listas para Hubs de CorreoSubir listas para Hubs de SMSSubir listas para Hubs de WhatsApp

¿Cómo subir una lista?

A continuación, te enseñamos a subir una lista a un Hub Saliente.

1. En el menú de Estadísticas, debes acceder a Hubs Salientes. Aquí deberás seleccionar del listado el Hub al que deseas cargarle una lista para que la procese.

2. Una vez que ingreses al dashboard del Hub, deberás hacer clic en el botón Subir.

Una vez que hagas clic en el botón, se desplegará un pop-up con el sistema de subida de listas. A continuación te mostramos cómo armar la lista.

¿Qué campos debo incluir en la lista?

Los campos disponibles varían según el canal del Hub. A continuación encontrarás los campos obligatorios y opcionales para cada uno, junto con recomendaciones para armar el archivo correctamente.

Formato y estructura del archivo

El archivo puede estar en formato XLSX, ODS, CSV o TXT, y debe tener un peso no superior a 50 MB.

Algunas recomendaciones para armar la lista:

• Una fila por contacto. Cada fila representa un contacto a procesar.
• Una columna por campo. Cada columna debe contener un único tipo de dato (por ejemplo, el número de teléfono en una columna y el nombre en otra).
• Encabezados opcionales pero recomendados. Puedes incluir una fila de encabezados con el nombre de cada columna. Esto facilita el paso de Match, donde asocias cada columna con el campo correspondiente del sistema.
• Solo los campos obligatorios son necesarios. Los campos opcionales pueden omitirse si no los necesitas.
• Los campos de texto con comas deben ir entre comillas si usas formato CSV. Por ejemplo: "González, Juan".

Ejemplo de estructura

telefono	zona_horaria	prioridad
59891234567	America/Montevideo	1
5491187654321	America/Buenos_Aires	2

Listas para Hubs de Telefonía

Para estas listas, el único campo obligatorio es el número al cual se va a llamar.

• Números (*): debes incluir al menos un número al cual llamar. Puedes incluir múltiples números para el mismo contacto; el sistema los intentará en orden, pasando al siguiente cuando se agotan los intentos del anterior.
• Parámetros: objeto de parámetros personalizados en formato clave-valor (ej: {"nombre": "Juan", "producto": "X"}). Estos valores se pueden usar en formularios.
• Zona horaria: zona horaria personalizada para el contacto, en formato estándar Continente/Ciudad (ej: America/Montevideo, America/Buenos_Aires, Europe/Madrid). Si no se incluye, se utiliza la zona horaria configurada en la campaña.
• Prioridad: número que define el orden de procesamiento del contacto dentro de la lista. Los contactos con menor número se procesan primero. Si no se incluye, el valor por defecto es 0. ¿No sabes qué es la prioridad del contacto? Visita esta guía
• ID de contacto: identificador externo del contacto (por ej. el ID en tu CRM). Es opcional y se utiliza para vincular la interacción con sistemas externos o en formularios.
• Teléfono del agente: exclusivo para Hubs de tipo Preview. Debes indicar el número de teléfono del usuario al que deseas asignar la interacción. El usuario debe ser miembro de la campaña; si no lo es, la lista dará error al subirse. Si se deja vacío, la interacción se asigna al primer usuario disponible.

Listas para Hubs de Correo

Para estas listas, el único campo obligatorio es la dirección de correo del cliente.

• Correo (*): dirección de correo electrónico del destinatario.
• Asunto: asunto del correo. Si se deja vacío, se utiliza el asunto configurado en el Hub. Soporta variables con la sintaxis ${variable}, que se reemplazan con los valores del campo Parámetros.
• Parámetros: objeto de parámetros personalizados en formato clave-valor (ej: {"nombre": "Juan", "producto": "X"}). Estos valores se usan para sustituir variables tanto en el asunto como en el contenido del correo con la sintaxis ${nombre}.
• Contenido: cuerpo del correo en formato HTML o texto plano. Si se deja vacío, se utiliza el contenido de la plantilla configurada en el Hub. Si se especifica contenido en la lista, este tiene prioridad sobre la plantilla. También soporta variables con la sintaxis ${variable}.
• Plantilla: nombre de una plantilla existente en el sistema. Si se especifica, debe existir en el sistema (ya sea una plantilla general o de la campaña); de lo contrario, la lista dará error al subirse. Si se deja vacío, se usa la plantilla configurada en el Hub. Si además hay contenido en la lista, el contenido tiene prioridad sobre la plantilla.
• Zona horaria: zona horaria personalizada para el contacto, en formato estándar Continente/Ciudad (ej: America/Montevideo, America/Buenos_Aires, Europe/Madrid). Si no se incluye, se utiliza la zona horaria configurada en la campaña.
• Prioridad: número que define el orden de procesamiento del contacto dentro de la lista. Los contactos con menor número se procesan primero. Si no se incluye, el valor por defecto es 0. ¿No sabes qué es la prioridad del contacto? Visita esta guía
• ID de contacto: identificador externo del contacto (por ej. el ID en tu CRM). Es opcional y se utiliza para vincular la interacción con sistemas externos o en formularios.
• Adjuntos: archivos a enviar junto con el correo. Debes subir los archivos previamente desde el dashboard del Hub y luego incluir la ruta copiada en esta columna. Conoce más sobre el envío de adjuntos con esta guía

¿Cómo subir un adjunto?

En caso de que desees enviar adjuntos con los correos, puedes subirlos desde el dashboard del Hub. ¡Te mostramos cómo hacerlo!

1. Para subir el adjunto, primero debes acceder al dashboard del Hub.

2. Una vez aquí, debes hacer clic en el botón Subir adjuntos. Aquí deberás seleccionar el archivo a enviar desde tu computadora o también puedes arrastrarlo.

3. El archivo se subirá automáticamente y quedará disponible para que se pueda enviar.

4. Para poder enviarlo a los contactos de la lista, debes hacer clic en los 3 puntitos y luego en Copiar.

Luego, en la lista, debes agregar una columna con la ruta que acabas de copiar en los contactos a los que deseas enviar el adjunto.

Listas para Hubs de SMS

• Números (*): número de teléfono del destinatario al que se enviará el mensaje.
• Parámetros: objeto de parámetros personalizados en formato clave-valor (ej: {"nombre": "Juan", "producto": "X"}). Estos valores se usan para sustituir variables en el contenido del mensaje con la sintaxis ${nombre}.
• Contenido: mensaje que se enviará al contacto. Si se especifica, tiene prioridad sobre cualquier plantilla (tanto la de la lista como la del Hub). Soporta variables con la sintaxis ${variable} que se reemplazan con los valores del campo Parámetros.
• Plantilla: nombre de una plantilla existente en el sistema. Se utiliza cuando no hay contenido en la lista. Si se especifica, debe existir en el sistema (ya sea una plantilla general o de la campaña); de lo contrario, la lista dará error al subirse. Si tampoco se especifica plantilla, se usa la primera plantilla configurada en el Hub.
• Zona horaria: zona horaria personalizada para el contacto, en formato estándar Continente/Ciudad (ej: America/Montevideo, America/Buenos_Aires, Europe/Madrid). Si no se incluye, se utiliza la zona horaria configurada en la campaña.
• Prioridad: número que define el orden de procesamiento del contacto dentro de la lista. Los contactos con menor número se procesan primero. Si no se incluye, el valor por defecto es 0. ¿No sabes qué es la prioridad del contacto? Visita esta guía
• ID de contacto: identificador externo del contacto (por ej. el ID en tu CRM). Es opcional y se utiliza para vincular la interacción con sistemas externos o en formularios.

Listas para Hubs de WhatsApp

Los Hubs de WhatsApp utilizan plantillas HSM, que son mensajes con formato aprobado por Meta. La plantilla se selecciona durante el asistente de subida (no se indica en el archivo), y sus variables definen las columnas adicionales que debes incluir en la lista.

• Número (*): número de teléfono del contacto en formato internacional, sin el símbolo +, espacios ni guiones. Por ejemplo: 5491176543210.
• Variables de la plantilla: una columna por cada variable de la plantilla HSM. Si la plantilla tiene dos variables (nombre y número de pedido), la lista debe tener dos columnas, una para cada valor. Los nombres de las columnas son libres; las asocias en el paso de Match.
• Zona horaria: zona horaria personalizada para el contacto, en formato estándar Continente/Ciudad (ej: America/Montevideo, America/Buenos_Aires, Europe/Madrid). Si no se incluye, se utiliza la zona horaria configurada en la campaña.
• Prioridad: número que define el orden de procesamiento del contacto dentro de la lista. Los contactos con menor número se procesan primero. Si no se incluye, el valor por defecto es 0. ¿No sabes qué es la prioridad del contacto? Visita esta guía
• ID de contacto: identificador externo del contacto (por ej. el ID en tu CRM). Es opcional y se utiliza para vincular la interacción con sistemas externos o en formularios.

Estructura del archivo

Cada variable de la plantilla HSM ocupa su propia columna. Por ejemplo, si la plantilla dice "Hola 1, tu turno es el 2", la lista debe tener una columna para la variable 1 y otra para 2. Los nombres de las columnas son libres; las asocias a cada variable en el paso de Match.

Una sola plantilla por lista

No es posible definir una plantilla diferente para cada contacto. Cada lista tiene una única plantilla HSM asociada, que se elige en el paso 2 del asistente de subida.

¿No sabes cómo armar la lista?

Descarga el archivo de ejemplo para ver la estructura esperada con datos de muestra, incluyendo las columnas requeridas y filas de ejemplo que puedes usar como referencia al armar tu propia lista.

Cada columna tiene un comentario incorporado con instrucciones sobre qué valor se espera y las restricciones que aplican. Abre el archivo en Excel o Google Sheets y pasa el mouse por encima de cada encabezado para verlos.

Subida de la lista

Ahora que ya tienes tu lista creada, es momento de subirla para que el Hub se encargue de crear las interacciones. ¡Te mostramos cómo hacerlo!

Paso 1: Subir archivo

Primero debes subir un archivo desde tu computadora o arrastrarlo. Recuerda que la lista puede ser un archivo XLSX, ODS, CSV o TXT, y debe tener un peso no superior a 50 MB.

Si incluiste encabezados en tu archivo, recuerda marcar la opción Incluir encabezados en el paso de Match para que el sistema los reconozca.

• Barrido horizontal: si habilitas esta opción, el sistema prioriza volver a contactar lo antes posible a los registros que ya tuvieron intentos previos. Así, si un contacto no atiende y vuelve a la lista, será contactado nuevamente en un corto intervalo de tiempo, buscando completar cada contacto antes de continuar con nuevos registros.

Paso 2: Seleccionar plantilla HSM Solo WhatsApp

Este paso solo aparece en Hubs de WhatsApp. Para Telefonía, Correo y SMS el asistente pasa directamente de "Subir archivo" a "Match".

Selecciona la plantilla HSM que se usará para todos los contactos de esta lista. Solo aparecen las plantillas aprobadas por Meta y habilitadas en uContact para la campaña del Hub Saliente. Si el Hub ya tiene una plantilla configurada, puedes elegir una diferente para esta lista; la seleccionada aquí tiene prioridad.

Paso 3: Match Paso 2 en otros canales

Haz coincidir las columnas de tu archivo con los campos del sistema. Si agregaste encabezados en tu lista, marca la opción Incluir encabezados.

A la izquierda aparece la primera fila del archivo; a la derecha, los campos disponibles para asociar. Si el campo no corresponde a ninguna columna, selecciona Saltar esta columna.

Si hay algún error en algún registro, aparecerá al hacer clic en Continuar con la línea exacta del problema. En la mayoría de los casos es un error en el formato del número de teléfono.

Hubs de WhatsApp

Las variables de la plantilla HSM seleccionada en el paso anterior aparecen precargadas. Debes asociar cada variable a la columna correspondiente de tu archivo antes de poder avanzar.

Cada variable tiene un identificador que indica de dónde viene dentro de la plantilla:

• body.N — variable número N del cuerpo del mensaje.
• buttons.N — variable del botón número N (por ejemplo, un código dinámico de cupón).

Ejemplo: imagina una plantilla con este contenido:

Hola 1, visita nuestro sitio para conocer nuestras ofertas. Te regalamos un código para tu primera compra. [ SHOP ] [ COPIAR CÓDIGO DE OFERTA ]

En este caso, la plantilla tiene dos variables:

• body.1 → el nombre del contacto (variable 1 del cuerpo).
• buttons.2 → el código de descuento que se copia al presionar el botón (botón número 2).

La lista deberá tener una columna para cada una, por ejemplo nombre y codigo_oferta, y en el paso de Match las asocias a body.1 y buttons.2 respectivamente.

Paso 4: Resumen Paso 3 en otros canales

Por último, podrás visualizar un resumen con las columnas seleccionadas y la información de la lista que asociaste a cada una de ellas. En caso de que alguna columna te haya faltado o que te haya quedado mal, puedes volver atrás y corregirlo.

Estados de las listas

Las listas de los Hubs pueden tener 3 estados diferentes posibles.

Indica que la lista está desactivada.

Indica que la lista se está activando.

Indica que la lista está activada.

Luego de subir la lista

Una vez que subas la lista, no comenzará a procesarse automáticamente, antes debes realizar algunos ajustes. ¿Listo? ¡Ahí vamos!

Activar la lista

Una vez que subas la lista, lo primero que debes hacer es activarla. Para hacer esto, debes hacer clic en los 3 puntitos de la lista y luego seleccionar la opción Activar.

El tiempo de activación depende de la cantidad de registros de la lista; generalmente demora algunos segundos. Una vez que la lista quede activada correctamente, quedará con el estado en color verde.

Asignarle una prioridad

Cuando la lista esté activada, podrás asignarle una prioridad para que se comience a procesar. Para hacer esto, debes hacer clic en el botón Prioridad de listas ubicado en la esquina inferior derecha.

Aquí te aparecerá el listado de listas activas, junto con su prioridad. Recuerda que la suma de todas las prioridades de las listas debe sumar 100%.

Ajuste de prioridades

Para ayudarte a distribuir las prioridades de forma rápida, cuentas con tres opciones que las ajustan automáticamente:

Normalizar

Si las prioridades actuales superan el 100%, haz clic en Normalizar para que el sistema las ajuste proporcionalmente hasta alcanzar exactamente el 100%. Los porcentajes relativos entre listas se mantienen. Por ejemplo, si las listas suman 230%, cada una se reducirá de forma proporcional hasta que el total sea 100%.

Igualar

Asigna el mismo porcentaje de prioridad a todas las listas. Por ejemplo, si tienes 4 listas, cada una recibirá un 25%.

Ponderar

Asigna a cada lista un porcentaje de prioridad proporcional a su cantidad de registros, de modo que todas las listas terminen de procesarse al mismo tiempo. Por ejemplo, si tienes tres listas con 1000, 500 y 250 registros, les asignará 57%, 29% y 14% respectivamente.

En la gráfica podrás observar de una forma más visual la distribución de las prioridades de las listas. Si deseas conocer más sobre la prioridad de las listas puedes visitar la siguiente guía.

Encender el Hub

Por último, en caso de que el Hub no esté encendido, puedes encenderlo haciendo clic en el botón Iniciar, ubicado en la esquina superior derecha.

Recuerda verificar que el Hub esté en horario, esto lo puedes verificar en el color del calendario o también en la configuración del Hub. A modo de ejemplo:

Indica que el Hub está en horario.

Indica que el Hub no está en horario.

¿Cómo reciclar una lista?

Para reciclar una lista, haz clic en el botón Reciclar lista. Se abrirá un panel con los siguientes pasos:

1. Selecciona el período: elige el rango de fechas en el que la lista fue procesada. El período debe incluir la fecha en la que la lista terminó de procesarse.

2. Selecciona la lista: una vez definido el período, en el selector de listas aparecerán todas las listas que se procesaron en ese rango de tiempo. Elige la que deseas reciclar.

3. Selecciona las tipificaciones: en la sección Resultado, selecciona la o las tipificaciones que deseas incluir en el reciclaje. Se generará una nueva lista con los registros que tengan alguna de las tipificaciones seleccionadas. Por ejemplo, si deseas reciclar todas las llamadas en las que el cliente no contestó, selecciona la tipificación No Answer.

Además, puedes activar la opción de procesamiento horizontal, que hace que el marcador priorice los contactos que ya fueron llamados anteriormente, completando cada contacto lo antes posible antes de pasar al siguiente.

Cuando tengas todo listo, haz clic en Reciclar. Dependiendo de la cantidad de registros, el procesamiento puede demorar algunos minutos. Una vez finalizado, se agregará una nueva lista a la tabla en estado deshabilitado y con prioridad 0, lista para que la habilites cuando lo desees.