> 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/sistema-de-rifas/sistema-de-rifas-guia-de-usuario.md).

# Sistema de Rifas - Guia 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 **email** 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. 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:

| Tarjeta             | Qué muestra                                |
| ------------------- | ------------------------------------------ |
| **Leads totales**   | Cantidad de leads en base de datos         |
| **Alta prioridad**  | Leads con score alto                       |
| **En seguimiento**  | Leads activos en el panel de tracking      |
| **Scraping activo** | Indica si hay un job corriendo ahora mismo |

El panel inferior muestra los **jobs de scraping recientes** con su estado y cuántos leads generó cada uno.

***

### 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 a buscar (ej. `dentistas`, `agencias de marketing`).
   * **Ubicación:** ciudad o región (ej. `Medellín`, `Miami FL`).
   * **País:** Colombia 🇨🇴 o USA 🇺🇸. Determina las fuentes usadas.
   * **Máximo de leads:** cuántos resultados quieres obtener.
3. Haz clic en **Iniciar scraping**.

#### ¿Qué hace el sistema automáticamente?

```
Nicho + Ubicación
  → Busca en Páginas Amarillas (CO) / DuckDuckGo / NPI (USA)
  → Analiza cada sitio: email, teléfono, SEO, diseño, rendimiento
  → Calcula un Score de 0–100
  → Clasifica: ALTA / MEDIA / BAJA prioridad
  → Genera un mensaje comercial personalizado por lead
  → Guarda todo en la base de datos
```

#### Estados del job

| Estado       | Significado                 |
| ------------ | --------------------------- |
| 🟡 Pendiente | En cola                     |
| 🔵 Corriendo | Scraping en progreso        |
| ✅ Completado | Finalizado con éxito        |
| ❌ Fallido    | Ocurrió un error (ver Logs) |

***

### 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 🔴 / MEDIA 🟡 / BAJA 🟢.

#### Filtros

Busca por nombre, email o URL. Filtra por prioridad, nicho, o si tiene email/teléfono. Ordena por score, nombre o fecha.

#### Ver detalle de un lead

Haz clic en cualquier fila para abrir el modal de detalle. Verás:

* Puntuaciones detalladas (SEO, diseño, rendimiento).
* Chequeos técnicos (SSL, H1, responsive, etc.).
* Tecnologías detectadas.
* El **mensaje comercial** 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 personalizado** generado automáticamente por el sistema. Aparece tanto en el modal de detalle (sección Leads) como en el panel derecho del seguimiento (sección Tracking). El componente es exactamente el mismo en ambos lugares.

#### Controles del editor

| Botón        | Acción                                                                 |
| ------------ | ---------------------------------------------------------------------- |
| **Preview**  | Ver el correo renderizado exactamente como lo recibirá el destinatario |
| **Copiar**   | Copia el texto al portapapeles                                         |
| **Editar**   | Abre un textarea para modificar el mensaje                             |
| **Guardar**  | Persiste 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.

#### Detección de idioma automática

El sistema detecta si el mensaje está en **inglés o español** y ajusta el asunto del correo automáticamente. No necesitas configurar nada.

***

### 6. Seguimiento (Tracking)

El módulo de seguimiento es el CRM de la plataforma.

#### ¿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                                             |
| --------------- | ----------------------------------------------------- |
| **Timeline**    | Historial de interacciones (notas, llamadas, correos) |
| **Asignación**  | Estado, asesor asignado, grupo                        |
| **Información** | Datos completos del lead                              |

El panel derecho también incluye el **editor de mensaje comercial** con los mismos dos botones de envío, idéntico al modal de Leads.

#### Estados de un lead en seguimiento

| Estado          | Significado                   |
| --------------- | ----------------------------- |
| ⚪ Pendiente     | Sin contacto iniciado         |
| 🔵 En proceso   | Contacto en curso             |
| 🟢 Contactado   | Respuesta obtenida            |
| 📅 Reagendar    | Solicita contacto posterior   |
| ⛔ No disponible | Sin presupuesto / sin interés |
| ✅ Ganado        | Cliente convertido            |
| ❌ Perdido       | Oportunidad cerrada           |

#### Registrar una nota o interacción

1. En la pestaña **Timeline**, escribe tu nota.
2. Selecciona el tipo: **Nota**, **Llamada**, **Reunión**, **WhatsApp**, **Email**, **Sin respuesta**.
3. Haz clic en **Guardar**.

***

### 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.

* **Crear usuario:** botón **+ Nuevo usuario**. Asigna nombre, email, contraseña y rol.
* **Editar:** clic en el icono de edición.
* **Activar / Desactivar:** toggle en la columna de estado.

#### Grupos

Permiten organizar equipos de ventas. Crea un grupo, asigna un nombre y añade usuarios. Los leads pueden asignarse a un grupo desde 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. Los cambios se guardan automáticamente.

***

### 9. Perfil comercial (firma de correo)

El perfil comercial define **quién firma los correos**. Sin esto, los mensajes no tendrán remitente ni datos de contacto.

Ve a **Firma Comercial** en el menú lateral:

| Campo         | Descripción                                    |
| ------------- | ---------------------------------------------- |
| **Nombre**    | Tu nombre completo                             |
| **Empresa**   | Nombre de tu empresa                           |
| **Email**     | Email de contacto visible para el destinatario |
| **Teléfono**  | Opcional                                       |
| **Sitio web** | URL de tu empresa (opcional)                   |

> **Configura esto antes de enviar cualquier correo.**

***

### 10. Configuración SMTP

Necesaria para enviar correos desde la plataforma. Ve a **Configuración SMTP**:

| Campo               | Ejemplo                  |
| ------------------- | ------------------------ |
| **Host**            | `smtp.gmail.com`         |
| **Puerto**          | `587` (TLS)              |
| **Usuario**         | `tu@gmail.com`           |
| **Contraseña**      | Contraseña de aplicación |
| **Email remitente** | `noreply@tudominio.com`  |

#### 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.

***

### 11. Logs del sistema

Ve a **Logs** en el menú lateral. Muestra el historial de operaciones del sistema: jobs de scraping, correos enviados, cambios de estado. Ú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            |   ✅   |          ❌         |

***

### 13. Seguridad de la cuenta

#### Cambiar contraseña

Mi Perfil → **Cambiar contraseña**. Necesitas introducir la contraseña actual. No puedes reutilizar las últimas 3.

#### Autenticación de dos factores (2FA)

Mi Perfil → **Seguridad** → Activar 2FA:

1. Escanea el código QR con tu app.
2. Introduce el código de 6 dígitos para confirmar.
3. Guarda los **8 códigos de respaldo** en un lugar seguro — se usan si pierdes acceso a tu app.

#### Sesiones activas

Mi Perfil → **Sesiones activas**. Puedes ver todos los dispositivos conectados y cerrar cualquiera individualmente.

***

### 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: Colombia → español, USA → inglés. El asunto del correo se ajusta automáticamente.

**¿Puedo editar el mensaje antes de enviarlo?** Sí, con el botón **Editar**. 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 el Timeline 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/sistema-de-rifas/sistema-de-rifas-guia-de-usuario.md?ask=<question>
```

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.