# Importar consentimiento (/es/guides/importing-consent)

Cuando migras desde otra plataforma, no solo mueves contactos — mueves **a qué accedió cada uno**. El importador de consentimiento ingiere el consentimiento de temas desde un CSV, mapeando los grupos de la otra herramienta a [temas](/docs/guides/preference-center) de Bitelio y conservando la fecha **original** de suscripción en el historial de consentimiento de cada contacto. Lo encuentras en **Ajustes › Datos › Importar consentimiento**.

## Antes de empezar

La importación de consentimiento se aplica sobre datos que ya existen — nunca crea contactos ni temas:

1. [Importa tus contactos](/docs/guides/importing-contacts) primero.
2. Crea los [temas](/docs/guides/preference-center#temas) a los que vas a mapear, y anota la **clave** de cada tema.

Una fila cuyo email no coincida con un contacto, o cuyo `topic_key` no coincida con un tema, se **omite** y se cuenta — nunca se adivina.

## Formato CSV

Descarga la plantilla desde la tarjeta, o construye un fichero con estas columnas:

```csv
email,topic_key,status,date
jane@acme.com,weekly_digest,subscribed,2023-05-01
john@acme.com,promotions,unsubscribed,2023-06-15
```

| Columna     | Obligatoria | Notas                                                                                             |
| ----------- | ----------- | ------------------------------------------------------------------------------------------------- |
| `email`     | Sí          | Debe coincidir con un contacto existente del proyecto (sin distinguir mayúsculas).                |
| `topic_key` | Sí          | Debe coincidir con la **clave** de un tema (no su nombre visible).                                |
| `status`    | Sí          | `subscribed` o `unsubscribed`. `no` / `false` / `0` también cuentan como baja.                    |
| `date`      | No          | La fecha original de suscripción (ISO `AAAA-MM-DD`). Se conserva en el historial en vez de "hoy". |

Una fila de cabecera se detecta y se salta automáticamente.

## Ejecutar la importación

1. **Sube el CSV** (o pega las filas en el cuadro).
2. Revisa las filas.
3. **Importar.**

Obtienes un resumen — cuántas filas se **importaron** y cuántas se **omitieron**. Cada fila importada fija el consentimiento por-tema del contacto y añade una entrada al [historial de consentimiento](/docs/guides/preference-center#historial-de-consentimiento) marcada como `import`, con la fecha original de `date`.

<Callout title="Hacerlo por API">
  La misma importación está disponible en la API:

  ```bash
  POST /consent/import
  { "rows": [ { "email": "jane@acme.com", "topicKey": "weekly_digest", "status": "subscribed", "occurredAt": "2023-05-01", "source": "mailchimp" } ] }
  → { "imported": 1, "skipped": 0, "errors": [] }
  ```
</Callout>

## Relacionado

* [Temas y centro de preferencias](/docs/guides/preference-center)
* [Importar contactos](/docs/guides/importing-contacts)