O portal do hóspede

Atualizado em 2026-04-22

Cada hóspede recebe um link pessoal para o portal que cobre três fases da sua estadia — num único URL. Pre-arrival, durante a estadia e post-stay.

Como recebe o hóspede o link?

Automaticamente. Assim que a reserva passa a CONFIRMED (primeiro pagamento), booking.booking_url é gerado via temporarySignedRoute. Esse link segue depois em:

• O e-mail booking-confirmed (bloco CTA "Abrir o meu portal")
• O e-mail booking-fully-paid (mesmo CTA)

O link funciona até 1 dia após a partida. Depois disso 403.

Quando pode o hóspede abrir o portal?

No mais cedo 2 dias antes da chegada (configurável pela definição bw_prearrival_portal_days). Antes desse período → 403 com explicação de quando abrirá.

O que vê o hóspede em cada fase?

📅 Pre-arrival (2 dias antes da chegada)

• Estado de pagamento — total / pago / em aberto, com botão para pagar online o valor restante
• Completar dados:
  • Obrigatório: nome próprio, apelido, telemóvel (para WhatsApp), morada, código postal, cidade, país
  • Opcional: nome da empresa, número de contribuinte, contacto de emergência
  • Os dados são guardados no Debtor
• Pedir hora de check-in — com time picker + nota opcional. No submit recebe um Telegram com botões Aprovar / Recusar. Clica → a reserva é atualizada, surge um badge na Visão geral dos quartos
• Escolha de pequeno-almoço por manhã — sempre visível, não apenas a partir do check-in
• Informação geral (WiFi, parking, horários de check-in, check-out)

🏠 Durante a estadia

Tudo o de pre-arrival continua visível, mais:

• 🔐 Desbloqueio de porta via webhooks do Home Assistant (porta da rua + quartos individuais)
• 🍺 Honesty bar — o hóspede toca em produtos, ficam em direto na sua fatura
• 💳 Fatura em direto com o saldo atual

👋 Post-stay (até partida + 1 dia)

• ⭐ CTA Google Reviews (link a partir da definição google_reviews_url)
• Fatura final + eventual pagamento residual
• Honesty bar + upsells de wellness ocultos (já não estão presentes)

Privacidade

• URL signed — não adivinhável
• Expira automaticamente
• Pode ser invalidada por reserva via admin (definir booking_url = null)
• A housekeeper tem um portal separado que NÃO mostra dados de hóspedes (ver secção Limpeza)