Documentation
Guide complet pour maîtriser Magic Quiz AI
Introduction
Bienvenue dans la documentation Magic Quiz AI ! Cette plateforme révolutionnaire utilise l'intelligence artificielle pour créer des quiz professionnels en moins de 30 secondes.
🚀 Ce que vous pouvez faire avec Magic Quiz
- Générer automatiquement des quiz à partir de vos documents
- Créer 6 types de questions différents
- Publier et partager vos quiz en ligne
- Analyser les résultats en temps réel
- Gérer une équipe et collaborer
Démarrage rapide
En 3 étapes simples
- Uploadez votre contenu ou entrez un sujet
- Générez votre quiz avec l'IA en 30 secondes
- Partagez avec vos participants
💡 Astuce : Vous pouvez créer et prévisualiser des quiz sans compte,
mais l'inscription est nécessaire pour publier.
Création de compte
Inscription rapide
Créez votre compte Magic Quiz AI en moins d'une minute. L'inscription est gratuite et sans engagement.
📝 Méthodes d'inscription
- Email classique : Inscription avec email et mot de passe
- Google OAuth : Connexion en 1 clic avec votre compte Google
- Inscription différée : Créez d'abord un quiz, puis inscrivez-vous pour le publier
💡 Bon à savoir : Vous pouvez créer et prévisualiser des quiz sans compte.
L'inscription n'est nécessaire que pour publier et partager.
Processus d'inscription
- Accédez à la page d'inscription : Cliquez sur "Se connecter" puis "Créer un compte"
- Remplissez le formulaire :
- Nom complet
- Adresse email valide
- Mot de passe sécurisé (min. 8 caractères)
- Validez votre email : Cliquez sur le lien de confirmation envoyé
- Complétez votre profil : Ajoutez vos informations (optionnel)
🔐 Sécurité du mot de passe
Votre mot de passe doit contenir :
- Au moins 8 caractères
- Une lettre majuscule
- Une lettre minuscule
- Un chiffre
- Un caractère spécial (recommandé)
Connexion avec Google
Pour une inscription encore plus rapide, utilisez votre compte Google :
1. Cliquez sur "Continuer avec Google"
2. Sélectionnez votre compte Google
3. Autorisez l'accès (email et nom uniquement)
4. C'est fait ! Votre compte est créé
🔒 Confidentialité : Nous ne collectons que votre email et nom via Google OAuth.
Nous n'accédons jamais à vos autres données Google.
Avantages d'un compte
✨ Avec un compte gratuit, vous pouvez :
- Sauvegarder vos quiz créés
- Publier des quiz (5€ par quiz)
- Accéder à votre dashboard personnel
- Voir les statistiques de base
- Inviter des participants par email
- Exporter les résultats en CSV
Passer à Professional
Débloquez toutes les fonctionnalités avec un abonnement Professional :
| Fonctionnalité | Gratuit | Professional |
|---|---|---|
| Création de quiz | ✅ | ✅ |
| Publication | 5€/quiz | Illimité |
| Durée quiz | 30 jours | Illimité |
| Upload fichiers | 10 MB | 50 MB |
| Analytics avancés | ❌ | ✅ |
| Gestion d'équipe | ❌ | ✅ |
| Support prioritaire | ❌ | ✅ |
🎁 Essai gratuit : Testez Professional gratuitement pendant 7 jours,
sans engagement et sans carte bancaire.
Récupération de mot de passe
Mot de passe oublié ? Pas de panique :
- Cliquez sur "Mot de passe oublié ?" sur la page de connexion
- Entrez votre adresse email
- Recevez un lien de réinitialisation par email
- Créez un nouveau mot de passe sécurisé
⚠️ Sécurité : Le lien de réinitialisation expire après 1 heure.
Si vous ne recevez pas l'email, vérifiez vos spams.
Créer un quiz
Méthodes de création
📄 À partir d'un document
Uploadez un PDF, Word, PowerPoint ou fichier texte. L'IA analysera le contenu et générera des questions pertinentes.
Formats acceptés : PDF, DOCX, PPTX, TXT
Taille max : 10 MB (50 MB pour Professional)
✍️ À partir d'un sujet
Entrez simplement un sujet et l'IA créera un quiz complet basé sur ses connaissances.
📝 À partir de texte
Collez directement votre contenu dans le champ de texte.
Génération par Intelligence Artificielle
Technologie utilisée
Magic Quiz utilise GPT-3.5/4 d'OpenAI pour analyser vos contenus et générer des questions pertinentes.
🤖 Processus de génération
- Analyse : L'IA lit et comprend votre contenu
- Extraction : Identification des concepts clés
- Génération : Création de questions variées
- Validation : Vérification de la cohérence
- Optimisation : Ajustement selon vos paramètres
⚠️ Important : Toujours vérifier les questions générées avant publication.
L'IA est performante mais peut faire des erreurs.
Temps moyen de génération : 15-30 secondes
Taux de précision : 95%+ sur sujets généraux
Langues supportées : Français, Anglais
Types de questions
L'IA sélectionne automatiquement les types les plus adaptés à votre contenu.
Questions disponibles
- QCM : Questions à choix multiples (une seule réponse)
- Vrai/Faux : Questions binaires
- Réponses multiples : Plusieurs bonnes réponses possibles
- Textes à trous : Compléter les espaces manquants
- Association : Relier des éléments entre eux
- Réponses courtes : Réponses libres en texte
Édition des quiz
Interface d'édition
Après la génération, vous pouvez modifier tous les aspects de votre quiz :
✏️ Modifications possibles
- Éditer le texte des questions et réponses
- Ajouter/supprimer des questions
- Réorganiser l'ordre des questions
- Ajuster les points par question
- Ajouter des explications détaillées
- Modifier le temps alloué
- Changer le type de question
💡 Conseil : Sauvegardez régulièrement vos modifications.
Les brouillons sont conservés automatiquement.
Publier un quiz
Options de publication
| Plan | Coût | Durée |
|---|---|---|
| Pay-as-you-go | 5€/quiz | 30 jours |
| Professional | Inclus | Illimité |
Système d'invitations
Envoyer des invitations
Invitez directement vos participants par email avec suivi des participations.
📧 Fonctionnalités d'invitation
- Envoi groupé jusqu'à 100 emails
- Message personnalisable
- Suivi des ouvertures
- Taux de participation
- Relances automatiques
- Statistiques détaillées
Format CSV accepté :
nom,email
Jean Dupont,jean@example.com
Marie Martin,marie@example.com
Analyse des résultats
Tableau de bord des résultats
Accédez à une vue complète des performances de vos participants.
📊 Métriques disponibles
- Score global : Moyenne et médiane
- Temps de réponse : Par question et total
- Taux de réussite : Par question
- Progression : Évolution dans le temps
- Comparaisons : Entre participants
💡 Astuce : Les résultats sont mis à jour en temps réel
pendant que les participants jouent.
Analytics avancés
Analyses détaillées
Obtenez des insights approfondis sur vos quiz et participants.
| Métrique | Description | Plan requis |
|---|---|---|
| Scores basiques | Moyennes et totaux | Tous |
| Analyse par question | Difficulté, discrimination | Professional |
| Heatmaps | Visualisation des réponses | Professional |
Export des données
Formats d'export
📥 Formats disponibles
- CSV : Pour Excel/Google Sheets
- Excel : Fichier .xlsx avec mise en forme
- PDF : Rapport complet avec graphiques
- JSON : Pour intégrations techniques
Contenu exporté :
- Informations participants
- Scores détaillés
- Réponses par question
- Temps de réponse
- Statistiques globales
- Graphiques (PDF uniquement)
Gestion d'équipe
Collaboration en équipe
Invitez des membres et collaborez efficacement sur vos quiz.
⚠️ Note : Fonctionnalité réservée aux abonnés Professional.
👥 Fonctionnalités équipe
- Inviter jusqu'à 10 membres
- Partage de quiz entre membres
- Historique des modifications
- Commentaires et annotations
- Gestion des permissions
Rôles et permissions
Types de rôles
👤 Admin
Accès complet à toutes les fonctionnalités
- Gérer l'équipe et les rôles
- Accès à la facturation
- Supprimer des quiz
- Modifier tous les paramètres
✏️ Éditeur
Création et modification de contenu
- Créer et modifier des quiz
- Publier des quiz
- Voir les résultats
- Exporter les données
👀 Viewer
Accès en lecture seule
- Consulter les quiz
- Voir les résultats
- Télécharger les rapports
API REST (Bientôt disponible)
⚠️ En développement : L'API sera disponible pour les abonnés Professional.
Aperçu des endpoints
POST
/api/v1/quizzes - Créer un quiz
GET
/api/v1/quizzes/{id} - Récupérer un quiz
PUT
/api/v1/quizzes/{id} - Modifier un quiz
DELETE
/api/v1/quizzes/{id} - Supprimer un quiz
Authentification API
🚧 En développement
Clés API
L'authentification se fera via des clés API générées depuis votre dashboard.
Headers requis :
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Exemple de requête :
curl -X POST https://api.magic-quiz.com/v1/quizzes \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title": "Mon Quiz", "topic": "JavaScript"}'
Endpoints API détaillés
🚧 Documentation complète à venir
Quiz
POST
/api/v1/quizzes/generate - Générer avec IA
Sessions
POST
/api/v1/sessions - Créer une session
GET
/api/v1/sessions/{id}/results - Résultats
Webhooks
POST
/api/v1/webhooks - Configurer webhook
Événements webhook disponibles :
- quiz.created
- quiz.published
- session.completed
- participant.finished