> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindosoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar contactos

> Cómo importar contactos de forma masiva desde un archivo Excel o CSV, o sincronizarlos desde Google Contacts

En esta guía vas a aprender a importar tus contactos a Mindo de forma masiva usando un archivo Excel o CSV. También vas a ver las otras opciones disponibles: carga manual y sincronización con Google Contacts.

<iframe width="560" height="315" src="https://www.youtube.com/embed/eHRRucDV_lY" title="Tutorial: Importar contactos en Mindo" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## Requisitos previos

* Tener una cuenta activa en Mindo.
* Tener tu lista de contactos en un archivo Excel (.xlsx, .xls) o CSV (.csv).
* Los contactos deben incluir al menos **nombre** y **teléfono** (con código de país).

## Importar desde Excel/CSV

<Steps>
  <Step title="Entrá a la sección de Contactos">
    Desde el menú lateral, hacé clic en **Contacts** dentro de la sección "Administration". Vas a ver la lista de contactos.
  </Step>

  <Step title="Hacé clic en 'Añadir contactos'">
    En la esquina superior derecha, presioná el botón **Añadir contactos**. Se abre un diálogo con tres pestañas:

    * **Manual**: para agregar contactos de a uno.
    * **Excel/CSV**: para importar desde un archivo.
    * **Google Contacts**: para sincronizar con tu cuenta de Google.
  </Step>

  <Step title="Seleccioná la pestaña Excel/CSV">
    Hacé clic en la pestaña **Excel/CSV**. Acá vas a encontrar:

    * **Descargar Plantilla**: te da un archivo Excel con el formato correcto y las columnas que Mindo espera.
    * **Subir Archivo**: la zona donde arrastrás o seleccionás tu archivo.

    <Note>
      Te recomendamos descargar la plantilla primero si es tu primera importación. Así te asegurás de que las columnas estén en el formato correcto.
    </Note>
  </Step>

  <Step title="Subí tu archivo">
    Arrastrá tu archivo Excel o CSV a la zona de carga, o hacé clic para seleccionarlo desde tu computadora. Una vez cargado, vas a ver el nombre del archivo y el botón **Abrir vista previa**.
  </Step>

  <Step title="Revisá la vista previa">
    Hacé clic en **Abrir vista previa**. Se abre una tabla con todos los datos de tu archivo donde podés:

    * Verificar el **mapeo automático de columnas** (Nombre completo, Correo, Teléfono, etc.).
    * Agregar un **prefijo telefónico** si tus números no lo incluyen (ej: +54).
    * Agregar un **detalle de origen** para identificar de dónde vienen estos contactos (ej: "Clientes Zona Norte").
    * **Editar datos** directamente en la tabla antes de importar.
    * **Eliminar filas** que no quieras importar.

    <Warning>
      Si alguna columna no se mapeó automáticamente, hacé clic en el selector de esa columna para asignarla al campo correcto. Podés elegir entre campos base y campos personalizados.
    </Warning>
  </Step>

  <Step title="Importá los contactos">
    Cuando todo esté listo, hacé clic en **Importar X contactos**. Los contactos se crean de inmediato y aparecen en tu lista con:

    * **Origen**: `csv_import`
    * **Detalle de Origen**: el nombre del archivo que usaste.
  </Step>
</Steps>

## Otras formas de añadir contactos

<AccordionGroup>
  <Accordion title="Carga manual">
    En la pestaña **Manual** del diálogo "Añadir contactos" podés agregar contactos de a uno, completando nombre, correo y teléfono.
  </Accordion>

  <Accordion title="Google Contacts">
    En la pestaña **Google Contacts** podés conectar tu cuenta de Google para importar contactos automáticamente. El proceso tiene dos pasos:

    1. **Conectar Google Contacts**: autorizás a Mindo a acceder a tu lista de contactos de Google.
    2. **Programar importación diaria**: Mindo sincroniza tus contactos de Google todos los días de forma automática.
  </Accordion>
</AccordionGroup>

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Qué formatos de archivo puedo usar?">
    Podés usar archivos Excel (.xlsx, .xls) o CSV (.csv). El tamaño máximo es de 50 MB. Los archivos grandes se procesan en segundo plano.
  </Accordion>

  <Accordion title="¿Qué columnas necesita mi archivo?">
    Las columnas básicas son: `full_name` (nombre completo), `email` (correo), `phone` (teléfono) y `wpp_phone` (teléfono de WhatsApp). Las obligatorias son el nombre y el teléfono.
  </Accordion>

  <Accordion title="¿Qué pasa si un contacto ya existe?">
    Mindo usa el número de teléfono para detectar duplicados. Si un contacto con ese teléfono ya existe, no se crea uno nuevo.
  </Accordion>

  <Accordion title="¿Puedo editar los datos antes de importar?">
    Sí. En la vista previa podés editar cualquier celda directamente, eliminar filas que no quieras importar y ajustar el mapeo de columnas.
  </Accordion>

  <Accordion title="¿Para qué sirve el 'Detalle de origen'?">
    Es una etiqueta opcional que te ayuda a recordar de dónde vinieron esos contactos (por ejemplo: "Feria Expo 2026", "Clientes Zona Sur"). Se guarda en cada contacto importado.
  </Accordion>

  <Accordion title="¿Puedo importar contactos sin código de país?">
    Sí. En la vista previa hay un campo para agregar un prefijo telefónico (ej: +54) a todos los números que no lo tengan.
  </Accordion>
</AccordionGroup>