Reviews: Sample Use Cases and Flows

This article presents possible use cases and corresponding sample flows that you can support. This can be a helpful jumping off point as you plan your implementation.

Real-time 2-way sync with an external eCommerce solution

Wix users can keep reviews from an external eCommerce solution up to date with their reviews on Wix with a 2-way sync. Synchronize Wix and the eCommerce solution with these flows:

• Initial setup
• Synchronize to the eCommerce solution
• Synchronize to Wix

Initial setup

Create mappings for the following from the Wix site to the eCommerce solution using common fields so the reviews can sync:

• Wix site entities to entities in the eCommerce solution.
• Wix site Contact IDs to author IDs in the eCommerce solution, for example using email addresses.
• Wix review fields to the review fields in the eCommerce solution for example, title, body, author.

Store the mappings on your server. Then follow these flows to create the 2-way sync.

Synchronize to the eCommerce solution

Listen for a change in Wix reviews with the following:

• Review Created
• Review Updated
• Review Moderation Status Changed
• Review Deleted

When one of the events is triggered, you receive the review in the response. You can send those changes to the eCommerce solution with a flow like this:

1. Get the slug which tells you what the event was, entityId, and other relevant information from the response.

2. Use the mappings from the initial setup to send the relevant information to the eCommerce solution.

3. Ignore the resulting event from the eCommerce solution so you don't create an endless loop of updates.

Synchronize to Wix

Listen for review events from the eCommerce solution. When you receive a change it needs to synchronize, follow this basic flow:

1. Use the Contacts API to check if the review author has a contact ID on the Wix site.

2. The Reviews API allows only 1 review for each entity per contact. Use the mappings from the initial setup to filter out imported reviews if there is already a Wix site review from the contact for the entity.

3. Use the mappings from the initial setup and call Create Review if the author is a contact.

4. Ignore the resulting event from Wix so you don't create an endless loop of updates.

Display review media in a widget

To create a media gallery of photos from reviews, retrieve images from reviews, and then display them in media layout:

1. Use Query Reviews to retrieve reviews that have media.

2. Extract the image.url from the response and use the Media API to retrieve the media.

3. Display the retrieved media items in gallery layout in a widget using Wix Blocks. Learn more about Wix Blocks design.

Get immediate updates of negative customer feedback

To receive timely customer feedback, gain insights into product satisfaction, and identify areas for improvement:

1. Listen for new reviews with Review Created.

2. Get the entityId, content, and any other relevant information from the response.

3. Extract reviews from the response that have a content.rating less than 3.

4. Provide the extracted review IDs to the Wix user so they can reply in the dashboard.

Display the most helpful product reviews in a widget

To display the most helpful reviews to promote products:

1. Use Query Reviews to get a list of the 10 most helpful reviews, sorted by most to least helpful.

2. Display the retrieved reviews in a widget using Wix Blocks. Learn more about Wix Blocks design.