> For the complete documentation index, see [llms.txt](https://docs.neuradevsoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neuradevsoftware.com/neuradev-hunter/neuradevhunter-guia-de-usuario.md). # NeuradevHunter — Guía de Usuario > **Para quién es esta guía:** cualquier usuario de la plataforma (administradores y usuarios regulares). No se necesita conocimiento técnico. ### 1. Acceso y sesión #### Iniciar sesión 1. Abre la app y escribe tu **Correo electrónico** y **Contraseña**. 2. Si tienes 2FA activado, te pedirá un código de 6 dígitos de tu app de autenticación (Google Authenticator, Authy, 1Password, etc.). 3. Haz clic en **Ingresar al sistema**. 4. La sesión se renueva automáticamente mientras usas la app.
#### Cerrar sesión Haz clic en tu avatar (esquina superior derecha) → **Cerrar sesión**. La sesión queda invalidada en el servidor inmediatamente.
#### Olvidé mi contraseña 1. En la pantalla de login → **¿Olvidaste tu contraseña?** 2. Introduce tu email y recibirás un enlace de recuperación válido **1 hora**. 3. Sigue el enlace, escribe la nueva contraseña y confirma. > **Nota:** No puedes reutilizar tus últimas 3 contraseñas. *** ### 2. Dashboard La página principal muestra un resumen en tiempo real con cinco tarjetas: | Tarjeta | Qué muestra | | ------------------- | ---------------------------------- | | **Total Leads** | Cantidad de leads en base de datos | | **Alta Prioridad** | Leads con score alto | | **Media Prioridad** | Leads con oportunidad moderada | | **Con Email** | Leads con contacto disponible | | **Con Teléfono** | Leads con contacto directo | El panel inferior muestra los **Últimos Leads** generados recientemente y el **Último Job** de scraping con su estado.
*** ### 3. Scraping — generar leads El scraping es el proceso de búsqueda automática de empresas en internet. #### Cómo lanzar un scraping 1. Ve a **Scraping** en el menú lateral. 2. Rellena los campos: * **Nicho / Tipo de negocio:** tipo de negocio a buscar (ej. `restaurantes`, `clínicas dentales`). * **Ubicación:** ciudad o región (ej. `Medellín`, `Miami FL`). * **País de búsqueda:** determina las fuentes usadas. * Usa el deslizador para ajustar el **Máximo de URLs** entre rápido y completo. 3. Haz clic en **Iniciar Scraping**. > Solo puede ejecutarse un job a la vez. Si hay uno activo, el botón lo indica. #### ¿Qué hace el sistema automáticamente? ``` Nicho + Ubicación → Descubrimiento de URLs (DuckDuckGo, sin API key) → Scraping & Análisis: SEO, diseño, rendimiento, datos de contacto → Scoring Automático: puntuación 0–100 y clasificación por prioridad → Mensajes Comerciales: propuestas personalizadas listas para enviar → Guarda todo en la base de datos ``` #### Estados del job | Estado | Significado | | ---------- | --------------------------------------- | | Pendiente | En cola | | Ejecutando | Scraping en progreso | | Completado | Finalizado con éxito | | Fallido | Ocurrió un error (ver Logs del Sistema) | | Cancelado | Detenido manualmente | Para detener un job en curso, haz clic en **Cancelar**.
*** ### 4. Leads — explorar resultados #### Tabla de leads Cada fila es una empresa detectada: * **Empresa:** nombre, URL y ubicación. * **Contacto:** email y teléfono detectados (si existen). * **Score:** puntuación 0–100. Más alto = más oportunidad. * **Prioridad:** Alta Prioridad / Media Prioridad / Baja Prioridad. #### Filtros Busca por nombre, email o URL con el buscador **Buscar empresa, email, URL...**. Filtra por prioridad o nicho con los desplegables. Ordena usando las opciones de **Score**, **Nombre A–Z** o **Más recientes**. Para quitar los filtros, haz clic en **Limpiar**. #### Ver detalle de un lead Haz clic en cualquier fila para abrir el modal de detalle. Verás: * Puntuaciones detalladas (SEO, Diseño, Rendimiento). * **Verificación Técnica** (SSL, H1, responsive, etc.). * **Stack Tecnológico** detectado. * El **Mensaje Comercial Sugerido** con sus opciones de envío. #### Exportar a CSV Botón **CSV** en la barra superior. Exporta todos los leads con los filtros activos.
*** ### 5. Mensaje comercial y envío de correos Cada lead tiene un **Mensaje Comercial Sugerido** generado automáticamente. Aparece en el modal de detalle (sección Leads) y en el panel derecho de Seguimiento. Es el mismo componente en ambos lugares. #### Controles del editor | Botón | Acción | | ------------------ | ---------------------------------------------------------------------- | | **Vista previa** | Ver el correo renderizado exactamente como lo recibirá el destinatario | | **Copiar mensaje** | Copia el texto al portapapeles | | **Editar mensaje** | Abre un área de texto para modificar el mensaje | | **Guardar** | Guarda los cambios en la base de datos | | **Cancelar** | Descarta los cambios del editor | #### Botones de envío Hay **dos botones de envío**, siempre visibles: | Botón | Qué hace | | ------------------------- | ----------------------------------------------------------------------------------------------------------- | | **Enviar correo** | Envía el email al lead y lo mueve a seguimiento con estado "Pendiente" | | **Enviar + seguimientos** | Igual que el anterior, pero además programa automáticamente 3 correos de seguimiento (a los 3, 7 y 14 días) | > Al hacer clic en cualquiera de los dos, aparece un diálogo de confirmación mostrando el destinatario y la empresa antes de enviar.
*** ### 6. Seguimiento (Tracking) El módulo de seguimiento es el CRM de la plataforma. Accede desde **Seguimiento** en el menú lateral. #### ¿Cómo llega un lead a Seguimiento? Un lead pasa a seguimiento **automáticamente** al enviar el correo desde la plataforma. También puedes añadirlo manualmente con el botón **+**. #### Navegación * **Panel izquierdo:** lista de leads con filtros por grupo y estado. * **Panel derecho:** detalle del lead, con 3 pestañas: | Pestaña | Contenido | | --------------- | ----------------------------------------------------- | | **Bitácora** | Historial de interacciones (notas, llamadas, correos) | | **Asignación** | Estado del lead, asesor responsable, grupo/equipo | | **Información** | Datos completos del lead | El panel derecho también incluye el **Mensaje Comercial Sugerido** con los mismos dos botones de envío. #### Estados de un lead en seguimiento | Estado | Significado | | ---------- | --------------------- | | Pendiente | Sin contacto iniciado | | En proceso | Contacto en curso | | Contactado | Respuesta obtenida | | Descartado | Oportunidad cerrada | #### Registrar una nota o interacción 1. En la pestaña **Bitácora**, escribe tu nota en el campo **Registrar interacción**. 2. Selecciona el tipo de resultado: * **Nota** * **Interesado** * **No interesado** * **No respondió** * **Llamar después** 3. Haz clic en **Guardar nota**.
*** ### 7. Seguimientos automáticos por email Al usar **Enviar + seguimientos**, el sistema programa 3 correos adicionales: | Seguimiento | Cuándo se envía | | ----------- | ----------------------------------- | | 1º | A los **3 días** del envío inicial | | 2º | A los **7 días** del envío inicial | | 3º | A los **14 días** del envío inicial | #### Gestionar la secuencia En el panel de seguimiento, sección **Seguimientos automáticos**: * Verás las fechas programadas con su estado (pendiente / enviado / cancelado). * Para cancelar uno individual: icono de cancelar en esa fila. * Para cancelar todos: botón **Cancelar todos**. > Si el lead ya respondió, cancela la secuencia para no seguir enviando correos automáticos. *** ### 8. Gestión de usuarios y grupos > Solo para **administradores**. #### Usuarios Ve a **Usuarios** en el menú lateral (sección Administración). * **Crear usuario:** botón **Crear usuario**. Asigna nombre completo, email, nombre de usuario, contraseña y rol. * **Editar:** icono de edición en la fila del usuario. * **Activar / Desactivar:** botón **Activar** o **Desactivar** en la columna de acciones. * **Restablecer contraseña:** botón **PW** en la fila del usuario. #### Grupos Ve a **Grupos** en el menú lateral (sección Administración). Permiten organizar equipos de asesores. Usa el botón **Crear Grupo**, asigna un nombre y añade usuarios. Los leads pueden asignarse a un grupo desde la pestaña **Asignación** en el panel de seguimiento. #### Asignación de leads Desde la pestaña **Asignación** en el panel de seguimiento: selecciona el **Asesor responsable** y el **Grupo / Equipo**. Los cambios se guardan automáticamente. *** ### 9. Firma Comercial La firma comercial define quién firma los correos. Sin esto, los mensajes no tendrán datos de contacto del remitente. Ve a **Firma Comercial** en el menú lateral: | Campo | Descripción | | ---------------------- | ------------------------------------------------- | | **Nombre completo** | Tu nombre completo | | **Empresa** | Nombre de tu empresa | | **Correo de contacto** | Email visible para el destinatario | | **Teléfono** | Teléfono o WhatsApp (opcional) | | **—** | No hay campo de sitio web visible en esta sección | Haz clic en **Guardar firma** para guardar los cambios. > **Configura esto antes de enviar cualquier correo.**
*** ### 10. Configuración SMTP Necesaria para enviar correos desde la plataforma. Ve a **Configuración SMTP** en el menú lateral. Tiene tres pestañas: | Pestaña | Contenido | | ----------------------- | -------------------------------------- | | **Configuración** | Datos del servidor SMTP | | **Correo de Prueba** | Enviar un correo de verificación | | **Historial de Envíos** | Registro de todos los correos enviados | #### Campos de configuración | Campo | Ejemplo | | ----------------------------------- | ------------------------ | | **Servidor SMTP** | `smtp.gmail.com` | | **Puerto** | `587` | | **Usuario / Correo SMTP** | `tu@gmail.com` | | **Contraseña / App Password** | Contraseña de aplicación | | **Nombre visible del remitente** | Tu nombre o empresa | | **Correo del remitente (opcional)** | `noreply@tudominio.com` | Haz clic en **Guardar configuración SMTP** para guardar. #### Gmail — contraseña de aplicación Gmail no acepta tu contraseña normal: 1. Cuenta de Google → Seguridad → Verificación en 2 pasos (debe estar activa). 2. Seguridad → **Contraseñas de aplicación** → Crear una para "Correo". 3. Copia los 16 caracteres y pégalos como contraseña en la configuración SMTP. #### Correo de prueba En la pestaña **Correo de Prueba**, ingresa un **Correo destinatario** y haz clic en **Enviar correo de prueba** para verificar que la configuración funciona.
*** ### 11. Logs del Sistema Ve a **Logs del Sistema** en el menú lateral (sección Administración). Muestra el historial completo de operaciones: jobs de scraping, correos enviados, cambios de estado. Puedes filtrar por nivel (informativos, advertencias, errores) y buscar en los mensajes. Útil para diagnosticar errores.
*** ### 12. Roles y permisos | Acción | Admin | Usuario | | ------------------------------- | :---: | :----------------: | | Ver leads | ✅ | ✅ | | Lanzar scraping | ✅ | ✅ | | Enviar correos | ✅ | ✅ | | Ver seguimiento | ✅ | ✅ (solo asignados) | | Gestionar usuarios | ✅ | ❌ | | Gestionar grupos | ✅ | ❌ | | Ver todos los leads en tracking | ✅ | ❌ | | Configurar SMTP | ✅ | ❌ | | Ver logs del sistema | ✅ | ❌ | | Acceder a Configuración | ✅ | ❌ | *** ### 13. Seguridad de la cuenta #### Cambiar contraseña Ve a **Mi Perfil** → sección **Cambiar Contraseña**. Necesitas introducir la **Contraseña actual** y luego la nueva contraseña dos veces. Haz clic en **Cambiar contraseña**. No puedes reutilizar las últimas 3. #### Autenticación de dos factores (2FA) El sistema soporta 2FA mediante app de autenticación. Si el administrador lo requiere, al iniciar sesión se te pedirá el código de 6 dígitos en la pantalla de **Verificación 2FA**. #### Información personal Ve a **Mi Perfil** → sección **Información Personal** para actualizar tu nombre completo. El correo electrónico no puede modificarse. Haz clic en **Guardar cambios**. *** ### 14. Preguntas frecuentes **¿Por qué el scraping no encuentra correos?** No todos los sitios web publican su email. El sistema solo extrae lo visible en el HTML. Si no hay correo, el campo queda vacío. **¿Cuál es la diferencia entre "Enviar correo" y "Enviar + seguimientos"?** "Enviar correo" manda un solo email. "Enviar + seguimientos" manda el mismo email y además programa 3 correos de seguimiento automáticos (días 3, 7 y 14). Usa la segunda opción cuando quieras mantener el contacto sin tener que recordarlo manualmente. **¿Puedo enviar correos sin SMTP configurado?** No. El administrador debe configurar el SMTP primero. **¿El mensaje se genera en inglés o español?** Depende del país de la búsqueda. El sistema detecta el idioma automáticamente y ajusta el asunto del correo. **¿Puedo editar el mensaje antes de enviarlo?** Sí, con el botón **Editar mensaje**. Puedes guardar los cambios permanentemente o simplemente enviar el mensaje modificado sin guardarlo. **¿Qué pasa si cancelo los seguimientos automáticos?** Los correos pendientes quedan cancelados. Los ya enviados no se pueden deshacer. **¿El editor de mensajes es el mismo en Leads y en Tracking?** Sí, es exactamente el mismo componente con el mismo comportamiento, los mismos botones y la misma lógica de envío. **¿Cómo sé que un correo se envió correctamente?** Aparece un mensaje de confirmación y se registra automáticamente una nota en la Bitácora del lead con el asunto del correo enviado. **¿Los leads se duplican si hago dos scrapings del mismo nicho?** El sistema intenta deduplicar por dominio. Filtra por URL o nombre para detectar posibles duplicados. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.neuradevsoftware.com/neuradev-hunter/neuradevhunter-guia-de-usuario.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.