Passer au contenu principal

Automatiser vos imports de fichiers via SFTP

Déposer régulièrement vos fichiers CSV sur un serveur SFTP pour que Feedier les importe automatiquement, sans doublons.

F
Écrit par François Forest

Menu → Sources → Nouvel import → Synchronisation → CSV via SFTP

En bref : vos systèmes déposent un fichier CSV sur un serveur SFTP, Feedier le récupère, l'importe, puis le range dans un dossier d'archive. C'est la solution pour un flux régulier de feedbacks (tickets, enquêtes d'un autre outil, exports CRM, transcriptions).

Quelle méthode pour un flux régulier ?

Votre situation

Méthode recommandée

Vos données sont dans Google Cloud

BigQuery : poussez vos données dans une table, Feedier les récupère seul. Aucune maintenance de fichiers.

Vos systèmes produisent des fichiers

CSV via SFTP (cet article)

Vous importez un historique une seule fois

Étape 1 : préparer le serveur SFTP

Option

Ce que vous faites

1. Votre propre serveur SFTP

Confirmez l'hôte, le port et le nom d'utilisateur. Créez un utilisateur dédié avec un répertoire personnel. Autorisez les adresses IP de Feedier dans votre pare-feu. Feedier vous fournit sa clé publique SSH.

2. Un SFTP fourni par Feedier

Envoyez l'adresse IP publique d'où partiront vos fichiers (pour l'autoriser) et la clé publique SSH de la machine d'envoi. Feedier vous renvoie l'adresse du serveur et vos identifiants.

L'accès se fait uniquement par clé SSH, jamais par mot de passe.

Créez un dossier par flux, par exemple un dossier par enquête.

Étape 2 : créer la connexion SFTP

  1. Allez dans Paramètres → Connexions et cliquez sur Nouvelle connexion.

  2. Choisissez SFTP (authentification par clé privée) et renseignez les informations du serveur.

Étape 3 : créer l'import

  1. Dans Sources, cliquez sur Nouvel import, choisissez Synchronisation puis CSV via SFTP.

  2. Renseignez les champs :

Champ

À quoi il sert

Connexion SFTP

La connexion créée à l'étape 2

Dossier à surveiller

Le dossier où arrivent les fichiers. Laissé vide, Feedier utilise le chemin de la connexion.

Motif de nom de fichier

Pour ne prendre que certains fichiers, par exemple tickets_*.csv

Colonnes à importer

Les en-têtes exacts de vos fichiers, utilisés à l'étape de correspondance

Colonne de date

La colonne qui donne la date de chaque feedback

  1. Choisissez la source, faites correspondre les colonnes, puis enregistrez.

Après l'import, chaque fichier est déplacé dans le sous-dossier archive du dossier surveillé. Un fichier n'est donc jamais importé deux fois.

Règles pour les fichiers

Règle

Pourquoi

En-têtes obligatoires et stables, en minuscules, avec des underscores, sans espace ni caractère spécial (zip_code, ticket_id, status, created_at)

Un en-tête modifié n'est plus reconnu par la correspondance enregistrée : l'import échoue, ou range la colonne au mauvais endroit.

Un seul séparateur pour tout le flux (virgule par défaut, point-virgule possible)

Mélanger virgule et point-virgule fait échouer la lecture.

UTF-8, valeurs contenant un séparateur ou un saut de ligne entre guillemets, guillemets internes doublés ("")

Le fichier est lu correctement, verbatims compris.

Dates dans un format unique de type ISO, par colonne

Si vous utilisez un format local, signalez-le lors du premier import.

Seulement les nouveaux enregistrements dans chaque fichier

Renvoyer toute la base (tickets, transcriptions) à chaque fois ralentit l'import et crée des doublons.

Un fichier par période et par flux, avec une date dans le nom (in/enquete_a/data_2026_11_11.csv)

Le suivi et la reprise en cas d'incident sont plus simples. Si plusieurs fichiers coexistent, utilisez des noms qui ne se chevauchent pas.

Les formats de colonnes de l'import CSV

NPS de 0 à 10, notes numériques, valeurs multiples séparées par |.

Exemple d'en-tête et de lignes :

ticket_id,email,status,created_at,comment,rating
12345,[email protected],in_progress,2026-08-08,"Un client a signalé un problème intermittent",4
12345,[email protected],closed,2026-08-10,"Problème résolu après l'application d'un correctif",5

Éviter les doublons

Si un même enregistrement peut revenir dans plusieurs fichiers (un ticket « en cours » puis « résolu »), demandez à votre Chef de projet Feedier d'activer une règle d'unicité sur un identifiant stable et présent sur chaque ligne, par exemple ticket_id. Le nouvel enregistrement remplace alors l'ancien.

Stratégie de fichier

Ce qu'il faut

Instantané complet (toute la période à chaque fois)

Règle d'unicité obligatoire

Incrémental (seulement les nouveautés)

Une clé unique stable

Avec l'exemple ci-dessus et l'unicité sur ticket_id, la deuxième ligne remplace le feedback du même ticket.

Retraiter des fichiers non conformes

Si vos systèmes produisent un fichier différent du format attendu (en-têtes, séparateur, valeurs), l'équipe Feedier peut mettre en place un prétraitement automatique.

  1. Envoyez à votre Chef de projet Feedier deux exemples : le fichier exporté d'origine et le fichier attendu, prêt à importer.

  2. Faites valider le format final avec lui, pour que les attributs correspondent à votre usage.

  3. Ensuite, continuez à envoyer votre format d'origine : il est transformé automatiquement.

Méthode avancée : flux piloté par une automatisation

Pour les flux avec prétraitement, ou mis en place par l'équipe Feedier, l'import peut aussi être piloté par une automatisation qui appelle un webhook selon un calendrier.

Les dossiers in et out

Le serveur a deux répertoires : déposez vos fichiers dans in ; une fois traités, ils sont déplacés dans out. La structure de out doit reproduire celle de in :

in

out

in/enquete_A

out/enquete_A

in/enquete_B

out/enquete_B

in/enquete_C

out/enquete_C

Les étapes

  1. Choisissez la méthode (BigQuery ou SFTP, option 1 ou 2) et partagez les accès.

  2. Déposez un fichier représentatif dans in/<nom_enquete>.

  3. Faites un premier import manuel de ce fichier depuis Sources (Import de fichier → CSV) : la correspondance des colonnes est enregistrée et sera réutilisée.

  4. Copiez l'UUID de cet import, affiché dans l'onglet Imports, et envoyez-le à votre Chef de projet Feedier.

  5. Confirmez le calendrier (quotidien, hebdomadaire ou mensuel), le séparateur, le nom des fichiers, la clé d'unicité et le besoin de prétraitement.

  6. L'automatisation est créée dans Automatisations : un déclencheur récurrent, puis un appel Webhook vers https://connect.feedier.com/webhook-test/import/feedback/file.

  7. Surveillez les premières exécutions et contactez le support en cas d'anomalie.

Calendrier : laissez une marge après le dépôt. Si votre système dépose le fichier le lundi à 9 h, programmez l'import le lundi à 11 h.

Exemple de contenu envoyé au webhook :

{
  "api_key": "VOTRE_CLE_API_PRIVEE",
  "source_type": "SFTP",
  "uuid": "ab1b0543-d59a-4fa3-8792-d895f5c4ab70",
  "sftp_configuration": {
    "host": "54.246.123.185",
    "port": "22",
    "username": "NOM_CLIENT",
    "ssh_key": "default",
    "file_path": "feedier_connect/NOM_CLIENT/in/enquete_A"
  },
  "preprocessing": "false",
  "delimiter": ";",
  "unicity": "false",
  "unicity_attribute_name": "nom_attribut"
}

Paramètre

Rôle

Valeurs

api_key

Votre clé API privée

source_type

L'origine des fichiers (SFTP interne ou externe)

SFTP

uuid

L'UUID d'un import précédent avec exactement la même structure de fichier ; sa correspondance est réutilisée

ab1b0543-…

sftp_configuration.host / .port

Le serveur et son port. Pour un SFTP Feedier, ceux communiqués par l'équipe Feedier

54.246.123.185 / 22

sftp_configuration.username

L'utilisateur SFTP

feedier_connect

sftp_configuration.ssh_key

La clé privée. Laissez default, sauf avec votre propre serveur : mettez alors votre clé

default ou le contenu de la clé

sftp_configuration.file_path

Le dossier in de l'enquête

…/in/enquete_A

preprocessing

Le fichier doit-il être retraité ? false s'il a exactement la structure du fichier de l'UUID

true / false

preprocessing_workflow

Le traitement appliqué avant l'import, si besoin

Fourni par l'équipe Feedier

delimiter

Le séparateur du fichier

, ou ;

unicity

Appliquer la règle d'unicité (remplacer l'ancien enregistrement par le nouveau)

