Pular para o conteúdo principal

Agendamento Público de Visitas

O módulo de Agendamento Público de Visitas (/booking/[token]) entrega aos clientes uma experiência moderna e adaptada a smartphones para escolha de horários de test drive ou consultoria comercial sem necessidade de criação de senha.

Estrutura criptográfica e ciclo do token​

Os links de agendamento são protegidos por tokens aleatórios que eliminam riscos de acesso indevido ou tentativas de adivinhação:

Geração e prazos de validade​

  • Composição: 32 bytes criptograficamente seguros gerados aleatoriamente e codificados em base64URL (crypto.randomBytes(32).toString("base64url")).
  • Prazo de expiração: O link permanece ativo por 48 horas a partir do envio (DEFAULT_EXPIRY_HOURS = 48).
  • Alerta de ausência de resposta: Se passadas 24 horas sem abertura ou confirmação (DEFAULT_NO_RESPONSE_HOURS = 24), o CRM avisa o vendedor para uma nova tentativa.
  • Rotina periódica: Um processo executa a cada 15 minutos (*/15 * * * *) para expirar convites fora do prazo e atualizar a linha do tempo do cliente.

Fases do status de agendamento​

  1. DRAFT: Link configurado no espaço do cliente, pronto para despacho.
  2. SENT: Encaminhado ao comprador por SMS, WhatsApp ou e-mail.
  3. OPENED: Registrado no instante em que o cliente abre a página. (Visualizações de operadores conectados não afetam este indicador).
  4. BOOKED: Data e horário confirmados pelo cliente.
  5. NO_RESPONSE: 24 horas decorridas sem interação.
  6. EXPIRED: 48 horas concluídas sem confirmação de reserva.
  7. CANCELLED: Cancelamento realizado pelo cliente ou pela loja.

Passo a passo de reserva pelo comprador​

1. Acesso à página de agendamento​

O cliente clica no link recebido: https://app.steer.ai/booking/<token>. A página carrega sem solicitar senhas. Um limitador de taxa evita abusos no serviço (120 requisições a cada 5 minutos por par IP:token).

2. Conferência do carro e do endereço​

A tela apresenta a ficha do veículo:

  • Foto principal do modelo em alta resolução.
  • Marca, Modelo, Versão, Ano, Combustível e Transmissão.
  • Endereço da loja, rota no mapa e contatos do vendedor responsável.

3. Seleção do horário de atendimento​

  • O cliente navega pelos horários livres da concessionária, alinhados ao fuso horário da unidade.
  • Prevenção de duplicidades: Caso dois clientes escolham a mesma vaga simultaneamente, a API retorna HTTP 409 (SLOT_UNAVAILABLE) e exibe alternativas de imediato.

4. Confirmação dos dados pessoais​

  • Confirmação de nome, telefone celular, e-mail e eventuais observações sobre carro usado para avaliação.
  • O envio garante o bloqueio do horário na agenda da concessionária, gera uma tarefa para o consultor e libera o download do arquivo de agenda (.ics).

Reagendamento e cancelamento​

O comprador pode utilizar o mesmo link antes da data combinada para remarcar o horário ou cancelar a visita.