Release notes
These are the release notes for the Voyado Engage app for Shopify.
2025-07-14
Automatic app disable on invalid Voyado API-key: Previously, if a customer’s API key was revoked (for example, after they churn), the app would remain active and need to be manually uninstalled. With this update, the app automatically disables itself when it encounters an invalid or deleted API key. To resume syncing, merchants just need to reconnect the app with a valid API key.
Skipping customers without email in POS orders: POS orders that include a customer who doesn't have an email address previously caused an error during sync. These cases are now filtered out, preventing the error.
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.
If receipt-sync stage is set to "Fulfilled" the app ignores the refund until the order is fully fulfilled.
If set to "Unfulfilled" the app syncs the refund immediately.
Fallback store for Contacts now optional in store-to-country mapping: 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. With this release, the customer will still sync, but without a link to a specific Engage store. The “Recruited in store” field will be left empty instead of blocking the sync.
Note that 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.
2025-03-31
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 more here.
2025-03-17
New UI Extensions: The app's POS UI extensions were upgraded to Shopify’s new Unified UI Extension Package improving performance and maintainability, and gicing access to the latest Shopify extension features.
Admin Action Extension: The existing admin link has been migrated to an Admin Action Extension for a more integrated experience within Shopify Admin.
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 the key attribute from the cartToken, ensuring consistency across all pixel events.
2024-11-01
Added instructions for updating contacts to be able to use new lang attribute.
2024-10-17
Added handling of refunds with an amount of 0. See here for details in the "Syncing receipts to Engage" section.
2024-06-28
Web pixel tracking now allows identification in checkout by email.
2024-01-23
Task monitoring overview page and config panel added.
2024-01-09
New sections in the setup and configuration page:
Headless API keys
Synchronize marketing preferences
Synchronize marketing preference changes from Shopify orders
2023-12-07
Headless loyalty API for displaying loyalty information without the Shopify front-end (link).
2023-12-01
Shopify POS integration moved out of beta.
New UI released for the Voyado Engage app.
2023-10-16
Shopify POS integration released. Full documentation here.
2023-10-05
Transactional state PARTIALLY_FULFILLED added (link).
Abandoned browse works out-of-the-box. Currently in BETA.
2023-09-28
Receipt number in Engage is now connected to order.name from Shopify instead of order.number.
Note 1: 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.
Note 2: 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".
A cancelled order no longer triggers a refund email.
2023-09-13
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). (link)
The "Accepts email" flag / consent in Engage is now updated correctly when completing checkout in Shopify. (link)
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.
Better error handling of error message 409 - ContactWithKeyIsBeingCreated.
When syncing orders, any zero-discount entries will now not be sent to Engage.
2023-08-15
Products of interest now sent to Engage (link)
Migration of customers and orders added (link)
2023-07-01
Assigning vouchers and promotions in Engage for use in Shopify (link)
2023-06-01
Triggering of abandoned cart actions in Engage (link)
2023-01-27
Sync of contacts between Engage and Shopify (link)
Transactional communication sent out from Engage (link)
Orders (receipts), both purchase and return, sent to Engage (link)
App theme block in Shopify showing customer's available vouchers and promotions (link)
Redeeming of promotions (link)
Redeeming of vouchers (link)
Soft identification (also called soft ID) (link)