There are two main features of the Klaviyo integration; capturing when a customer has submitted a review in Okendo and sending review request emails through a flow in Klaviyo. This article will help you set up the integration and explain the custom Okendo events, in detail.
Connecting Okendo to Klaviyo
Open the Okendo app > Settings > Integrations > Klaviyo:
2. Open the Klaviyo admin > Settings > API Keys.
3. Copy the public API key and paste it into the Okendo app.
4. Likewise, create a Private API Key labeled "Okendo", and paste it into the respective section in the Okendo app. Ensure it is Full Access.
5. Enable the product review aggregate and top reviews feed.
6. Click Save.
Okendo Review Request Metrics
Eligible for Okendo Review Request
This event contains the list of products that are eligible to be reviewed within a customer's order (Product Title, Product Image URL, and links to our Review capture form). This is sent from Okendo when an order has been fulfilled, through the "Forward to Klaviyo" Sequence.
An example of the payload:
Email Address: bob.mcgee@example.com
First Name: Bob
Last Name: Mcgee
Products: {u'Image Url': u'https://d3hw6dc1ow8pp2.cloudfront.net/emails/review/product-placeholder.png', u'Review Rating Urls': [{u'Url': u'#1', u'Stars': 1}, {u'Url': u'#2', u'Stars': 2}, {u'Url': u'#3', u'Stars': 3}, {u'Url': u'#4', u'Stars': 4}, {u'Url': u'#5', u'Stars': 5}], u'Name': u'Placeholder Product', u'Review Url': u'#'}, {u'Image Url': u'https://d3hw6dc1ow8pp2.cloudfront.net/emails/review/product-placeholder.png', u'Review Rating Urls': [{u'Url': u'#1', u'Stars': 1}, {u'Url': u'#2', u'Stars': 2}, {u'Url': u'#3', u'Stars': 3}, {u'Url': u'#4', u'Stars': 4}, {u'Url': u'#5', u'Stars': 5}], u'Name': u'Placeholder Product', u'Review Url': u'#'}
Review Request Id: d8d075f8-fd43-4b4b-abde-26e04d93b082
Ineligible for Okendo Review Request
This event is sent to indicate that an order is no longer eligible for a review request (the order was returned/refunded, for example).
Created Okendo Review
The "Created Okendo Review" metric/event is automatically sent to Klaviyo when a review is submitted. The metric contains all the data submitted in the review.
Note that you can set custom attributes for your product reviews within the Okendo app and these will appear in the payload as well.
Consider how these attributes may be useful for other flows or campaigns once captured.
Rating: 4,
Review Title: My New Favourite Product,
Review Body: I cannot believe how much I love this new product.,
Is Recommended: true,
Sentiment: positive,
Language Code: "en,
Source: write-review-button,
ProductID: 1885452822491,
Product Name: Small Cat Toy,
VariantID: 17387480307827,
Variant Name: Roller Coaster,
Sku: 888888,
Reviewer Display Name: Bob M.,
Reviewer Full Name: "Bob McGee,
Coupon Code: OKR-DISCOUNT-CODE,
Coupon Description: $5 off your next order,
Loyalty Events: OkendoLoyaltyEvent,
Loyalty Points: 100,
Loyalty Provider: LoyaltyLlama,
Image Count: 1,
Image Urls: https://i.imgur.com/PU37h8I.jpg
Video Count: 0,
Size Purchased: 4,
Body Shape: Hourglass,
Size Purchased: 12 / L
An Example Payload in Klaviyo.
The next steps are: