Saltar al contenido principal

Reserva Pública de Citas

El módulo de Reserva Pública de Citas (/booking/[token]) ofrece a los compradores de vehículos una experiencia rápida, accesible desde cualquier dispositivo y sin necesidad de crear contraseñas para concertar una prueba o cita comercial.

Seguridad y ciclo de vida del token criptográfico​

Los enlaces de reserva se generan con parámetros de alta entropía que impiden accesos indebidos o manipulaciones:

Parámetros de generación y validez​

  • Estructura del token: 32 bytes aleatorios criptográficamente seguros, codificados en base64 compatible con URL (crypto.randomBytes(32).toString("base64url")).
  • Periodo de validez: El enlace permanece activo durante 48 horas desde su emisión (DEFAULT_EXPIRY_HOURS = 48).
  • Aviso por falta de respuesta: Si tras 24 horas no se registra actividad (DEFAULT_NO_RESPONSE_HOURS = 24), el sistema alerta al asesor comercial para un nuevo contacto.
  • Automatización periódica: Un proceso en segundo plano verifica cada 15 minutos (*/15 * * * *) los enlaces caducados y actualiza la cronología del cliente.

Estados del enlace de reserva​

  1. DRAFT: Creado en el espacio del cliente, pendiente de envío.
  2. SENT: Remitido al comprador por SMS, WhatsApp o correo electrónico.
  3. OPENED: Registrado en cuanto el cliente abre la página de reserva. (Las visitas internas del personal del concesionario no alteran este estado).
  4. BOOKED: Franja horaria reservada y confirmada por el usuario.
  5. NO_RESPONSE: 24 horas transcurridas sin acción del comprador.
  6. EXPIRED: 48 horas agotadas sin formalizar reserva.
  7. CANCELLED: Cancelación realizada por el comprador o por el concesionario.

Pasos del cliente para formalizar su cita​

1. Apertura del enlace de reserva​

El cliente pulsa en el enlace recibido: https://app.steer.ai/booking/<token>. La interfaz se carga al instante sin pedir contraseñas. Un mecanismo de control de frecuencia previene accesos abusivos (120 peticiones cada 5 minutos por par IP:token).

2. Revisión del vehículo y datos del punto de venta​

La pantalla presenta la ficha descriptiva:

  • Fotografía principal del coche en alta resolución.
  • Marca, Modelo, Versión, Año, Combustible y Transmisión.
  • Dirección física de la concesión, indicaciones de llegada y datos del asesor asignado.

3. Elección de la franja horaria​

  • El cliente consulta la agenda en tiempo real del concesionario, ajustada a su huso horario.
  • Resolución de conflictos: Si dos clientes intentan reservar la misma franja a la vez, el sistema responde con HTTP 409 (SLOT_UNAVAILABLE) y propone las alternativas más cercanas.

4. Confirmación de datos​

  • Validación de nombre, teléfono móvil, correo electrónico y comentarios sobre un posible vehículo a entregar como parte de pago.
  • Al confirmar, se bloquea la cita en el calendario, se genera una tarea interna para el asesor y se facilita la descarga del archivo de calendario (.ics).

Gestión de cambios y cancelaciones​

El comprador puede acceder de nuevo al mismo enlace antes de la fecha acordada para modificar el horario o cancelar la cita.