Reservas

Descripcion general

Las Reservas son las citas programadas que vinculan un cliente con un servicio, ubicación, proveedor y horario específicos. La sección de Reservas ofrece una vista de calendario FullCalendar con filtros avanzados, un asistente de creación de 4 pasos, y gestión completa del ciclo de vida de cada cita.

Cómo acceder

• Navega a Agendamiento > Reservas (cuarta pestaña en la navegación lateral).
• También accesible directamente desde el menú lateral como Agendamiento (vista simplificada solo con reservas).
• Roles: Administrador/Gestor de Reservas ven todas las reservas. Los proveedores solo ven las suyas.

Vista general de la interfaz

La sección de Reservas muestra:

1. Encabezado — Título, botón de nueva reserva, y enlace a configuración (si estás en vista simplificada).
2. Filtros — Cuatro desplegables para filtrar por servicio, ubicación, proveedor y estado.
3. Leyenda de estados — Indicadores de color para cada estado de reserva.
4. Calendario — Vista FullCalendar que muestra las reservas como bloques de color. Soporta vistas de mes, semana, día y lista.

Estados de las reservas

Estado	Color	Descripción
Pendiente	Amarillo	Esperando confirmación (cuando el servicio requiere aprobación)
Confirmada	Azul	Cita confirmada
Completada	Verde	La cita se realizó exitosamente
Cancelada	Rojo	Cancelada por el cliente o el proveedor
No asistió	Gris	El cliente no se presentó
Reagendada	Morado	Reemplazada por una nueva reserva

Transiciones de estado válidas

Pendiente    → Confirmada, Cancelada
Confirmada   → Completada, Cancelada, No asistió, Reagendada
Completada   → (estado final)
Cancelada    → (estado final)
No asistió   → (estado final)
Reagendada   → (estado final)

Funcionalidades y acciones

Crear una nueva reserva

Qué hace: Crea una cita nueva siguiendo un asistente de 4 pasos.

Pasos:

Paso 1 — Servicio y Ubicación:

1. Haz clic en el botón + Nueva Reserva.
2. Selecciona el Servicio deseado.
3. Selecciona la Ubicación (solo muestra ubicaciones donde se ofrece el servicio seleccionado).
4. Haz clic en Siguiente.

Paso 2 — Fecha y Horario:

1. Selecciona una Fecha en el selector de fecha.
2. El sistema calcula y muestra los horarios disponibles como botones.
3. Selecciona un horario disponible. Cada botón muestra la hora de inicio y fin, y cuántos proveedores están disponibles.
4. Haz clic en Siguiente.

Paso 3 — Proveedor:

1. Se muestra la lista de proveedores disponibles para el horario seleccionado.
2. Selecciona un proveedor de la lista.
3. Haz clic en Siguiente.

Paso 4 — Información del cliente:

1. Opcionalmente busca un contacto existente para vincular la reserva a una conversación.
2. Si el contacto tiene múltiples conversaciones, selecciona la conversación a vincular.
3. Completa los datos del cliente:
   • Nombre del cliente (requerido)
   • Teléfono (opcional)
   • Email (opcional)
   • Notas (opcional)
4. Haz clic en Crear Reserva.

Notas importantes:

• Si el servicio tiene "Requiere aprobación" activado, la reserva se crea con estado Pendiente.
• Si no requiere aprobación, la reserva se confirma automáticamente y se crea un evento en el calendario del proveedor.
• Al vincular un contacto, los datos (nombre, teléfono) se prellenan automáticamente.

Filtrar reservas

Qué hace: Filtra las reservas mostradas en el calendario.

Pasos:

1. Usa los desplegables de filtro en la parte superior:
   • Servicio — Muestra solo reservas de un servicio específico.
   • Ubicación — Filtra por ubicación.
   • Proveedor — Filtra por proveedor asignado.
   • Estado — Filtra por uno o más estados (selección múltiple).
