Avis Clients

Overview

Le système d’avis Wagoo permet de collecter et afficher les retours clients avec un système de notation.

Créer un avis

Via l’interface

1. Allez à la page publique du projet
2. Cliquez Laisser un avis
3. Remplissez le formulaire :
   • Note : De 1 à 5 étoiles
   • Titre : “Excellent service”
   • Commentaire : Votre avis détaillé
4. Cliquez Soumettre

L’avis est soumis pour modération et sera visible après approbation.

Via l’API

curl -X POST http://localhost:3000/api/projects/{projectId}/reviews \
  -H "Content-Type: application/json" \
  -d '{
    "rating": 5,
    "title": "Excellent service",
    "content": "Très satisfait du service fourni",
    "email": "client@example.com"
  }'

Statuts d’avis

PENDING

En attente de modération. Visible seulement pour l’admin.

Affichage public : Non
Notifications : Admin reçoit une alerte

APPROVED

Approuvé et visible publiquement.

Affichage public : Oui
Positif : Aide à la confiance des nouveaux clients

REJECTED

Rejeté. Non visible publiquement.

Raisons possibles :
- Contenu inapproprié
- Spam
- Hors sujet

Modérer les avis

Vue d’administration

1. Ouvrez votre projet
2. Allez à Reviews
3. Voir les avis en attente
4. Pour chaque avis :
   • ✅ Approver : Publier l’avis
   • ❌ Reject : Refuser l’avis

Répondre à un avis

Fonctionnalité future : Pouvoir répondre aux avis clients

Afficher les avis

Page publique

URL : http://mon-projet.wagoo.app/avis

Affiche :

• Tous les avis approuvés
• Triés par date (récents d’abord)
• Note et titre
• Avatar de l’auteur
• Note moyenne du projet

Widget d’avis (à intégrer)

<!-- Code à ajouter sur votre site -->
<script src="https://wagoo.app/widget/reviews.js" 
        data-project-id="YOUR_PROJECT_ID"></script>

Notation

Système d’étoiles

• ⭐ 1 étoile : Très mauvais
• ⭐⭐ 2 étoiles : Mauvais
• ⭐⭐⭐ 3 étoiles : Bon
• ⭐⭐⭐⭐ 4 étoiles : Très bon
• ⭐⭐⭐⭐⭐ 5 étoiles : Excellent

Moyenne

La note moyenne du projet s’affiche automatiquement :

Note moyenne = (Somme des notes) / (Nombre d'avis)

Via l’API

Récupérer les avis

# Tous les avis approuvés
curl http://localhost:3000/api/projects/{projectId}/reviews?status=APPROVED
 
# Tous les avis (admin)
curl http://localhost:3000/api/projects/{projectId}/reviews \
  -H "Authorization: Bearer YOUR_TOKEN"

Modérer un avis

curl -X PATCH http://localhost:3000/api/projects/{projectId}/reviews/{reviewId} \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "status": "APPROVED"
  }'

Supprimer un avis

curl -X DELETE http://localhost:3000/api/projects/{projectId}/reviews/{reviewId} \
  -H "Authorization: Bearer YOUR_TOKEN"

Anti-spam

Wagoo protège contre les avis malveillants :

✅ Modération manuelle requise ✅ Limite d’1 avis par email par projet par jour ✅ Détection de contenu inapproprié ✅ Vérification CAPTCHA optionnelle

Cas d’usage

Portfolio freelance

Affichchez les avis de vos clients satisfaits.

Service local

Rassemblez les retours des clients.

Produit/SaaS

Collectez les feedback et notes publiquement.

Événement

Demandez les retours après l’événement.

Intégration avec les réseaux sociaux

Partager un avis :

Boutons de partage : Facebook, Twitter, WhatsApp

Notifications

Pour l’admin

• 📧 Email quand un nouvel avis est soumis
• 📧 Email pour chaque mention/réponse

Voir Gestion d’équipe pour ajouter des modérateurs.