Importar CSV y copiar y pegar

Subir un CSV o pegar filas de una hoja de cálculo es la vía manual para importar contactos en un proyecto. Ambas pasan por el mismo asistente de importación y producen una fuente de datos que puedes refrescar más adelante. En esta página se explica el formato del archivo, los pasos del asistente, cómo actualizar una importación existente y —importante— cómo fijar el consentimiento de marketing de cada contacto al importar.

Formato del archivo CSV

Unas pocas reglas mantienen limpia una importación:

Requisito	Detalle
Tamaño del archivo	Hasta 20 MB
Codificación	UTF-8 (autodetectada; aparece un aviso si el archivo no es UTF-8)
Separador	Autodetectado (la plantilla usa ;)
Primera fila	Cabeceras de columna
Teléfonos	Formato internacional, asignados a _phone_mobile con un selector de País por defecto

El asistente autodetecta la codificación y el separador, así que en la mayoría de casos solo hay que confirmar. Los teléfonos se asignan al atributo _phone_mobile; si a algunas filas les falta el prefijo de país, el selector de País por defecto lo completa.

El número de filas es un aviso, no un límite estricto: a partir de 100.000 filas en un archivo (o 5.000 en un pegado) el panel avisa del tamaño, pero la importación puede seguir.

El asistente de importación

El asistente recorre hasta cinco pasos, algunos saltados automáticamente cuando no aplican:

1. 1

   Subida

   Elige el archivo .csv. El panel lo analiza, detecta codificación y separador, y muestra una vista previa de las filas.

2. 2

   Mapeo

   Asigna cada columna a un atributo de Instasent — a uno existente, creando un atributo nuevo, o ignorando la columna. Consulta el mapeo de campos.

3. 3

   Campo clave

   Elige el identificador que decide quién es quién. Se salta si el proyecto aún no está activo.

4. 4

   Unificar

   Resuelve los duplicados. Solo aparece cuando el email o el teléfono no son únicos en tus datos.

5. 5

   Tags

   Añade al menos una Tag para terminar. Las Tags son marcas que identifican los contactos que incorpora esta importación.

Las filas no válidas se muestran como avisos con una vista previa, no se rechazan sin más: ves qué falla y decides si seguir.

Actualizar una importación existente

Para refrescar una importación CSV anterior, vuelve a subir un archivo con el mismo campo clave y los mismos campos mapeados. Este asistente de actualización tiene tres pasos —seleccionar la fuente, subir el nuevo archivo y configurar la actualización—:

• Actualizar existentes — los contactos ya presentes se actualizan. Siempre activado.
• Crear nuevos — los contactos no vistos antes se añaden. Siempre activado.
• Eliminar ausentes — un interruptor (desactivado por defecto). Al activarlo, los contactos que faltan en el nuevo archivo se retiran de la fuente.

Puedes conservar los tags existentes o añadir nuevos (hasta 38 caracteres cada uno).

Copiar y pegar

Copiar y pegar usa el mismo asistente, pero en vez de un archivo se pega texto delimitado (de Excel o un CSV) en un área de texto. La primera fila son las cabeceras, igual que en un archivo. El límite es de 10.000 líneas, y la fuente se nombra copy-paste-YYYY-MM-DD.HH-mm por defecto.

Importar el consentimiento

Una importación puede fijar la preferencia de marketing de cada contacto, no solo sus atributos, y acertar con esto es esencial, porque una importación puede, si no, sobrescribir la preferencia real de un contacto.

Hay dos formas de hacerlo, y las dos terminan en la misma importación de CSV:

• Un CSV normal puede asignar una columna al atributo de preferencia de marketing de un canal, igual que cualquier otro atributo.
• Subir preferencias de marketing abre una página dedicada a importar el consentimiento. Enumera los atributos de consentimiento en Atributos disponibles, y en Recursos ofrece Descargar plantilla de bajas y la Guía para importar bajas, que lleva de vuelta a esta sección. Su botón Subir CSV lleva después al mismo asistente.

Qué puede fijar una importación de consentimiento y qué no:

• La preferencia de marketing, una columna por canal. La página de subida muestra _accepts_marketing_sms como Acepta marketing (SMS/RCS), además de _accepts_marketing_email y _accepts_marketing_whatsapp. La columna de SMS gobierna también RCS: RCS no tiene atributos ni columnas de consentimiento propios (ver Consentimiento compartido).
• La supresión, no. Una importación de CSV no puede suprimir un contacto: una columna _is_subscribed_* en el archivo no se aplica, y la supresión del contacto no cambia. La supresión se fija desde el perfil del contacto o por la API (ver Cómo funciona).

Los valores son true / false, y una celda vacía significa "sin cambio": deja intacto el valor que ya tenía el contacto en vez de reiniciarlo. Un contacto que no recibe ningún valor conserva el valor por defecto, sin preferencia (null).

La plantilla de bajas

Una lista de contactos que no quieren tus promociones, por ejemplo personas que se han quejado, es una baja de marketing. Descargar plantilla de bajas te da un archivo preparado para ello, marketing_opt_outs.csv, separado por comas, con cuatro columnas:

• _phone_mobile: el móvil del contacto, en formato internacional.
• _email: opcional; ayuda a que coincida con contactos que ya tienes.
• _accepts_marketing_sms: la preferencia de SMS, que cubre también RCS.
• _accepts_marketing_whatsapp: la preferencia de WhatsApp.

Las filas de ejemplo solo llevan false o una celda vacía: false registra la baja en ese canal, y una celda vacía deja ese canal como está. Sustitúyelas por tu propia lista. Si solo tienes las bajas, súbelas en un CSV aparte con la preferencia en false, y usa Teléfono móvil y Email como atributos de unificación para que las filas coincidan con los contactos existentes.

Que las bajas se respeten

Las bajas importadas solo se aplican a los envíos con la política Sin opt-out u Opt-in. Basic ignora las preferencias de marketing, así que a esos contactos les sigue llegando: solo deja fuera a los contactos suprimidos. Para respetarlas por defecto, elige Sin opt-out como política por defecto en la pestaña Cumplimiento de cada canal. RCS tiene su propia política, y WhatsApp también, así que fijarla en SMS no las cubre. La página de subida enlaza a los ajustes de cada canal disponible en tu proyecto (Ajustes de SMS, Ajustes de RCS, Ajustes de WhatsApp); la política está en su pestaña Cumplimiento. Más en Si importas listas de bajas, y en Políticas de cumplimiento para saber a quién llega cada política.

Para saber qué significa cada atributo de consentimiento y cómo se combinan los valores, consulta Atributos de suscripción.