2. El calendario se actualiza automáticamente.

Ver detalles de una reserva

Qué hace: Abre un diálogo con los detalles completos de la reserva.

Pasos:

1. Haz clic en cualquier reserva en el calendario.
2. Se abre un diálogo mostrando:
   • Información del servicio, ubicación y proveedor
   • Datos del cliente (nombre, teléfono, email)
   • Fecha y hora de la cita
   • Estado actual
   • Notas
   • Quién creó la reserva y cuándo

Editar información del cliente

Qué hace: Modifica los datos del cliente de una reserva existente.

Pasos:

1. Abre el detalle de la reserva.
2. Haz clic en Editar.
3. Modifica el nombre, teléfono, email o notas del cliente.
4. Haz clic en Guardar.

Notas importantes:

• Solo se pueden editar los datos del cliente, no la fecha/hora ni el proveedor. Para cambiar la fecha, usa la función de reagendamiento.

Cambiar el estado de una reserva

Qué hace: Mueve una reserva al siguiente estado en su ciclo de vida.

Pasos:

1. Abre el detalle de la reserva.
2. Según el estado actual, verás los botones de acción disponibles:
   • Confirmar — Mueve de Pendiente a Confirmada (crea evento en el calendario).
   • Completar — Marca como completada.
   • Cancelar — Cancela la reserva (elimina el evento del calendario). Se solicita una razón.
   • No asistió — Marca que el cliente no se presentó.
3. Haz clic en el botón de la acción deseada.

Reagendar una reserva

Qué hace: Cambia la fecha/hora de una reserva existente.

Pasos:

1. Abre el detalle de la reserva.
2. Haz clic en Reagendar.
3. Selecciona la nueva fecha y horario (el sistema verifica disponibilidad).
4. Opcionalmente selecciona un nuevo proveedor.
5. Confirma el reagendamiento.

Notas importantes:

• La reserva original se marca como "Reagendada" y se crea una nueva reserva con el nuevo horario.
• El evento del calendario de la reserva original se elimina y se crea uno nuevo.

Fuentes de reservas

Fuente	Descripción
Manual	Creada por un miembro del equipo desde la interfaz
Agente de IA	Creada automáticamente por el agente de IA durante una conversación
API	Creada a través de la API de plataforma

Integración con el calendario

• Al confirmar una reserva → se crea un Evento en el calendario del proveedor con el formato: [Nombre del Servicio] - [Nombre del Cliente].
• Al cancelar una reserva → el Evento vinculado se elimina automáticamente.
• Los eventos creados por reservas aparecen en el calendario personal del proveedor y se sincronizan con Google Calendar si está conectado.

Notificaciones en tiempo real

Cuando se crea, modifica o cambia el estado de una reserva, todos los miembros del equipo reciben una notificación en tiempo real (vía SignalR). El calendario de reservas se actualiza automáticamente sin necesidad de recargar la página.

Preguntas frecuentes

P: ¿Qué pasa si intento reservar un horario que ya no está disponible? R: El sistema verifica la disponibilidad en tiempo real al momento de crear la reserva. Si el horario ya fue tomado, recibirás un error y deberás seleccionar otro horario.

P: ¿Puedo ver las reservas de todos los proveedores? R: Los administradores y gestores de reservas ven todas las reservas. Los proveedores solo ven las reservas de los servicios que tienen asignados.

P: ¿Las reservas canceladas desaparecen del calendario? R: Las reservas canceladas pueden seguir visibles si filtras por el estado "Cancelada". Por defecto, el calendario muestra todos los estados.

P: ¿Puedo vincular una reserva a una conversación de WhatsApp? R: Sí, en el paso 4 del asistente de creación puedes buscar un contacto y vincular la reserva a su conversación. Esto permite que el agente de IA tenga contexto sobre las citas del cliente.

Funcionalidades relacionadas

• Descripcion General del Agendamiento
• Servicios
• Proveedores
• Calendario