Contactos

El módulo de Contactos es el núcleo de FusionCRM. Aquí gestionas toda tu base de clientes, prospectos y leads con campos estándar y personalizados.

Vista general

El directorio de contactos muestra una tabla paginada con todos tus contactos. Puedes:

• Buscar contactos por nombre, email, teléfono o empresa (mínimo 3 caracteres; los espacios de más no afectan: "Juan Acosta" encuentra "Juan Acosta")
• Ordenar columnas haciendo clic en los encabezados
• Filtrar por campos estándar y personalizados
• Ver el puntaje de lead scoring de cada contacto
• Acceder al perfil completo de cualquier contacto
• Exportar la lista a CSV (solo propietarios de la organización)

Nota

Los contactos son visibles por todos los usuarios de la organización por defecto. El administrador puede configurar permisos granulares desde Configuración → Usuarios.

Nota

Al guardar un contacto (a mano, por importación, formulario o API) los valores se guardan sin espacios al inicio ni al final.

CRUD de contactos

Crear contacto

Para crear un contacto nuevo:

1
Haz clic en "+ Nuevo contacto"
Botón en la esquina superior derecha del directorio.
2
Completa los campos básicos
Nombre (requerido), apellido, correo electrónico, teléfono, empresa y cargo.
3
Agrega campos personalizados
Si tu organización tiene campos adicionales configurados, aparecerán en el formulario.
4
Guarda el contacto
Haz clic en "Guardar" para crear el contacto en el directorio.

Campos estándar disponibles

Campo	Tipo	Requerido
Nombre	Texto	Sí
Apellido	Texto	No
Email	Email	No
Teléfono	Teléfono	No
Empresa	Texto	No
Cargo	Texto	No
Ciudad	Municipio del catálogo DANE	No
Departamento	Se completa solo con la ciudad	No
País	Selección	No
Notas	Texto largo	No
Propietario	Usuario	Auto-asignado

Consejo

Puedes crear contactos directamente desde una conversación de WhatsApp o email. Al recibir un mensaje de un número desconocido, aparece el botón "Crear contacto".

Editar contacto

Para editar un contacto existente:

1. Haz clic en el nombre del contacto en el directorio
2. En el perfil del contacto, haz clic en el ícono de lápiz (✏️) junto a cualquier campo
3. Edita el campo directamente (edición inline) o usa el botón "Editar perfil"
4. Los cambios se guardan automáticamente al salir del campo

Nota

El perfil de contacto también muestra el historial de deals, facturas, cotizaciones, conversaciones y actividades asociadas a ese contacto.

Eliminar contacto

Para eliminar un contacto:

1. Abre el perfil del contacto
2. Haz clic en el menú de opciones (⋮) en la esquina superior derecha
3. Selecciona "Eliminar contacto"
4. Confirma la acción en el diálogo de confirmación

Importante

Eliminar un contacto es una acción irreversible. Se eliminará el contacto y todas sus relaciones (deals, notas, actividades). Las conversaciones y facturas asociadas no se eliminan.

Ciudad y departamento

La ciudad se elige de la lista oficial de municipios de Colombia (DANE). Al escribir aparecen sugerencias como "Medellín — Antioquia"; al elegir una, el departamento se completa solo. Así no hay "BOGOTA" y "Bogotá D.C." como si fueran dos ciudades, y los filtros por ciudad o por departamento traen a todos.

• Si escribes una ciudad sin elegirla de la lista, se guarda igual y el contacto la muestra como "sin confirmar" (por ejemplo, "Rionegro · sin confirmar", porque hay un Rionegro en Antioquia y otro en Santander).
• La lista dinámica "Ciudades sin confirmar" reúne esos contactos para corregirlos cuando quieras.
• Para contactos de otro país la ciudad es texto libre.

Por API: city, cityCode, state y stateCode

cityCode	Código DANE del municipio, 5 dígitos (05001 = Medellín). Es la fuente de verdad: si lo envías, se derivan los otros tres.
city	Nombre de la ciudad. Enviado solo, debe corresponder sin ambigüedad a un municipio.
state	Departamento en texto. Lo deriva el servidor; enviado sirve de pista para desambiguar city.
stateCode	Código DANE del departamento (05 = Antioquia). Siempre lo calcula el servidor; el valor enviado se ignora.

