Saltar al contenido
NuevoVer cómo

Importar contactos desde CSV (mapeo de columnas)

Sube un CSV, mapea sus columnas a los campos de FirstSales, e importa contactos en masa a una lista — con limpieza automática de correos.

Tutoriales
Gestión de Listas
min de lectura
6 min
pasos
7 · Principiante

  1. Abre el importador

    En Contacts, haz clic en Import Contacts para desplegar el panel de importación de CSV.

  2. Elige la lista de destino

    Selecciona una Contact List en la parte superior del panel. El selector de archivos permanece deshabilitado hasta que se elija una lista: cada contacto importado necesita un destino.

    Elige la lista de destino

  3. Sube tu CSV

    Arrastra o haz clic para seleccionar un archivo .csv. FirstSales acepta archivos de hasta 5MB y 10,000 filas. Si no estás seguro de qué forma debe tener el archivo, haz clic primero en Download sample CSV para ver la fila de encabezado esperada.

  4. Revisa las estadísticas detectadas automáticamente

    Antes de importar nada, el panel muestra los conteos de Total, Valid (filas con un correo bien formado) y No Email, así sabes exactamente qué entrará y qué no.

  5. Mapea tus columnas

    Cada encabezado del CSV se mapea a un campo de FirstSales: Email es el único obligatorio. Los encabezados reconocidos (como emailaddress o jobtitle) se mapean automáticamente por ti; ajusta lo que se haya mapeado mal o define una columna como Skip. Las columnas que no se mapean a un campo destino se conservan como campos personalizados, no se descartan.

  6. Agrega etiquetas para toda la lista (opcional)

    Escribe una etiqueta y pulsa Enter para convertirla en chip. Cualquier etiqueta que agregues aquí se aplica a todos los contactos de esta importación, lo cual es una forma rápida de marcar un lote completo para segmentación posterior.

  7. Importa y lee el resultado

    Haz clic en Import. El panel de finalización muestra Imported, Duplicates, Errors y Total, además de un resumen de limpieza si la limpieza automática está activada para tu workspace.

Consejos de experto

  • Solo Email es obligatorio

    Todos los demás campos destino son opcionales. Deja en Skip las columnas que no necesites en lugar de forzar un mapeo.

  • Separa etiquetas con punto y coma en una sola celda

    Coloca varias etiquetas en una sola celda del CSV, como `saas;marketing`, y mapea esa columna a Tags: cada valor se convierte en su propia etiqueta al importar.

  • Nada en tu archivo se pierde

    Cualquier encabezado que FirstSales no reconozca se guarda como campo personalizado en el contacto, incluso sin un campo destino coincidente.

  • Activa la limpieza antes de importar

    Activa Contact cleaning en la configuración de Tools primero, así los correos inválidos se detectan a 0.2 créditos por contacto nuevo: solo se te cobra por contactos completamente nuevos.

Preguntas frecuentes

¿Cuál es el tamaño máximo de archivo y el número de filas?

5 MB y 10,000 filas por archivo. Divide las exportaciones más grandes e impórtalas por lotes.

¿Qué columna es obligatoria?

Solo Email. El botón de importar permanece deshabilitado hasta que una columna se mapee a Email y al menos una fila tenga una dirección válida.

¿Qué pasa con los contactos duplicados?

Se detectan durante la importación y se reportan en el conteo de Duplicates. Los contactos existentes se agregan a la lista de destino en lugar de volver a crearse.

Mi CSV tiene columnas que FirstSales no lista: ¿se pierden?

No. Las columnas sin mapear se almacenan como campos personalizados en cada contacto.

¿Cómo agrego varias etiquetas a la vez desde el archivo?

Usa una columna con valores separados por punto y coma y mapéala a Tags, o escribe etiquetas a nivel del panel que se apliquen a cada fila de la importación.

¿Qué pasa si me quedo sin créditos durante la importación?

