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	[email protected]	Validado
Teléfono (WhatsApp)	Número para comunicación vía WhatsApp	Texto / Numérico	[phone]	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	[phone]
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.