Documentación
La guía completa de Tralo
Todo lo que necesitas saber para crear, compartir y mejorar tus historias con ramificaciones y tus paquetes de fichas, incluido el formato JSON para importar y exportar.
1. Empezar
Créez un compte gratuit, et vous arrivez sur votre dashboard : c'est votre bibliothèque. Vous y trouvez d'office deux histoires de démonstration (badge « Démo ») : jouez-les pour comprendre l'expérience élève. Elles ne sont pas modifiables, mais le menu ⋯ permet de les dupliquer dans votre bibliothèque pour les adapter librement.
Le bouton + Nouvelle histoire crée un brouillon avec une première scène et ouvre l'éditeur.
2. Escribir una historia
Une histoire est une suite de scènes. Chaque scène raconte une situation (texte + image facultative) et propose des choix à l'élève :
• Un choix bonne réponse mène à la scène suivante (champ « Mène à la scène »). Vous pouvez y ajouter un renforcement : une phrase qui confirme et explique.
• Un choix fausse piste affiche son explication (« pourquoi c'est une erreur »), puis l'élève réessaie sur la même scène. Si vous lui donnez une scène cible, il part au contraire sur cette branche : utile pour créer de vraies bifurcations.
Une scène marquée « Scène finale » termine l'histoire, avec un ton : réussite, neutre ou échec. L'onglet Mapa montre toutes les scènes et leurs connexions (vert = bonnes réponses, pointillés vermillon = fausses pistes).
Au moment de publier, Tralo vérifie votre histoire : scènes sans bonne réponse, bonnes réponses sans destination, scènes non reliées au départ, absence de fin… Vous pouvez corriger ou publier quand même.
3. Crear fichas
En plus des histoires, Tralo propose des paquets de flashcards : des cartes recto/verso idéales pour la révision et la mémorisation rapide. Parfait pour les dates historiques, le vocabulaire, les formules, ou toute notion nécessitant une mémorisation active.
Un paquet se compose de multiples cartes. Chaque carte a :
• Un recto (la question, le terme ou le concept)
• Un verso(la réponse, la définition ou l'explication)
El alumno mira el anverso, intenta recordar y, a continuación, da la vuelta a la ficha para comprobarlo. Un método probado para consolidar los conocimientos.
En el editor de paquetes, puedes: añadir, duplicar o eliminar fichas, organizar su orden y visualizar la vista previa en tiempo real con un efecto de volteo en 3D.
4. Compartir con los alumnos
Le bouton Compartir de l'éditeur active le lien de partage (de la forme tralo.fr/s/abc123). Vos élèves l'ouvrent sur n'importe quel appareil, sans créer de compte.
Vous pouvez définir un code d'accès (ex. 6EMEB) pour réserver l'histoire à votre classe : les élèves le saisissent une fois, il reste mémorisé pendant leur session. Désactivez le lien à tout moment : il cesse immédiatement de fonctionner.
5. Estadísticas
Chaque lecture via le lien de partage alimente l'onglet Stats de l'éditeur : nombre de lectures, taux de complétion, score moyen, erreurs par lecture, et surtout les scènes les plus difficiles (où vos élèves se trompent le plus), précieux pour ajuster vos explications.
Le niveau de détail dépend de votre formule : les statistiques essentielles(cartes de synthèse) sont incluses dans le plan Gratuit ; l'analyse par scène est disponible dès le plan Essentiel ; les statistiques avancées (détail par session de lecture et export .csv) sont réservées aux plans Pro et Duo.
Les lectures sont sans identité déclaréepar défaut : aucun nom, prénom ni compte élève n'est demandé. Un identifiant technique de session et les données de progression restent toutefois enregistrés ; ces lectures sont donc pseudonymes, et non anonymes au sens strict du RGPD. Vos propres aperçus d'auteur ne comptent pas. Le bouton « Réinitialiser » efface l'historique (par exemple entre deux classes).
6. Organizar la biblioteca
Créez des dossiers colorés (par classe, matière, projet…) depuis la barre latérale du dashboard. Le menu ⋯ de chaque histoire permet de la déplacer, la dupliquer, l'exporter ou la supprimer. Supprimer un dossier ne supprime pas ses histoires : elles reviennent à la racine.
7. Importación/exportación y formato JSON
Chaque histoire s'exporte en fichier .json (menu ⋯ → Exporter, ou paramètres de l'éditeur). Le bouton Importer (.json) du dashboard (réservé aux formules payantes) accepte :
• une histoire seule (le format ci-dessous) ;
• une sauvegarde complète : { "stories": [ … ] } (générée par « Tout exporter » dans les paramètres).
À l'import, tous les identifiants sont régénérés et l'histoire arrive en brouillon à la racine : aucun risque de collision, vous pouvez importer le même fichier plusieurs fois.
| Campo | Tipo | Función |
|---|---|---|
| title | string | Título de la historia (obligatorio). |
| description | string | Presentación que se muestra a los alumnos antes de empezar. |
| emoji | string | Emoji de portada (p. ej., « 🗝 »). |
| coverGradient | number | Color de la portada, del 0 al 11. |
| startSceneId | string | ID de la escena inicial; debe existir en «scenes» (obligatorio). |
| scenes | Scene[] | La lista de escenas (obligatorio). |
| Campo | Tipo | Función |
|---|---|---|
| id | string | Identificador único en el archivo (libre: «scene-1»…). |
| title | string | Título de la escena (que se muestra en el encabezado del lado del alumno). |
| text | string | El texto de la escena. \n para los saltos de línea. |
| image | string | null | URL de una imagen, o nula. |
| choices | Choice[] | Las opciones propuestas ([] para una escena final). |
| isEnding | boolean | true = escena final (termina la historia). |
| endingTone | string | «success», «neutral» o «failure»: la pantalla final. |
| Campo | Tipo | Función |
|---|---|---|
| id | string | Identificador único en el archivo. |
| text | string | El texto de la opción que se muestra al alumno. |
| targetSceneId | string | null | ID de la escena de destino. En caso de respuesta incorrecta, null = el alumno vuelve a intentarlo en el mismo lugar. |
| isCorrect | boolean | true = respuesta correcta, false = pista falsa. |
| explanation | string | Comentario didáctico que se muestra tras la elección. |
Ejemplo completo (importable tal cual):
{
"title": "Le Trésor du CDI",
"description": "Une enquête au CDI pour apprendre à chercher l'information.",
"emoji": "🗝️",
"coverGradient": 2,
"startSceneId": "scene-depart",
"scenes": [
{
"id": "scene-depart",
"title": "L'énigme",
"text": "Un mot mystérieux vous attend sur la table du CDI : « Le trésor se cache dans le livre qui parle des volcans d'Auvergne. »\n\nComment le trouver ?",
"image": null,
"choices": [
{
"id": "choix-catalogue",
"text": "Chercher « volcans Auvergne » dans le catalogue en ligne",
"targetSceneId": "scene-rayon",
"isCorrect": true,
"explanation": "Exact : le catalogue indique la cote du livre en quelques secondes."
},
{
"id": "choix-hasard",
"text": "Ouvrir tous les livres un par un",
"targetSceneId": null,
"isCorrect": false,
"explanation": "Avec 5 000 livres au CDI, il vous faudrait des semaines. Le catalogue est fait pour ça !"
}
],
"isEnding": false,
"endingTone": "neutral"
},
{
"id": "scene-rayon",
"title": "Au rayon 550",
"text": "Le catalogue indique la cote 551.21 VOL. Vous trouvez le livre… et à l'intérieur, une carte de lecteur dorée !",
"image": null,
"choices": [],
"isEnding": true,
"endingTone": "success"
}
]
}Este formato se presta bien a la generación mediante IA: facilítale estas tablas y pídele una historia sobre tu tema y, a continuación, importa el resultado.
Generar una historia con una IA: indicación lista para copiar
Collez le texte ci-dessous dans l'assistant de votre choix (ChatGPT, Claude, Gemini…), remplacez ce qui est entre crochets par votre sujet et vos réglages, puis enregistrez la réponse dans un fichier .json que vous importerez avec le bouton Importer (.json) du dashboard.
Eres diseñador pedagógico. Crea una historia interactiva con ramificaciones (una narración en la que el alumno hace avanzar la trama respondiendo a preguntas) destinada a importarse a Tralo. PARÁMETROS (sustituye lo que aparece entre corchetes): - Tema: [TEMA, p. ej., el ciclo del agua] - Asignatura: [ASIGNATURA, p. ej., Ciencias Naturales] - Nivel de clase: [NIVEL, p. ej., 6.º] - Objetivo pedagógico: [LO QUE EL ALUMNO DEBE APRENDER O SABER HACER] - Número de escenas: [APROX. 8] - Número de finales: [AL MENOS 2, incluyendo uno de éxito y otro de fracaso] - Opciones por escena: [DE 2 A 3] - Tono / ambiente: [p. ej., investigación, aventura, vida cotidiana] - Duración de lectura prevista: [p. ej., 10 minutos] - Idioma: [francés] - A evitar / a priorizar: [vocabulario obligatorio, conceptos ajenos al programa que deben excluirse, etc.] INSTRUCCIONES: - Cada escena ofrece opciones: al menos una respuesta correcta que haga avanzar la historia y pistas falsas. Cada pista falsa tiene una explicación pedagógica clara (por qué es incorrecta y qué había que entender). - Una pista falsa con «targetSceneId»: null hace que el alumno vuelva a intentar la misma escena; en caso contrario, puede llevar a otra rama. - Adapta la historia y el vocabulario al nivel indicado, sin errores. El error siempre debe ser instructivo. - Prevé el número de finales solicitados, con distintos tonos (éxito / fracaso / neutro). FORMATO DE SALIDA: responde ÚNICAMENTE con un objeto JSON válido, sin ningún texto a su alrededor ni etiquetas Markdown, que se ajuste estrictamente a este modelo: { "title": "cadena", "description": "cadena (presentación que se muestra antes de empezar)", "emoji": "un solo emoji de portada", "coverGradient": número entero de 0 a 11, "startSceneId": "id de una escena de la lista que aparece a continuación", "scenes": [ { "id": "identificador único, p. ej., scene-1", "title": "cadena de caracteres", "text": "el texto de la escena (\n para un salto de línea)", "image": null, "choices": [ { "id": "identificador único, p. ej., elección-1", "text": «la opción que se presenta al alumno», «targetSceneId»: «id de la escena de destino, o null para volver a intentarlo en el mismo sitio», «isCorrect»: true o false, «explanation»: «el comentario que se muestra tras esta elección»Una IA puede equivocarse: abre la historia importada en el editor y comprueba los enlaces entre escenas, que las respuestas y los finales antes de compartirla. La importación comprueba el formato del archivo, no la corrección pedagógica.
8. Ajustes de la cuenta
La page Configuración (menu du compte → Paramètres) regroupe :
• Perfil: changer votre nom ; changer d'e-mail (confirmé par un lien envoyé à la nouvelle adresse).
• Equipo : invitations, membres et dossier partagé.
• Preferencias : affichage des histoires et flashcards de démonstration.
• Notificaciones : choisir les e-mails facultatifs ; les messages essentiels de sécurité, facturation et suppression restent actifs.
• Seguridad : changer de mot de passe, activer la vérification en deux étapes, renouveler les codes de secours et déconnecter des appareils.
• Mis datos : compteurs et export complet de vos histoires et images en un fichier (votre sauvegarde), durée de conservation des statistiques lecteurs et effacement immédiat de ces statistiques.
• Zona sensible : tout supprimer (après confirmation), demander la suppression du compte, se déconnecter.
Une question que cette page n'a pas résolue ? Écrivez-nous.
9. Suscripción y facturas
Tout se gère depuis Paramètres → Abonnement & Factures, sans passer par un site externe. Vous pouvez à tout moment changer de formule, basculer entre mensuel et annuel (la différence est calculée au prorata), résilier ou réactiver. Vos factures y sont consultables et téléchargeables en PDF.
Les formules : Gratis (3 histoires, sans images), Lo esencial (100 histoires, sans images), Pro (histoires illimitées + images dans les scènes). Dúo y equipo pequeño (2 à 5 personnes) donne à chaque membre un accès Pro nominatif, un Dossier partagé et une facture unique ; gérez les membres depuis Réglages → Équipe.
Remise « TRALO50 » : elle offre −50 % pendant 3 mois sur les abonnements mensuels Essentiel et Pro. Elle est appliquée automatiquement sur la page de récapitulatif Tralo ; vous n'avez aucun code à saisir sur la page Stripe.
Que se passe-t-il si mon abonnement s'arrête ?Si vous résiliez ou qu'un paiement n'aboutit pas, l'accès aux fonctions payantes est suspendu, mais vos histoires restent là pendant un mois. Vous recevez un e-mail, puis un rappel une semaine avant, puis deux jours avant. Passé ce mois, le contenu est supprimé (histoires, dossiers, images, statistiques), mais votre compte est conservé : vous pouvez revenir et reprendre un abonnement quand vous voulez. Pendant ce mois, deux options : réactiver votre formule, ou télécharger tout votre travail.
10. Descargar mis historias y mis imágenes
Vous gardez la main sur vos données. Pour tout récupérer, images comprises :
• Paramètres → Mes données → « Tout exporter (.zip) ». Vous obtenez un fichier .zip contenant tralo-sauvegarde.json (toutes vos histoires) et un dossier images/ avec toutes vos illustrations.
• Juste les images ? Depuis le dashboard → « Mes images », téléchargez une image à la fois, ou « Tout télécharger (.zip) ».
Pour réimporter plus tard, utilisez le bouton Importer (.json) du dashboard avec le fichier tralo-sauvegarde.json issu du zip (voir le format JSON).
11. Administrar una organización
Tralo Adminest la console séparée réservée aux organisations ouvertes avec l'équipe Tralo. Elle sert à gérer la structure, les membres, les invitations, les rôles, les licences, les contenus partagés, les statistiques, la facturation, la sécurité et le journal d'audit. Un abonnement individuel ou Duo ne donne pas automatiquement accès à cette console.
Le guide complet de Tralo Admin pour les organisations explique le parcours depuis l'invitation et la double authentification jusqu'aux opérations quotidiennes d'un administrateur, notamment la désignation du gestionnaire initial et l'invitation d'autres gestionnaires administrateurs.