Feefo offers various methods to integrate its services into your workflow, allowing you to collect reviews and feedback from your customers seamlessly. In this knowledge base article, we will provide you with a comprehensive guide on how to set up Feefo integration.
Prerequisites
Before starting the integration process, please ensure that the file you intend to upload is UFT-8 encoded. Once your file is ready, you can choose from the following integration options:
Option 1: SFTP Transfer
If you prefer to upload your data file to Feefo using SFTP, please follow these steps:
Server Details: Server: sftp://ftp2.feefo.com Username: <your_merchant_identifier> Password: <Assigned as part of the implementation process> Port: 2222 (non-standard port) To find your merchant identifier, navigate to the Feefo Hub by clicking on your name in the top right corner or by going to 'Settings' > 'Business Details'.
Option 2: Data Fetch
If you'd like Feefo to fetch your data file from your location periodically, you can choose from daily, weekly, or monthly intervals, with the process usually occurring around midnight (GMT). Feefo supports the following protocols for data fetch:
HTTP/HTTPS FTP/FTPS/SFTP
For added security, we recommend whitelisting the following IP addresses:
35.197.217.47 35.197.212.84 35.189.112.9 34.105.171.51 34.89.34.212
To set up data fetch, please get in touch with our technical team and provide the following details:
- The URL where the data file is located.
- The username and password (if configured).
- Confirmation of the desired fetch frequency (daily, weekly, or monthly).
Option 3: JavaScript Sale Integration
If your business processes transactions through an eCommerce website, Feefo offers an iFrame solution for requesting reviews automatically. Here's how to set it up:
Only sales from the site registered in the Feefo Hub under 'Settings > Brand Profile > Website Forwarding URL' can be used. Contact us to add multiple subdomains if needed.
Add the iFrame to your site's sale confirmation page. Here's an example of an iFrame:
<iframe id="FSI_IFrame"
style="display: none;"
width="0"
height="0"
src="https://api.feefo.com/api/sales/merchant?merchantidentifier=MERCHANTIDENTIFIER"
data-feefo-email="example@feefo.com"
data-feefo-orderref="8e95692384"
data-feefo-name="John Smith"
data-feefo-customerref="546516564"
data-feefo-products='[{"description":"Test Description","productsearchcode":"546651","productlink":"https://www.google.com","tags":{"saleschannel":"Web","productline":"games"}}]'>
</iframe>Here's what each line of the iFrame means, along with optional values:
Src: The Feefo API URL for your Merchant Identifier. data-feefo-email: The consumer email address. data-feefo-orderref: The order number. data-feefo-name: The customer's name. data-feefo-customerref: The customer's reference number. data-feefo-feedbackdate: The date for sending the feedback request (dd/mm/yy). data-feefo-date: The date of the sale. data-feefo-products: Information about the products in the sale.
After adding the iFrame, your sales information will be automatically sent to Feefo, subject to validation checks. If any checks fail, the sale will be rejected, and the feedback request won't be sent.
Please note that server-side script assistance is not provided. If you have questions about Feefo's iFrame, feel free to reach out.
Lastly, ensure that every page using the iFrame includes the following code snippet at the bottom:
<!-- Post message handler --> <script type="text/javascript" src="https://api.feefo.com/api/assets/js-sale-integration/javascript/feefo-js-post-message-handler.js"></script> <!-- Initialize the Post Message Handler --> <script type="text/javascript"> var FPMH = new Feefo.PostMessageHandler(); FPMH.init(); </script>
This snippet is crucial for the sale to process and be sent to Feefo successfully.
With these integration options, you can seamlessly collect reviews and feedback from your customers using Feefo. If you encounter any issues or have further questions, please don't hesitate to contact our support team for assistance.