Importer un grand volume de feedback à l'aide de l'API
- Carlos Carasco
- Alexis Pinon
- Clémence Masson (Unlicensed)
L'API Feedier vous permet d'importer un volume plus important (> 2 000 feedback) que le module d'importation du tableau de bord. Si vous souhaitez importer un volume inférieur à 2 000 commentaires, utilisez ce guide.
Étape 1 : Préparer le fichier
L'API Feedier fonctionne avec des fichiers CSV et prend en charge 3 types de données pour les données de feedback
created_at→ Heure de création de l'entrée de feedback. Le format doit être AAAA-MM-JJ HH:MM:SS. Dans Excel ou Google Spreadsheet, vous pouvez définir un format d'heure personnalisé comme dans l’exemple de tableau ci-dessous, mais il n'est pas obligatoire.question_answer:X→ Chaque réponse qui doit être importée dans Feedier doit avoir sa propre colonne avec l'en-tête question_answer:X où X est l'ID de la question de Feedier. Vous pouvez trouver l'ID de la question depuis la page des Questions.Toutes les autres colonnes seront traitées et importées en tant qu'attributs dans Feedier.
Voici un exemple de structure de fichier fonctionnelle :
cree_le: | question_answer:121881 | question_answer:121882 | customer_id |
|---|---|---|---|
2022-12-25 00:00:00 | 5 | J’aime cette entreprise | 123 |
Cela créera dans Feedier un retour avec une date de création le 25 décembre 2022, avec une note de 5, une réponse texte et un attribut customer_id avec la valeur 123
Le fichier doit être encodé en UTF-8 et avec ';' comme séparateur et non ','.
Documentation Excel ici :" Import or export text (.txt or .csv) files - Microsoft Support “
Étape 2: Importer le fichier
Télécharger le fichier venant de l'étape 1.
Maintenant, l'API de Feedier doit être capable d'accéder au fichier en ligne. Importez-le sur un service en ligne qui renvoie le fichier sous forme de CSV lisible (pas une page pour télécharger le CSV). Lorsqu'il est atteint par URL, le fichier doit se télécharger automatiquement. Des services tels que Hubspot files, AWS S3 ou d'autres peuvent être utilisés.
Exemple: https://resources.feedier.com/hubfs/Import-Feedier-test.csv
Pour des raisons de sécurité, nous vous recommandons vivement de supprimer le fichier une fois l'importation terminée.
Étape 3: Preparer l’appel API
Pour démarrer le processus d'importation, nous avons besoin de l'appel API suivant :
https://api.feedier.com/v1/feedback/bulk?url={csv_file_url}&api_key={private_api_key}
L'URL du fichier CSV doit être remplacée par l'URL que vous obtenez à l'étape 2 et encodée en URL (https%3A%2F%2Fresources.feedier.com%2Fhubfs%2FImport-Feedier-test.csv)
Étape 4 : Appeler l’API
Ouvrez votre navigateur et appelez l'URL avec votre fichier CSV et votre clé API privée
Lorsque cela fonctionne, vous verrez le message :
A job has been triggered to import the feedback data