Importer un cours depuis Teachable (API)

Teachable n’exporte pas les cours sous forme de fichier, mais son API publique permet à Acatudy de lire un cours leçon par leçon : le programme, le texte de chaque leçon, ses quiz et les élèves inscrits. Teachable exige le plan Growth ou supérieur pour créer des clés d’API. Avec un autre plan, utilisez la voie par CSV décrite à la fin.

1. Créer une clé d’API dans Teachable

1. Ouvrir les paramètres de l’API

   Dans l’administration de votre école Teachable, allez dans Settings → API.

2. Créer la clé

   Cliquez sur Create API Key, donnez-lui un nom (par exemple « Import Acatudy ») et copiez-la. Une clé créée uniquement pour cela se supprime facilement une fois terminé.

2. Se connecter et choisir le cours

1. Ouvrir l’outil d’import Teachable

   Allez dans Importer, ouvrez Migrer depuis une autre plateforme, choisissez Teachable et cliquez sur Se connecter via l’API.

2. Coller la clé

   Cliquez sur Se connecter et voir mes cours. Acatudy vérifie la clé immédiatement et liste vos cours, y compris ceux qui ne sont pas publiés (signalés comme tels).

3. Choisir un cours

   Sélectionnez le cours, laissez coché Importer aussi la liste des élèves du cours si vous voulez inviter ses élèves, puis cliquez sur Lire le cours. Acatudy lit chaque leçon en arrière-plan et ouvre l’aperçu une fois terminé ; un cours volumineux peut prendre quelques minutes.

3. Vérifier l’aperçu et importer

Choisissez le nom de la matière et le cours et, pour chaque quiz, s’il s’agit d’un Test d’entraînement (ne compte pas dans la note) ou d’un Examen. Les quiz sans question notée sont proposés comme tests d’entraînement. Chaque élément des leçons apparaît avec ce qu’il devient, ou le motif pour lequel il est ignoré. Cliquez sur Importer ; à la fin, vous pouvez télécharger le Récapitulatif de l’import (CSV) avec chaque élément, son résultat et le motif.

4. Ce qui devient quoi

Les unités qui ont encore quelque chose à recréer sont créées non publiées, avec la liste en haut de leur description, pour que les élèves ne voient pas d’unités inachevées.

5. Terminer le contenu

• Vidéos : téléchargez-les dans Teachable et importez-les dans leur unité (Acatudy les optimise pour le streaming), ou ajoutez-les sous forme de liens si elles sont sur YouTube, Vimeo ou un service similaire.
• Pièces jointes : importez les PDF et les images de la liste comme ressources de l’unité.
• Questions à plusieurs bonnes réponses : dans Acatudy, les questions à choix multiple n’ont qu’une seule bonne réponse ; réécrivez-les ou scindez-les.
• Quand une unité est complète, supprimez sa liste À recréer et publiez-la.

Élèves : des invitations, pas des copies

Les inscriptions de Teachable ne contiennent qu’un identifiant ; Acatudy recherche donc le nom et l’email de chaque élève, jusqu’à 1 000 par cours (s’il y en a davantage, l’aperçu vous indique d’importer le reste avec le CSV de Teachable). Le brouillon s’ouvre dans l’outil d’import d’élèves habituel : les nouveaux élèves créent leur propre mot de passe avec un lien, et celui qui a déjà un compte dans une autre académie Acatudy reçoit une invitation sans que son compte soit modifié.

Ce qui n’est pas importé

• Les vidéos hébergées sur Teachable, les pièces jointes, les commentaires, les offres complémentaires (upsells) et les scripts des blocs de code intégré.
• Les questions à plusieurs bonnes réponses ou sans bonne réponse.
• La progression des élèves, les notes, les réponses aux quiz et les certificats ; les prix et les pages de vente.

Sans accès à l’API

Le propriétaire de l’école peut exporter les élèves dans Teachable depuis Users → Export CSV. Le lien reçu par email expire vite : téléchargez-le tout de suite et téléversez-le dans Utilisateurs → Importer les élèves. Consultez aussi Migrer depuis d’autres plateformes.

Sécurité et limites

Acatudy ne fait que lire depuis Teachable. La clé n’est pas enregistrée : elle circule chiffrée entre les étapes de l’outil d’import, est utilisée pendant la lecture du cours puis supprimée. Les requêtes sont espacées et s’interrompent quand Teachable le demande. Importer à nouveau le même cours affiche un avertissement et ne le duplique jamais, sauf si vous cochez Importer à nouveau comme copie.