Para qué sirve#
Es la pantalla principal del módulo: ves todos los contactos en una tabla, los buscas, los filtras por pestaña, eliges qué columnas mostrar y entras a la ficha de cada uno. Desde aquí también creas contactos, importas y exportas.
Quién puede usarlo y cómo llegar#
- Quién: administradores, supervisores y agentes. Todos ven todos los contactos.
- Cómo llegar: menú lateral > Contactos. El encabezado dice «Gestión de contactos».
La barra superior#
De izquierda a derecha:
| Elemento | Qué hace |
|---|---|
| Lupa (Buscar) | Abre un cuadro flotante para buscar. Cuando hay una búsqueda activa, la lupa muestra un punto verde. |
| Pestañas | Todos los contactos, Mis contactos y Contactos no asignados, cada una con su cantidad. |
| Icono de columnas (Columnas) | Elige qué columnas ver y en qué orden. |
| Ejecutar acción masiva | Aparece solo cuando hay contactos seleccionados. Ver Acciones masivas. |
| Importar Excel | Abre el asistente de importación. Ver Importar contactos. |
| Exportar | Descarga la lista a Excel. Ver Exportar contactos. |
| Nuevo | Abre el formulario «Agregar contacto». Ver Crear y editar contactos. |
Pestañas#
| Pestaña | Qué muestra |
|---|---|
| Todos los contactos | Todos los contactos. |
| Mis contactos | Los contactos cuyo propietario eres tú. |
| Contactos no asignados | Los contactos sin propietario. |
- Las cantidades de las tres pestañas se recalculan con la búsqueda que tengas activa.
- Connecto recuerda la última pestaña que usaste en tu navegador. También puedes abrir una directamente con la dirección
/contactos?vista=mios(todos,miososin). - Los contactos que se fusionaron dentro de otro no aparecen en la lista: se ve solo el contacto principal. Ver Duplicados y fusión.
ELIMINADO. Para verlos u ocultarlos como columna, usa la columna Estado (está oculta por defecto).Búsqueda#
- Haz clic en la lupa.
- Escribe en el cuadro «Buscar por nombre, correo o teléfono...». La lista se actualiza sola poco después de dejar de escribir.
- Para limpiar, usa la X del cuadro. Con Enter o Esc se cierra el cuadro (la búsqueda sigue aplicada).
Cómo busca:
- Compara contra el nombre, los apellidos, el número de documento, los correos y los teléfonos del contacto.
- No distingue mayúsculas ni tildes.
- Los teléfonos se encuentran escritos como quieras:
+57 313-282 2000y573132822000dan el mismo resultado. - Puedes escribir varias palabras: el contacto debe contener todas (hasta 8 palabras; el texto se recorta a 120 caracteres).
Mensajes cuando no hay resultados:
| Situación | Mensaje |
|---|---|
| Hay una búsqueda sin coincidencias | «No hay contactos que coincidan con la búsqueda.» |
| «Mis contactos» vacía | «No tienes contactos asignados.» |
| «Contactos no asignados» vacía | «No hay contactos sin asignar.» |
| Otro caso vacío | «No hay contactos.» |
| Todavía no existe ningún contacto | «Todavía no hay contactos.» |
Columnas#
La tabla permite mostrar u ocultar columnas y cambiarlas de orden. Tu elección se guarda por usuario.
Columnas disponibles#
| Columna | Qué muestra | Visible por defecto |
|---|---|---|
| Nombre | Nombre del contacto, tal como está guardado. Si no tiene, «(sin nombre)». | Sí |
| Tipo | Etiqueta con el color del tipo de contacto. | Sí |
| Canales | Un icono por canal: WhatsApp, Messenger, Instagram, Telegram, correo y llamada. El icono se enciende (con el color de su red) si el contacto tiene ese canal; si no, al pasar el cursor dice «(no tiene)». Correo y llamada se calculan a partir de su correo y su teléfono. | Sí |
| Correo | El primer correo del contacto. | Sí |
| Teléfono | El primer teléfono del contacto. | Sí |
| Propietario | Nombre del asesor responsable, o «Sin asignar». | Sí |
| Última actividad | Hace cuánto fue la última interacción y de qué tipo (ver abajo). | Sí |
| Oportunidad | Etapa de la oportunidad abierta del contacto, o «—». | No |
| País, Idioma, Moneda | Nombre del país, idioma o moneda. | No |
| Registrado | Fecha de registro, por ejemplo «Ene 25, 2026» (en la zona horaria de la empresa). | No |
| Campos opcionales activos | Una columna por cada campo opcional que hayas activado (Apellidos, Fecha de nacimiento, Edad, etc.). | No |
| Campos personalizados | Una columna por cada campo personalizado activo. Los de tipo Sí / No muestran «Sí» o «No». | No |
| Estado | ACTIVO, INACTIVO, ELIMINADO o BLOQUEADO, con un punto de color. Siempre va como última columna por defecto. | No |
Cambiar las columnas#
- Haz clic en el icono de columnas. Se abre el menú Columnas.
- Marca o desmarca cada columna para mostrarla u ocultarla.
- Arrastra una fila por su asa (puntos verticales) para cambiar el orden.
- Para volver a la configuración original, pulsa Restablecer.
Última actividad#
Muestra el tiempo transcurrido («ahora», «hace 5 minutos», «hace 2 días», «hace 3 semanas», «hace 1 mes», «hace 1 año») y un icono según el tipo. Al pasar el cursor ves el tipo y la fecha exacta. Los tipos son:
| Tipo | Significado |
|---|---|
| Mensaje del contacto | El contacto escribió. |
| Mensaje del equipo | Un asesor escribió. |
| Llamada | Hubo una llamada. |
| Correo recibido / Correo enviado | Un correo entró o salió. |
| Nota | Un asesor agregó una nota. |
Los mensajes automáticos del sistema no cuentan como actividad.
Iconos junto a los tres puntos#
Si el contacto tiene ahora mismo una conversación abierta, aparece a la izquierda del botón de opciones el icono de la red (hasta dos). Se actualiza solo cada pocos segundos: cuando la conversación se cierra, el icono desaparece. Al pasar el cursor dice «Conversación abierta por WhatsApp» (o la red que sea). El chat web se muestra como «Chat web».
Ordenar y paginar#
- Orden: fijo, del contacto registrado más recientemente al más antiguo. No se puede ordenar por otras columnas.
- Paginación: abajo a la derecha eliges Mostrar 20, 50 o 100 por página. Hay botones de anterior y siguiente, un indicador «Página X de Y» y un cuadro «Ir a…» para saltar a una página.
- A la izquierda ves «Mostrando 1–20 de 340» (o «Sin resultados»).
Seleccionar contactos#
- Marca la casilla de cada fila para seleccionar.
- La casilla del encabezado selecciona la hoja. Si hay más de una hoja, Connecto pregunta: «La lista contiene N registros distribuidos en N hojas. ¿Te gustaría seleccionar únicamente los de la hoja actual o todos los registros de todas las hojas?», con las opciones Solo los N registros de esta hoja, Todos los N registros de todas las hojas y Cancelar.
- Con la selección activa, abajo a la izquierda verás «N seleccionados» (y «(todos los que coinciden)» si elegiste todas las hojas) y el enlace Quitar selección.
- Con selección, aparece el menú Ejecutar acción masiva. Ver Acciones masivas.
Menú de cada fila (tres puntos)#
| Opción | Qué hace |
|---|---|
| Editar contacto | Abre el formulario de edición. |
| Eliminar registro | Pide confirmar («Estás a punto de eliminar a «Nombre». ¿Deseas continuar?») y marca al contacto como ELIMINADO. |
Haz clic en cualquier otra parte de la fila para abrir la Ficha del contacto.
Reglas y comportamientos#
- La lista está pensada para cientos de miles de contactos: solo se cargan las filas de la hoja que ves.
- Si la lista no carga, aparece «No se pudo cargar la lista. Revisa tu conexión o recarga la página.»
- El filtro por estado existe en el sistema pero no se muestra en la pantalla; la lista siempre trae todos los estados.
Filtrar por tipo de contacto#
En el encabezado de la columna Tipo hay un icono de filtro (un embudo). Al pulsarlo se abre un menú flotante con Todos los tipos y cada tipo de contacto (por ejemplo, CONTACTO y CLIENTES) con su color. Marca los tipos que quieras ver, o Todos los tipos para quitar el filtro; la lista se actualiza al instante. El icono se pone azul mientras hay un filtro activo.
El filtro se aplica junto con la búsqueda y la pestaña elegida (Todos, Mis contactos, No asignados): los contadores de las pestañas muestran cuántos hay con ese filtro, y Exportar y las acciones masivas sobre «todos los que coinciden» respetan los tipos elegidos.
<!-- Fuente: tenant-app/public/contactos/index.php, shared/src/Core/ContactosLista.php, shared/src/Core/ContactMerge.php, db/migrations/0113_contactos_busqueda.sql, db/migrations/0098_contactos_propietario_actividad.sql, tenant-app/public/api/contactos_redes_abiertas.php, tenant-app/public/api/user_pref.php -->