# 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.hablla.com/hablla-docs-es/datos/personas.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.