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

# Introducción

> Registre personas una vez y utilícelas en el panel y en la API: etiquetas, temas, segmentos y campañas.

<Tip>
  Un **contacto** es la **persona** en su base de datos. Etiquetas, temas, segmentos y campañas **organizan** o **despachan** además de eso, no son lo mismo.
</Tip>

## ¿Qué son los contactos en Notifique?

Es el espacio de trabajo **base de datos de personas**: nombre, teléfono, correo electrónico, etiquetas, campos adicionales y preferencias de marketing. Te registras **una vez** y lo reutilizas en plantillas, campañas, segmentos y envíos de API.

Puede:

* **Crear e importar** contactos (se requiere teléfono y/o correo electrónico)
* **Etiquetar** con etiquetas reutilizables (`Lead`, `VIP`)
* **Registrar consentimiento** por tema con **temas** (Boletín, Promociones)
* **Crear audiencias** con **segmentos** (reglas guardadas con AND/OR)
* **Envío por lotes** con **campañas** (plantilla + canales + audiencia)

Piense en un **archivo de cliente** en un cajón: sin él, cada envío se convierte en una hoja de cálculo suelta.

## Dónde vive en el panel

| Menú                      | Qué es                                                             |
| ------------------------- | ------------------------------------------------------------------ |
| **Contactos**             | Registro de persona, etiquetas, campos personalizados, importación |
| **Audiencia → Temas**     | Temas de marketing y consentimiento                                |
| **Audiencia → Segmentos** | Audiencias basadas en reglas (filtro guardado)                     |
| **Audiencia → Campañas**  | Envío por lotes (plantilla + canales + quién recibe)               |

## No confundas: mapa conceptual

| Concepto                | Analogía rápida             | Qué hace                                                                |
| ----------------------- | --------------------------- | ----------------------------------------------------------------------- |
| **Contacto**            | El archivo de la persona    | Almacena teléfono, correo, nombre, etiquetas, campos                    |
| **Etiqueta**            | Sticker en el archivo       | Etiqueta manual (`Lead`, `Cliente`)                                     |
| **Campo personalizado** | Fila extra (`city`, `plan`) | Filtros de segmento y `{{variables}}` en plantillas                     |
| **Tema**                | Asunto que acepta recibir   | Consentimiento por tema (Boletín ≠ Promociones)                         |
| **Segmento**            | Búsqueda guardada           | "Tiene etiqueta X **y** acepta marketing **y** está suscrito al tema Y" |
| **Campaña**             | Sello y buzón               | Plantilla + canales + audiencia → **Ejecutar** encola envíos            |

**Orden mental:** contacto → (etiqueta/campo) → tema → segmento → campaña.

<Info>
  **Segmento** responde "¿**quién** está dentro?". **Campaña** responde "¿**qué**, **qué canales** y **cuándo** enviar?". **El tema** responde "¿esta persona **acepta este tipo** de marketing?".
</Info>

## ¿Cuándo usarlo?

Excelente para **campañas**, **CRM integrado**, **personalización** con el nombre del cliente y **cumplimiento de marketing** por tema. Para un **SMS único** a un número que no reutilizarás, puedes enviarlo directamente en la API del canal sin crear un contacto.

## Cómo funciona en la práctica

1. **Registrar** contactos (panel o API), teléfono y/o correo electrónico, únicos en el espacio de trabajo
2. **Organizar** con etiquetas, campos personalizados y temas
3. **Crear segmentos** con reglas (vista previa antes del envío)
4. **Crear campañas** vinculando plantilla, canales y audiencia
5. **Enviar** (Ejecución) o programación, misma cola y créditos que la API de envío

<Note>
  Cada contacto necesita **teléfono o correo electrónico** (o ambos). Duplicado en el espacio de trabajo → **409** (`CONTACT_PHONE_EXISTS`, `CONTACT_EMAIL_EXISTS`).
</Note>

## En la API

* CRUD completo para **contactos, etiquetas, temas, segmentos, campañas**
* Alcances: `contacts:*`, `tags:*`, `topics:*`, `segments:*`, `campaigns:*`
* Las campañas API utilizan **`whatsapp`**, **`sms`**, **`email`**, **`telegram`** (subconjunto de plantilla)

Detalles de la ruta: **Referencia API** en la pestaña Contactos.

## Próximos pasos

* [Inicio rápido](/es/contacts-api/como-funciona/quick-start): primera etiqueta y primer contacto
* [Ámbitos de clave API](/es/contacts-api/como-funciona/escopos-da-api-key): permisos
* [Temas de comunicación](/es/contacts-api/como-funciona/topicos-de-comunicacao): consentimiento por tema
* [Segmentos de audiencia](/es/contacts-api/como-funciona/segmentos-na-audiencia): audiencias dinámicas
* [Campañas del panel](/es/contacts-api/como-funciona/campanhas-no-painel): envío por lotes