¿Qué es la importación de contactos?
La importación de contactos permite añadir y actualizar múltiples contactos en la plataforma.
La importación de contactos es útil por las siguientes razones:
Sincroniza una lista de contactos con la plataforma
Sincronizar tu lista de contactos con la plataforma te ayuda a identificar contactos cuando te envían mensajes.Actualiza masivamente contactos en la plataforma
Actualiza la información de múltiples contactos existentes en la plataforma en lugar de actualizarlos uno por uno.Inicia una conversación con el contacto
Inicia conversaciones con contactos en tu lista de contactos sin necesidad de que ellos envíen el primer mensaje.
Enviar el primer mensaje solo es aplicable para WhatsApp, SMS y correo electrónico, siempre y cuando se añada el número de teléfono o dirección de correo electrónico del contacto.
Importación de contactos
El proceso de importación de contactos se divide en 3 partes: subir archivo CSV, mapeo y revisión.
Parte 1: Iniciar una importación de contactos
Para importar contactos, necesitas subir un archivo CSV. Cada fila en tu archivo CSV representa un contacto y cada columna representa un campo de contacto.
Paso 1: En el módulo Contactos, haz clic en la flecha del botón Añadir contacto > Importar contactos.
Alternativamente, ve a Ajustes > Importar datos > haz clic en el botón Importar contactos.
Paso 2: Sube un archivo CSV con los contactos y detalles que deseas importar.
Asegúrate de que el archivo CSV cumple con los siguientes requisitos:
Solo se aceptan archivos CSV para la importación.
El tamaño del archivo debe ser inferior a 20MB.
El archivo debe contener al menos una fila.
El archivo debe contener menos de 200,000 filas.
Se requiere una columna de nombre para añadir nuevos contactos.
Al menos una columna debe ser mapeada a un identificador (excepto por la opción de importación AñadirTodos los contactos a pesar de los duplicados).
Todos los números de teléfono en el archivo CSV deben incluir el código de país y se recomienda utilizar el signo "+", p.e. +60189988776.
Formato recomendado para campo Fecha: "AAAA-MM-DD". ej. 2023-10-25
Para ver un ejemplo de un archivo CSV poblado, descarga la muestra haciendo clic en el hiperenlace.
Paso 3: Selecciona la finalidad de la importación para este archivo.
Finalidad de la importación | Acción |
|---|---|
Añadir solo nuevos contactos | Añade solo nuevos contactos en el archivo CSV al espacio de trabajo. |
Actualizar solo contactos existentes | Actualiza solo los contactos existentes en el espacio de trabajo con valores del archivo. |
Añadir y actualizar contactos | Actualiza los contactos existentes y añade nuevos contactos al espacio de trabajo. |
Añadir todos los contactos a pesar de los duplicados | Todos los contactos en el archivo serán tratados como nuevos contactos. Puedes revisar y fusionar los contactos duplicados manualmente en la plataforma. |
Paso 4: Selecciona un identificador para reconocer los contactos existentes. El identificador puede ser un número de teléfono o un correo electrónico. Si tu propósito de importación es Actualizar solo contactos existentes, también puedes seleccionar ID de contacto como identificador.
Ten en cuenta que las direcciones de correo electrónico no distinguen entre mayúsculas y minúsculas. Esto significa que john.smith@gmail.com y John.Smith@gmail.com serán reconocidos como la misma dirección de correo electrónico en la plataforma.
El identificador no está disponible para la selección si has seleccionado la opción Añadir todos los contactos a pesar de los duplicados en el paso anterior.
Paso 5: Agrega etiquetas para todos los contactos que se están añadiendo o actualizando en el espacio de trabajo según sea necesario. Luego, haz clic en Siguiente.
Se generará automáticamente una etiqueta de importación para identificar cada lote importado. Puedes eliminar esta etiqueta.
Parte 2: Mapear cabeceras CSV a campos de contacto
Mapea los encabezados de columna en el archivo CSV a campos de contacto en tu espacio de trabajo. Esto determina qué campo de contacto se actualizará con los valores de una columna. Si el encabezado de una columna en el archivo coincide perfectamente con el nombre de un campo de contacto (por ejemplo, Número de teléfono), se asignará automáticamente.
Asegúrate de que el identificador definido esté mapeado. Cada campo de contacto solo puede mapearse una vez.
Si deseas omitir una columna para que sus valores no se importen, desmarca la casilla a su izquierda. Debes seleccionar al menos una columna para proceder con la importación.
Casilla «No sobrescribir» y sus funciones
Si has seleccionado la opción Actualizar solo contactos existentes o Añadir y actualizar contactos, aparecerá la opción No sobrescribir.
Cuando "No sobrescribir" esté marcada:
Los campos con valores existentes no se sobrescribirán, los valores solo se añadirán cuando el campo esté vacío.
Se añadirán nuevas etiquetas sin eliminar las etiquetas existentes.
Por defecto, un valor en el archivo CSV reemplazará el valor de campo existente correspondiente en tu espacio de trabajo.
Ejemplo:
El Contacto A en tu espacio de trabajo tiene el correo electrónico contactabc@email.com. En el archivo CSV subido, el Contacto A se identifica por su número de teléfono y tiene la dirección de correo electrónico contact123@email.com.
Si la casilla de verificación no está marcada (por defecto), el valor existente se sobrescribirá y el correo electrónico del Contacto A se actualizará a _contact123@email.com._
Si la casilla está marcada, el valor existente no se sobrescribirá y el correo electrónico del Contacto A permanecerá como contactabc@email.com.
Una vez que las columnas hayan sido mapeadas, haz clic en Siguiente. El archivo de importación será validado. Ten en cuenta que la importación de archivos CSV más grandes llevará más tiempo.
Parte 3: Revisar importación
Se te informará del número de contactos que se añadirán y actualizarán después de la importación, o que se omitirán por errores. Una vez listo, haz clic en Importar para continuar.
Las filas que contengan errores no serán importadas. Para identificar errores en las filas originales, haz clic en "Descargar archivo de error" para descargar un archivo CSV con una columna "Error". Resuelve los errores descritos en los mensajes de error. Una vez hecho, sube el archivo CSV corregido o regresa a la Parte 1 para reconfigurar la importación.
Una vez que el archivo ha sido validado, haz clic en Importar para continuar. Aparecerá un cuadro de diálogo para confirmar que la importación ha comenzado.
El proceso de importación puede tardar algún tiempo. Puedes supervisar su progreso yendo a Ajustes > Importar datos.
Comprobar el resultado de la importación
Recibirás una notificación por correo electrónico y en el centro de notificaciones de la plataforma cuando se complete el trabajo de importación.
Puedes descargar el archivo de resultados desde tu correo electrónico o desde la tabla de Historial de importación en Ajustes > Importar datos. Este archivo estará disponible durante 7 días. El archivo de resultados contendrá 2 columnas adicionales: Estado de importación y Errores.
La columna Estado de importación puede tener uno de 4 estados posibles:
Estado de importación | Resultado |
|---|---|
Importado | El contacto se añadió correctamente. |
Actualizado | El contacto se ha actualizado correctamente. |
Omitido | Se omitió el contacto según la finalidad de la importación (por ejemplo, nuevo contacto en una importación 'Actualizar solo contactos existentes'). |
Error | El contacto no se importó debido a error(es). |
La columna de errores marcará las filas con errores detectados durante la importación. Los contactos en estas filas no fueron importados. Para importar estos contactos, resuelve los errores y vuelve a intentarlo.
Preguntas Frecuentes y Resolución de Problemas
¿Cuántos archivos puedo importar a la vez?
Solo puedes importar un archivo por importación.
¿Por qué no puedo importar Contactos mediante un archivo CSV?
Puede que no puedas importar Contactos si hay problemas con la creación o el formato de tu archivo CSV.
Para evitar problemas al importar Contactos, verifica lo siguiente:
El archivo está guardado como un archivo CSV válido (.csv).
El archivo está codificado en UTF-8.
Los números de teléfono de los contactos están en formato E164.
¿Por qué los nombres de contacto con caracteres especiales aparecen incorrectamente en mi archivo CSV?
Esto ocurre porque Excel usa la codificación ANSI, que no admite ciertos caracteres especiales o no latinos, como caracteres chinos o logogramas.
Para asegurar que los nombres de contacto se muestren correctamente, el archivo CSV debe importarse usando codificación UTF-8.
Lo que puedes hacer
Abre Excel y selecciona Datos > Obtener datos > Desde texto/CSV.
En la pestaña Datos, bajo Origen de archivo, elige 65001: Unicode (UTF-8).
Haz clic en Importar.
Guarda tu configuración.
Vuelve a abrir tu archivo para confirmar que los caracteres se muestran correctamente.
¿Por qué no puedo iniciar una nueva importación?
Solo se puede tener un trabajo de importación en progreso a la vez. Espera hasta que se complete el trabajo de importación antes de comenzar uno nuevo.
¿Qué significa el error "Sesión expirada"?
Tienes una ventana de 1 hora para proceder con un trabajo de importación. Si no se inicia una importación dentro de 1 hora en la etapa de Revisión, se cancelará automáticamente y deberás reiniciar el proceso de importación.
¿Y si hay dos Contactos con el mismo identificador en el archivo CSV?
Ambas filas de Contacto en el archivo CSV se marcarán en la columna de Errores del archivo de error. Sus valores no se añadirán ni se actualizarán en el Espacio de trabajo.
¿Y si hay dos Contactos existentes con el mismo identificador en el Espacio de trabajo?
Si varios contactos comparten un valor de identificador en el Espacio de trabajo (por ejemplo, perfiles de Contacto duplicados o una dirección de correo electrónico o número de teléfono compartido utilizado por dos Contactos), se indicará un error en la fila con el mismo valor en el archivo CSV.
¿Son obligatorios los Tags para las importaciones de Contactos?
No, no lo son. Puedes añadir, actualizar y eliminar Tags como desees.
Se generará automáticamente un Tag de importación para identificar qué Contactos fueron añadidos o actualizados durante la importación. Este Tag es opcional y se puede eliminar.
¿Por qué no se identifican algunos Contactos existentes por el identificador de número de teléfono?
El formato del número de teléfono tiene que ser idéntico en el archivo CSV y en el Espacio de trabajo para que el número sea identificado. Si el mismo número de teléfono tiene formatos diferentes (por ejemplo, uno le falta un código de área), no se podrá identificar el Contacto existente y el Contacto en el archivo será tratado como un nuevo Contacto.
Si estás tratando de actualizar solo Contactos existentes, este Contacto será saltado.
Si estás tratando de subir nuevos Contactos, se creará un nuevo perfil de Contacto para este Contacto.
¿Por qué los números de teléfono aparecen en notación científica en mi archivo CSV?
Al preparar un archivo CSV para la Importación de Contactos, los números de teléfono que son demasiado largos pueden convertirse automáticamente en notación científica (por ejemplo, 4.48E+11).
Esto ocurre porque las herramientas de hojas de cálculo, como Excel, cambian automáticamente el formato de las celdas. Al convertirse, el formato del número de teléfono queda inválido, lo que provoca que la Importación de Contactos falle.
Qué puedes hacer
Cambia el formato de la columna de números de teléfono a Texto sin formato.
Guarda tu archivo CSV.
Vuelve a subir tu archivo CSV para importar contactos.
