VisioFormation · APIConnecter vos outils, conserver le contrôle

Connecter Make à VisioFormation avec Google Sheets

À chaque nouvelle ligne dans Google Sheets, Make peut créer ou retrouver un apprenant dans VisioFormation. Ce premier scénario utilise deux champs, name et email. Un troisième champ du tableur identifie l’événement pour permettre un nouvel essai.

Tester la connexion à VisioFormation

  1. Dans API & Intégrations, créez une intégration pour Make sur votre organisme de test. Cochez students:create et relevez l’URL de base ainsi que les deux jetons.
  2. Dans un scénario de test, ajoutez HTTP → Make a request (version 4). Sélectionnez API key. Dans Credentials, créez une clé avec le premier jeton comme valeur, choisissez In the header et saisissez X-VF-Token-1 comme nom du paramètre.
  3. Dans Headers, ajoutez X-VF-Token-2 avec le second jeton et Accept avec la valeur application/json. Le champ d’en-tête manuel peut être visible aux éditeurs du scénario ou dans un export. Utilisez une paire de test et gardez les jetons hors du tableur. Pour une équipe qui doit masquer les deux valeurs aux éditeurs, utilisez une connexion Make privée qui gère les deux secrets.
  4. Choisissez GET. Collez l’URL de base de votre compte, puis ajoutez /auth/check. Laissez le corps vide. Activez Parse response et désactivez Allow redirects dans les options avancées.
  5. Lancez Run once. Le résultat attendu est un statut HTTP 200 et data.authenticated à true. Une fois la connexion vérifiée, réutilisez ces réglages d’authentification dans le scénario ci-dessous.

Préparer une feuille Google Sheets

Nommez le premier onglet Apprenants. Inscrivez ces en-têtes sur la première ligne et ajoutez une ligne de test. Attribuez un identifiant permanent à chaque nouvel événement, même si vous triez ensuite le tableau.

id_evenementnom_completemail
ins-1042Camille Martincamille@example.com
  1. Créez un scénario avec Google Sheets → Watch New Rows. Sélectionnez le fichier, l’onglet Apprenants et indiquez que la première ligne contient les en-têtes. Gardez les lignes de données consécutives.
  2. Pour choisir votre ligne d’essai, réglez le point de départ du déclencheur. Si vous partez des prochaines lignes, ajoutez une nouvelle ligne complète après avoir réglé ce point. Lancez le déclencheur une fois pour voir les colonnes dans le panneau de mappage.
  3. Ajoutez HTTP → Make a request après Google Sheets. Reprenez la clé et l’en-tête du test de connexion. Passez la méthode à POST et ajoutez /students à l’URL de base.

Remplir le JSON avec les valeurs de la ligne

Choisissez Body content type → application/JSON, puis Body input method → Data structure. Créez une structure avec les deux champs de type Text ci-dessous. Cliquez dans chaque valeur et sélectionnez la colonne issue du module Google Sheets.

Emplacement dans HTTPValeur à mapperRésultat pour la ligne de test
Corps → nameColonne nom_completCamille Martin
Corps → emailColonne emailcamille@example.com
Headers → Idempotency-KeyTexte fixe gs-apprenant- suivi de la pastille id_evenementgs-apprenant-ins-1042

Make ajoute le type de contenu JSON et encode les valeurs. Avec la ligne ci-dessus, le corps envoyé contient exactement les deux propriétés suivantes.

{
  "name": "Camille Martin",
  "email": "camille@example.com"
}

Exécutez le scénario une fois. Vérifiez success, puis conservez data.student_id et request_id. Le statut 201 indique une création et 200 peut indiquer la réutilisation d’un compte compatible. Pour vérifier le résultat dans VisioFormation, cherchez l’email dans vos apprenants. Activez ensuite la planification souhaitée dans Make.

Envoyer une entreprise avec un nombre variable d’apprenants

Pour inscrire plusieurs salariés à une même session, utilisez un seul classeur avec deux onglets. Un lot_id identifie une demande d’inscription à une session donnée. L’entreprise peut ainsi envoyer une autre demande ultérieurement avec un autre identifiant.

OngletUne ligne représenteColonnes proposées
ParticipantsUn salarié du lotlot_id, nom_complet, email
Lots_validesUne demande complète, à envoyerlot_id, course_id, raison_sociale, email_entreprise, adresse, siret, prix_total, nb_participants
  1. Renseignez d’abord tous les salariés dans Participants. Ajoutez la ligne dans Lots_valides quand le lot est complet. Enregistrez le SIRET, l’identifiant de session et le prix comme du texte, par exemple 900.00 pour le prix.
  2. Déclenchez le scénario sur Watch New Rows dans Lots_valides. Ajoutez Google Sheets → Search Rows sur Participants avec le filtre lot_id égal au lot déclencheur. Réglez la limite de recherche pour couvrir tous les salariés du lot.
  3. Ajoutez Array aggregator. Choisissez Search Rows comme module source et lot_id comme regroupement. Construisez un élément avec name et email pour chaque salarié. Si vous utilisez le type de tableau du module HTTP suivant, définissez d’abord sa structure students[]. Avant l’envoi, filtrez sur un tableau non vide dont la longueur correspond à nb_participants et respecte le plafond de votre organisme.
  4. Dans le module HTTP, choisissez POST vers /enrollments/companies avec la permission enrollments:companies:create. Mappez course_id, les champs de company et company_enrollment.price depuis le lot. Pour un prix global, fixez company_enrollment.price_type à total. Les champs de company sont name, email, address et siret.
  5. Activez le mappage du tableau students et sélectionnez le tableau de l’agrégateur. Utilisez gs-inscription- suivi de lot_id comme clé d’idempotence. Gardez le même ordre de salariés lors d’un réessai. Vérifiez les identifiants de l’entreprise et de chaque inscrit dans la réponse.

Cette opération inscrit immédiatement les salariés. Pour soumettre une demande à validation, utilisez la route de pré-inscription entreprise et son propre modèle de champs.

Reprendre un scénario après une erreur

Après un délai dépassé, reprenez le même événement avec son corps et sa clé d’origine. Pour un 429, planifiez le réessai après le nombre de secondes annoncé dans Retry-After. Pour un 422, consultez error.fields et corrigez le mappage. Un 409 demande de lire error.code avant toute nouvelle tentative.

Documentation Make · Module HTTP · Clé API · Google Sheets · Agrégateur