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
- Dans API & Intégrations, créez une intégration pour Make sur votre organisme de test. Cochez
students:createet relevez l’URL de base ainsi que les deux jetons. - 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-1comme nom du paramètre. - Dans Headers, ajoutez
X-VF-Token-2avec le second jeton etAcceptavec la valeurapplication/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. - 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. - Lancez Run once. Le résultat attendu est un statut HTTP
200etdata.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_evenement | nom_complet | |
|---|---|---|
| ins-1042 | Camille Martin | camille@example.com |
- 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.
- 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.
- 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 HTTP | Valeur à mapper | Résultat pour la ligne de test |
|---|---|---|
Corps → name | Colonne nom_complet | Camille Martin |
Corps → email | Colonne email | camille@example.com |
Headers → Idempotency-Key | Texte fixe gs-apprenant- suivi de la pastille id_evenement | gs-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.
| Onglet | Une ligne représente | Colonnes proposées |
|---|---|---|
| Participants | Un salarié du lot | lot_id, nom_complet, email |
| Lots_valides | Une demande complète, à envoyer | lot_id, course_id, raison_sociale, email_entreprise, adresse, siret, prix_total, nb_participants |
- 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.00pour le prix. - 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. - Ajoutez Array aggregator. Choisissez Search Rows comme module source et
lot_idcomme regroupement. Construisez un élément avecnameetemailpour chaque salarié. Si vous utilisez le type de tableau du module HTTP suivant, définissez d’abord sa structurestudents[]. Avant l’envoi, filtrez sur un tableau non vide dont la longueur correspond ànb_participantset respecte le plafond de votre organisme. - Dans le module HTTP, choisissez POST vers
/enrollments/companiesavec la permissionenrollments:companies:create. Mappezcourse_id, les champs decompanyetcompany_enrollment.pricedepuis le lot. Pour un prix global, fixezcompany_enrollment.price_typeàtotal. Les champs decompanysontname,email,addressetsiret. - Activez le mappage du tableau
studentset sélectionnez le tableau de l’agrégateur. Utilisezgs-inscription-suivi delot_idcomme 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