Para qué sirve#
Esta página lista todos los datos que Connecto guarda de un contacto y explica cuáles vienen de fábrica, cuáles puedes activar y cuáles puedes crear tú. Para activar, crear o reordenar campos, ve a Configuración de contactos.
Quién puede usarlo#
Todos los usuarios ven y editan los campos activos. Solo un administrador puede activarlos, desactivarlos o crear campos nuevos.
Los tres grupos de campos#
1. Campos básicos (siempre presentes)#
| Campo | Qué es | Notas |
|---|---|---|
| Nombre | Nombre del contacto. | Obligatorio. |
| Tipo de contacto | Clasificación (Cliente, Proveedor, Lead…). | Obligatorio; el tipo de fábrica se llama «CONTACTO». |
| Correo (Email) | Correos del contacto. | Puede tener varios; se muestra el primero. |
| Teléfono | Teléfonos del contacto. | Puede tener varios; se muestra el primero. |
| País | País del contacto. | Si no se indica, se deduce del prefijo del teléfono cuando el contacto entra por WhatsApp o se importa. |
| Idioma | Idioma. | Los contactos nuevos reciben el idioma predeterminado. |
| Moneda | Moneda. | Los contactos nuevos reciben la moneda predeterminada. |
| Estado | ACTIVO, INACTIVO, ELIMINADO (y BLOQUEADO mientras haya un bloqueo vigente). | Por defecto ACTIVO. |
| Fecha de registro | Cuándo se creó el contacto. | Automática; no se edita. |
2. Datos por canal#
Además del correo y el teléfono, un contacto puede tener varias cuentas en cada red:
| Dato | Ejemplo de ayuda en el formulario |
|---|---|
| Teléfono | +57 300 1234567 |
| Correo electrónico | [email protected] |
| Número de WhatsApp | |
| Messenger | Usuario o ID de Messenger |
| @usuario de Instagram | |
| Telegram | @usuario o ID de Telegram |
| TikTok | @usuario de TikTok |
3. Datos que llena el sistema#
| Dato | Qué es |
|---|---|
| Propietario | Asesor responsable. Ver Propietario del contacto. |
| Última actividad | Última interacción del contacto y su tipo. Ver Lista de contactos. |
| Metadatos | Etiquetas asignadas. Ver Metadatos. |
| Notas | Notas de asesores. Ver Ficha del contacto. |
Campos opcionales#
Son campos que vienen incluidos pero apagados por defecto. No se crean ni se eliminan: solo se activan. Un administrador los gestiona en Configuración > Gestión de contactos > Campos opcionales del contacto.
| Campo | Cómo se llena | Regla |
|---|---|---|
| Apellidos | Texto | Hasta 150 caracteres. En la ficha y el chat se muestra junto al nombre. |
| Fecha de nacimiento | Fecha | No puede ser futura ni de más de 130 años atrás. |
| Edad | Lista de 0 a 120 años («0 Años», «1 Año», «2 Años»…) | Si el contacto tiene fecha de nacimiento, la edad se calcula sola y el campo se bloquea con el aviso «Calculada a partir de la fecha de nacimiento.». Sin fecha, la edad se guarda tal como la elijas. |
| Nacionalidad | Lista de países | Debe ser un país del catálogo. |
| Tipo de identificación | Lista | Solo muestra los tipos de documento habilitados (de fábrica: CEDULA DE CIUDADANIA, PASAPORTE, TARJETA DE IDENTIDAD). |
| Número de documento | Texto | Hasta 60 caracteres. |
| Dirección | Texto | Hasta 255 caracteres. |
| Departamento o estado | Lista | Si el contacto tiene país, solo se ofrecen los departamentos de ese país. Un departamento de otro país se rechaza: «Ese departamento no pertenece al país del contacto.» Al cambiar el departamento, la ciudad se vacía si ya no le corresponde. |
| Ciudad o municipio | Lista | Si hay departamento elegido, solo se ofrecen sus ciudades. Una ciudad que no corresponde al departamento o al país se rechaza («Esa ciudad no pertenece al departamento elegido.», «Esa ciudad no pertenece al país del contacto.»). Al elegir una ciudad se completa su departamento. |
Opciones de cada campo opcional#
Cada campo opcional activo tiene cuatro interruptores en Configuración:
| Interruptor | Qué hace | Por defecto |
|---|---|---|
| Activo | Muestra el campo en el formulario, la ficha, la lista (como columna), la importación y la exportación. | Apagado |
| Visible en conversación | Lo muestra en el panel de información del chat. | Encendido |
| Obligatorio | No se puede guardar un contacto sin ese dato. | Apagado |
| Único | El valor no puede repetirse en otro contacto. | Apagado |
Obligatorio y Único solo se ven con el campo activo. Con Edad obligatorio, no se exige si el contacto tiene fecha de nacimiento.
Campos personalizados#
Son los campos propios de tu empresa. Un administrador los crea en Configuración > Gestión de contactos > Campos personalizados.
| Tipo | Qué guarda | Cómo se llena |
|---|---|---|
| Texto | Texto libre (hasta 500 caracteres al editarlo rápido). | Caja de texto |
| Número | Un número, con o sin decimales. | Caja numérica |
| Lista de opciones | Una de las opciones que definas. | Lista; la primera opción vacía dice «— Sin especificar —» |
| Sí / No | Verdadero o falso. | Interruptor (en la ficha, lista con Sí / No) |
Cada campo personalizado tiene estos interruptores:
| Interruptor | Qué hace | Por defecto |
|---|---|---|
| Visible en el área de conversación (panel Información del chat) | Lo muestra al asesor mientras atiende. | Apagado |
| Obligatorio (no se puede guardar un contacto sin este dato) | Exige un valor. No aplica a los de tipo Sí / No. | Apagado |
| Único (el valor no puede repetirse en otro contacto) | Evita valores repetidos. No aplica a los de tipo Sí / No. | Apagado |
- Los campos nuevos quedan al final del orden. Puedes reordenarlos arrastrándolos; ese orden se usa en el formulario, la ficha y las columnas de la lista.
- La clave interna del campo se genera una sola vez a partir del nombre y no cambia aunque después renombres el campo.
- Si eliminas un campo personalizado, se borra también su valor de todos los contactos.
Reglas y comportamientos#
- Los campos opcionales y personalizados activos aparecen como columnas disponibles en la Lista de contactos, en la exportación y en la importación.
- Los campos desactivados dejan de mostrarse, pero sus valores no se borran.
- Las comparaciones de «único» no distinguen mayúsculas ni espacios al inicio o final.
<!-- Fuente: shared/src/Core/ContactOptionalFields.php, shared/src/Core/ContactValidator.php, tenant-app/public/contactos/index.php, tenant-app/public/configuracion/index.php, db/migrations/0008_contactos_extendido.sql, db/migrations/0015_catalogos_contacto.sql, db/migrations/0016_custom_fields_visible_chat.sql, db/migrations/0017_campos_opcionales_contacto.sql, db/migrations/0042_custom_fields_obligatorio_unico.sql, db/migrations/0043_campos_opcionales_opciones.sql -->