# Signalement d'incidents par les voyageurs

Quelque chose est cassé pendant un séjour ? Avec le signalement d'incidents activé, les voyageurs vous le disent dans le portail voyageurs : pas de formulaire à part, pas de numéro de téléphone à chercher. La réservation, le logement et les dates sont renseignés automatiquement.

## 1. L'activer

1. Ouvrez **Settings → Issue reports**.
2. Cochez **Guests can report issues**.
3. Facultatif : saisissez l'adresse e-mail qui reçoit les signalements (par exemple votre équipe de maintenance). Si le champ reste vide, l'adresse de notification de l'hôte définie dans **Settings → Email** est utilisée.
4. **Save**.

Le signalement d'incidents reste désactivé tant que vous ne l'activez pas. Vous pouvez le désactiver à tout moment ; les signalements déjà reçus restent dans le tableau de bord.

## 2. Ce que voit le voyageur

Dès que le guide de séjour est débloqué (check-in et paiements effectués) et jusqu'à un jour après le check-out, le portail voyageurs affiche **Report an issue** sous *Besoin de quelque chose ?* et dans le bouton d'aide. Le voyageur indique :

- **Type of issue** (type de problème) : climatisation ou chauffage, plomberie, eau chaude, électricité, Wi-Fi ou TV, électroménager, porte, serrure ou clé, propreté, nuisibles, bruit, article manquant ou autre.
- **Ce qui s'est passé** et, en option, le numéro d'appartement ou de porte.
- **Photos** : jusqu'à 4, prises avec l'appareil photo du téléphone.
- **Le degré d'urgence** : urgent, bientôt ou pas urgent (pour après le séjour).
- **Le meilleur moment pour passer** : matin, après-midi ou soir.
- **Si votre équipe peut entrer** en son absence (clés dans la boîte à clés) ou s'il attend sur place.
- Un numéro de **téléphone ou WhatsApp**.

Après l'envoi, le voyageur voit son signalement et son statut (*Reçu*, *En cours de réparation*, *Résolu*) au même endroit.

## 3. Traiter les signalements

Vous recevez une notification push (**Settings → Notifications → A guest reported an issue**) et un e-mail ; les signalements urgents sont marqués *URGENT*. Tous les signalements se trouvent sous **Issues** dans le menu du haut, avec le nombre de signalements ouverts sur l'onglet.

Ouvrez un signalement pour voir la description, les photos, les coordonnées (appel ou WhatsApp en un geste), le meilleur moment et l'autorisation d'entrer. Passez-le en **In progress** ou **Resolved**, et ajoutez des notes internes pour votre équipe — le voyageur ne les voit jamais. Le signalement apparaît aussi dans l'activité de la réservation.

Les photos des voyageurs sont stockées de manière confidentielle avec la réservation et ne sont visibles que par les utilisateurs connectés de votre compte.

## Pour les développeurs

Chaque nouveau signalement déclenche l'événement webhook `issue.reported` (voir **Settings → Webhooks**). `GET /api/v1/issues` liste les signalements et `PATCH /api/v1/issues/{id}` modifie le statut ou ajoute une note.

## Questions fréquentes

### Les voyageurs peuvent-ils signaler un problème avant l'arrivée ?

Non. Le bouton apparaît dès que le guide de séjour est débloqué et disparaît un jour après le check-out.

### En ai-je besoin si j'utilise déjà un outil de formulaires ?

Non, c'est facultatif. L'avantage : le signalement est automatiquement lié à la réservation et au logement, et le voyageur voit son statut.