Documentazione

La guida completa a Tralo

Tutto ciò che c'è da sapere per creare, condividere e migliorare le tue storie a ramificazione e i tuoi pacchetti di flashcard, compreso il formato JSON per l’importazione e l’esportazione.

1. Iniziare

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. Scrivere una storia

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 Mappa 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. Creare delle flashcard

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)

Lo studente osserva il fronte, cerca di ricordare, quindi gira la scheda per verificare. Un metodo collaudato per consolidare le conoscenze.

Nell’editor del mazzo è possibile: aggiungere, duplicare o eliminare schede, organizzarne l’ordine e visualizzare l’anteprima in tempo reale con un effetto di capovolgimento 3D.

4. Condividere con gli studenti

Le bouton Condividi 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. Statistiche

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. Organizzare la propria libreria

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. Importazione/esportazione e 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.

Storia (directory principale del file)
CampoTipoRuolo
titlestringTitolo della storia (obbligatorio).
descriptionstringPresentazione visualizzata agli studenti prima di iniziare.
emojistringEmoji di copertina (es. " 🗝 ").
coverGradientnumberColore della copertina, da 0 a 11.
startSceneIdstringID della scena iniziale; deve essere presente in scenes (obbligatorio).
scenesScene[]L'elenco delle scene (obbligatorio).
Scene (ogni elemento di scenes)
CampoTipoRuolo
idstringIdentificatore univoco nel file (a scelta: "scene-1"…).
titlestringTitolo della scena (visualizzato nell'intestazione dal lato dello studente).
textstringIl testo della scena. \n per i salti di riga.
imagestring | nullURL di un'immagine, oppure null.
choicesChoice[]Le scelte proposte ([] per una scena finale).
isEndingbooleantrue = scena finale (conclude la storia).
endingTonestring"success", "neutral" o "failure": la schermata finale.
Choice (ogni elemento di choices)
CampoTipoRuolo
idstringIdentificatore univoco nel file.
textstringIl testo della scelta presentato allo studente.
targetSceneIdstring | nullID della scena di destinazione. In caso di risposta errata, null = lo studente riprova nella stessa scena.
isCorrectbooleantrue = risposta corretta, false = risposta errata.
explanationstringIl feedback didattico visualizzato dopo la scelta.

Esempio completo (importabile così com'è):

{
  "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"
    }
  ]
}

Questo formato si presta bene alla generazione tramite IA: fornite queste tabelle e richiedete una storia sul vostro argomento, quindi importate il risultato.

Generare una storia con un'IA: prompt pronto da copiare

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.

Sei un progettista didattico. Crea una storia interattiva a ramificazioni (un racconto in cui lo studente fa progredire la trama rispondendo a delle domande) destinata ad essere importata in Tralo. PARAMETRI (sostituisci ciò che è tra parentesi quadre): - Argomento / tema: [ARGOMENTO, es. il ciclo dell'acqua] - Materia: [MATERIA, es. Scienze naturali] - Livello scolastico: [LIVELLO, es. 6ª] - Obiettivo didattico: [CIÒ CHE LO STUDENTE DEVE IMPARARE O SAPERE FARE] - Numero di scene: [CIRCA 8] - Numero di finali: [ALMENO 2, di cui uno positivo e uno negativo] - Scelte per scena: [DA 2 A 3] - Tono / atmosfera: [es. indagine, avventura, vita quotidiana] - Durata di lettura prevista: [es. 10 minuti] - Lingua: [francese] - Da evitare / da privilegiare: [vocabolario prestabilito, concetti fuori programma da escludere, ecc.] ISTRUZIONI: - Ogni scena propone delle scelte: almeno una risposta corretta che fa progredire la narrazione e delle false piste. Ogni falsa pista ha una chiara spiegazione didattica (perché è sbagliata e cosa bisognava capire). - Una falsa pista con "targetSceneId": null fa riprovare lo studente sulla stessa scena; altrimenti può condurre a un altro ramo. - Adatta la narrazione e il vocabolario al livello indicato, senza errori. L’errore deve sempre essere istruttivo. - Prevedi il numero di finali richiesto, con toni diversi (successo / fallimento / neutro). FORMATO DI OUTPUT: rispondi ESCLUSIVAMENTE con un oggetto JSON valido, senza alcun testo circostante né tag Markdown, rigorosamente conforme a questo modello: { "title": "stringa", "description": "stringa (presentazione visualizzata prima di giocare)", "emoji": "un solo emoji di copertina", "coverGradient": numero intero da 0 a 11, "startSceneId": "ID di una scena dall'elenco sottostante", "scenes": [ { "id": "identificatore univoco, es. scene-1", "title": "stringa", "text": "il testo della scena (\n per un'interruzione di riga)", "image": null, "choices": [ { "id": "identificatore univoco, es. scelta-1", "text": "la scelta presentata allo studente", "targetSceneId": "ID della scena di destinazione, oppure null per riprovare nella stessa scena", "isCorrect": true o false, "explanation": "il feedback visualizzato dopo questa scelta" } ], "isEnding": true o false, "endingTone": "success" | "neutral" | "failure" } ] } REGOLE IMPERATIVE: - Tutti gli "id" (scene e scelte) sono univoci nel file. - "startSceneId" corrisponde esattamente all'"id" di una scena esistente. - Ogni "targetSceneId" diverso da zero punta a una scena esistente. - Una scena finale ha "isEnding": true e "choices": []. - Ogni scena non finale ha almeno una scelta con "isCorrect": true e un "targetSceneId" valido. - Lascia "image": null ovunque (qui non si aggiungono immagini). - Il JSON deve essere valido e importabile così com’è.

Un'IA può sbagliare: apri la storia importata nell'editor e verifica i collegamenti tra le scene, la correttezza delle risposte e i finali prima di condividerla. L’importazione controlla il formato del file, non la correttezza didattica.

8. Impostazioni dell'account

La page Impostazioni (menu du compte → Paramètres) regroupe :

Profilo: changer votre nom ; changer d'e-mail (confirmé par un lien envoyé à la nouvelle adresse).
Squadra : invitations, membres et dossier partagé.
Preferenze : affichage des histoires et flashcards de démonstration.
Notifiche : choisir les e-mails facultatifs ; les messages essentiels de sécurité, facturation et suppression restent actifs.
Sicurezza : changer de mot de passe, activer la vérification en deux étapes, renouveler les codes de secours et déconnecter des appareils.
I miei dati : 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.
Area sensibile : 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. Abbonamento e fatture

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 : Gratuito (3 histoires, sans images), Essenziale (100 histoires, sans images), Pro (histoires illimitées + images dans les scènes). Duo e piccolo team (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. Scaricare le mie storie e le mie immagini

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. Amministrare un'organizzazione

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.