> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/campanas/importar-contactos.md).

# Importar contactos

Prepara y mapea contactos, interpreta importaciones parciales y comprende los duplicados en Secuencias de Texto.

Prepara la lista antes de [crear una secuencia](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/campanas/crear-una-campana.md). Importar un contacto permite que se procese; no confirma que ya se envió un mensaje.

## Prepara el archivo

Usa **CSV o XLSX de hasta 5 MB**, con encabezados y una fila por contacto. Incluye:

* Una columna de teléfono. El formato internacional E.164, como `+573001234567`, es la opción más segura; guárdalo como texto para conservar el signo más.
* Una columna de nombre si necesitas personalización.
* Una columna por cada variable obligatoria de la plantilla.
* Columnas opcionales para el contexto de la conversación.

Los números nacionales pueden normalizarse según la región/zona horaria de la secuencia. No dependas de ello para una lista de varios países. Corrige los números ambiguos o inválidos antes de importar.

Importa solo personas a las que tengas permiso de contactar. La importación no evita bajas voluntarias, bloqueos ni restricciones del proveedor.

## Sube y mapea

1. Sube el archivo en el asistente de creación.
2. Asocia **Número de teléfono** a la columna del destinatario.
3. Asocia cada variable de la plantilla. Revisa las sugerencias automáticas en lugar de aceptarlas sin comprobar.
4. Si corresponde, mapea variables de conversación y revisa varias filas, incluidos los valores vacíos.
5. Finaliza y espera el resultado. Conserva el archivo original hasta comprobarlo.

Un valor obligatorio de la plantilla debe corregirse aunque el teléfono sea válido.

## Agrega los contactos al CRM

En el paso de mapeo de una importación desde archivo, **Agregar también estos contactos al CRM** pone los contactos del archivo en tu [CRM](https://docs.dapta.ai/dapta-docs-es/crm.md) cuando la secuencia ya los tiene. Viene desmarcada. Cada contacto se crea o se actualiza por su número de teléfono, sin duplicados, y queda asociado a esta secuencia; al terminar, Dapta te dice cuántos fueron **Nuevos**, **Actualizados** y **Asociados a la secuencia**, y lista las filas que no pudo agregar.

Si agregarlos falla, la secuencia igual tiene sus contactos y está encendida; Dapta te pregunta si quieres **Reintentar** o dejarlo para **Ahora no**.

## Interpreta el resultado

| Resultado  | Significado                                                                      |
| ---------- | -------------------------------------------------------------------------------- |
| Recibidos  | Filas enviadas para importación.                                                 |
| Insertados | Destinatarios nuevos agregados a esta secuencia; no es un conteo de entregas.    |
| Duplicados | Números que ya existen en la misma secuencia; se omiten, no se agregan otra vez. |
| Inválidos  | Filas rechazadas con errores de validación; corrige la fila/campo indicado.      |

Las filas recibidas se distribuyen entre insertadas, duplicadas e inválidas. Una importación puede tener éxito parcial. Corrige las filas fallidas y usa nuevamente la ruta de importación disponible; no recrees toda la secuencia porque algunas filas sean inválidas.

{% hint style="info" %}
Volver a importar un número que ya pertenece a una Secuencia de Texto no reactiva al destinatario, no reinicia sus intentos ni reenvía el mensaje. La reactivación de contactos de otros productos de campañas no es una función de Secuencias de Texto.
{% endhint %}

## Agrega contactos a una secuencia activa

Los destinatarios nuevos recibidos mediante una ruta compatible de importación o fuente conectada pueden reactivar el procesamiento de una secuencia que espera contactos. Los envíos siguen respetando su horario y límites. Revisa en **Conexiones** las fuentes ya conectadas y sus resultados de sincronización. Una secuencia vinculada a una etapa de un pipeline del CRM toma a quien entre a la etapa: revisa [Una etapa del pipeline vinculada](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/campanas/gestionando-tu-campana.md#una-etapa-del-pipeline-vinculada).

La carga de archivo descrita aquí pertenece al asistente de creación. No supongas que **Configuración** incluye un segundo control de carga. Si tu secuencia no ofrece una ruta posterior de importación/fuente, consulta con soporte antes de planear una lista que se actualice continuamente.

Los duplicados dentro de una secuencia y la protección entre secuencias son reglas distintas: consulta [lógica de mensajes y límites](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/campanas/logica-de-mensajes-y-limites.md) antes de planear otro contacto.

*Revisión del código fuente: 17 de septiembre de 2026.*

{% content-ref url="/pages/HN4FsuIhI1cMAsY8L8Eg" %}
[Gestionando tu secuencia](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/campanas/gestionando-tu-campana.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/campanas/importar-contactos.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