true / false

unicity_attribute_name

L'attribut clé, qui doit déjà exister dans Feedier

ticket_id

Qui fait quoi

Élément

À fournir ou confirmer

Responsable

Méthode

BigQuery (avec la table dataset.table) ou SFTP (option 1 ou 2)

Vous

Accès

Hôte, port, utilisateur et règles de pare-feu (votre SFTP), ou IP et clé publique SSH (SFTP Feedier)

Vous

Dossiers

Sous-dossiers in/<nom_enquete> et fichier d'exemple

Vous

Premier import

Import manuel et UUID transmis

Vous

Prétraitement

Fichiers d'origine et attendu, puis mise en place

Équipe Feedier

Unicité

L'attribut clé

Vous

Calendrier

Cadence, nom et emplacement des fichiers

Vous, puis configuration par Feedier

Ce que l'IA fait de ces données

Chaque verbatim des fichiers importés est analysé dès son arrivée : sentiment, thèmes de votre taxonomie, et masquage des données personnelles (attributs nlp_…). Vos tickets ou transcriptions sont ainsi classés avec les mêmes thèmes que vos enquêtes et avis. Chaque verbatim analysé est décompté de votre budget d'analyse IA.

FAQ

Mon séparateur est le point-virgule. Est-ce un problème ?

Non, tant qu'il est le même dans tous les fichiers du flux.

Peut-on gérer plusieurs enquêtes depuis un seul serveur SFTP ?

Oui : un dossier par enquête, un import par dossier, et des noms de fichiers cohérents.

J'ai changé le nom d'une colonne. Que faire ?

Mettez à jour la liste des Colonnes à importer et la correspondance de l'import, ou prévenez votre Chef de projet Feedier si un prétraitement est en place.

Peut-on automatiser sans premier import manuel ?

Pour la méthode avancée, non : le premier import enregistre la bonne correspondance des colonnes (via son UUID) et évite les mauvaises surprises.

Mes adresses IP doivent être autorisées. Lesquelles ?

Demandez la liste à jour au support.


Dernière vérification : 11 novembre 2026, version 4.23.5.

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