Importar Contactos Desde un Archivo CSV a Kontrolya Conversacional (Wintook)

Soporte
1

Para importar Contactos Desde un Archivo CSV a Kontrolya Conversacional (Wintook) haz lo siguiente:

Paso 1 — Abrir el importador

En la pantalla Contactos, haz clic en el botón Importar de la esquina superior derecha.

Paso 2 — Descargar el CSV de ejemplo

Dentro de la ventana de importación encontrarás el enlace Descargar un ejemplo de CSV. El archivo que se descarga tiene estos encabezados:

id,name,email,identifier,phone_number,ip_address,custom_attribute_1,custom_attribute_2

Ese archivo es solo una muestra de datos, no la lista de columnas disponibles. Hay campos que Wintook reconoce y no aparecen ahí (company, city), y hay columnas del ejemplo que no son campos especiales (id, ip_address, custom_attribute_1, custom_attribute_2).

Si vas a partir de ese archivo, borra primero las columnas id, ip_address, custom_attribute_1 y custom_attribute_2, o cada contacto terminará con atributos personalizados innecesarios llamados literalmente “id” e “ip_address”.

Toma tu archivo que contiene los registros de los contactos que vas a importar y coloca los encabezados según la información que tengas.

Las columnas que se pueden importar son name, email, identifier, phone_number, company, city y los atributos personalizados que necesites, ejemplo puesto, tipo, estado, etc.

La importación de atributos funciona por “coincidencia de nombres”. Si el nombre de la columna no está registrado en el sistema como un atributo válido, El sistema descarta esa información.

Paso 3 — Elegir el archivo

Haz clic en Elegir archivo y selecciona el .csv de tu equipo. Si te equivocaste, usa Cambiar para reemplazarlo.

Paso 4 — Confirmar

Pulsa Importar. Verás el mensaje: “Se te notificará por correo electrónico cuando la importación esté completa.”

Importante: la importación se procesa en segundo plano, no es instantánea. Cuando termine, los administradores de la cuenta reciben un correo con el resultado.

4. Formato del archivo CSV

4.1 Columnas reconocidas

Columna Obligatoria Descripción
name No Nombre completo del contacto.
email Ver nota Correo electrónico. Debe tener formato válido y ser único en la cuenta.
phone_number Ver nota Teléfono en formato internacional (ej. +5215512345678). Si omites el +, Wintook lo agrega automáticamente.
identifier Ver nota Identificador único propio de tu sistema (ID de tu CRM, ecommerce, etc.).
company No Nombre de la empresa. No viene en el archivo de ejemplo, pero sí funciona.
city No Ciudad. No viene en el archivo de ejemplo, pero sí funciona.
Cualquier otra columna No Se guarda como atributo personalizado con el nombre exacto del encabezado.

Solo cuatro columnas son campos propios del contacto: name, email, phone_number e identifier. company y city se guardan como datos adicionales. Todo lo demás se convierte en atributo personalizado, se llame como se llame.

Nota sobre campos identificadores: cada fila debe traer al menos uno de identifier, email o phone_number. Sin ninguno de los tres, Wintook no puede identificar al contacto y la fila se rechaza.

La columna se llama company, no company_name. Si escribes company_name, el dato no se guarda como empresa: termina en atributos personalizados. Es normal, además, que company y city aparezcan también dentro de los atributos personalizados del contacto.

Las etiquetas no se importan desde el CSV. Una columna labels no crea ni asigna etiquetas: se guarda como texto en un atributo personalizado.

4.1.1 Columnas del ejemplo que conviene borrar

Columna Qué hace en realidad
id No es el identificador interno de Wintook ni sirve para nada. Crea un atributo personalizado llamado id con el número de fila. Bórrala.
ip_address No rellena la IP real del contacto. Crea un atributo personalizado llamado ip_address. Bórrala salvo que quieras guardar ese dato como texto.
custom_attribute_1, custom_attribute_2 Son marcadores de posición. Renómbralas con el nombre real de tu atributo (plan, segmento, rfc…) o bórralas.

