# Segnalazione guasti da parte degli ospiti

Qualcosa si è rotto durante il soggiorno? Con le segnalazioni attive, gli ospiti te lo comunicano nel portale ospiti: nessun modulo a parte, nessun numero di telefono da cercare. Prenotazione, struttura e date vengono compilate automaticamente.

## 1. Attivale

1. Apri **Settings → Issue reports**.
2. Spunta **Guests can report issues**.
3. Facoltativo: inserisci l'indirizzo email che riceve le segnalazioni (per esempio il tuo team di manutenzione). Se lo lasci vuoto, si usa l'indirizzo per le notifiche all'host impostato in **Settings → Email**.
4. **Save**.

Le segnalazioni restano disattivate finché non le attivi. Puoi disattivarle di nuovo in qualsiasi momento; le segnalazioni già ricevute restano nella dashboard.

## 2. Cosa vede l'ospite

Dal momento in cui la guida del soggiorno è sbloccata (check-in e pagamenti completati) fino a un giorno dopo il check-out, il portale ospiti mostra **Report an issue** sotto *Ti serve qualcosa?* e nel pulsante di aiuto. L'ospite indica:

- **Type of issue** (tipo di problema): aria condizionata o riscaldamento, idraulica, acqua calda, elettricità, Wi-Fi o TV, elettrodomestico, porta, serratura o chiave, pulizia, infestanti, rumore, oggetto mancante o altro.
- **Cosa è successo** e, facoltativamente, il numero dell'appartamento o della porta.
- **Foto**: fino a 4, scattate con la fotocamera del telefono.
- **Quanto è urgente**: urgente, presto o non urgente (per dopo il soggiorno).
- **Orario migliore per l'intervento**: mattina, pomeriggio o sera.
- **Se il tuo team può entrare** quando l'ospite è fuori (chiavi nella cassetta portachiavi) oppure se l'ospite aspetta.
- Numero di **telefono o WhatsApp**.

Dopo l'invio, l'ospite vede la segnalazione e il suo stato (*Ricevuta*, *In riparazione*, *Risolta*) nello stesso punto.

## 3. Gestisci le segnalazioni

Ricevi una notifica push (**Settings → Notifications → A guest reported an issue**) e un'email; le segnalazioni urgenti sono contrassegnate con *URGENT*. Trovi tutte le segnalazioni in **Issues** nel menu in alto, con il numero di quelle aperte sulla scheda.

Apri una segnalazione per vedere la descrizione, le foto, i contatti (chiamata o WhatsApp con un tocco), l'orario migliore e il permesso di accesso. Segnala come **In progress** o **Resolved** e aggiungi note interne per il tuo team: l'ospite non le vede mai. La segnalazione compare anche nell'attività della prenotazione.

Le foto degli ospiti vengono salvate in modo riservato con la prenotazione e mostrate solo agli utenti del tuo account che hanno effettuato l'accesso.

## Per sviluppatori

Le nuove segnalazioni attivano l'evento webhook `issue.reported` (vedi **Settings → Webhooks**). `GET /api/v1/issues` elenca le segnalazioni e `PATCH /api/v1/issues/{id}` cambia lo stato o aggiunge una nota.

## Domande frequenti

### Gli ospiti possono fare segnalazioni prima dell'arrivo?

No. Il pulsante compare quando la guida del soggiorno è sbloccata e scompare un giorno dopo il check-out.

### Mi serve se uso già uno strumento per i moduli?

No, è facoltativo. Il vantaggio è che la segnalazione viene collegata automaticamente alla prenotazione e alla struttura, e l'ospite ne vede lo stato.