Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Centralise your feedback by connecting to Feedier’s API

Table of Contents

API Connection

...

Table of Contents
Info

The Feedier API let you import a higher volume (> 2,000 feedback) than the dashboard Import module. If you arae looking to import a volume lower than 2,000 feedback, use this guide.

Step 1: Prepare the file

Feedier API works with CSV file, and support 3 type of data types for the feedback data

  • created_at → Creation time of the feedback entry. ⚠️ The format must be DD/MM/YYYY HH:MM:SS. In Excel, or Google Spreadhseet, you can define the custom time format as below:

    Image Added
  • question_answer:X → Every answer that needs to be imported in Feedier, must have its own column with the header question_answer:X where X is the Feedier’s Question ID. You can find the Question ID from the Questions page.

    Image Added
  • All other columns will be treated and imported as Attributes in Feedier.

Here is an example of working file structure:

created_at

question_answer:121881

question_answer:121882

customer_id

23/12/2022 00:00:00

5

I love this company

123

This will create in Feedier a feedback with a creation time 23rd of December 2022, with a rating score of 5, text answer and attribute customer_id with the value 123.

Step 2: Upload the file

(tick) Download the file from Step 1.

Now, Feedier’s API must be able to reach the file online. So import it to an online service that return the file as a readable CSV (not a page to download the CSV). When reached by URL the file must download automatically. Such servcies can be Hubspot files, AWS S3 or others.

Example: https://resources.feedier.com/hubfs/Import-Feedier-test.csv

Note

For security reasons, we highly recommend you to delete the file when the import is completed.

Step 3: Prepare the API call

The start the import process, we need the following API call:

https://api.feedier.com/v1/feedback/bulk?url={csv_file_url}&api_key={private_api_key}

Note

If you are using a private instance, replace the api.feedier.com with your instance’s API url.

The CSV file URL must be replaced with the URL you get from Step 2 and URL encoded (https%3A%2F%2Fresources.feedier.com%2Fhubfs%2FImport-Feedier-test.csv)

The Private API key, can be found on your Feedier Dashboard with an Admin role:
Organizations → Integrations → Private API key.

Step 4: Call the API

Open your browser and call the url with your CSV file and Private API key.

https://api.feedier.com/v1/feedback/bulk?url=https%3A%2F%2Fresources.feedier.com%2Fhubfs%2FImport-Feedier-test.csv&api_key=YOUR_PRIVATE_API_KEY

(tick) When it works, you will see the message:

A job has been triggered to import the feedback data