Documentation

Import de fichiers CSV

Découvre comment configurer ta base de données et gérer l'import de fichiers CSV dans Emailzing.

Choix du stockage de données

Emailzing te propose deux options pour stocker tes données de prospection :

OptionAvantagesNœuds concernés
PostgreSQLSQL avancé, faible coût, auto-hébergementCreateTablesOnce, tous les nœuds postgres
AirtableInterface visuelle, déploiement instantanéInitAirtable, InsertCompaniesAirtable, tous les nœuds airtable

Pour Airtable, clone notre base modèle. Clique sur "Copier la base" puis configure l'ID appXXXXX et ton Personal Access Token dans les credentials n8n.

Initialisation de la structure

1. Choisis et initialise ton moteur de base de données

Selon ton choix de stockage :

  • PostgreSQL : Ouvre le nœud CreateTablesOnce, vérifie le SQL et exécute-le (une seule fois).
  • Airtable : Lance le nœud InitAirtable pour créer les tables companies, workfields et requests.

2. Configure le pipeline d'ingestion CSV

Le workflow suit cette séquence :

WatchCSVFolder → DownloadFile → SplitRows → ParseCSV → MapColumns → RequireDomain&LinkedIn → UpsertCompany → Done

Sources des fichiers CSV

Tu peux obtenir tes fichiers CSV de différentes sources :

  • TheirStack : une excellente source pour identifier les entreprises utilisant des technologies spécifiques
  • Exports LinkedIn
  • Bases de données d'entreprises
  • Listes personnalisées

TheirStack est particulièrement utile car il te permet d'identifier précisément les entreprises utilisant les technologies qui t'intéressent (React, Vue, Angular, etc.).

Convention de nommage

Le nom de tes fichiers CSV suit le format : [workfield]_[tag].csv
Exemples :

  • React_1.csv : entreprises utilisant React
  • NextJS_Q2.csv : entreprises utilisant Next.js (prospects pour Q2)
  • Svelte.csv : entreprises utilisant Svelte

Le préfixe [workfield] est crucial car il permet à Emailzing de :

  • Lier automatiquement les entreprises à leur stack technique
  • Personnaliser les messages de prospection en fonction de la technologie utilisée
  • Segmenter ta base de prospects par expertise

Structure du CSV

Les entêtes obligatoires sont :

  • Domain : domaine de l'entreprise
  • Employees : nombre d'employés
  • Company : nom de l'entreprise
  • Telephones : numéros de téléphone
  • Emails : adresses email génériques
  • LinkedIn : URL de la page entreprise LinkedIn
  • City : ville
  • State : état/région
  • Country : pays

Tu peux adapter les noms des colonnes dans le nœud MapColumns si tes fichiers CSV utilisent une structure différente.

3. Configure les workfields

Le workflow utilise deux nœuds pour initialiser les domaines d'expertise :

  • ConfigureWorkFields
  • CreateWorkfields

Exemple de configuration :

[
  { id: "React",     years: "9" },
  { id: "NextJS",    years: "4" },
  { id: "SvelteKit", years: "3" }
]

Le champ id doit correspondre au préfixe [workfield] de tes fichiers CSV pour une personnalisation correcte des emails.

4. Import manuel de prospects (optionnel)

Si tu disposes déjà d'une liste de prospects qualifiés, tu as plusieurs options pour les intégrer :

Import direct dans Airtable

La méthode la plus simple si tu utilises Airtable :

  1. Ouvre ta base Airtable
  2. Va dans la table leads
  3. Clique sur "+" pour ajouter des lignes
  4. Copie/colle tes données ou importe-les via l'interface Airtable

Airtable accepte les imports CSV et Excel, et peut mapper automatiquement les colonnes si les noms correspondent.

Création d'un workflow personnalisé

Tu peux créer ton propre workflow n8n pour automatiser l'import depuis d'autres sources :

  • Un dossier Drive dédié aux prospects
  • Une autre base de données
  • Une API tierce

La seule contrainte est de respecter la structure de données suivante :

ChampDescriptionObligatoire
emailEmail du prospect
first_namePrénom
last_nameNom
company_nameNom de l'entreprise
linkedin_profile_urlURL du profil LinkedIn
languageLangue préférée (FR/EN)
positionPoste occupé
phoneTéléphone
notesNotes diverses

Assure-toi que les données importées sont propres et standardisées :

  • Emails en minuscules
  • Noms correctement capitalisés
  • URLs LinkedIn complètes
  • Langue en format ISO (FR/EN)

Vérification des credentials

Assure-toi d'avoir configuré tous les accès nécessaires :

ServiceConfiguration
Google Drive OAuthNœuds WatchCSVFolder, DownloadFile
PostgreSQLCredential PostgreSQL Database
Airtable Personal TokenTous les nœuds Airtable
Google Custom SearchNœud GetEmployeesList (key + cx)

Test rapide

  1. Désactive les triggers
  2. Exécute CreateTablesOnce (ou InitAirtable) puis SeedWorkfields
  3. Dépose React_demo.csv dans le dossier Drive surveillé
  4. Vérifie l'enregistrement dans la table companies
  5. Réactive les triggers

Une fois ces étapes validées, tu peux passer à la configuration de la recherche de leads LinkedIn.


Si tu utilises Airtable, tu peux cloner directement notre base de prospects prête à l'emploi.