Objectif: Découvrez comment configurer des importations automatiques de feedbacks au format CSV dans Feedier, sans intervention technique initiale.
Cet article détaille les étapes clés, les prérequis, les options SFTP, le format attendu des fichiers, le mappage des données, la planification des imports, le prétraitement, la gestion des doublons ainsi que les limitations et responsabilités associées.
À qui s'adresse ce guide ?
Les clients qui ont besoin d'exporter/importer automatiquement des données de feedback (CSV) et qui souhaitent un import automatisée dans Feedier.
Process rapide - de bout en bout en 7 étapes
Choisissez la source: BigQuery ou SFTP. Pour SFTP, choisissez l'option 1 (votre SFTP) ou l'option 2 (fourni par Feedier).
Partagez les détails d'accès (et, pour le SFTP de Feedier, votre IP et votre clé publique SSH). Feedier créera des dossiers in/(nom_de_l'enquête) et out.
Exigences relatives aux fichiers CSV : Si les données du fichier doivent être retraitées avant d'être importées, suivez les étapes de retraitement. Respectez la contrainte d'unicité.
Préparer le fichier CSV en respectant les règles d'en-tête et télécharger un échantillon représentatif vers in.
Exécutez la première importation manuelle sur la page Sources. Sauvegardez et partagez l'UUID d'importation avec l'équipe CS.
Confirmer le calendrier, le délimiteur, le nom du fichier, la clé d'unicité et tous les besoins de prétraitement.
Feedier active l'automatisation. Surveillez les premières exécutions automatisées ; contactez le support si des anomalies apparaissent.
Options d'import prises en charge (choisir une option)
Recommandation : Si vous utilisez déjà Google Cloud Platform, téléchargez votre feedback vers BigQuery et activez l'intégration de l'importation BigQuery pour une configuration plus simple et sans maintenance. Si ce n'est pas le cas, utilisez SFTP comme décrit ci-dessous.
BigQuery (de préférence pour les utilisateurs de GCP) : Pousser les données vers une table désignée ; l'intégration BigQuery de Feedier tire automatiquement.
SFTP (référentiel standard actuel) : Déposez des fichiers CSV dans une boîte de réception SFTP à partir de laquelle Feedier les récupère et les importe.
Options de configuration SFTP
Vous téléchargerez vos fichiers CSV vers un SFTP avec deux dépôts : in et out. Télécharger les fichiers vers IN. Les artefacts traités ou les résultats sont écrits dans out s'ils sont configurés.
Option 1 - Utiliser votre propre SFTP (vous donnez l'accès à Feedier)
Confirmer l'hôte SFTP, le nom d'utilisateur et le port.
Créez un utilisateur dédié et un répertoire personnel avec des sous-dossiers in et out.
Partagez avec l'équipe CS de Feedier : l'hôte, le port, le nom d'utilisateur, et la plage d'IP source autorisée ou les règles de pare-feu. Feedier vous fournira la clé publique SSH pour l'authentification par clé SSH.
Option 2 - Feedier fournit un accès SFTP
Fournissez les informations suivantes à Feedier afin que nous puissions créer votre accès SFTP dédié :
L'adresse IP publique à partir de laquelle vous téléchargerez (pour l'inscription).
La clé publique SSH du serveur ou de la machine qui accèdera au SFTP.
Feedier vous renverra votre point d'accès SFTP et vos informations d'identification. Votre structure SFTP comprendra des répertoires d'entrée et de sortie.
La même structure de dossier créée dans le répertoire d 'entrée doit être répliquée dans le répertoire desortie.
Par exemple, si trois sous-répertoires sont créés dans le répertoire in:
in/enquête_Ain/enquête_Bin/enquête_C
La même structure doit exister dans out:
out/survey_Aout/enquête_Bout/enquête_C
Chaque fichier traité du répertoire in sera transféré dans son répertoire correspondant dans le répertoire out après l'exécution de l'intégration de l'importation.
Exigences relatives aux fichiers CSV
Type de fichier : Fichier CSV avec un délimiteur cohérent (virgule par défaut ; point-virgule également pris en charge s'il est spécifié).
La ligne d'en-tête est obligatoire. Les en-têtes doivent être en minuscules, avec des traits de soulignement à la place des espaces. Exemple : zip_code, ticket_id, status, created_at.
Pas d'espace dans les noms d'en-tête. Évitez les caractères spéciaux et les lettres majuscules. Les noms doivent rester stables dans le temps afin de préserver les correspondances.
Encodage : UTF-8 recommandé. Mettez entre guillemets les valeurs qui contiennent des délimiteurs ou des sauts de ligne. Échapper aux guillemets intégrés en utilisant des guillemets doubles.
Champs de date et d'heure : conserver un format cohérent, de type ISO, pour chaque colonne. Si des formats locaux sont utilisés, communiquez-les lors de la première importation pour garantir une analyse correcte.
🔎 Prétraitement (facultatif)
Si les fichiers produits par vos systèmes diffèrent du CSV utilisé pour le premier import (en-têtes, délimiteur, formatage), Feedier peut configurer un prétraitement pour normaliser les données avant d'appliquer le mapping. Ceci est généralement identifié par le chef de projet (côté client) et le responsable de l'implémentation CS avant la mise en place de l'automatisation.
Fournissez deux échantillons au responsable de l'implémentation CS : le fichier exporté original et le fichier souhaité, prêt à être importé (nous vous recommandons de confirmer le format final à votre responsable CS, afin de vous assurer que le format et les attributs respectent le cas d'utilisation et le format d'importation de la plateforme). L'équipe d'assistance mettra alors en place un flux de travail de prétraitement en conséquence.
Une fois validé, vous pouvez continuer à envoyer votre format d'origine ; le flux de travail le transformera automatiquement.
Contrainte d'unicité (déduplication)
Pour éviter d'importer le même feedback plusieurs fois (par exemple, un ticket qui évolue de in_progress à closed et qui apparaît dans deux fichiers de semaines différentes), activez une règle d'unicité.
Indiquez à l'équipe CS que vous souhaitez activer la contrainte d'unicité.
Spécifiez l'attribut utilisé comme clé unique (par exemple, ticket_id ou email). Le workflow l'utilisera pour remplacer l'enregistrement précédent.
⚠️ Choisissez une clé stable dans le temps et présente dans chaque ligne.
Premier import (mapping manuel)
Pour activer l’automatisation des imports, commencez par effectuer une première importation manuelle depuis la page Sources de Feedier, en utilisant un fichier CSV représentatif. Cette étape permet de créer un template de correspondance des champs (mapping), qui sera ensuite réutilisé pour les imports automatisés.
Préparez votre fichier CSV conformément aux exigences ci-dessus.
Allez sur la page Sources de Feedier et lancez une importation CSV. Mettez en correspondance les colonnes avec les attributs et les questions de Feedier souhaités, puis enregistrez.
Copiez l'UUID d'importation affiché sur la page des importations, il sera utilisé dans l'étape suivante.
Automatiser votre importation
Un flux de travail automatisé qui lit périodiquement votre source SFTP, applique le mapping sauvegardé et ingère les nouveaux enregistrements doit être créé
Fréquence : quotidienne, hebdomadaire ou mensuelle.
Stratégie de fichier : instantané complet ou incrémental. Pour les instantanés complets, des règles d'unicité doivent être appliquées afin d'éviter les doublons ; pour les fichiers incrémentiels, il convient de fournir une clé unique stable.
Communiquez votre calendrier préféré et l'endroit où le fichier apparaîtra, en utilisant une convention de dénomination horodatée (par exemple, in/survey_a/data_yyyy_mm_dd.csv).
Étapes pour automatiser votre importation
Dans Feedier, cliquez sur Autopilot.
2. Créez un nouveau flux de travail.
3. Choisissez la récurrence de votre importation (cron) dans le nœud de récurrence. Par exemple : si votre système dépose le CSV tous les lundis à 09:00, planifiez l'exécution tous les lundis à 11:00 pour vous assurer que le fichier est disponible.
4. Ajoutez un nœud Webhook.
5. Définissez l'URL du Webhook à : https://connect.feedier.com/webhook-test/import/feedback/file.
6. Voici un exemple de charge utile JSON :
{
"api_key" : "YOUR_ORG_API_KEY",
"source_type" : "SFTP",
"uuid" : "ab1b0543-d59a-4fa3-8792-d895f5c4ab70",
"sftp_configuration" : {
"host" : "54.246.123.185",
"port" : "22",
"username" : "CLIENT_NAME",
"ssh_key" : "default",
"file_path" : "feedier_connect/CLIENT_NAME/in/survey_A"
},
"preprocessing" : "false",
"delimiter" : " ;",
"unicity" : "false",
"unicity_attribute_name" : "attribute_name"
}
Référence des paramètres JSON
Paramètre | Description du paramètre | Exemple / Autorisé |
| Clé privée du client |
|
| La source à partir de laquelle nous récupérerons le fichier CSV envoyé par le client. Pour l'instant, nous ne supportons que SFTP (interne ou externe) | SFTP |
uuid | L'UUID de la page des importations pour une importation précédente avec exactement la même structure CSV. La correspondance sera réutilisée. | ab1b0543-d59a-4fa3-8792-d895f5c4ab70 |
sftp_configuration.host | L'hôte du serveur SFTP. Pour le SFTP hébergé par Feedier, utilisez la configuration communiquée par l'équipe Feedier pour accéder au serveur SFTP. | 54.246.123.185 |
sftp_configuration.port | Le port utilisé pour la connexion SFTP. Pour le SFTP hébergé par Feedier, utiliser la configuration communiquée par l'équipe Feedier pour accéder au serveur SFTP. | 22 |
sftp_configuration.username | Le nom d'utilisateur pour la connexion SFTP. | feedier_connect |
sftp_configuration.private_key | La clé privée utilisée pour authentifier la connexion SFTP. Cette valeur doit rester | par
|
prétraitement | Indique si le fichier CSV doit être prétraité. Si le CSV dans SFTP correspond à celui utilisé pour générer l'UUID, il faut mettre false. | true/false |
délimiteur | Le délimiteur utilisé dans le fichier CSV. | ; |
flux_de_traitement | Le flux de travail exécuté pour prétraiter le fichier CSV avant de générer l'UUID et d'importer. Fourni en tant que partie de la charge utile si nécessaire. | Fourni dans la charge utile |
unicity | Application ou non de règles d'unicité (éviter d'importer deux fois le même enregistrement ; remplacer l'ancien par le nouveau). | true/false |
nom_de_l'attribut_d'unicité | L'attribut utilisé pour vérifier si le retour d'information existe déjà. Doit correspondre à un nom d'attribut déjà utilisé sur la plateforme. | Doit correspondre à un attribut existant ; par exemple, ticket_id |
Liste de contrôle opérationnelle
Objet | Ce que vous fournissez ou confirmez | Propriétaire |
Méthode d'ingestion | Confirmer BigQuery ou SFTP. Si BigQuery, confirmer dataset.table. Si SFTP, confirmez l'option 1 (votre SFTP) ou l'option 2 (fournie par Feedier). | Client |
Détails d'accès | Fournir l'hôte/port/nom d'utilisateur et les règles de la liste d'autorisation (votre SFTP), ou votre IP et la clé publique SSH (Feedier SFTP). | Client |
Structure du dossier | Créez des sous-dossiers in/(nom_de_l'enquête) et téléchargez un échantillon CSV pour la première importation. | Client |
Mapping de la première importation | Exécutez une importation CSV manuelle sur la page Sources et partagez l'UUID d'importation avec l'équipe CS. | Client |
Besoin de prétraitement | Si le CSV brut de votre système diffère du CSV de mappage, partagez les fichiers originaux et souhaités pour configurer la normalisation. | Équipe d'alimentation |
Règle d'unicité | Confirmez l'attribut clé unique (par exemple, ticket_id) afin d'éviter les doublons et d'activer le comportement d'insertion ascendante. | Client |
Calendrier | Choisissez une cadence quotidienne/hebdomadaire/mensuelle et confirmez la convention de dénomination des fichiers/l'emplacement. | Client → Configuration de Feedier |
Limites et meilleures pratiques
Schéma stable : Veillez à ce que les en-têtes restent stables. Si vous devez les modifier, informez-en CS pour qu'il mette à jour le mappage et le prétraitement.
Délimiteurs cohérents : Ne mélangez pas les virgules et les points-virgules entre les fichiers d'un même flux ; communiquez le délimiteur une seule fois.
Un fichier par horaire : Préférez un fichier consolidé par cadence et par enquête. S'il existe plusieurs fichiers, utilisez des modèles de dénomination clairs et sans chevauchement.
N'envoyez pas l'ensemble du jeu de données Source à chaque fois (par exemple, votre base de données complète de tickets ou de transcriptions). Pour de meilleures performances, n'incluez que les nouveaux enregistrements dans chaque fichier.
Sécurité et accès
- Utilisez l'accès par clé SSH pour le SFTP.
Exemple d'en-tête et de lignes CSV
En-têtes (minuscules, caractères de soulignement) : ticket_id,email,status,created_at,comment,rating
Exemple de lignes :
12345,[email protected],in_progress,2025-08-08,"Un client a signalé un problème intermittent",4
12345,[email protected],closed,2025-08-10,"Problème résolu après l'application d'un correctif",5
Avec l'unicité du ticket_id, la deuxième ligne remplacera le feedback précédent pour le même ticket, évitant ainsi les doublons.
FAQ
Pouvons-nous automatiser les importations sans la première importation manuelle ?
Pouvons-nous automatiser les importations sans la première importation manuelle ?
Nous avons besoin d'un premier import manuel pour capturer le mapping correct (via son UUID). Cela permet de minimiser les surprises et de s'assurer que le flux automatisé correspond aux attributs prévus.
Que se passe-t-il si notre délimiteur CSV est ';' au lieu de ',' ?
Que se passe-t-il si notre délimiteur CSV est ';' au lieu de ',' ?
C'est possible. Indiquez à l'équipe CS votre délimiteur lors de la configuration afin que le flux de travail l'analyse correctement.
Comment éviter les doublons dans les instantanés hebdomadaires ?
Comment éviter les doublons dans les instantanés hebdomadaires ?
Activez la règle d'unicité et spécifiez une clé stable (par exemple, ticket_id). Le flux de travail effectuera un upsert sur la base de l'enregistrement le plus récent.
Peut-on envoyer plusieurs enquêtes à partir d'un seul SFTP ?
Peut-on envoyer plusieurs enquêtes à partir d'un seul SFTP ?
Oui. Créez un sous-dossier par enquête sous IN et conservez des noms de fichiers cohérents pour simplifier le routage.
Nous avons modifié le nom d'un en-tête. Que faire maintenant ?
Nous avons modifié le nom d'un en-tête. Que faire maintenant ?
Informez l'équipe CS. Nous mettrons à jour la cartographie ou ajusterons le prétraitement pour aligner le nouvel en-tête avec la configuration d'importation que vous avez sauvegardée.