Skip to main content

Set Up Your Rivyo Integration

Who gets this? This feature is currently available for brands on all Postscript plans. Learn more about Postscript plans here.

When you connect Rivyo with Postscript, you can send personalized SMS messages triggered by real review activity so your subscribers hear about reviews, rewards, and requests at exactly the right moment. Turn post-purchase engagement into repeat revenue with timely automations for review requests, review confirmations, and coupon reminders.

Create an API Key in Postscript

  1. Select your Shop Name in the side menu of your Postscript dashboard, then select API.

  2. Select Create Security Key Pair on the right side of the page, then confirm your action by selecting Yes.

  3. Add a label to your API key so you can track where this API key is being used.

  4. Select Show in the Private Key column to reveal your API key. Copy this key or write it down—you'll need to enter it in Rivyo later.

Connect Rivyo to Postscript

  1. From your Shopify Admin, open the Rivyo app and select to Settings.

  2. Select Integrations.

  3. Locate the Postscript section and select Integration.

  4. Paste your Private API Key into the API Key field.

  5. Select Save.

Rivyo will now automatically send SMS events to your Postscript account whenever review activity occurs.

Events Sent to Postscript

Once connected, Rivyo sends the following custom events to Postscript. Each can be used as a trigger in your automation flows.

Trigger Event

When It Triggers

Use in SMS Flow

Rivyo - ReviewRequest

When Rivyo sends an automatic post-purchase review request

Ask the subscriber to leave a review after delivery

Rivyo - ReviewRequestByCampaign

When a review request is sent manually via a Rivyo campaign

Re-engage subscribers in a bulk campaign

Rivyo - ReviewSubmitted

When a subscriber successfully submits a review

Send a thank-you or follow-up offer

Rivyo - CouponSent

When Rivyo sends a discount coupon as a review reward

Remind the subscriber to use their coupon

Set Up an Automation Flow in Postscript

Use Rivyo events in a Postscript automation flow to send SMS messages automatically.

  1. Select Messaging in the side menu of your Postscript dashboard, then select Automations.

  2. Select Create Automation in the top-right corner of the page, then choose Create Automation Flow.

  3. Select Trigger event or property.

  4. Search for Rivyo and select the event you want to use (e.g., Rivyo - ReviewRequest).

  5. Select the + button to add an action, then select Message.

  6. Write your SMS message. Use the event properties listed in the next section to personalize it.

Note: Both Postscript and Okendo offer a Wait option. You can use either to set up the waiting period between the customer's order being fulfilled or delivered and the review request being sent, but be careful about using both, as the customer could wait twice as long as expected before receiving their SMS.

Event Properties

Each Rivyo event passes a set of properties to Postscript. Use these as merge tags in your SMS message editor to personalize messages for each subscriber.

Rivyo - ReviewRequest & Rivyo - ReviewRequestByCampaign

Below are the properties available when using Rivyo - ReviewRequest or Rivyo - ReviewRequestByCampaign as your trigger.

Property

Description

Customer Name

Full name of the customer

Customer Email

Email address of the customer

Order Id

The Shopify order number

Product Title

Name of the product being reviewed

Product Image Url

URL of the product image

Product Review Url

Direct link for the subscriber to submit their review

Store Name

Your Shopify store name

Store Url

URL of your Shopify store

TIP: Always include the Product Review Url property in review request messages. Without it, subscribers have no way to submit their review.

Rivyo - ReviewSubmitted

Below are the properties available when using Rivyo - ReviewSubmitted as your trigger.

Property

Description

Customer Name

Full name of the reviewer

Customer Email

Email of the reviewer

Order Id

The Shopify order number

Product Title

Name of the reviewed product

Product Url

URL of the product page

Rating

Star rating submitted (1–5)

Review Title

Headline of the submitted review

Review Body

Full text of the submitted review

Store Name

Your Shopify store name

Rivyo - CouponSent

Below are the properties available when using Rivyo - CouponSent as your trigger.

Property

Description

Customer Name

Full name of the customer

Customer Email

Customer email address

Coupon Code

The discount code sent as a review reward

Coupon Value

Value of the coupon (e.g., 15% off next order)

Product Title

The product the customer reviewed to earn this coupon

Store Name

Your Shopify store name

Frequently Asked Questions

Why aren't Rivyo events appearing in Postscript?

There are a few things to check. First, confirm your Private API Key is saved correctly in RivyoSettingsIntegrationsPostscript. Next, make sure automatic review requests are enabled in Rivyo. Finally, verify that orders are fulfilling correctly in Shopify — events won't fire if fulfillment isn't triggering as expected.

Why aren't my subscribers receiving SMS messages?

The subscriber must have SMS marketing consent enabled in Shopify before they can receive messages. Also confirm that your automation flow is published and active in Postscript — a flow in draft status won't send messages.

Why are my event properties showing blank in messages?

Make sure you are using properties that match the selected trigger event. Each event has its own set of available properties — refer to the tables in the Event Properties section above for a full list. Also note that some properties only populate with live data and may appear blank in preview mode. Testing with a real event is the best way to confirm everything is working.

Why won't my API key save in Rivyo?

Double-check that you copied the Private Key and not the Public Key from Postscript. If the issue persists, generate a new Security Key Pair in Postscript, then re-enter and save it in Rivyo.

Get Support


Have questions? Please feel free to reach out to our wonderful Support team at [email protected] or via live chat. You can also submit a support request here!

Need ongoing channel strategy guidance? Please fill out this form and we'll connect you to one of our certified partners.

Did this answer your question?