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

# Contactos

> La base de destinatarios para campañas: alta, importación masiva, campos personalizados, grupos y bajas.

<Info>Outbound → **Contactos** · Owner y Admin · Requiere un plan con campañas (desde *Growth*)</Info>

Un **contacto** es una persona a la que puedes enviar campañas de WhatsApp. Es distinto de un *cliente* del [CRM](/guia/06-crm): el cliente nace cuando alguien te escribe; el contacto lo cargas tú. Cuando un contacto responde a una campaña, se convierte también en cliente y ambos quedan vinculados.

## Crear un contacto

**Nuevo contacto**:

| Campo                      | Notas                                                                                                                                                              |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Teléfono** (obligatorio) | Cualquier formato con 8–15 dígitos (`+502 1234 5678`, `50212345678`…). El sistema lo normaliza a formato internacional. Si ya existe en la organización, lo avisa. |
| **Nombre** y **Apellido**  | Se usan como variables en plantillas (*Hola {{nombre}}*).                                                                                                          |
| **Email**                  | Opcional.                                                                                                                                                          |
| **Campos personalizados**  | Aparecen aquí los que hayas definido (ver abajo).                                                                                                                  |

## Importar contactos

Para cargar muchos a la vez, **Importar** abre un asistente de tres pasos:

<Steps>
  <Step title="Archivo">
    Pulsa **Descargar plantilla** para obtener un Excel con las columnas correctas: `phone` (obligatoria), nombre, apellido, email y una columna por cada campo personalizado de tu organización. Acepta `.xlsx` y `.csv`, hasta 5.000 filas. Selecciona el archivo y pulsa **Analizar archivo**.
  </Step>

  <Step title="Revisión">
    Antes de escribir nada verás el resumen: **Filas**, **Válidas**, **Inválidas**, **Duplicadas en archivo** y **Ya existentes**, y una tabla fila por fila con el motivo de cada problema.

    Opciones:

    * **Actualizar contactos existentes**: si un teléfono ya está en la base, sobrescribe sus datos con los del archivo. Si no lo marcas, esas filas se saltan.
    * **Agregar al grupo**: mete todos los importados en un grupo (útil para crear la audiencia de una campaña en el mismo paso).

    Pulsa **Confirmar importación**.
  </Step>

  <Step title="Resultado">
    **Creados**, **Actualizados**, **Saltados** y **Fallidos**, con el detalle de cada fila fallida.
  </Step>
</Steps>

<Tip>
  Los teléfonos de Guatemala pueden ir con o sin `+502`; el sistema los normaliza. Los errores más comunes son celdas con texto en la columna `phone` y números con menos de 8 dígitos.
</Tip>

## Campos personalizados

Botón **Campos personalizados**. Definen qué datos propios de tu negocio guarda cada contacto y, sobre todo, qué **variables** puedes usar en plantillas y campañas (*su póliza {{numero_poliza}} vence el {{vencimiento}}*).

| Campo        | Notas                                                                                                                                                      |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Key**      | Identificador interno y encabezado de columna en la importación. Solo minúsculas, dígitos y guion bajo (`numero_poliza`). **No se puede cambiar** después. |
| **Etiqueta** | Nombre visible (*Número de póliza*).                                                                                                                       |
| **Tipo**     | Texto · Número · Fecha · Sí / No                                                                                                                           |

Eliminar un campo no borra los valores ya guardados, solo deja de mostrarlos.

## Grupos

Botón **Grupos**. Un grupo es un segmento de contactos (*Clientes VIP*, *Renovaciones noviembre*) que luego eliges como audiencia de una campaña.

* Crea grupos con **Nombre** y descripción.
* Añade contactos de tres formas: al importar (opción *Agregar al grupo*), seleccionándolos en la tabla y pulsando **Agregar a grupo** (puedes crear el grupo ahí mismo con **+ Crear grupo nuevo**), o por [API](/desarrolladores/introduccion).
* **Quitar de grupo** funciona igual con la selección. Eliminar un grupo no elimina los contactos.

## Bajas (opt-out)

Un contacto **Dado de baja** no recibe campañas: el sistema lo omite automáticamente (aparece como *Omitido* en los resultados). Se da de baja:

* Manualmente, con **Dar de baja** en la fila (y **Reactivar** para revertirlo).
* Automáticamente, cuando el cliente responde pidiendo no recibir más mensajes, si tu plantilla incluye esa opción.

<Warning>
  Respetar la baja no es opcional: WhatsApp penaliza los números que envían a personas que pidieron no recibir mensajes, hasta bloquear el envío. Incluye siempre una forma de darse de baja en plantillas de marketing (por ejemplo, un pie *Responde STOP para dejar de recibir mensajes*).
</Warning>

## Tabla, filtros y exportación

* Filtra por **Grupo** y **Estado** (Activos / Dados de baja) y busca por nombre, email o teléfono.
* Selecciona la página con la casilla superior para acciones en lote.
* **Exportar** descarga `contactos.xlsx` con los filtros de grupo y estado aplicados.