Passa al contenuto principale

Prenotazione Pubblica di Appuntamenti

Il modulo di Prenotazione Pubblica di Appuntamenti (/booking/[token]) mette a disposizione degli acquirenti un'interfaccia snella e adatta a qualsiasi dispositivo mobile per scegliere data e ora di una prova su strada o di una consulenza senza dover creare account.

Architettura sicura e ciclo di vita del token​

I link di prenotazione sono protetti da token crittografici ad alta sicurezza che evitano accessi non autorizzati o tentativi di enumerazione:

Generazione e durata del token​

  • Composizione: 32 byte pseudocasuali crittograficamente sicuri convertiti in formato base64URL (crypto.randomBytes(32).toString("base64url")).
  • Validità prestabilita: Il collegamento resta attivo per 48 ore dalla ricezione (DEFAULT_EXPIRY_HOURS = 48).
  • Soglia di mancata risposta: Se dopo 24 ore il link non è stato utilizzato (DEFAULT_NO_RESPONSE_HOURS = 24), nel CRM si attiva un promemoria per il venditore.
  • Procedura periodica in background: Un processo automatico scansiona ogni 15 minuti (*/15 * * * *) i link scaduti e aggiorna lo storico delle attività.

Fasi dello stato di prenotazione​

  1. DRAFT: Link creato nel pannello del lead, in attesa di spedizione.
  2. SENT: Inviato al compratore via SMS, WhatsApp o posta elettronica.
  3. OPENED: Registrato non appena il compratore visualizza la pagina web. (Le aperture da parte di personale autenticato non modificano lo stato).
  4. BOOKED: Appuntamento selezionato e confermato dall'utente.
  5. NO_RESPONSE: Trascorse 24 ore senza interazione.
  6. EXPIRED: Scadute le 48 ore senza conferme.
  7. CANCELLED: Visita annullata dal cliente o dalla concessionaria.

Percorso di prenotazione per l'acquirente​

1. Apertura del collegamento​

Il cliente tocca il link ricevuto: https://app.steer.ai/booking/<token>. La schermata si carica immediatamente senza password. Un sistema di limitazione protegge il servizio da chiamate ripetute (120 richieste ogni 5 minuti per coppia IP:token).

2. Controllo della vettura e della sede​

La pagina illustra i dati del veicolo:

  • Immagine principale ad alta definizione.
  • Marca, Modello, Allestimento, Anno, Alimentazione e Cambio.
  • Indirizzo della sede, mappa per raggiungerla e recapiti del consulente commerciale.

3. Scelta dell'orario dell'appuntamento​

  • L'utente consulta il calendario aggiornato della concessionaria nel fuso orario locale.
  • Gestione delle concomitanze: Se due clienti provano a fissare contemporaneamente la stessa fascia oraria, l'API risponde con HTTP 409 (SLOT_UNAVAILABLE) e mostra immediatamente gli orari liberi più vicini.

4. Inserimento recapiti e conferma​

  • Verifica di nome, cellulare, email ed eventuali note su un veicolo da dare in permuta.
  • L'invio blocca l'orario in agenda, crea un promemoria di preparazione per il venditore e visualizza la schermata finale con file di calendario (.ics).

Riprogrammazione e disdetta in autonomia​

Il cliente può riaprire il link in qualsiasi momento prima della visita per modificare l'orario o cancellare l'appuntamento.