Passer au contenu principal

Comment importer vos contacts externes ?

Importez facilement vos contacts pour optimiser le parcours de don et pré-remplir automatiquement les informations de vos donateurs.

Écrit par Jimmy Ratiarison

Vous souhaitez simplifier l’expérience de don grâce à des données déjà connues ?
Suivez les étapes ci-dessous pour importer vos contacts externes correctement 👇


⚙️ Étape 1 - Préparer votre fichier d’import

Avant toute chose, vous devez compléter ce fichier de contacts externes.

ℹ️ Le fichier fourni est un modèle générique → pensez à le télécharger ou à le dupliquer afin de pouvoir le remplir


📄 Comprendre la structure du fichier

Le fichier contient deux feuilles :

1. Feuille de documentation

Elle détaille pour chaque colonne :

  • Sa description

  • Le format attendu

  • Des exemples

  • Son caractère obligatoire ou non

2. Feuille de saisie

C’est ici que vous pouvez renseigner les informations de vos contacts après avoir téléchargé le fichier sur votre ordinateur.

☝🏻 Plus vous ajoutez d’informations, plus le pré-remplissage sera efficace.


🧩 Champs obligatoires

Vous devez obligatoirement renseigner 3 colonnes :

  • email
    Exemple : [email protected]

  • contact_key
    Clé unique permettant d’identifier le contact

    • Minimum 24 caractères

    • Doit être unique pour chaque contact
      Exemple : 3cc0ae90-9e68-42ae-8ea1-4259141b44c5

    💡 Vous pouvez utiliser un outil ou une IA pour générer ces clés.

  • external_id
    Identifiant externe du donateur (ex : ID dans votre CRM)
    Exemple : 0d0e456c-906e-4cf9-b059-001c6e93e181

ℹ️ Le contact_key est essentiel et doit être stocké dans votre CRM : il permet de retrouver le donateur et de pré-remplir automatiquement le formulaire sur la base du formulaire appelé depuis votre CRM et/ou n'importe quel url dans laquelle vous poussez le champ contact_key


✏️ Finaliser votre fichier

  1. Complétez les informations disponibles

  2. Supprimez les colonnes inutilisées

  3. Exportez le fichier au format CSV


📥 Étape 2 - Importer vos contacts dans RGIVE

Rendez-vous dans : Exports / Imports → Imports

Créer un modèle d’import

  1. Cliquez sur Créer un modèle

  2. Renseignez :

    • Nom du modèle

    • Schéma : sélectionnez Contacts externes

  3. Enregistrez


Lancer l’import

  1. Cliquez sur le bouton ▶️ (en haut à droite)

  2. Cliquez sur Exécuter

  3. Sélectionnez votre fichier CSV

  4. Cochez Exécution test (recommandé)

  5. Lancez l’exécution


Vérifier l’import

Rendez-vous dans : Historique d’exécution

  • Cliquez sur Voir pour consulter le détail

  • En cas d’erreur :

    • Téléchargez le fichier d’erreurs en cliquant sur "voir"

    • Corrigez puis relancez l’import

✅ Si tout est correct, relancez l’import sans mode test


🔍 Étape 3 - Vérifier vos contacts importés

Rendez-vous dans : Contacts externes

Vous pourrez :

  • Consulter la liste des contacts importés

  • Accéder à chaque fiche donateur

  • Vérifier les informations importées

  • Retrouver la contact_key associée


🔗 Étape 4 - Utiliser la clé pour pré-remplir un formulaire

Pour pré-remplir un formulaire de don, il suffit d’ajouter la clé dans l’URL :

?contact_key=VOTRE_CLE

📌 Exemple :

https://donate.surfrider.eu/don/?contact_key=da2c2fc268d3d75887478beb8ccdce52cbed340b160c74c25568a7447d600b46

🎯 Résultat :
Lorsque le donateur accède à ce lien, ses informations sont automatiquement pré-remplies.


🔒 Sécurité et bonnes pratiques

  • ✅ Les données ne sont pas visibles dans l’URL (seule la clé est utilisée)

  • ✅ Le système respecte les recommandations de la CNIL

  • ✅ Chaque clé est unique et sécurisée

💡 Cela garantit un parcours fluide tout en protégeant les données personnelles.


🚀 Bonnes pratiques

Pour optimiser vos imports :

  • Ajoutez un maximum d’informations utiles

  • Vérifiez l’unicité des contact_key

  • Testez toujours vos imports avant exécution finale

  • Conservez une copie propre de vos fichiers


✅ Vos contacts externes sont maintenant importés et prêts à être utilisés !
Vos donateurs bénéficient d’un parcours simplifié et personnalisé 🎉

Avez-vous trouvé la réponse à votre question ?