Webhooks for preferences

Voyado Engage uses a third-party service called Svix as a “Webhooks as a Service” platform. This keeps your Shopify account in sync with any changes made to a customer’s marketing preferences for email, postal and SMS communication. Before you can complete the setup for this service, you’ll need an encryption key. Contact your Voyado team to get this. If you are already live with the Voyado Engage app for Shopify, you must make sure that all marketing preferences are currently in sync between Engage and Shopify before you activate this webhooks feature. Otherwise there is a risk of overriding the correct opt-in/out status in Engage.

​

How it works

Svix is used to dispatch events from Engage to a POST endpoint hosted by the Voyado Engage app. Here is an example of the workflow from Engage to Shopify:

1. The customer opts-out from email marketing through an email sent to them from Voyado Engage.
2. The change in their preferences triggers an encrypted event to Svix.
3. Svix passes the event to the Voyado Engage app, where it is placed in a queue.
4. The app decrypts the event payload and updates the customer’s preferences in Shopify

​

Prerequisites

There are some prerequisites before this will work:

• The “Webhooks” module need to be enabled in Engage
• You need to have permissions to access the “Webhooks Dashboard“.
• You will have received a 32 character encryption key from your Voyado team
• You’ve made sure that all customers marketing preferences are in sync between Shopify and Engage

​

Setting it up

Here are the steps to follow:

1. Enter the Voyado Engage app for Shopify.
2. Go to “Settings“ and scroll down to the section “Synchronize marketing preference changes from Engage to Shopify.”
3. Enable the functionality by checking the box “Enable“.
4. Input your Encryption key and select “Save”.

1. Copy the webhook URL to your clipboard.
2. Login into Voyado Engage and go to the “Webhooks Dashboard” in the Administration menu.
3. In the top right corner, select “Add endpoint“.
4. Paste in the webhook URL in the “Endpoint URL” field.
5. Enable the eventscontact.acceptsEmail.changedandcontact.acceptsSms.changedunder the section “Message Filtering”.
6. Select “Create“ and you are good to go!

​

Email marketing options “Preselected“

If you have marketing options set to “Preselected“, you’ll have to activate this setting below in the Voyado Engage app. This is needed to sync the correct consent given in the checkout by the consumers. Now press “Save” and you’re done.