Para qué sirve#
Los metadatos son etiquetas que se asignan a los contactos para registrar lo que sabes de ellos más allá de sus datos básicos, por ejemplo «Interesado en cursos», «Pidió cotización» o «Presupuesto alto». Un contacto puede tener varios a la vez. También sirven como audiencia de una difusión y como clasificación al importar.
Quién puede usarlo y cómo llegar#
| Tarea | Quién | Dónde |
|---|---|---|
| Crear, editar y eliminar metadatos | Solo administradores | Configuración > Metadatos |
| Asignar o quitar metadatos de un contacto | Cualquier usuario | Panel de información del chat (sección Metadatos) o acción masiva |
El menú Metadatos está en Configuración (antes se llamaba «Etiquetas»).
Crear y administrar metadatos#
En Configuración > Metadatos ves una tabla con Color, Nombre, Descripción y Análisis con IA («Definido» si el metadato tiene instrucción de análisis). Botón Agregar metadato.
| Campo | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Nombre | Nombre del metadato. Obligatorio y único. | Hasta 100 caracteres. Placeholder: «Ej. Presupuesto, Ciudad de interés» | Vacío |
| Descripción | Qué representa y para qué se usa. | Hasta 1000 caracteres | Vacía |
| Color | Para reconocerlo de un vistazo. | Selector o código hexadecimal #RRGGBB | #10B981 |
| Instrucción de análisis con IA | Criterio para que la IA lo asigne. | Hasta 4000 caracteres | Vacía |
Paso a paso#
- Ve a Configuración > Metadatos y pulsa Agregar metadato.
- Completa nombre, descripción y color.
- Pulsa Guardar. Mensaje: «Metadato creado.» (al editar: «Metadato guardado.»).
Para editar usa el icono de lápiz de la fila; para eliminar, la papelera (pide confirmar «¿Eliminar el metadato "X"?»).
Reglas#
- Si el nombre ya existe: «Ya existe un metadato con ese nombre.» Sin nombre: «El nombre del metadato es obligatorio.»
- No se puede eliminar un metadato asignado a algún contacto: «No se puede eliminar: el metadato está asignado a N contacto(s). Quítalo de los contactos primero.»
- Si no eres administrador y envías cambios: «Solo un administrador puede modificar esta configuración.»
Cómo se asignan los metadatos a un contacto#
Hay tres orígenes, y cada asignación guarda quién la hizo y cuándo:
| Origen | Cómo se asigna | Etiqueta que verás |
|---|---|---|
| Asesor | A mano desde el panel de información del chat, con la acción masiva Asignar metadato, o al importar contactos. | «Asesor» |
| Sistema | Un proceso automático. | «Sistema» |
| Asistente de IA | La IA lo asigna al analizar la conversación, siguiendo la instrucción de análisis del metadato. | «Asistente de IA» |
Un metadato no se puede asignar dos veces al mismo contacto: «Ese metadato ya está asignado al contacto.»
Asignar desde el panel de información del chat#
- En el Chat, abre la conversación del contacto.
- En el panel de información, sección Metadatos, pulsa AGREGAR.
- Elige un metadato del menú. Si ya tiene todos: «Ya tiene asignados todos los metadatos configurados.»; si no hay ninguno: «Aún no hay metadatos configurados. Créalos en Configuración > Metadatos.»
- Verás «Metadato agregado». Cada metadato muestra su color, nombre, un distintivo de origen y «Asignado por Nombre · fecha».
Para quitar uno, pulsa la X del metadato y confirma «¿Quitar el metadato «X» de este contacto?». Mensaje: «Metadato quitado». Cualquier usuario puede quitar metadatos.
Si el metadato lo asignó el sistema o la IA, se guarda y se muestra un párrafo que explica por qué se asignó, generado automáticamente. Incluye quién lo asignó y cuándo, la conversación de origen si la hay, qué representa el metadato, y el motivo registrado o el criterio de análisis.
Asignar a muchos contactos#
Con la acción masiva Asignar metadato (ver Acciones masivas) o en el paso Clasificar de la importación.
Dónde se ven#
- Panel de información del contacto (chat y correo), sección Metadatos.
- Evento «Metadato asignado: X» en la actividad del contacto (con «Por [nombre]» y «(IA)» o «(sistema)»).
- Como audiencia al crear una difusión (todos los contactos que tengan ciertos metadatos).
Asignación por IA#
La IA puede asignar un metadato al analizar la conversación de un contacto, siempre que:
- El módulo Análisis y asistencia IA esté activo en Configuración > Preferencias.
- Esté configurado el proveedor de IA (proveedor, modelo y API key) en Configuración IA.
- El análisis de metadatos esté activado en Configuración IA.
- El metadato tenga una instrucción de análisis que describa cómo identificarlo (por ejemplo: «Asígnalo si el contacto pregunta por precios»).
Mientras no se cumplan 1 a 3, el campo de instrucción aparece deshabilitado con el aviso «La instrucción de análisis con IA está deshabilitada. Configura la inteligencia artificial y activa el análisis de metadatos en Configuración IA para poder definirla.» Si la IA ya está lista pero falta el análisis: «Activa el análisis de metadatos con IA en Configuración IA…»; al editar un metadato en ese estado, su instrucción anterior se conserva.
Más detalles de la configuración en Configuración IA.
<!-- Fuente: tenant-app/public/configuracion/index.php, shared/src/Core/ContactMetadatos.php, tenant-app/public/api/contact_metadatos.php, tenant-app/public/api/contactos_masivo.php, tenant-app/public/internal/metadato_asignar.php, shared/js/chat.js, shared/js/info-panel.js, tenant-app/views/partials/info_panel.php, tenant-app/public/api/contact_dashboard.php, shared/i18n/es.php -->