Para qué sirve#
Descargar a un archivo de Excel los contactos de la lista, con la búsqueda y la pestaña que tengas aplicadas.
Quién puede usarlo y cómo llegar#
- Quién: administradores y supervisores exportan cualquier pestaña. Un agente solo exporta sus contactos (la pestaña «Mis contactos»), aunque esté viendo otra.
- Cómo llegar: Contactos > botón Exportar (ayuda: «Exportar a Excel los contactos de la lista (con el filtro actual)»).
Paso a paso#
- En Contactos, elige la pestaña (Todos los contactos, Mis contactos o Contactos no asignados) y, si quieres, escribe una búsqueda.
- Pulsa Exportar.
- Connecto cuenta los contactos y pregunta: «Se exportarán N contactos (todos los contactos).» El texto cambia según el caso: «tus contactos», «los contactos sin asignar» y, si hay búsqueda, «que coinciden con «texto»».
- Con más de 30.000 contactos agrega: «Es una lista grande: armar el archivo puede tardar uno o dos minutos. No cierres esta pestaña.»
- Pulsa Exportar. Aparece el aviso «Armando el archivo de N contactos…» y al terminar se descarga
contactos_AAAA-MM-DD.xlsx.
Mensajes posibles:
| Mensaje | Cuándo |
|---|---|
| «No hay contactos para exportar con el filtro actual.» | La lista filtrada está vacía. |
| «No se pudo preparar la exportación» | Falló el conteo. |
| «El servidor no pudo armar el archivo.» | Falló la generación. El aviso se titula «No se pudo exportar». |
Qué trae el archivo#
Una sola hoja llamada «Contactos», con los títulos en negrita y la primera fila fija. Columnas:
| Columna | Contenido |
|---|---|
| ID | Número interno del contacto. |
| Nombre, Apellidos | Apellidos sale siempre (queda vacío si el campo opcional no se usa). |
| Tipo, Estado | Tipo de contacto y estado del registro. |
| Correo, Otros correos | El primer correo y, separados por coma, los demás. |
| Teléfono, Otros teléfonos | Igual para teléfonos. |
| País, Idioma, Moneda | Nombres, no códigos. |
| Propietario | Nombre del asesor. |
| Registrado, Última actividad | Fecha y hora (AAAA-MM-DD HH:MM) en la zona horaria de la empresa. |
| Campos opcionales activos | Una columna por campo (menos Apellidos, que ya está). Fechas como AAAA-MM-DD; la edad se calcula a partir de la fecha de nacimiento si existe. |
| Campos personalizados activos | Una columna por campo. Los Sí / No salen como «Sí» o «No». |
Reglas y comportamientos#
- La exportación incluye también los contactos con estado
ELIMINADO(la lista no los oculta). No incluye los fusionados dentro de otro. - Máximo de 1.000.000 de contactos por archivo (Excel admite hasta 1.048.575 filas de datos).
- El archivo se arma por lotes en el servidor, sin cargar todo en memoria.
- Cada exportación queda registrada en el registro de auditoría del sistema, con el filtro usado y la cantidad de filas.
La exportación respeta lo que ves en pantalla: pestaña y búsqueda. No depende de las columnas que tengas visibles en la tabla; siempre trae las columnas de la tabla de arriba.
<!-- Fuente: tenant-app/public/api/contactos_exportar.php, tenant-app/public/contactos/index.php, shared/src/Core/ContactosLista.php, shared/src/Core/XlsxEscritor.php -->