VORTEX Integration Systeme.io

Guide complet de configuration — 6 etapes

Admin prive
Formulaire opt-in
API SYSTEMEIO_API_KEY
Contact cree
Tag ajoute
Regle automatisation
Sequence email
1

Obtenir la cle API Systeme.io

Compte : matelena30@gmail.com

Ou aller dans Systeme.io

systeme.io → Se connecter avec matelena30@gmail.com En haut a droite → clic sur ton avatar / nomParametres du profil → onglet API et Webhooks → section Cles API → bouton [Generer une nouvelle cle API]

Creer la cle

  1. Nom de la cle : VORTEX Deploy
  2. Permissions : Lecture + Ecriture (toutes les permissions)
  3. Cliquer sur Creer
  4. La cle s'affiche une seule fois → la copier immediatement
Attention : La cle API ne s'affiche qu'a la creation. Une fois la page fermee, tu ne peux plus la voir. Copie-la maintenant et garde-la en securite.

Format de la cle

Exemple de format : sk_prod_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (chaine longue commencant souvent par sk_ ou directement alphanumerique)

Checklist

  • Connecte a systeme.io avec matelena30@gmail.com
  • Cle API generee avec permissions lecture + ecriture
  • Cle copiee et sauvegardee en securite
2

Ajouter la variable dans Vercel

Variable d'environnement SYSTEMEIO_API_KEY

Ou aller dans Vercel

vercel.com → Se connecter → Dashboard → projet vortex-deploy → onglet Settings → section Environment Variables

Variable a ajouter

