Skip to main content

Okendo Reviews

Learn how to set up rewarding customer's for leaving reviews via Okendo using Shopify Flow.

Written by Kris - Mage Loyalty
Updated over a month ago

Prerequisites

  • A Starter plan or higher on Mage Loyalty

  • Okendo installed on your Shopify store

  • Access to Shopify Flow (available on all Shopify plans)

Step 1: Create the Earning Rule

  1. In your Shopify admin, open the Mage Loyalty app

  2. Navigate to Loyalty Program > Earning Rules

  3. Click Leave a Review

  4. Configure the rule:

    • Earning rule name — Give the rule a name (e.g. "Leave a Review")

    • Review app — Select Okendo from the dropdown

    • Points — Enter the number of points to award per review (e.g. 100)

    • Photo review points (optional) — Enter a specific point amount for reviews that include photos (e.g. 150). Leave empty to use the base points amount

    • Video review points (optional) — Enter a specific point amount for reviews that include videos (e.g. 200). Leave empty to use the base points amount

  5. (Optional) Set a frequency limit to prevent abuse. For example, you can limit customers to earning points for 1 review every 7 days

  6. Make sure the rule is enabled using the status toggle in the sidebar

  7. Click Save

Step 2: Set Up the Shopify Flow

Once the earning rule is saved, you need to create a Shopify Flow that triggers the point award when a customer submits a review in Okendo.

  1. In your Shopify admin, go to Settings > Flow (or search for "Flow" in the admin search bar)

  2. Click Create workflow

  3. Click Select a trigger

  4. Search for Okendo and select the Review Created trigger

  5. Click the + button to add an action

  6. Search for Mage Loyalty and select the Add Points for Review action

  7. Configure the action fields:

    • Customer email — Map this to the customer's email from the Okendo trigger. This is typically available as {{email}}.

    • Internal note (optional) — Add any note for internal tracking

    • Image count (optional) — Map this to the image count (e.g. {{ imageCount }}). Required if you want to award extra points for photo reviews

    • Video count (optional) — Map this to the video count (e.g. {{ videoCount }}). Required if you want to award extra points for video reviews

    • Rating (optional) — Map this to the review rating

    • Sentiment (optional) — Map this to the review sentiment

Click Turn on workflow in the top right corner

Step 3: Test the Integration

  1. Submit a test review on your store using Okendo

  2. Check that the Shopify Flow ran successfully:

    • Go to Settings > Flow and click on your workflow

    • Check the Run history tab for recent executions

  3. Verify the customer received points:

    • In the Mage Loyalty app, navigate to Customers

    • Find the customer who left the review and confirm their points balance increased

Photo & Video Review Points

You can reward customers with different point amounts depending on the type of review they leave.

When you configure photo and video review points in the earning rule settings, the system uses this priority:

  1. Video review: If the review includes a video, the customer earns the video review points amount

  2. Photo review: If the review includes photos (but no video), the customer earns the photo review points amount

  3. Text review: If the review has no photos or videos, the customer earns the base points amount

For example, if you set base points to 100, photo review points to 150, and video review points to 200:

  • A text-only review earns 100 points

  • A review with photos earns 150 points

  • A review with a video earns 200 points

  • A review with both photos and a video earns 200 points (video takes priority)

To use this feature, make sure you map the Image count and Video count fields in your Shopify Flow action (see Step 2 above).

Frequently Asked Questions

What happens if the same review triggers the flow twice?
Mage Loyalty automatically deduplicates reviews. Each Flow execution has a unique identifier, so the same review will never award points twice.

What if the customer isn't enrolled in the loyalty program?
Points are only awarded to customers who are already part of your loyalty program. If the customer hasn't enrolled yet, the review will be recorded but no points will be given.

Can I use frequency limits?
Yes. When configuring the earning rule, enable the frequency limit option. For example, you can limit customers to earning points for 1 review every 7 days. This prevents abuse while still rewarding genuine reviewers.

Does this work with VIP tier multipliers?
Yes. If your loyalty program has VIP tiers with point multipliers enabled, the multiplier will automatically apply to review points.

Can I set an approval delay?
If your earning rule has an approval time configured, points will be held in a pending state until the approval period has passed. This gives you time to moderate reviews before points are awarded.

Troubleshooting

Points aren't being awarded

  • Verify the Shopify Flow is turned on and check the run history for errors

  • Confirm the earning rule is enabled in Mage Loyalty

  • Make sure the customer email in the Flow action matches the email in your loyalty program

  • Check that the customer is enrolled in your loyalty program

Flow shows an error

  • Ensure the customer email field is correctly mapped from the Okendo trigger

  • Verify your Mage Loyalty app is installed and your subscription is active

Need help?
Use our live chat inside the Mage Loyalty app or email us at [email protected].

Did this answer your question?