[Extensión] Cómo importar contactos en masa en Blip con la extensión Gerenciador de Contatos

1. Introducción

2. Prepara el archivo CSV

3. Importa los contactos

4. Revisa los contactos importados

5. Contactos duplicados

6. Buenas prácticas

7. Soporte

Descripción breve: Registra grandes bases de contactos en Blip a partir de un archivo CSV. La extensión Gerenciador de Contatos lee la hoja de cálculo, mapea las columnas y crea o actualiza los contactos del bot de una sola vez.

Introducción

Registrar contactos uno por uno consume tiempo cuando la base es grande. Con la importación masiva del Gerenciador de Contatos, envías un archivo CSV y creas o actualizas varios contactos a la vez, con la base centralizada en Blip. Por ejemplo, al migrar 5,000 clientes de otra herramienta, exportas la hoja, verificas la vista previa e importas todos los contactos al bot en una sola operación.

La extensión reconoce automáticamente columnas como nombre, teléfono y correo electrónico y usa estos datos para crear o actualizar cada contacto en el bot donde está instalada. Contactos con el mismo teléfono o correo electrónico se agrupan en el mismo registro, por lo que reimportar una base actualiza los contactos existentes en lugar de duplicarlos. Para agregar uno o pocos contactos, usa Crear contacto en lugar de la importación.

Antes de comenzar

La importación se realiza en el bot en el que está abierta la extensión Gerenciador de Contatos, y los contactos ingresan por un canal. Verifica estos prerrequisitos antes de empezar:

• La extensión Gerenciador de Contatos debe estar instalada en el bot cuyos contactos quieres gestionar. Activa el Gerenciador de Contatos en Blip Store si aún no lo has hecho.

• El bot debe tener WhatsApp conectado o el canal de correo electrónico activo. Sin ninguno de los dos, la extensión avisa que no encontró un canal compatible y la importación no estará disponible.

• Tu usuario debe tener permiso para crear y editar los contactos del bot.

• Los contactos deben estar en un archivo en formato CSV.

• La columna de teléfono (para WhatsApp) o de correo electrónico (para email) debe estar llena. Ese dato identifica a cada contacto, y la extensión ignora los registros que no lo tengan.

Haz una primera importación de prueba con pocos contactos antes de enviar la base completa.

Prepara el archivo CSV

Guarda el archivo en CSV, con la primera fila conteniendo los nombres de las columnas. La extensión acepta coma, punto y coma, tabulación o barra vertical como separador y detecta automáticamente cuál usaste.

La extensión reconoce algunas columnas por el nombre del encabezado, aceptando variaciones en portugués, inglés y español: nombre (nome, name, nombre), apellido (sobrenome, last name, apellido), teléfono (telefone, phone, celular, whatsapp, teléfono) y correo electrónico (email, e-mail). Las columnas de ciudad, documento y cualquier campo adicional no se reconocen automáticamente: las asocias manualmente en la etapa de personalización. La extensión junta nombre y apellido en un solo nombre de contacto.

Ejemplo de archivo:

nome,sobrenome,telefone,email,cidade,documento
João,Silva,5514999999999,joao@email.com,Botucatu,12345678900
Maria,Santos,5514988888888,maria@email.com,Bauru,98765432100

Teléfono

Indica el número con código de área y, preferentemente, el código del país (formato internacional, como 5514999999999). Si no indicas el código del país, la extensión interpreta el número como brasileño. La extensión elimina espacios, paréntesis, guiones, puntos y el signo más antes de validar, y ignora números inválidos. Cuando una celda contiene más de un teléfono separado por coma, punto y coma o barra, la extensión considera solo el primero.

Correo electrónico

Verifica que las direcciones estén completas y sin espacios antes o después del valor. En una importación por correo electrónico, es la dirección la que identifica al contacto.

Documento y codificación

El campo Documento acepta CPF, CNPJ u otro identificador de tu operación. Formatea la columna como texto en la hoja para que el programa no altere el valor, por ejemplo, quitando un cero a la izquierda. Guarda el archivo en UTF-8 para preservar acentos, cedillas y caracteres especiales en los nombres y en las ciudades.

Importa los contactos

La importación tiene dos etapas: Subida y Personalización.

1. Accede a Blip, abre el bot cuyos contactos quieres importar y abre la extensión Gerenciador de Contatos. La extensión lista los contactos ya registrados y las acciones disponibles.

2. En la pantalla del Gerenciador de Contatos, haz clic en Importar contactos. La extensión abre la ventana de importación en la etapa Subida.

3. En Elige el canal de donde vendrán tus contactos, selecciona WhatsApp o Email. Los contactos ingresan como contactos del canal elegido, identificados por el teléfono (WhatsApp) o por el correo electrónico (Email). Si el bot tiene solo un canal compatible, ya viene seleccionado. Arrastra el archivo CSV al área de subida o haz clic en ella para elegir el archivo en la computadora y haz clic en Subir. La extensión lee el archivo y muestra una Vista previa con Nombre, Teléfono y Correo electrónico de los primeros contactos (hasta 100). Verifica los datos y haz clic en Siguiente.

4. En la etapa Personalización, en Columnas del archivo de entrada, selecciona las columnas que quieres asociar manualmente. Para cada una, usa el campo Propiedad para elegir el campo de Blip (Teléfono, Nombre, Email, Ciudad o Documento), o activa Extra y da un nombre para guardar el valor como un campo personalizado del contacto. Las columnas de nombre, teléfono y correo electrónico ya reconocidas se importan incluso sin mapeo. Usa esta etapa para importar ciudad, documento y campos personalizados, o para corregir una columna asociada al campo incorrecto.

5. Haz clic en Importar. La extensión procesa los contactos en lotes y muestra el progreso ("Importando X de Y contactos..."). Al terminar, verás el total de contactos importados. Si algún registro no puede ingresar, por ejemplo sin teléfono válido en una importación por WhatsApp o sin correo electrónico en una importación por email, la extensión informa el total de fallas.

No cierres la página mientras la importación esté en curso. Bases grandes pueden tardar algunos minutos.

Revisa los contactos importados

Usa el campo Buscar contactos para localizar algunos registros de la hoja por nombre, teléfono, correo electrónico o documento. Abre un contacto y verifica si los datos quedaron en los campos correctos. Haz esta revisión antes de usar la base en mensajes activos, campañas, automatizaciones o integraciones.

Contactos duplicados

Cada contacto se identifica por el teléfono (en WhatsApp) o por el correo electrónico (en email). Cuando importas un contacto con el mismo identificador de uno que ya existe, la extensión actualiza el contacto existente en lugar de crear un duplicado. Aun así, estandariza teléfono, correo electrónico y documento en la hoja para que los registros coincidan como esperas y para mantener búsquedas, segmentaciones y campañas consistentes.

Buenas prácticas

• Haz una prueba con una muestra pequeña antes de importar la base completa.

• Guarda una copia del archivo original.

• Guarda el CSV en UTF-8 y elimina líneas vacías y espacios sobrantes.

• Estandariza teléfonos y documentos.

• Mantén solo la información necesaria y autorizada, siguiendo las políticas de privacidad y tratamiento de datos de tu operación.

• Importar contactos no dispara mensajes. El envío de mensajes activos depende de las reglas del canal y de las autorizaciones de los contactos.

Soporte

En caso de duda o problema con la extensión, contáctanos por correo electrónico a support@wiv.com.br.

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