> For the complete documentation index, see [llms.txt](https://docs.byronbutler.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.byronbutler.com/crm-inmobiliario/manual-de-usuario.md).

# Manual de Usuario

Índice

1. Introducción
2. Acceso al sistema
3. Panel de Control (Dashboard)
4. Contactos
5. Leads (Kanban)
6. Llamadas
7. Acciones Diarias
8. Soporte (Tickets)
9. Administración de Usuarios
10. Mi Perfil
11. Exportar a PDF

***

### 1. Introducción

El CRM Inmobiliario es una herramienta web diseñada para ayudar a asesores inmobiliarios a gestionar sus clientes, leads, llamadas y acciones diarias. El sistema permite organizar visualmente el proceso de venta mediante un tablero Kanban, registrar el historial de comunicaciones y obtener métricas clave del negocio.

#### Funcionalidades principales

* Tablero Kanban para gestionar leads por estado
* Registro de llamadas y acciones diarias
* Agenda de contactos
* Dashboard con KPIs, gráficos y filtros por periodo
* Sistema de roles (admin / usuario)
* Módulo de soporte técnico con tickets
* Exportación a PDF del dashboard

***

### 2. Acceso al Sistema

#### 2.1. Iniciar sesión

1. Abre la URL del CRM en tu navegador.
2. Introduce tu **usuario** y **contraseña**.
3. Haz clic en **"Iniciar sesión"**.

#### 2.2. Registrarse

1. En la pantalla de login, haz clic en **"Crear cuenta"**.
2. Completa los campos: **Nombre completo**, **Correo electrónico**, **Usuario** y **Contraseña**.
3. Haz clic en **"Crear cuenta"**.
4. Recibirás un mensaje de confirmación. Tu cuenta queda **pendiente de activación** por el administrador.
5. El administrador recibirá una notificación por email automáticamente.

#### 2.3. Cerrar sesión

Haz clic en el botón **"Cerrar sesión"** en la esquina superior derecha.

***

### 3. Panel de Control (Dashboard)

El dashboard ofrece una visión general del negocio con indicadores clave y gráficos.

#### 3.1. Barra de estadísticas

En la parte superior se muestran:

| Indicador            | Descripción                               |
| -------------------- | ----------------------------------------- |
| **Total**            | Número total de leads                     |
| **Vendidos**         | Leads en estado VENDIDO                   |
| **Fact. Realizada**  | Suma de facturación de leads vendidos     |
| **Fact. Pendiente**  | Suma de facturación del resto de leads    |
| **Realizado Asesor** | Retorno del asesor sobre leads vendidos   |
| **Pendiente Asesor** | Retorno del asesor sobre leads pendientes |
| **Captados**         | Número de leads captados                  |

Los indicadores con valor 0 se ocultan automáticamente.

#### 3.2. Filtros por periodo

Puedes filtrar los datos del dashboard por:

* **Mes**: selecciona un mes y año concretos.
* **Trimestre**: selecciona un trimestre (Q1-Q4) y año.
* **Año**: selecciona un año.
* **Todo**: muestra todos los datos sin filtrar.

#### 3.3. Tarjetas KPI

Resumen visual con: Total, Vendidos, Fact. Realizada, Fact. Pendiente, Realizado Asesor, Pendiente Asesor, Captados, Llamadas, Tasa de Éxito, Valor Inmuebles, Tasa de Conversión, Valor Cartera.

#### 3.4. Gráficos

* **Llamadas por mes**: gráfico de barras con las llamadas registradas cada mes.
* **Resultado llamadas**: gráfico de donut (éxito / perdidas).
* **Acciones por mes**: gráfico de barras con el total de acciones.

#### 3.5. Tablas

* **Leads por estado y origen**: desglose detallado.
* **Valor Total Cartera**: resumen económico completo.

#### 3.6. Exportar PDF

Haz clic en **"Exportar PDF"** para descargar un informe completo del dashboard con todos los gráficos y tablas incluidos.

***

### 4. Contactos

La pestaña **Contactos** permite gestionar una agenda de contactos independiente de los leads.

#### 4.1. Añadir contacto

1. Haz clic en **"Añadir Contacto"**.
2. Rellena los datos (nombre, código OKC, origen, tipo cliente, tipo inmueble, etc.).
3. Marca **"Crear lead automáticamente con estos datos"** si deseas crear también un lead en el tablero Kanban.
4. Haz clic en **"Guardar Contacto"**.

#### 4.2. Buscar contactos

Usa el campo de búsqueda para filtrar contactos en tiempo real por nombre, código OKC, origen o tipo.

#### 4.3. Editar / Eliminar

Usa los iconos del lápiz (editar) y papelera (eliminar) en cada contacto.

***

### 5. Leads (Kanban)

El tablero Kanban organiza los leads en columnas según su estado, permitiendo arrastrar y soltar para cambiar de estado.

#### 5.1. Estados del Kanban

| Columna              | Descripción                           |
| -------------------- | ------------------------------------- |
| **PROSPECTO**        | Nuevo lead sin contacto significativo |
| **SEGUIMIENTO**      | En proceso de seguimiento             |
| **PRIMERA VISITA**   | Se ha realizado la primera visita     |
| **PRESENTACIÓN**     | Presentación de propuesta             |
| **COMERCIALIZACION** | En proceso de comercialización        |
| **ARRAS**            | Contrato de arras firmado             |
| **NOTARIA**          | En trámites notariales                |
| **VENDIDO**          | Operación cerrada                     |
| **PERDIDO**          | Operación cancelada                   |

#### 5.2. Añadir lead

1. Haz clic en **"Añadir Lead"**.
2. Rellena los campos obligatorios (nombre) y opcionales.
3. Los campos de valoración y comisión calculan automáticamente la facturación con IVA.
4. Haz clic en **"Guardar Lead"**.

#### 5.3. Mover lead entre columnas

Arrastra y suelta la tarjeta del lead a la columna deseada. El cambio de estado se guarda automáticamente.

#### 5.4. Editar / Eliminar lead

* **Editar**: haz clic en el icono del lápiz en la esquina superior derecha de la tarjeta.
* **Eliminar**: haz clic en el icono de la papelera.

#### 5.5. Campos del lead

| Campo                | Descripción                                                |
| -------------------- | ---------------------------------------------------------- |
| **Nombre**           | Nombre del cliente                                         |
| **Código OKC**       | Código interno (se convierte a mayúsculas automáticamente) |
| **Origen**           | Cómo llegó el lead (Referido, Portal, RRSS, etc.)          |
| **Tipo Cliente**     | Comprador, Vendedor, Inversor, Arrendatario, Demandante    |
| **Tipo Inmueble**    | Piso, Casa/Chalet, Local, Terreno, etc.                    |
| **Captación**        | Si/No — indica si el lead fue captado activamente          |
| **Fecha Captación**  | Fecha de captación (si aplica)                             |
| **Valor Casa**       | Valor del inmueble en euros                                |
| **Comisión Agencia** | Porcentaje de comisión de la agencia                       |
| **% Asesor**         | Porcentaje de retorno para el asesor                       |
| **Facturación**      | Calculada automáticamente (valor × comisión + IVA 21%)     |
| **Último Contacto**  | Fecha del último contacto                                  |
| **URL CRM**          | Enlace externo al CRM                                      |
| **Observaciones**    | Notas adicionales                                          |

***

### 6. Llamadas

La pestaña **Llamadas** permite registrar el historial de llamadas realizadas.

#### 6.1. Registrar llamada

1. Selecciona el **lead** asociado.
2. Introduce la **fecha** y **notas**.
3. Selecciona el **resultado**:
   * **Seguimiento**
   * **Primera visita**
   * **No contesta**
   * **Perdido**
4. Haz clic en **"Guardar Llamada"**.

#### 6.2. Historial

Las llamadas se muestran ordenadas por fecha, con el lead asociado, resultado y notas.

#### 6.3. Estadísticas

* Total de llamadas
* Llamadas exitosas (Seguimiento + Primera Visita)
* Porcentaje de éxito
* Llamadas pérdidas

***

### 7. Acciones Diarias

La pestaña **Acciones** permite registrar 10 tipos de acciones diarias con campos numéricos.

#### 7.1. Registrar acción

1. Introduce los valores para cada tipo de acción (llamadas, visitas, emails, etc.).
2. Haz clic en **"Guardar Acción"**.

#### 7.2. Vista semanal

Las acciones se agrupan por semanas con subtotales semanales y total general.

***

### 8. Soporte (Tickets)

La pestaña **Soporte** permite contactar con el administrador mediante un sistema de tickets.

#### 8.1. Crear un ticket

1. Haz clic en **"Nuevo Ticket"**.
2. Escribe un **asunto** y un **mensaje** describiendo tu consulta o incidencia.
3. Haz clic en **"Enviar"**.

#### 8.2. Responder a un ticket

1. Haz clic en el ticket de la lista.
2. Escribe tu respuesta en el campo de texto.
3. Haz clic en **"Responder"**.

#### 8.3. Estados del ticket

| Estado          | Descripción                                  |
| --------------- | -------------------------------------------- |
| **Abierto**     | Ticket recién creado, pendiente de respuesta |
| **En Progreso** | El administrador ha respondido               |
| **Cerrado**     | Ticket resuelto y cerrado                    |

#### 8.4. Para administradores

* Ven todos los tickets de todos los usuarios.
* Pueden cambiar el estado del ticket (En Progreso, Cerrar).
* Pueden crear tickets asignados a un usuario específico.

***

### 9. Administración de Usuarios

Solo visible para usuarios con **rol de administrador**.

#### 9.1. Gestión de usuarios

* Tabla con todos los usuarios registrados.
* Muestra: nombre, email, usuario, rol, estado, leads, vendidos, llamadas, acciones y fecha de registro.

#### 9.2. Activar / Desactivar usuario

Haz clic en el badge de estado (Activo/Inactivo) para cambiar el estado. O usa el botón **"Activar"** en la fila del usuario.

#### 9.3. Editar usuario

Haz clic en el icono del lápiz para modificar: nombre, email, usuario, rol, estado y contraseña.

#### 9.4. Crear usuario

Haz clic en **"Nuevo Usuario"** para crear un usuario directamente desde el panel.

#### 9.5. Eliminar usuario

Haz clic en el icono de la papelera. Si te eliminas a ti mismo, se cerrará tu sesión.

***

### 10. Mi Perfil

Haz clic en el icono de engranaje ⚙️ en la esquina superior derecha.

#### 10.1. Cambiar datos personales

Puedes modificar tu **nombre**, **correo electrónico** y **nombre de usuario**.

#### 10.2. Cambiar contraseña

Introduce tu **contraseña actual** y la **nueva contraseña** (dos veces para confirmar).

> Nota: cualquier cambio requiere introducir tu contraseña actual.

***

### 11. Exportar a PDF

Desde el Dashboard, haz clic en **"Exportar PDF"** para generar un documento con:

* KPIs y estadísticas
* Gráficos de llamadas y acciones
* Tablas de leads por estado/origen
* Valor total de cartera

El PDF se descargará automáticamente.

***

### Consejos rápidos

* 🖱️ **Arrastra y suelta** los leads entre columnas del Kanban.
* 🔍 **Filtra el dashboard** por mes, trimestre o año para ver datos concretos.
* 📧 **Regístrate** y espera la activación del administrador.
* 🎫 **Usa los tickets** de soporte para cualquier duda o incidencia.
* 📊 **Exporta el dashboard** a PDF para informes.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.byronbutler.com/crm-inmobiliario/manual-de-usuario.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
