Rivo and Postscript integration explained
Unlock the potential of SMS marketing to connect with your customers instantly and personally. Using Postscript with Rivo, you can engage with subscribers through your loyalty program data, create targeted segments, automate personalized messages, and drive higher engagement through SMS campaigns.
Benefits
Sync loyalty data (points balance, VIP tier, referral URL, loyalty status) as custom properties to subscriber profiles
Trigger targeted automation flows when customers earn points, redeem rewards, move between VIP tiers, or complete referrals
Use Rivo events as event splits and subscriber event splits in automation flows for personalized customer journeys
Use Rivo events as cancellation triggers in automation and campaign flows to prevent message overlap
Create powerful segments based on loyalty status, points balance, and VIP tier for targeted campaigns
Personalize messages in flows using Rivo custom properties to increase engagement and conversions
β¨ Rivo events are available on the Plus plan only
Connecting Rivo with Postscript
From your Rivo Dashboard, go to Integrations
Find Postscript in the Email & SMS Marketing section and click Configure
Enter your private API key (Where to find my Private API Key?)
Click Save
Optional: Under Custom Event Triggers, check the list of events you'd like to add to your Postscript account
Toggle the switch
ON
to enable the integration.
π Note: The 'Loyalty Profile Updated' event will be deprecated soon. We recommend migrating to the specific events under Custom Event Triggers for more granular control over your automation flows.
Where to find my Private API Key?
From your Postscript Dashboard, go to your account settings
Click API
Click on the Create Security Key Pair button
Once the new key is generated, enter the label
Click Show and copy the private key.
Viewing Loyalty data in your subscriber's profile
Locate the Rivo properties of your subscribers within their profile in Postscript.
Enter the phone number of a subscriber in the Search bar or access your segments to find the subscribers within
Click on the profile
Scroll down to Custom Properties and see the Loyalty data available.
Creating segments based on Loyalty data
Segmentation is a helpful tool that allows you to send targeted messages to a specific group of subscribers based on their Rivo properties.
From your Postscript Dashboard, go to Messaging
Click Segments > Create Segment
Enter the name of your new segment
Below Segment Criteria, click on the pre-selected filter to replace it
From the dropdown menu, select any of the Rivo properties available
Optional: Click + Add Rule to add an
or
connector within the same filterOptional: Add more filters for your segment if needed
Click Save Segment.
Rivo properties available
Property
|
Example
|
Custom Field Rivo-Date-of-Birth
|
|
Custom Field Rivo-Loyalty-Status
|
|
Custom Field Rivo-Points-Balance
|
|
Custom Field Rivo-Referral-URL
|
|
Custom Field Rivo-VIP-Tier-Name
|
|
Using Loyalty data in automation flows
Automation flows are sequential communications triggered by specific events. Use Rivo events to automatically start flows when customers interact with your loyalty program, allowing you to send timely, relevant SMS messages that drive engagement and conversions.
β¨ Rivo events are available on the Plus plan only
From your Postscript Dashboard, go to Automations
Click Create Automation > Create Automation Flow
Create a flow from scratch to open the flow builder
Under Trigger event or property, click Select an event
From the dropdown menu, select any of the Rivo events available
Optional: Add filters to the trigger if you want to be more specific on when the flow should start
Click Save
Make sure you have completed your flow with your preferred Flow Actions
Click Save Changes or Schedule or Activate.
π‘ Pro Tip: Rivo custom properties and events can be used in automation flows as trigger events, trigger filters, subscriber filters, cancellation triggers, trigger event splits, wait for event splits, and merge tags.
Rivo events available
Trigger event
|
Description
|
Trigger filters
|
Rivo - AdvocateSignup
|
A customer signed up for the referral program through a campaign
|
β’ Referral Link
|
Rivo - BirthdayCaptured
|
A customer enrolled in the program saved their birthdate
|
β’ Captured At
β’ Dob
|
Rivo - CustomerAccountActivated
|
A customer created an account using Shopify's legacy customer account system or via Rivo Accounts
|
β’ Account Activated At
|
Rivo - CustomerBirthday
|
A customer enrolled in the program earned points for celebrating their birthday
|
β’ Earnings Amount
|
Rivo - CustomerMovesDownATier
|
A customer enrolled in the program fell to a lower tier
|
β’ Vip Tier Name
|
Rivo - CustomerMovesUpATier
|
A customer enrolled in the program unlocked a higher tier
|
β’ Vip Tier Name
|
Rivo - NotificationPointsExpiry LastChance
|
A customer enrolled in the program will have their points balance expire in 3 days
|
β’ Expiry Date
β’ Expiry Date Formatted
β’ Time Until Expiry
|
Rivo - NotificationPointsExpiry Warning
|
A customer enrolled in the program will have their points balance expire in 30 days
|
β’ Expiry Date
β’ Expiry Date Formatted
β’ Time Until Expiry
|
Rivo - NotificationRewardExpiry LastChance
|
A customer enrolled in the program will have their reward expire in 3 days
|
β’ Expiry Date
β’ Expiry Date Formatted
β’ Reward
β’ Time Until Expiry
|
Rivo - NotificationRewardExpiry Warning
|
A customer enrolled in the program will have their reward expire in 30 days
|
β’ Expiry Date
β’ Expiry Date Formatted
β’ Reward
β’ Time Until Expiry
|
Rivo - PointsEarned
|
A customer enrolled in the program earned points after completing an action
|
β’ Earnings Amount
|
Rivo - ReferralCompleted
|
An advocate earned a reward after their referred friend placed their first order. The event appears on the advocate's profile
|
β’ Friend Email
|
Rivo - ReferralFriendClaim
|
A referred friend followed the referral link and claimed their reward
|
β’ Friend Email
β’ Reward Code
β’ Reward Name
β’ Reward Tos
|
Rivo - ReferralInviteFriend
|
An advocate sent their referral link through the email sharing option. The event is attributed to the advocate
|
β’ Advocate Name
β’ Friend Email
β’ Reward Name
|
Rivo - RewardRedeemed
|
A customer enrolled in the program redeemed or earned a reward. This event works for both advocates and referred friends
|
β’ Reward Code
|
π Important Note: Starting September 10th, 2024, all Rivo events enabled will be automatically added to your Postscript account upon integration setup, making it easier to create powerful automation flows.
Using Loyalty data to set up campaigns
You can create a campaign flow to deliver messages to a targeted customer segment. For more customization, you can use the Rivo event to automatically remove a subscriber from the flow if any of their Rivo properties are updated.
β¨ Rivo events are available on the Plus plan only
From your Postscript Dashboard, go to Campaigns
Click Create Campaign > Create Campaign Flow
Create a flow from scratch or use a template to open the flow builder
Select which customer segment you wish to send the campaign
Optional: Select which segment you want to exclude from the campaign
Optional: Under Remove a subscriber when (optional), click + Add Trigger and select any of the Rivo events available
Click Save
Make sure you have completed your flow with your preferred Flow Actions
Click Save Changes or Schedule or Activate.
π‘ Pro Tip: Rivo custom properties and events can be used in campaign flows as cancellation triggers, wait for event splits, and merge tags.
Adding Loyalty data to messages
Use merge tags to put each subscriber's Rivo properties into your text messages in campaign and automation flows.
Create a campaign flow or automation flow
Drag the Send message box from the Flow Actions menu and drop it wherever you wish
Click the purple tag icon (π·οΈ) at the bottom of the message field
Below Subscriber Properties, you will see the Rivo properties available
Once you are finished composing the message, click Save
Make sure you have completed your flow and click Save Changes or Schedule or Activate.
π Note: You can only use the Loyalty data as message tags in your campaign flow or automation flow.
Rivo properties available
Property
|
Example
|
Rivo-Date-of-Birth
|
|
Rivo-Loyalty-Status
|
|
Rivo-Points-Balance
|
|
Rivo-Referral-URL
|
|
Rivo-VIP-Tier-Name
|
|
Common Questions
Will the Loyalty data show up for all subscribers?
Our integration uses phone numbers to match the Members and Guests of your Loyalty program. Data will be synced to Postscript subscribers whose profiles have both emails and phone numbers in your Rivo loyalty program.
Can I use the Rivo event in legacy automations?
No, you can only find Rivo events in automation flows. However, you can still use the Rivo properties as user filters in your legacy automation.
Can I use Loyalty data in standard campaigns?
No, you can only use Rivo data in campaign flows. Within campaign flows, you can use Rivo events as cancellation triggers and Rivo properties as merge tags in your messages.
How frequently is data synced between Rivo and Postscript?
Customer data is synced automatically when changes occur in your loyalty program. You can also manually sync data by clicking the "Sync Now" button in your integration settings.
Can't get the app up and running? Please reach out to our live chat support team!