4.2 Requisitos del archivo

  • Formato CSV separado por comas.
  • La primera fila debe contener los encabezados, escritos exactamente como en la tabla anterior (minúsculas y guion bajo).
  • Codificación UTF-8 sin BOM. Si guardas desde Excel en Windows con la opción “CSV UTF-8”, el archivo incluye unos bytes invisibles al inicio que dañan el primer encabezado y hacen que esa columna deje de reconocerse. Guarda como CSV (delimitado por comas), o exporta desde Google Sheets o LibreOffice.
  • Si un valor contiene comas, la celda debe ir entre comillas dobles.
  • Por precaución, deja name como primera columna: si el encabezado llegara a dañarse, pierdes el nombre pero no la columna que identifica al contacto.

4.3 Ejemplo de archivo

Plantilla recomendada, ya depurada:

name,email,identifier,phone_number,company,city,plan
Clarice Uzzell,[email protected],bb4e11cd-0f23-49da,+498963648018,Acme Inc,Madrid,premium
Marieann Creegan,[email protected],e60bab4c-9fbb-47eb,+15417543010,Acme Inc,Bogotá,basico
Nancey Windibank,[email protected],f793e813-4210-4bf3,+15417543011,Acme Inc,Lima,premium

En este ejemplo, plan no es un campo estándar: Wintook lo guardará como atributo personalizado llamado plan en cada contacto.

No hace falta incluir todas las columnas: puedes importar solo name,email o solo name,phone_number si es lo único que tienes.

5. Cómo maneja Wintook los duplicados

Al procesar cada fila, Wintook busca si el contacto ya existe en la cuenta, en este orden de prioridad:

  1. Por identifier
  2. Si no lo encuentra, por email
  3. Si no lo encuentra, por phone_number
  • Si el contacto ya existe: se actualiza con los datos nuevos de la fila (las celdas vacías del CSV no borran la información existente).
  • Si no existe: se crea un contacto nuevo.

Por eso puedes volver a subir un CSV corregido sin miedo a duplicar registros, siempre que mantengas el mismo identifier, email o phone_number.

6. Etiquetas

Las etiquetas no se pueden asignar desde el archivo CSV. Alternativas:

  1. Usar un atributo personalizado como criterio de segmentación. Agrega al CSV una columna propia (por ejemplo segmento, con valores como vip o mayorista), luego filtra por ese atributo en la pantalla de Contactos y guarda el resultado como segmento. Es el reemplazo directo y no requiere trabajo manual.
  2. Etiquetar después, contacto por contacto, desde el panel lateral de cada ficha.

7. Resultado de la importación y filas rechazadas

Cuando el proceso termina, los administradores reciben un correo con el resumen: cuántos registros se procesaron y cuántos fueron rechazados.

Si hubo filas rechazadas, Wintook genera un archivo de registros fallidos con las mismas columnas de tu archivo original más una columna errors que explica el motivo de cada fallo. Corrige ese archivo y vuelve a importarlo: solo se procesarán esas filas.

Si hubo rechazos es posible que recibas dos correos de aviso en lugar de uno. Es normal y no significa que los contactos se hayan importado por duplicado.

Errores más comunes

Error Causa Solución
Correo inválido o en uso Formato incorrecto, o el correo ya pertenece a otro contacto. Corregir el correo o unificar los registros.
Teléfono inválido o en uso No está en formato internacional, o ya está asignado a otro contacto. Usar el formato +<código de país><número>, sin espacios ni guiones.
La importación falla por completo El archivo está mal formado: comillas sin cerrar, columnas desalineadas. Volver a exportar el CSV desde la hoja de cálculo y subirlo de nuevo.
Se crean contactos incompletos o duplicados sin razón aparente El archivo se guardó con BOM y el primer encabezado quedó dañado. Guardar el archivo en UTF-8 sin BOM (ver 4.2).