1. Home
  2. Klaviyo API migration update

Klaviyo API migration update

Opinew is going to migrate to a new version of the API and some changes will be needed to keep the integration running, otherwise, the email content populated by the tags used in the template editor and the actual emails will show as empty, making current flows not work properly.

Before we release the update, we recommend you backup and clone your current review request flows using the integration.

If you feel confident enough, you can jump to step 3 without doing any backups.

Go to every Opinew-related flow (meaning those flows that use Eligible for Opinew review request or Left a review on Opinew as their triggers. You can use the trigger filters bar on top to see them) and click on the emails.

Then on the right sidebar click on the three-dot icon and select Save as a template. That way, you can add the same emails on new flows.

Save emails as templates

Make sure to do it for every email used in your flows.

Create new versions of all your current Opinew-related flows. To do that, you can clone all your current Opinew-related flows on Klaviyo.

Steps:

  1. Go to flows and select the flow you want to clone.
  2. Then click on the three dots and select “Clone“.
Clone your flows

These clones will work on the new version of the integration and should be set on Draft until the new version is released.

Step 3 – Update tags

If you have followed the previous steps, make sure you are editing the tags on the newly cloned flows.
If you haven’t followed the previous steps, please wait for the release date of our new API to make the changes in your current flows.

Inside the Opinew-related flows, the event properties used as tags on emails need to be updated, so we need to go through all the emails that use these tags.

To do that we select the email blocks on the flow and then on the right sidebar we select the Edit template button. Once inside the email template editor, we do the following:

Tags for Eligible for Opinew review request emails, replace Old tags with the New ones:

Remove the .items.data part of every old tag (if present).

OldNew
{{ event.items.data.customer_name|default:” }}        {{ event.customer_name|default:” }}
{{ event.items.data.product_image|default:” }}          {{ event.product_image|default:” }}
{{ event.items.data.product_name|default:” }}           {{ event.product_name|default:” }}
{{ event.items.data.review_link|default:” }}               {{ event.review_link|default:” }}
{{ event.items.data.review_request_link|default:” }}  {{ event.review_request_link|default:” }}

Tags for Left a review on Opinew emails, replace Old tags with the New ones:

Remove the .items part of every old tag (if present).

OldNew
{{ event|lookup:’is photo review’|default:” }}      {{ event|lookup:’is photo review’|default:” }}
{{ event.items.link|default:” }}     {{ event.link|default:” }}
{{ event.items.order_id|default:” }}        {{ event.order_id|default:” }}
{{ event.items.review|default:” }}{{ event.review|default:” }}
{{ event.items.review_star_rating|default:” }}           {{ event.review_star_rating|default:” }}
{{ event.items.reviewer|default:” }}{{ event.reviewer|default:” }}
{{ event|lookup:’review star rating’|default:” }}{{ event|lookup:’review star rating’|default:” }}

Make sure all new flows using the new tags are under Draft. They only need to set them to live after the release date.

Also make sure to edit the tags from image blocks, links, buttons and other elements apart from text blocks on the email editor.

All the other functionalities of the integration like coupons, sync profiles, adding profiles to lists, will work as usual. The only thing needed to upgrade is the tags from the emails.

Updated on May 2, 2024
Was this article helpful?

Leave a Comment