Los contactos igual se importan, pero se omite la limpieza de correos y verás un aviso de “imported but not verified” con un enlace para recargar créditos. Puedes volver a ejecutar la limpieza más tarde desde la tabla de contactos.

¿Importar envía algún correo?

No. Importar solo agrega contactos a una lista. Si esa lista alimenta una campaña activa, la inscripción es un paso aparte: consulta el flujo de transferencia de listas para ver cómo funciona la confirmación de inscripción.

Gestión de Listas

Prospección que sigue cuando te desconectas.Leads, emails, seguimientos y respuestas, resueltos.

Conecta buzones ilimitados y deja que los agentes de IA busquen leads, escriban cada email y hagan seguimiento. O envía tus propias plantillas en modo manual. Desde $29/mes.

Empieza tu prueba de $1 Ver precios

$1 por 3 días · Cancela cuando quieras · Sin contrato

Instalar con IA

Tu agente de código configura la CLI y las skills de FirstSales por ti.

Prompt para Claude Code

I'm setting up FirstSales (https://firstsales.io), an AI outbound sales platform: campaigns, contacts, a reply inbox, deliverability and lead signals. Help me get my workspace sending real, good emails end to end, from Claude Code.

Read these first so you know how FirstSales works:
- Developer docs and API: https://developer.firstsales.io
- CLI: https://www.npmjs.com/package/@firstsales.io/cli
- Skills for coding agents: https://github.com/firstsalesio/firstsales-skills (read README.md and GUIDE.md)

Setup
1. Install the CLI: npm install -g @firstsales.io/cli
2. Install the FirstSales skills:
   claude plugin marketplace add firstsalesio/firstsales-skills
   claude plugin install firstsales@firstsales
3. Ask me if I already have a FirstSales account. If not, send me to https://app.firstsales.io to sign up.
4. Ask me to create an API key under Settings → API → API Keys, with only the scopes we need.
   Never ask me to paste the key into this chat. Tell me to run this in my own terminal, so the key stays hidden:
   read -rs FS_KEY && firstsales auth login --api-key "$FS_KEY"; unset FS_KEY
5. Run `firstsales whoami` and tell me which workspace and organisation we are connected to.

Then ask me about my business: what I sell, who I sell to (roles, company size, countries), my best customers, and what I use today for outbound (tools, lists, mailboxes). Walk me through:
1. Teaching FirstSales my business: website, offer, proof points and case studies in the knowledge base, so the AI writes like someone who knows the product.
2. Connecting my sending mailboxes and checking my sending domain: SPF, DKIM, DMARC and warm-up. If anything is unhealthy, tell me the exact DNS record to add.
3. Bringing in contacts: import my CSV or CRM export into a clean list, remove duplicates and bad emails, and block domains I must never email (customers, competitors, my own).
4. Building my first campaign: the right list, senders, steps and timing. Write the sequence with me, show me the drafts, and do not launch until I say yes.
5. Setting up Signals if it fits: find people engaging with LinkedIn posts about topics my buyers care about, and turn them into leads.
6. Inviting my team and giving each person the right access.

Once campaigns run, show me how to work the reply inbox from here: which replies need an answer, draft responses in my voice, and move good conversations into deals. If I use Cal.com, connect it so follow-ups can offer my booking link (not the first email).

Throughout, as you learn about my business, proactively suggest and help create:
- Reply templates for the questions and objections my prospects are likely to raise, based on my product, site and codebase if you can see them.
- Campaign ideas and segments worth testing, with the reason for each.

Safety rules:
- Show every change as a dry run (--dry-run) first and wait for my yes. Never send emails, launch campaigns or delete anything without my yes.
- Tell me before anything that spends credits, and how many.

Be opinionated. If the docs give a sensible default, just use it. Don't make me choose between five options.
Developer docs ↗npm: @firstsales.io/cli ↗GitHub: firstsales-skills ↗