# Personas

## Entidad: Personas

### 1. Visión General

La entidad **Personas** es el núcleo del modelado de datos de Hablla y representa a cualquier individuo con el que la organización interactúa — ya sea cliente, prospecto, lead, socio o contacto interno.

En el contexto del **MCI (Marketing Conversacional Integrado)**, *Personas* es la base para centralizar y unificar interacciones en múltiples canales, asegurando que cada conversación sea **contextual, personalizada y orientada por datos**.

***

### 2. Objetivos de la Entidad

* **Unificar datos de contacto** de múltiples canales en un registro único.
* **Historial consolidado de interacciones** para una visión 360º de la relación.
* **Activar la personalización** en campañas, flujos y atenciones.
* **Soportar el cumplimiento** con la LGPD y la gobernanza de datos.

***

### 3. Atributos y Campos Predeterminados

| Campo                          | Descripción                                           | Tipo de Dato               | Ejemplo                                | Observaciones            |
| ------------------------------ | ----------------------------------------------------- | -------------------------- | -------------------------------------- | ------------------------ |
| **ID Interno**                 | Identificador único generado por la plataforma Hablla | UUID                       | `3f9c2b...`                            | No editable              |
| **Nombre Completo**            | Nombre del individuo                                  | Texto                      | `João da Silva`                        | Obligatorio              |
| **Correo electrónico**         | Dirección electrónica                                 | Texto / Correo electrónico | `joao@email.com`                       | Validado                 |
| **Teléfono (WhatsApp)**        | Número para comunicación vía WhatsApp                 | Texto / Numérico           | `+55 11 91234-5678`                    | Formato E.164            |
| **Identificador de Instagram** | ID del perfil de Instagram                            | Texto                      | `17841405793187218`                    | Obtenido vía API         |
| **Identificador de Facebook**  | ID del perfil de Facebook                             | Texto                      | `1000123456789`                        | Obtenido vía API         |
| **Telegram ID**                | ID único del contacto en Telegram                     | Texto                      | `123456789`                            | Obtenido vía Bot         |
| **Teléfono (voz)**             | Número para llamadas telefónicas                      | Texto / Numérico           | `+55 21 99876-5432`                    |                          |
| **Historial de Interacciones** | Registro completo de mensajes, llamadas y actividades | Registro                   | —                                      | Actualización automática |
| **Etiquetas**                  | Etiquetas para segmentación                           | Lista de texto             | `["Cliente VIP", "Black Friday 2025"]` | Libre                    |
| **Fuente de Adquisición**      | Origen del contacto                                   | Texto                      | `Campaña WhatsApp Ads`                 |                          |
| **Estado de Consentimiento**   | Indica si hay autorización para comunicaciones        | Booleano                   | `true`                                 | Compatible con LGPD      |

***

### 4. Relaciones con Otras Entidades

| Entidad            | Tipo de Relación | Descripción                                                                               |
| ------------------ | ---------------- | ----------------------------------------------------------------------------------------- |
| **Organizaciones** | N:N              | Una Persona puede estar asociada a múltiples Organizaciones (y viceversa).                |
| **Tarjetas**       | 1:N              | Una Persona puede estar vinculada a varias Tarjetas (oportunidades, tickets, atenciones). |
| **Tareas**         | 1:N              | Una Persona puede tener Tareas asociadas directa o indirectamente.                        |

***

### 5. Reglas de Negocio

1. **Identificación Multicanal**
   * Cada canal posee su identificador único (p. ej., Instagram ID, teléfono de WhatsApp).
   * El mismo individuo puede tener diferentes IDs por canal.
2. **Unificación de Registros**
   * La fusión de registros duplicados debe seguir reglas de priorización de datos (última actualización > más completa).
3. **Historial Inmutable**
   * Las interacciones registradas no pueden borrarse, solo ocultarse por cuestiones de cumplimiento.
4. **Consentimiento Obligatorio**
   * Las comunicaciones proactivas requieren estado de consentimiento `true`.

***

### 6. Ejemplos de Uso

* **Marketing**: Segmentación de leads que interactuaron en Instagram en los últimos 30 días.
* **Ventas**: Identificación de decisores vinculados a una misma Organización.
* **CX**: Recuperar historial completo de un cliente antes de una llamada de soporte.

***

### 7. Buenas Prácticas

* **Actualizar datos** siempre que una nueva interacción aporte información más precisa.
* **Usar etiquetas estandarizadas** para facilitar la segmentación.
* **Evitar duplicados** por importación de listas no tratadas.
* **Mantener el consentimiento** revisado periódicamente para evitar bloqueos de campañas.

***

### 8. Consideraciones de Seguridad y LGPD

* Almacenar solo los datos necesarios para la operación.
* Garantizar que las solicitudes de eliminación de datos se traten dentro del plazo legal.
* Registrar logs de cambios y accesos al perfil de la Persona.