Set Up Your Okendo Integration

   Tip: Select any of the images or GIFs in this article for a closer look.

Postscript integrates with Okendo, allowing you to share information between the two solutions.

About Okendo


Okendo makes it easy to gather and showcase customer reviews and user-generated content for your products and overall brand. With Okendo, you can build trust with prospective customers and drive future sales.

Why You Should Set Up Okendo


  • Easily reach specific customer segments with review requests and incentives.
  • Showcase user-generated content, such as customer pictures or videos featuring your products.
  • Build a pre-purchase FAQ with past customer feedback and insight.
  • Gain insights into customer segments, profiles, and product experiences.

Create a Postscript API Key


API.png

  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 Okendo later. 

Configure Postscript in Okendo


Once you have your private Postscript API key, you will need to enter it into Okendo's Postscript integration space.

  1. Select Settings in the bottom-left corner of your Okendo dashboard.
  2. From the Settings menu, select Integrations.
  3. Locate Postscript in the Email & SMS section and select the pencil icon.
  4. Copy your Private API Key in the space provided.
  5. Select Save.

Okendo Profile Properties and Events Data Synced with Postscript


   Note: Okendo only syncs profile properties and events data for existing Postscript subscribers. Okendo does not create new subscriber records or sync this data for any Okendo customer who does not already have a Postscript subscriber record

Okendo customer profile properties

Property name Description

Okendo Given Name

The first name of the customer.
Okendo Family Name The last name of the customer.
Okendo Average Review Rating The average rating given by the customer across all reviews.
Okendo Average Review Sentiment The general sentiment of the customer's reviews.
Okendo Latest Review Rating The rating given in the customer's most recent review.
Okendo Latest Review Sentiment The sentiment of the customer's most recent review.
Okendo Latest NPS Category The category of the customer's latest Net Promoter Score (NPS).
Okendo Latest NPS Date The date of the customer's latest NPS.
Okendo Latest NPS The score of the customer's latest NPS.
Okendo Number of Reviews The total number of reviews submitted by the customer.
Okendo Number of Survey Responses The total number of survey responses submitted by the customer.
Okendo Referral Shareable Link A link that the customer can share for referrals, if present.
Okendo Number of Successful Referrals The total number of successful referrals made by the customer.
Okendo Latest Successful Referral Date The date of the customer's latest successful referral.
Okendo Total Successful Referral Revenue The total revenue generated from the customer's successful referrals.
Okendo Loyalty Enrolment Date The date when the customer enrolled in the loyalty program.
Okendo Loyalty Next Birthday Date The next birthday date for the customer in the loyalty program.
Okendo Loyalty Points Balance The current balance of loyalty points for the customer.
Okendo Loyalty Points Expiry Date The date when the customer's loyalty points will expire.
Okendo Loyalty Program Status The current status of the customer in the loyalty program.
Okendo Loyalty VIP Tier The VIP tier of the customer in the loyalty program.
Okendo Loyalty VIP Tier Expiry Date The expiry date of the customer's VIP tier status.

Okendo event types and properties

Review Created

When a customer submits a review via Okendo, a custom event is logged in Postscript. This event includes the following properties:

Property name Description
Bought For The recipient of the product
Coupon Code The code for a discount coupon, if present
Coupon Description A description of the discount coupon, if present
Is Recommended Does the reviewer recommend the product (Yes/N)
Language Code The language in which the review is written
Loyalty Events Information about loyalty events, if present
Loyalty Points The number of loyalty points awarded, if present
Loyalty Provider The provider of the loyalty program, if present
Next-Day Delivery Whether the order included next-day delivery
Overall Sentiment The general feeling or sentiment expressed in the review
Photo Count The number of photos included with the review
Product Name The name of the product being reviewed
Product URL The web address (URL) for the product
Rating The rating given to the product, typically on a scale (e.g., 1 to 5 stars)
Review Body The main text of the review
Review Created Date The date when the review was created
Review Title The title or headline of the review
Reviewer Country Code The country code of the reviewer
Reviewer Display Name The display name of the reviewer
Reviewer Full Name The full name of the reviewer
Reviewer Zone Code The zone code of the reviewer
Source The source of the review, if present
VariantID The unique identifier for the product variant, if applicable
Video Count The number of videos included with the review
Variant Name The name of the product variant, if applicable
ProductID The unique identifier for the product
SKU The stock keeping unit, a unique identifier for the product
Okendo Average Review Rating The average rating given by the customer across all reviews
Okendo Has Submitted Media Indicates whether the customer has submitted photos or videos (Yes/No)
Okendo Latest Review Rating The rating given in the customer's most recent review
Okendo Number of Reviews The total number of reviews submitted by the customer

 

   Note: Attributes captured in the review may also be passed to Postscript as event properties

Review Request Created

When a fulfilled order meets review recruitment requiremends, Okena creates a review request with the following properties:

Property name Description
Email Address The email address of the customer.
First Name The first name of the customer.
Last Name The last name of the customer.
Name The name of the product for review.
Image Url The URL to retrieve a product image.
Order Fulfilled Date The date the product order was fulfilled.
Order Number The product order number.
Review Request Id The unique ID assigned to the product request.
Review Url The URL where the customer can leave a review.
Variant Name The name of the product variant (if any) on the order.

 

Submitted Okendo Quiz

When a customer completes an Okendo quiz, Okendo creates a Submitted Okendo Quiz event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Quiz Name The name of the quiz taken by the customer.
Quiz Response ID A unique identifier for the quiz response.
Redirect URL The URL to which the customer is redirected after completing the quiz, if applicable.
First Recommended Product ID The identifier for the first recommended product, if applicable.

 

Received Okendo Referral Coupon

When a referral coupon is issued, Okendo creates a Received Okendo Referral Coupon event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Date Received The date when the coupon was received.
Customer Role The role of the customer (e.g., referrer or recipient).
Coupon Code The unique code for the coupon issued to the customer.
Coupon Description A brief description of the coupon.
Coupon Expiry Date The date when the coupon will expire.

 

If the coupon is redeemed, additional properties are sent:

Property name Description
Recipient Order Discount Amount The discount amount applied to the recipient's order.
Recipient Order ID The identifier for the recipient's order, converted to a remote ID format.
Recipient Order Number The order number for the recipient's order.
Recipient Order Total Price The total price of the recipient's order.

 

Redeemed Okendo Referral Coupon

When an Okendo referral coupon is redeemed, Okendo creates a Redeemed Okendo Referral Coupon event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Date Redeemed The date when the coupon was redeemed.
Customer Role The role of the customer (e.g., referrer or recipient).
Locale The locale or language preference of the customer.
Order Discount Amount The discount amount applied to the redeemer's order.
Order ID The identifier for the redeemer's order.
Order Number The order number for the redeemer's order.
Order Total Price The total price of the redeemer's order.

 

Opted In to Okendo Referrals

When a referrer opts into a referral program, Okendo creates a Opted In to Okendo event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Date Opted-In The date when the referrer opted into the referral program.
Customer Role The role of the customer (e.g., referrer).
Locale The locale or language preference of the referrer.
Invitation Link A link for inviting others, if applicable.
Referrer Email The email address of the referrer.
Referrer Name The name of the referrer.

 

Okendo Referral Shareable Link Used

When an anonymous recipient shares their details after selecting a shared referral link, Okendo creates a Okendo Referral Shareable Link Used event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Date Opted-In The date when the referrer opted into the referral program.
Customer Role The role of the customer (e.g., referrer).
Recipient Email The email address of the recipient.
Recipient Full Name The full name of the recipient.
Verification URL A URL for verifying the referral, if applicable.
Locale The locale or language preference of the recipient.

 

Opted In to Okendo Referrals

When a recipient opts into a referral program, Okendo creates an Opted In to Okendo Referrals event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Date Opted-In The date when the referrer opted into the referral program.
Locale The locale or language preference of the customer.
Invitation Link A link for inviting others, if applicable.
Verification URL A URL for verifying the referral, if applicable.
Recipient Email The email address of the recipient.
Recipient First Name The first name of the recipient.
Recipient Last Name The last name of the recipient.

 

Sent Okendo Referral

When a referrer sends an invitation to a recipient, Okendo creates a Sent Okendo Referral event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Date Sent The date when the invitation was sent.
Customer Role The role of the customer (e.g., referrer).
Invitation URL The URL of the invitation.
Locale The locale or language preference of the referrer.
Recipient Full Name The full name of the recipient.
Recipient Email The email address of the recipient.
Recipient First Name The first name of the recipient.
Recipient Last Name The last name of the recipient.

 

Okendo Referral Invitation

When a referrer sends an invitation link to a recipient, Okendo creates an Okendo Referral Invitation event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Customer Role The role of the customer (e.g., recipient).
Date Sent The date when the invitation was sent.
Locale The locale or language preference of the recipient.
Recipient Email The email address of the recipient.
Recipient First Name The first name of the recipient.
Recipient Last Name The last name of the recipient.
Referrer First Name The first name of the referrer.
Referrer Last Name The last name of the referrer.
Invitation URL The URL of the invitation.

 

Okendo Referral Rejected

When a referral is rejected, Okendo creates an Okendo Referral Rejected event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Customer Role The role of the customer (e.g., referrer or recipient).
Should Notify Customer Indicates whether the customer should be notified.
Rejection Reason The reason for the referral rejection.
Email The email address of the customer.
Locale The locale or language preference of the customer.
Rejection Type The type of rejection (e.g., manual, automatic).

 

Enrolled in Okendo Loyalty

When a customer's loyalty status changes, Okendo creates an Okendo Enrolled in Okendo Loyalty event with the following properties (but no other properties):

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Description A description of the action that earned the points.
Action The specific action that resulted in earning points.

 

Okendo Loyalty Points Awarded

When a customer earns loyalty points, Okendo creates an Okendo Loyalty Points Awarded event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Points Earned The number of points earned by the customer.
Description A description of the action that earned the points.
Action The specific action that resulted in earning points.

 

