Skip to main content
Here you’ll find the changes and updates to the Voyado Engage app for Shopify. There is an RSS feed for this page allowing you to subscribe to changes as they are published.

Show me the RSS feed

​

​
Shopify Headless API URLs changed

Contact details URL changed to:
https://shopify-app.engage.voyado.cloud/api/v1/contact-detailsBack in stock subscription URL changed to:
https://shopify-app.engage.voyado.cloud/api/back-in-stock/subscribe
​

​
App disabled when invalid API key used

With this update, the app automatically disables itself when it encounters an invalid or deleted API key. To resume syncing, merchants need to reconnect the app with a valid API key. Previously, if a customer’s API key was revoked (for example, after they churn), the app would remain active and would need to be manually uninstalled.

​
Skip customers without email in POS orders

POS orders that include a customer who doesn’t have an email address are now filtered out, preventing errors.

​
Improved handling of refunds for unfulfilled orders

Previously, syncing a refund for an order that had not yet reached the specified receipt-sync stage would cause the error: “Cannot handle refund due to related order not being synced.” This has now been addressed, aligning refund behavior with the expected syncing logic, which is:
  • If receipt-sync stage is set to “Fulfilled” the app ignores the refund until the order is fully fulfilled
  • If receipt-sync stage is set to “Unfulfilled” the app syncs the refund immediately

​
Fallback store optional in store-to-country mapping

A customer without a specific Engage store will now sync. The “Recruited in store” field will be left empty instead of blocking the sync. Previously, if a customer’s country wasn’t mapped to a store in Engage, and no fallback store was configured, the app would return a validation error.
If no fallback store is set, orders from unmapped countries won’t sync. Be sure to map all shipping countries or else define a fallback store to avoid missing data.
​

​
Shopify app now uses GraphQL

GraphQL is a flexible and modern way to retrieve data from an API, allowing faster syncing and smaller data loads. You will need to go into Shopify and update your Voyado Engage app before April 1st to avoid any issues.

Read about the update to GraphQL

​

​
New UI extensions

The app’s POS UI extensions were upgraded to Shopify’s new Unified UI Extension Package, improving performance and maintainability, and giving access to the latest Shopify extension features.

Read more about the Unified UI Extension Package

​
Admin action extension

The existing admin link has been migrated to an Admin Action Extension for a more integrated experience within Shopify Admin.

See more on admin action extensions

​
Script tag upgrade

Shopify is moving away from script tags, requiring users to move from the checkout_complete event to the Web Pixel API’s checkout_completed event. The cr parameter sent to Engage has also been adjusted to exclude thekey attribute from the cartToken, ensuring consistency across all pixel events.

See more on the script tag changes

​

​
New lang attribute

Added instructions for updating contacts to use the new lang attribute.

See about the lang attribute here

​

​
Handling of zero-value refunds

Added handling of refunds with an amount of 0.

See more about syncing receipts

​

​
Web pixel tracking update

Web pixel tracking now allows identification in checkout by email.

See more about web pixel tracking

​

​
Task monitoring overview

Task monitoring overview page and config panel added.

See more about task monitoring overview

​

​
Setup and configuration additions

New sections were added to the setup and configuration guide:
  • Headless API keys
  • Synchronize marketing preferences
  • Synchronize marketing preference changes from Shopify orders

See the setup and configuration guide

​

​
Headless loyalty API

Headless loyalty API added, for displaying loyalty information without using the Shopify front-end.

Read about the loyalty API

​

​
Shopify POS integration

Shopify POS integration moved out of beta.

​
UI update

New UI released for the Voyado Engage app.
​

​
Shopify POS integration

The Shopify POS integration was released.

See Shopify POS articles

​

​
PARTIALLY_FULFILLED state

Transactional state PARTIALLY_FULFILLED was added.

​
Abandoned browse

Abandoned browse now works out-of-the-box.
​

​
Change in handling of receipt number

Receipt number in Engage is now connected to order.name from Shopify instead of order.number.
This will not affect already imported orders. Merchants with already imported orders should use the search term “Contains” when segmenting in Engage on specific order number or receipt numbers.
Some merchants may not be affected by this at all since order number and order name can be the same in Shopify. The main change then is a suffix added to the number. Example: “12345” becomes “12345VOY”.

​
Cancelled order update

A cancelled order no longer triggers a refund email.
​

​
Migration of orders

Added migration of orders for customers who were imported to Engage outside of the Shopify app. For example, through a CSV file import in Engage.

​
Consents handled correctly in checkout

The “Accepts email” flag / consent in Engage is now updated correctly when completing checkout in Shopify.

​
Validation mismatch fixed

The validation mismatch on orders within the app has now been resolved. Previously, order totals did not match those in Shopify and were therefore not imported.

​
Error handling improvement

Better error handling of error message 409 - ContactWithKeyIsBeingCreated.

​
Fix for zero-discount entries

When syncing orders, any zero-discount entries will now not be sent to Engage.
​

​
Products of interest

Products of interest now sent to Engage.

​
Migration added

Migration of customers and orders added.
​

​
Assigning of vouchers and promotions

Assigning vouchers and promotions in Engage for use in Shopify.
​

​
Abandoned cart added

Triggering of abandoned cart actions in Engage.
​

​
Contacts sync

Sync of contacts between Engage and Shopify.

​
Transactional communication

Transactional communication now sent out from Engage.

​
Orders sent

Orders (receipts), both purchase and return, sent to Engage.

​
App theme block

App theme block in Shopify showing customer’s available vouchers and promotions.

​
Redemption added

Redeeming of promotions and vouchers.

​
Soft identification added

Soft identification (also called soft ID) added to app.