SYSTEMEIO_API_KEY = [ta cle API copiee a l'etape 1]

Configuration du scope

Environments a cocher : [x] Production [x] Preview [x] Development Sensitive : Oui (coche "Sensitive" si l'option existe)

Sauvegarder et redéployer

  1. Cliquer sur Save
  2. Aller dans l'onglet Deployments
  3. Cliquer sur les 3 points du dernier deployment → Redeploy
  4. Attendre que le deployment passe au vert
Pourquoi redéployer ? Les variables d'environnement Vercel ne sont prises en compte qu'au prochain deploiement. Sans redeploi, les fonctions API continueront a utiliser l'ancienne configuration.

Verification dans le code

La variable est deja lue dans api/_config.js et api/_db.js :

// api/_config.js const SYSTEMEIO_API_KEY = process.env.SYSTEMEIO_API_KEY || ''; // api/_db.js — sendToSystemeIO utilise cette variable const apiKey = process.env.SYSTEMEIO_API_KEY; if (!apiKey) return; // Silencieux si pas defini

Checklist

  • Variable SYSTEMEIO_API_KEY ajoutee dans Vercel
  • Scope : Production + Preview + Development
  • Redeploi effectue et deployment au vert
3

Creer les tags dans Systeme.io

3 tags pour segmenter les leads et membres

Ou aller dans Systeme.io

Menu lateral gaucheContacts → onglet Tags → bouton [+ Creer un tag]

Tag 1 — Guide gratuit

Tag 2 — Challenge 21 jours

Tag 3 — Membre actif

Nommage important : Les noms de tags doivent etre identiques au caractere pres a ce qui est envoye dans le code (sendToSystemeIO(email, 'lead-guide-gratuit')). Pas d'espaces, pas de majuscules.

Checklist

  • Tag "lead-guide-gratuit" cree
  • Tag "lead-challenge-21j" cree
  • Tag "membre-actif" cree
4

Campagne : Nurturing Guide Gratuit

Sequence automatique de 7 emails sur 6 jours

Creer la campagne

Menu lateral gaucheEmailsCampagnes → bouton [+ Creer une campagne]

Parametres de la campagne

Comment ajouter chaque email

Dans la campagne[+ Ajouter un email] → Remplir l'Objet → Regler le Delai → Editeur → icone </> HTML → Coller le contenu HTML
Regle d'automatisation : Apres avoir cree la campagne, configure une regle : Trigger = tag lead-guide-gratuit ajoute → Action = inscrire a cette campagne. La campagne doit etre activee (pas en brouillon) pour que les emails partent.

Checklist

  • Campagne "VORTEX — Nurturing Guide Gratuit" creee
  • 7 emails ajoutes avec les bons delais (J0, J1, J2, J3, J4, J5, J6)
  • Campagne activee (pas en brouillon)
  • Regle : tag lead-guide-gratuit → inscription campagne
5

Campagne : Challenge 21 Jours

21 emails sur 21 jours — 1 email par jour

Creer la campagne

EmailsCampagnes[+ Creer] → Type : Sequence

Parametres

Structure des 21 emails

Chaque email correspond a 1 jour du challenge. Delai = 1 jour entre chaque. Le premier email (Jour 1) s'envoie immediatement a l'inscription.

Regle d'automatisation pour le challenge

Automatisations → Regles → [+ Creer] Declencheur : Tag ajoute Tag : lead-challenge-21j Action : Inscrire a une campagne Campagne : VORTEX — Challenge 21 Jours

Email Jour 21 — Conversion

Checklist

  • Campagne "VORTEX — Challenge 21 Jours" creee
  • 21 emails ajoutes, delai 1 jour entre chaque
  • Email Jour 21 avec CTA de conversion
  • Campagne activee
  • Regle automatisation : tag lead-challenge-21j → inscription campagne
6

Tester l'integration complete

Verification de bout en bout

Test 1 — Formulaire opt-in guide gratuit

  1. Ouvrir vortex-deploy.vercel.app/guide-gratuit.html dans un onglet prive
  2. Entrer une adresse email de test (ex. ton email +test : matelena30+test@gmail.com)
  3. Soumettre le formulaire
  4. Verifier dans Systeme.io → Contacts que le contact apparait avec le tag lead-guide-gratuit
  5. Verifier dans la campagne que le contact est inscrit a la sequence
  6. Verifier que l'email 1 a ete envoye (ou est en file d'attente)
Systeme.io → Contacts → Rechercher l'email de test → Verifier les tags : lead-guide-gratuit present → Onglet Campagnes → inscrit a "VORTEX — Nurturing Guide Gratuit" → Statut email 1 : Envoye ou En attente

Test 2 — Contact existant (409 Conflict)

  1. Soumettre le formulaire une 2e fois avec le meme email
  2. L'API doit detecter le 409 et faire un PATCH au lieu de POST
  3. Le contact ne doit pas etre duplique dans Systeme.io
  4. Le tag doit etre ajoute si absent
La nouvelle version de sendToSystemeIO dans api/_db.js gere automatiquement le cas 409. Verifier les logs Vercel si le comportement est inattendu.

Test 3 — Verifier les logs Vercel

vercel.com → vortex-deploy → Deployments → Dernier deployment → Functions → Chercher les appels API recents → Verifier absence de message : "Systeme.io error" → Presence de : pas d'erreur = OK

Diagnostics frequents

Fonction addTagToContact (usage avance)

Pour ajouter un tag supplementaire a un contact deja existant depuis une autre fonction API :

const { addTagToContact } = require('./_db'); // Exemple : apres un paiement confirme, ajouter le tag membre-actif await addTagToContact(email, 'membre-actif'); // Retourne { ok: true } ou { ok: false, reason: '...' }

Resume de la configuration complete

Variable Vercel SYSTEMEIO_API_KEY = cle API Systeme.io
Tags crees lead-guide-gratuit lead-challenge-21j membre-actif
Campagne 1 VORTEX — Nurturing Guide Gratuit (7 emails, J0 a J6)
Campagne 2 VORTEX — Challenge 21 Jours (21 emails, 1/jour)
Regles tag lead-guide-gratuit → sequence guide
tag lead-challenge-21j → sequence challenge
Gestion 409 Contact existant → PATCH automatique (update + tag)
Flux complet Formulaire → API Vercel → Systeme.io → tag → regle → campagne → emails

Checklist finale

  • Test 1 OK — contact cree avec tag lead-guide-gratuit
  • Test 1 OK — inscrit a la sequence guide, email 1 envoye
  • Test 2 OK — pas de doublon avec 2e soumission du meme email
  • Aucune erreur dans les logs Vercel
  • Campagne challenge configuree et activee
  • Integration complete et operationnelle