Okendo Loyalty Points Redeemed

When a customer redeems loyalty points, Okendo creates an Okendo Loyalty Points Redeemed event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Points Spent The number of points spent by the customer.
Description A description of the redemption.
Coupon Code The code for any coupon associated with the redemption.
Coupon Description A description of the coupon.

 

Okendo Loyalty Tier Changed

When a customer's loyalty tier changes, Okendo creates an Okendo Loyalty Tier Changed event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Old Tier The previous tier of the customer.
New Tier The new tier of the customer.
Earning Period End The end date of the earning period for the new tier.
Is Tier Upgrade Indicates whether the change is an upgrade.

 

Okendo Loyalty Points Adjusted

When a customer's loyalty points are adjusted by a merchant, Okendo creates an Okendo Loyalty Points Adjusted event with the following properties:

Property name Description
ActivityID Unique ID assigned to the event.
Date Recorded date of event.
Adjusted Amount The amount by which the points were adjusted.
Adjusted Description A description of the adjustment.

 

Okendo Loyalty Tier Upgrade Nudge

When a customer has reached 80% or more of the necessary spend required to reach the next loyalty tier, the customer is sent a nudge and Okendo creates an Okendo Loyalty Tier Upgrade Nudge event with the following properties:

Property name Description
Current Tier The current loyalty tier of the customer before the upgrade.
Next Tier The next loyalty tier that the customer is being nudged to upgrade to.
Spend To Upgrade Tier The amount the customer needs to spend to reach the next tier.

 

If the eligibility period is 'lifetime', the following property is included:

Property name Description
All Time Spend The total amount the customer has spent over their lifetime.

 

If the eligibility period is a specific time window, the following properties are included:

Property name Description
Spent Within Tier Upgrade Window The amount spent by the customer within the current upgrade window.
Tier Upgrade Window End Date The end date of the current tier upgrade window.

 

Submitted Okendo Survey

When a survey response it submitted, Okendo creates a Submitted Okendo Survey event with the following properties:

Property name Description
Survey Name The name of the survey that the customer completed.
Email Address The email address provided by the customer.
First Name The first name of the customer.
Last Name The last name of the customer.
Survey Questions and Answers Additional properties containing questions from the survey and the corresponding answers provided by the customer.

 

If rewardType is "coupon":

Property name Description
Coupon Description A description of the coupon awarded.
Coupon Code The code for the coupon awarded to the customer.

 

If rewardType is "loyalty":

Property name Description
Loyalty Events The event ID associated with the loyalty reward, if applicable.
Loyalty Points The number of loyalty points awarded, if applicable.
Loyalty Provider The provider of the loyalty program.

 

Review Request Cancelled

When a customer cancels a review request, Okendo creates a Review Request Cancelled event with the following properties:

Property name Description
Review Request Id The unique identifier for the original review request.

 

Update Customer Profile

When there is a customer profile update, Okendo creates an Update Customer Profile event (no properties are sent).

Using Okendo Profile Properties and Events Data in Postscript


Merchants can leverage Okendo profile properties and events data to reach subscribers at key moments in their customer journey. These personalized, targeted messages can create urgency, drive desired behaviors, and create a higher-touch shopping experience.

Merchants can also create use profile properties to create segments for different campaign flows and campaigns.

   Tip: Make the most out of the Okendo integration by using automation flows instead of legacy automations.

Create an Okendo Automation in Postscript


Once you have successfully connected Postscript and Okendo, you can create a Postscript automation using an Okendo trigger.

OkendoAutomation.gif

  1. Select Messaging in the side menu of your Postscript dashboard, then select Automations.
  2. In the top-right corner of the page, select Create Automation, then choose Create Legacy Automation. Since you are creating this automation from scratch, select Custom Automation.
  3. Select Okendo Review Request from the Automation Trigger drop-down list.
  4. Select Save & Continue to Messages.
  5. To add a review link, select the More drop-down button above the message field, then select Add Tag.
  6. From the drop-down list, select Review Url
  7. Make sure your typing cursor is where you want the tag placed, then select Insert Tag. The {review_url} tag should appear in your message.
  8. Select Save Automation in the bottom-right corner of the page.
  9. Last, select the Enabled toggle so it changes to blue.
   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.

Create a Postscript Sequence in Okendo


An Okendo sequence sends notification of a fulfilled or delivered order to Postscript, triggering a review request automation message for subscribers who have opted-in.

  1. Select Mail in the side menu of your Okendo dashboard, then select Sequences.
  2. Scroll down to the integration section and select Postscript. Then, select Get Started.
  3. Select the Wait component, then define your wait criteria in the side panel. You can choose to wait a certain amount of days after an item fulfillment or delivery.
  4. Save your changes, then select the Start button in the top-left corner of the page.

Get Support


Have questions? Please feel free to reach out to our wonderful Support team at support@postscript.io 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.

Was this article helpful?
0 out of 0 found this helpful