Demandes et avis
Comment la question d'un voyageur et son avis parviennent à l'équipe de l'hôte, comment l'équipe les traite dans le tableau de bord, et les limites qui gardent les formulaires propres.
Pour le pack Full Stack
Comment ils parviennent à l'hôte
| Sur le site | Dans le tableau de bord |
|---|---|
| Le formulaire de contact | Une demande, avec le nom du voyageur, son e-mail, son téléphone facultatif et son message |
| La boîte de dialogue de question sur la page d'un séjour | Une demande sur ce séjour, avec les dates et le nombre de voyageurs demandés |
| Un avis issu d'une réservation terminée | Un avis, publié aussitôt sur la page du séjour |
- Chacun prévient en direct chaque admin qui peut voir les demandes ou les avis, et arrive sur la page Demandes ou Avis du tableau de bord.
- Le voyageur voit une confirmation sur la page où il se trouve. Le message d'une question compte de 10 à 4000 caractères et le commentaire d'un avis de 10 à 2000, et le site vérifie les deux avant l'envoi, avec les mêmes limites que l'API.
- Rien n'est envoyé par e-mail, ni au voyageur ni à l'hôte : le template n'a pas de service de messagerie. L'équipe répond depuis sa propre messagerie, et un développeur peut ajouter un expéditeur à côté de la notification.
Demandes
| Statut | Signification |
|---|---|
| Nouvelle | Vient d'arriver. Chaque demande commence ici. |
| Répondue | L'équipe a répondu. |
| Clôturée | Terminée, quel que soit le résultat. |
- La page Demandes filtre par statut avec les totaux, et cherche par référence (
I001et ainsi de suite), nom, e-mail ou séjour, vingt par page, à côté de la demande sélectionnée : son séjour, les dates et les voyageurs demandés, les coordonnées du voyageur et ce qu'il a écrit. - Le panneau de détail change le statut et garde une note interne, que le voyageur ne voit jamais.
- Les demandes ne peuvent pas être supprimées : clôturez celles que vous avez terminées.
Avis
- Un voyageur note un séjour depuis sa propre page de réservation une fois la réservation terminée, une fois par réservation, avec une note de 1 à 5 par demi-étoile et un commentaire de 10 à 2000 caractères.
- Un avis est publié sur la page du séjour dès qu'il est écrit, et la moyenne du séjour le suit.
- La page Avis les liste huit par page, avec les totaux d'avis publiés et masqués, une recherche par voyageur ou commentaire, et des filtres de statut, de séjour, de note minimale et d'ancienneté (7, 30, 90 ou 365 jours). Publish et Hide changent aussitôt la moyenne publique du séjour.
- Les avis ne peuvent pas être supprimés : masquez ceux qui ne doivent pas être montrés.
Garder les formulaires propres
- Chaque adresse peut envoyer cinq questions et cinq avis en dix minutes ; le suivant est refusé avec un message demandant d'attendre. Les compteurs sont dans la mémoire de l'API.
- Un champ caché attrape les robots : une question qui le remplit reçoit la réponse habituelle et n'est stockée nulle part.
- Chaque question porte un jeton à usage unique, si bien qu'un double clic ou un renvoi enregistre une demande, pas deux.
- Derrière un reverse proxy, définissez
TRUST_PROXY=1dans le.envde l'API, sinon chaque visiteur partage le quota du proxy.
Qui peut faire quoi
| Permission | Autorise |
|---|---|
inquiries.view | Lire les demandes, et être notifié des nouvelles |
inquiries.edit | Changer le statut et la note d'une demande |
reviews.view | Lire les avis, et être prévenu des nouveaux |
reviews.moderate | Publier et masquer des avis |
Les deux rôles du seed, Super Admin et Manager, détiennent les quatre.
Les routes derrière tout cela
POST /api/inquiries est public : name, email, message (10 à 4000 caractères) et client_token, et en option phone, stay_slug, check_in, check_out et guests. Un avis est POST /api/bookings/:reference/review avec le jeton ou l'e-mail de la réservation, rating et comment, et les avis publiés d'un séjour sont GET /api/stays/:slug/reviews. Le tableau de bord lit et met à jour les demandes avec GET et PATCH /api/inquiries/:id (status, admin_notes), et les avis avec GET /api/reviews/manage et PATCH /api/reviews/manage/:id (status : published ou hidden).