Para qué sirve#
Aquí defines qué datos guardas de cada contacto: los tipos de contacto, los campos opcionales que quieres activar, los campos personalizados propios de tu empresa y los catálogos (tipos de documento, países, departamentos, ciudades, idiomas y monedas). Los metadatos tienen su propia página: Metadatos.
Quién puede usarlo y cómo llegar#
- Quién: solo administradores (todo Configuración está limitado a administradores).
- Gestión de contactos: menú del avatar > Ajustes de sistema > Gestión de contactos. Muestra, una debajo de otra, tres tarjetas: Tipos de contacto, Campos opcionales del contacto y Campos personalizados.
- Catálogos: Configuración general > Datos maestros (sub-pestaña con cuadros grandes): Tipos de documento, Países, departamentos y ciudades, Idiomas y Monedas. Ver también Datos maestros.
Los cambios de esta sección se guardan con sus propios botones Guardar (formularios) o, en los interruptores, de inmediato; la pantalla se recarga y muestra un aviso.
Tipos de contacto#
Clasifican a las personas y empresas (Cliente, Proveedor, Lead…). Cada contacto tiene un tipo, que se elige al crearlo o editarlo, y sirve para organizar la lista y para armar la audiencia de las difusiones. El color es el fondo de la etiqueta del tipo, visible en la lista y en la ficha del chat.
La tabla muestra Nombre, Color, En uso («N contacto(s)») y las acciones editar y eliminar.
| Campo | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Nombre | Nombre del tipo. Obligatorio y único. | Texto. Ejemplo: «Cliente, Proveedor, Lead» | Vacío |
| Color | Fondo de la etiqueta. | Selector o código #RRGGBB | #10B981 |
- Botón Agregar tipo. Mensajes: «Tipo de contacto guardado.», «El nombre del tipo de contacto es obligatorio.»
- Un tipo en uso se puede renombrar o cambiar de color. Solo se puede eliminar cuando ningún contacto lo usa (el botón de eliminar no aparece mientras tenga contactos). Si aun así falla: «No se puede eliminar: hay contactos usando este tipo.» Eliminado: «Tipo de contacto eliminado.»
- De fábrica existe un único tipo: CONTACTO (color
#10B981). - Al crear contactos, el tipo preseleccionado es el primero de la lista (el de menor número de creación).
Campos opcionales del contacto#
Se suman a los campos obligatorios de fábrica (Nombre, Tipo de contacto, Email, Teléfono, País, Idioma, Moneda, Estado y Fecha de registro). No se crean ni se eliminan: solo se activan. Los activos aparecen en el formulario de contactos, la ficha, la lista y el panel de información del chat. Si activas «Fecha de nacimiento», la edad se calcula sola.
La tabla tiene una fila por campo y cuatro interruptores:
| Columna | Qué hace | Por defecto |
|---|---|---|
| Activo | Activa o desactiva el campo. | Apagado en los nueve campos |
| Visible en conversación | Muestra el campo en el panel de información del chat. | Encendido (solo se ve con el campo activo) |
| Obligatorio | No se puede guardar un contacto sin este dato. | Apagado |
| Único | El valor no puede repetirse en otro contacto. | Apagado |
Los campos son, en este orden: Apellidos, Fecha de nacimiento, Edad, Nacionalidad, Tipo de identificación, Número de documento, Dirección, Departamento o estado y Ciudad o municipio. Qué guarda cada uno: Campos del contacto.
Mensaje al cambiar un interruptor: «Campo actualizado.»
Campos personalizados#
Datos propios de tu negocio (empresa, plan contratado, si autorizó el uso de sus datos…). Aparecen en el formulario, la ficha, la lista (como columnas) y el panel del chat si lo marcas.
Cada fila de la lista muestra el nombre, el tipo (text, number, select, switch) y etiquetas «Obligatorio», «Único», «Visible en conversación» y, en las listas, «N opción(es)». Arrastra con el icono de puntos para reordenar; el orden se guarda al soltar.
Crear un campo#
- Pulsa Agregar campo.
- Completa el cuadro «Agregar campo personalizado» (tabla de abajo) y pulsa Guardar. Mensaje: «Campo personalizado creado.» (al editar: «Campo personalizado guardado.»).
| Campo | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Nombre del campo | Etiqueta que ve el usuario. Obligatorio. | Texto. Ejemplo: «Empresa, Fecha de nacimiento» | Vacío |
| Tipo de campo | Cómo se llena. | Texto, Número, Lista de opciones, Sí / No | Texto |
| Opciones | Opciones de la lista (solo para «Lista de opciones»). | Botón Agregar opción; las opciones vacías se descartan | Sin opciones |
| Visible en el área de conversación (panel Información del chat) | Lo muestra al asesor mientras atiende. | Interruptor | Apagado |
| Obligatorio (no se puede guardar un contacto sin este dato) | Exige un valor. | Interruptor | Apagado |
| Único (el valor no puede repetirse en otro contacto) | Evita repetidos. | Interruptor | Apagado |
Reglas:
- Sin nombre: «El nombre del campo es obligatorio.»
- El tipo se puede cambiar al editar, pero los valores ya guardados no se convierten.
- La clave interna se genera una vez a partir del nombre (en minúsculas, con guiones bajos) y nunca cambia.
- Eliminar un campo (papelera, con confirmación «¿Eliminar este campo? También se borrará su valor de todos los contactos.») borra su valor de todos los contactos. Mensaje: «Campo personalizado eliminado.»
Catálogos (Datos maestros)#
Los contactos guardan el código del país, idioma o moneda; por eso un elemento en uso no se puede eliminar, y si cambias su código, los contactos que lo usaban lo siguen.
Tipos de documento#
Opciones del campo «Tipo de identificación». Columnas: Nombre, Habilitado, y acciones.
| Dato | Valores | Por defecto |
|---|---|---|
| Nombre | Hasta 80 caracteres | De fábrica: CEDULA DE CIUDADANIA, PASAPORTE, TARJETA DE IDENTIDAD |
| Habilitado | Interruptor. Solo los habilitados aparecen en las listas. | Encendido |
Se eliminan solo si ningún contacto los usa: «No se puede eliminar: N contacto(s) usan este tipo de documento. Puedes deshabilitarlo en su lugar.»
Países, departamentos y ciudades#
Una vista de tres columnas: elige un país para ver sus departamentos o provincias, y un departamento para ver sus ciudades o municipios. Los botones Agregar de departamentos y ciudades se habilitan al elegir el país o departamento correspondiente.
| Elemento | Datos | Reglas |
|---|---|---|
| País | Código (2 a 5 letras, ejemplo CO, MX, US), Nombre (hasta 120), Indicativo (solo dígitos, hasta 6, sin el +), Zona horaria (ejemplo America/Bogota; define la hora local del contacto en el chat) | El indicativo permite deducir el país de quien escribe por WhatsApp y llena el selector de prefijos del formulario. No se elimina si tiene contactos, departamentos o contactos con esa nacionalidad. |
| Departamento / Provincia | País, Nombre (hasta 120) | No se elimina si tiene ciudades o contactos. |
| Ciudad / Municipio | Departamento, Nombre (hasta 120) | No se elimina si algún contacto la usa. |
De fábrica hay 30 países (Colombia, México, Estados Unidos, Canadá, España, Argentina, Chile, Perú, Ecuador, Venezuela, Bolivia, Paraguay, Uruguay, Brasil, Panamá, Costa Rica, Guatemala, El Salvador, Honduras, Nicaragua, Cuba, República Dominicana, Puerto Rico, Reino Unido, Francia, Alemania, Italia, Portugal, China e India) y los 33 departamentos de Colombia con su ciudad principal.
Idiomas y monedas#
| Catálogo | Datos | Por defecto de fábrica |
|---|---|---|
| Idiomas | Código (ejemplo es, en, pt), Nombre (hasta 80) | Español (predeterminado), Inglés, Portugués, Francés, Alemán, Italiano |
| Monedas | Código (3 a 10 letras: COP, USD, EUR), Nombre (hasta 80), Símbolo (hasta 8) | Peso colombiano (predeterminada), Dólar estadounidense, Euro, Peso mexicano, Peso argentino, Peso chileno, Sol peruano, Real brasileño, Libra esterlina, Dólar canadiense |
- El predeterminado se asigna a los contactos nuevos. Para cambiarlo, pulsa Usar por defecto en otra fila.
- No se puede eliminar el predeterminado: «No se puede eliminar el idioma predeterminado: define otro como predeterminado primero.»
- Un elemento en uso: «No se puede eliminar: hay N contacto(s) usando X.»
- Código duplicado: «Ya existe un país con el código X.» (igual para idioma y moneda).
- Código mal escrito: «Código inválido: usa el código de país de 2 letras (CO, MX, US…).» (o de idioma / de moneda).
- Zona horaria inválida: «Zona horaria inválida (ej. America/Bogota).»
Metadatos#
Se administran en Configuración > Metadatos. Ver Metadatos.
Otros ajustes que afectan a los contactos#
| Ajuste | Dónde | Por defecto |
|---|---|---|
| Propietario automático del contacto | Configuración > Oportunidades | Encendido |
| Módulo Oportunidades (columna Oportunidad, fila en la ficha, pestaña Pipeline) | Configuración > Preferencias | Apagado de fábrica |
| Exigir consentimiento y texto del pie de baja | Configuración > Gestión de difusión | Encendido |
| Aviso de bloqueo al contacto | Configuración > Sesiones de chat > Bloqueo | Encendido |
| Contenidos de terceros | Configuración > Preferencias | Ninguno |
<!-- Fuente: tenant-app/public/configuracion/index.php, shared/src/Core/ContactOptionalFields.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, db/migrations/0098_contactos_propietario_actividad.sql, db/migrations/0060_bloqueo_mensaje.sql -->