Existen tres maneras distintas de añadir contactos en Zenvia Attraction: manualmente o por importación de archivos. Este artículo te enseña a incluir contactos en las listas de Zenvia Attraction mediante el envío de un archivo. De esta manera, envías toda tu base de contactos de forma sencilla y rápida.

A continuación, vamos a detallar cómo añadir un nuevo archivo de importación.

Nueva importación

Para utilizar este recurso, tienes los caminos disponibles de acceso:

• En el menú lateral, en Contactos > Gestionar contactos, haz clic en Agrega contactos > Importa desde un archivo;

• En el menú lateral, en Contactos > Listas de contactos, haz clic en Agrega contactos > Importa desde un archivo.

Seguindo cualquiera de los caminos, inicias el proceso de importación de tu base de contactos. El primer paso es subir tu archivo de contactos.

Subida del archivo

Para cargar tu archivo, simplemente haz clic en Cargar archivo o arrástralo al campo destacado. Si deseas eliminar este archivo, haz clic en la X ubicada a la derecha.

⚠️ Atención: Solo puedes importar un archivo cada vez debido a la forma de procesamiento y la disposición de las columnas de los archivos.

💡 Tip: Asegúrate de crear el archivo correctamente. Las especificaciones del archivo son las siguientes:

• Debe estar en formato .csv;

• Los números de teléfono (para envíos de SMS, WhatsApp y RCS) o las direcciones de correo electrónico (para envíos de correo electrónico) deben estar obligatoriamente en la primera columna, es decir, siempre en la columna A de la hoja de cálculo;

• La primera fila del archivo debe ser el encabezado. Inserta el nombre de las variables utilizadas en tu mensaje y utiliza coma (,) o punto y coma (;) para separar cada campo;

• Un número de contacto por línea en el archivo;

• Debe contener el número de contacto en el formato DDI+DDD (por ejemplo: 5551999999999);

• Debe contener hasta 120 MB.

Esta importación puede ser incluida en una o más listas. Para hacerlo, solo necesitas seleccionarlas en la caja de selección. Las listas seleccionadas aparecerán como una "tag".

⚠️ Atención: para incluir contactos, debes crear una lista o utilizar una que ya exista. En el ejemplo, seleccionamos una lista creada anteriormente.

Después de esta etapa, haga clic en el botón Avanza para continuar a la próxima etapa de la importación.

A continuación, detallamos la próxima fase de la importación: el mapeo de los campos del archivo.

Mapear campos

En Mapeo de campos aparece una previsualización de los campos de la lista importada. En Campo del gestor de contactos, determinas lo que cada columna de tu archivo importado representa, y aquí tienes la libertad de elegir dónde esas informaciones serán colocadas.

⚠️ Atención: Es obligatorio registrar el teléfono celular o el correo electrónico y vincular el contacto a una o más listas (el sistema siempre impedirá la adición si faltan estos datos). El teléfono debe registrarse en el formato DDI+DDD+número. Por ejemplo, para números de Argentina, siempre debe incluirse el número 9 entre el código del país y el código de área, por lo tanto, sería así: 549+DDD+XXXXXXXX, sin espacios ni guiones. Consulta los códigos DDI de los países de América Latina:

En la columna Importar, puedes seleccionar los campos que serán habilitados, o sea, cuáles serán utilizados por la lista. Si una columna llega a ser deshabilitada, el sistema no subirá los datos y la ignorará durante la importación.

💡 Tip: Nota que el comportamiento estándar de la importación es sobrescribir. Por ejemplo: En el caso de que sea encontrado un número de teléfono igual en la lista seleccionada, el sistema sobrescribirá los otros datos utilizando el archivo como base.

Ejemplo de cómo se debe configurar el archivo:

Para el mensaje "¡Hola {{nombre}}! Su consulta está agendada para el {{fecha}} a las {{hora}}. Para cancelar la cita, llame al 0800 400 1100", es necesario que el archivo contenga las variables del mensaje organizadas en columnas distintas, por lo tanto, debe incluir las columnas Nombre, Fecha y Hora, ya que el texto del mensaje tiene las variables {{nombre}}, {{fecha}} y {{hora}}, además de la columna obligatoria Teléfono o correo electrónico.

En la columna Campo del gestor de contacto, seleccione los campos predeterminados o cree un campo adicional. Para ello, haga clic en Seleccionar un campo y luego en Crear campo adicional.

Campos extras

La creación de campos adicionales te permite personalizar la información que se utilizará en la creación de un contacto. Puede crear campos adicionales a través de la API o al importar la lista de contactos en una lista.

Al hacer clic, necesitarás crear un nombre para el campo. La creación de Campos extras te permite personalizar las informaciones que serán utilizadas en la creación de un contacto. En el ejemplo abajo, creamos el campo extra “fecha de nacimiento”. Si está todo listo, podemos Confirmar.

Después de crear el nombre del campo, es necesario elegir el Tipo del campo, o sea, el que determina el formato de las informaciones que serán importadas, que puede ser Texto, Número o Fecha. En el ejemplo, el tipo del campo seleccionado es Fecha.

⚠️ Atención: La creación de campos extras está disponible tan solo para contactos añadidos vía importación de archivos. El límite de creación de campos extras es 100 por organización y cada uno puede ser usado en otras importaciones.

Recuerda que, por el momento, sólo es posible crear campos extra al añadir contactos vía CSV a una lista. El cliente puede traer datos desde cualquier CRM que permita conexiones API para la exportación de datos. 

Después de seleccionar el Tipo del campo, solo necesitas hacer clic en el botón Confirmar para iniciar el procesamiento del archivo.

Confirmación

Al hacer clic en Confirmación, se completa la importación, ahora solo tienes que esperar mientras tu archivo es procesado por el sistema. Haz clic en Ir a importaciones para ver el progreso de la importación.

Historial de importaciones

Al hacer clic en el botón Ir a importaciones, se abrirá la pantalla de Historial de importaciones. En esta etapa, se pueden ver todos los archivos que se han importado. Además, si lo deseas, también puedes realizar una nueva importación.

El historial presentado se divide en las siguientes columnas:

• Nombre de los archivos importados;

• Estado actual de la importación del archivo, que puede ser:

  • Procesado: indica que un archivo ha sido procesado correctamente (etapa completada);

  • Procesando: indica que el archivo aún no ha terminado la importación (generalmente ocurre con archivos grandes);

  • Error: si el archivo fue procesado pero ocurrió alguna irregularidad.

• Fecha en la que ocurrió la importación;

• Cuántos contactos contiene el archivo.

¡Listo! Ahora ya sabes cómo importar contactos desde un archivo.