En la API la ciudad es estricta: si city es ambigua, está mal escrita o no existe, la respuesta es 422 CITY_UNRESOLVED con los candidates posibles y no se guarda nada; reenvía con el cityCode que corresponda. Un cityCode inexistente responde 400 INVALID_CITY_CODE. Busca el código con GET /api/catalogs/municipalities?q=medellin.

Consejo

Ejemplos, caché del catálogo y el comportamiento de formularios e importación en Ciudades: catálogo DANE.

Campos personalizados

Los campos personalizados permiten almacenar información específica de tu negocio que no está en los campos estándar.

Tipos de campos disponibles:

Texto

Cadena de texto libre

Número

Valores numéricos

Fecha

Selector de fecha

Booleano

Sí / No

Selección

Lista desplegable

Multi-selección

Múltiples opciones

Dirección de email

Teléfono

Número de teléfono

URL

Dirección web

Para crear un campo personalizado, ve a Configuración → Campos de contacto → Nuevo campo.

Consejo

Los campos personalizados también se pueden usar como criterios de filtro en el directorio de contactos y para segmentar listas para campañas masivas.

Listas y segmentos

Las listas de contactos te permiten agrupar contactos según criterios específicos para enviarles campañas masivas o gestionar segmentos de clientes.

Crear una lista

1. Ve a Contactos → Listas
2. Haz clic en "+ Nueva lista"
3. Asigna un nombre descriptivo a la lista
4. Agrega contactos manualmente o filtra por criterios
5. Guarda la lista

Nota

Las listas son estáticas por defecto: no se actualizan automáticamente cuando nuevos contactos cumplen los criterios. Para segmentación dinámica, usa los filtros avanzados al momento de crear campañas.

Importar contactos

Puedes importar contactos masivamente desde un archivo CSV. Esto es ideal para migrar desde otro CRM o cargar una base de datos existente.

Proceso de importación

1
Prepara el archivo CSV
El archivo debe tener encabezados en la primera fila. Descarga la plantilla de ejemplo desde el módulo de importación.
2
Ve a Contactos → Importar
Haz clic en el botón de importación en el directorio de contactos.
3
Sube el archivo
Arrastra el archivo CSV al área de carga o haz clic para seleccionarlo.
4
Mapea los campos
Asocia las columnas de tu CSV con los campos de FusionCRM. Los campos estándar se detectan automáticamente.
5
Revisa y confirma
FusionCRM mostrará una vista previa de los primeros registros. Confirma para iniciar la importación.

Formato CSV recomendado:

nombre,apellido,email,telefono,empresa,ciudad
Juan,García,juan@empresa.com,3001234567,Mi Empresa,Bogotá
María,López,maria@empresa.com,3109876543,Otra Empresa,Medellín

Advertencia

Los contactos con el mismo email que ya existen en el sistema serán actualizados, no duplicados. Verifica tu CSV antes de importar para evitar sobreescribir datos existentes.

Filtros avanzados

Los filtros avanzados permiten segmentar la vista del directorio según múltiples criterios combinados con operadores lógicos (AND/OR).

Campos filtrables

• Todos los campos estándar (nombre, email, empresa, ciudad, país)
• Todos los campos personalizados
• Fecha de creación y última actualización
• Propietario asignado
• Puntaje de lead scoring
• Lista de contactos a la que pertenece
• Tiene deals activos
• Última actividad

Consejo

Guarda los filtros frecuentes como "vistas" haciendo clic en "Guardar vista" después de configurar tus filtros. Esto te permitirá acceder rápidamente a segmentos de contactos que revisas regularmente.

KPIs de contacto

El perfil de cada contacto incluye indicadores clave de desempeño (KPIs) que muestran el historial y valor de ese contacto para el negocio:

Deals activos

Negocios en proceso

Valor total

Suma de deals ganados

Facturas

Total facturado

Último contacto

Fecha de última interacción

Primeros Pasos

Empresas