Connect Lantern quiz completions to your Rivo: Loyalty Program, Rewards program using Shopify Flow. This workflow lets you automatically award loyalty points (or run other Rivo actions) when a customer completes a quiz.
Prerequisites
Shopify Flow installed and active on your store.
Rivo: Loyalty Program, Rewards installed and configured on a Shopify plan that supports Flow connectors.
A Lantern quiz published with an Opt‑in page that collects an email address.
In the quiz Results Page → Orders & Tags, enable Create customer in Shopify so Flow has a customer to act on.
Why this matters: Rivo actions need a valid customer identifier (Shopify customer ID or email) to award points. Using the Lantern trigger Quiz Completed — with customers ensures that identifier is available.
1. Create the Workflow in Shopify Flow
1.1 Open Shopify Flow and click Create workflow → Select a trigger.
1.2 In the editor, select Lantern → choose Quiz Completed — with customers.
1.3 (Recommended) Add a Condition to check Quiz ID so the workflow only runs for a specific quiz (helpful if you have multiple quizzes). You can find the quiz ID in Lantern → More Integrations.
1.4 (Recommended) Add a short Wait action (30–60 seconds) to give Shopify time to finish creating/propagating the new customer before the Rivo action runs.
2. Choose a Rivo Action
Rivo’s Flow connector offers several actions. The two most relevant for quiz completions are Add points and Add points for a custom action.
2.1. Simplest: Add points
Award a fixed number of points for anything (simple, does not require creating a “Custom Action” in Rivo).
2.1.1 In Flow, click Add action → Rivo: Loyalty Program, Rewards → Add points.
2.1.2 Customer identifier: click Add variable and choose {{email}} (or use {{customer.id}}). 2.1.3 Set Points amount (e.g., 50), and optionally add a description like Completed Lantern quiz.
Optional fields
Internal note — Private, visible only in Rivo admin (e.g., “Flow: Lantern quiz – pets-best-bite”).
Skip email — Suppress the customer notification for this points grant. Useful for QA or silent rewards.
Points calculation — Formula-based points for order events. Leave blank for quiz completions (no order context); rely on Points amount or the Custom `Action’s configured value.
Tip: If you want the workflow to run only for certain quizzes, keep the Quiz ID condition from step 1.3.
2.2. — Optional: Add points for a Custom Action (shows in “Ways to earn”)
Award points tied to a named “Custom Action” you set up in Rivo (shows as a Way to Earn in your loyalty widget).
2.2.1 Create a Custom Action in Rivo:
In your Rivo dashboard, go to Programs → Points.
Click Add another way to earn and select Custom Action.
Fill the fields:
Action Name (present tense) — e.g., Complete quiz.
Completed Action Name (past tense) — e.g., Completed quiz.
Description — short text customers will see.
Points amount — how many points to award (e.g., 50).
Limit how many times each customer can earn points for this action — optional (e.g., 1 per 30 days).
Click Save to create the Custom Action, then continue with the Flow setup.
2.2.2 Back in Flow, choose Rivo → Add Points for a Custom Action. 2.2.3 Customer identifier: click Add variable and choose {{email}} (or use {{customer.id}}). Then enter the Custom Action name exactly as defined in Rivo (case‑sensitive). Optionally set a Points amount override.
3. Turn On the Workflow
3.1 Click Turn on workflow to activate. From now on, when a customer completes the quiz, Flow will run the Rivo action to award points automatically.
Example Variations
Segmented rewards: Add a Condition before the Rivo action (e.g., check quiz ID or a specific response) to vary the points awarded.
VIP boosts: Pair Add points with Update Customer VIP Tier when certain criteria are met.
Cross‑app automation: Use the Lantern trigger to also tag the customer, send an internal email, or pass data to other Flow‑compatible apps.
Notes & Tips
Use Quiz Completed — with customers so a Shopify Customer exists and you can pass {{customer.id}}/{{email}} to Rivo.
Lantern’s quiz completion has no order yet; leave any Order ID fields blank for quiz‑based rewards.
If the customer is brand‑new, a brief Wait (30–60s) improves reliability before the Rivo action.
For a named activity that appears in your loyalty widget, use Add Points for a Custom Action and ensure the Custom Action name matches exactly in Rivo.