Introduction
The Adobe Commerce (Magento 2) extension for Engage allows Magento clients to leverage Engage as their customer experience platform, enabling a more personalized experience for their end-users. As a user of this extension, you can adapt it to personalize your customer's journey beyond what is shown here with the help of your development team/agency.
Caution
This Voyado Engage extension has been developed to work with a default Adobe Commerce (Magento 2) installation. If your Magento 2 implementation has had custom development, Voyado can't guarantee that the extension will work as intended, nor will Voyado be able to support you technically if any issues arise because of this.
Some user guides for this extension can be found in the Engage Help Center.
Release notes
4.0.0, 2024-03-13 ----------------- - Working towards one contact type in Engage - ContactType ‘Member’. Working towards one contact type in Voyado - ContactType ‘Member’. We have added the option to work towards one contact type instead of three. 3.1.1, 2023-11-29 ----------------- - Ticket #164822: improve getting requested type when creating an account. 3.1.0, 2023-11-23 ----------------- - Ticket #164822: Properly promote to member when creating an account. 3.0.0, 2023-11-01 ----------------- - Ticket #149066: support AES as decryption method for soft login. - Ticket #150467: clear client history before trying a new call. - Ticket #164235: improve finding contact by removing contactType from receipts body. 2.2.0, 2023-02-07 ----------------- - Ticket #147317: make handlers plugable in Magento. 2.1.1, 2022-11-30 ----------------- - No ticket. Use correct value to set decryption mode. 2.1.0, 2022-07-12 ----------------- - Ticket #138658: support Magento 2.4.4 and PHP 8.1 2.0.0, 2022-03-03 ----------------- - Ticket #125852: support Voyado promotions. - Ticket #126019: support Voyado vouchers. - Ticket #130181: remove setting consents, must be done in client modules. 1.0.0, 2021-08-25 ----------------- - Ticket #118857: initial version.3.0.0, 2023-11-01 ------------------ - Ticket #149066: Support AES as decryption method for soft login.- Ticket #150467: Clear client history before trying a new call.- Ticket #164235: Improve finding contact by removing contactType from receipts body. (Note: Fix connected to King Louie issue) 2.2.0, 2023-02-07 ----------------- - Ticket #147317: make handlers plugable in Magento. 2.1.1, 2022-11-30 ----------------- - No ticket. Use correct value to set decryption mode. 2.1.0, 2022-07-12 ----------------- - Ticket #138658: support Magento 2.4.4 and PHP 8.1 2.0.0, 2022-03-03 ----------------- - Ticket #125852: support Voyado promotions. - Ticket #126019: support Voyado vouchers. - Ticket #130181: remove setting consents, must be done in client modules. 1.0.0, 2021-08-25 ----------------- - Ticket #118857: initial version.
6.0.0, 2024-03-13 ----------------- - Refactored configuration sections. Sections in the configuration are now more clear. Renamed some config settings and changed their position. - Set phone number validation as default validation in the code. - Working towards one contact type in Engage - ‘Member’. Added the option to work towards one contact type instead of three. 5.1.0, 2023-11-23 ----------------- - Ticket #164822: Properly promote to member when creating an account and if street, gender or phone number is empty, do not send it to Voyado. 5.0.1, 2023-11-07 ----------------- - Ticket #165108: wait a little while to make sure new or updated objects are ready for processing. 5.0.0, 2023-11-01 ----------------- - Ticket #149066: support AES as decryption method for soft login. - Ticket #150467: improve search performance in Voyado admin by adding indexes. - Ticket #150467: clear client history before trying a new call to prevent getting wrong history. - Ticket #164235: improve lookup hits by removing contactType from receipts. - Ticket #144831: clean up records in table voyado_magento2_status - Ticket #162636: observe shipments to send partial shipments to Voyado. 4.2.0, 2023-10-10 ----------------- - Ticket #156112: [BETA feature] Web activity tracking on contacts, products and cart, all are configurable. 4.1.2, 2023-11-07 ----------------- - Ticket #165108: wait a little while to make sure new or updated objects are ready for processing. 4.1.1, 2023-09-26 ----------------- - Ticket #162683: added check on whether the customer model is present before we request a value from it when creating a new customer. 4.1.0, 2023-09-06 ----------------- - Ticket #159194: explain that Soft Login display message on frontend is for debugging purposes. - Ticket #148453: reflect shipping costs on invoice receipt. - Ticket #149761: get customer Voyado ID from Voyado if it's not stored in Magento. 4.0.3, 2023-06-13 ----------------- - Ticket #157726:set fallback values if the first and last name are empty. 4.0.2, 2023-05-26 ----------------- - Ticket #155596: improve logic to update/set custom attributes on customer. 4.0.1, 2023-05-23 ----------------- - Ticket #155596: set fallback values if the street and housnumber are empty. 4.0.0, 2023-05-02 ----------------- - Ticket #152167: export formatted phone number, but only if it's a valid one. - Ticket #150526: sync customer and address data from Voyado back into Magento. - Ticket #153915: sync newsletter subscription from Voyado to Magento. - Ticket #151380: prevent error when loading promotions/vouchers without a customer id. - No ticket. Improve performance loading status log in Magento admin. - Ticket #150355: export language as default contact property. 3.4.1, 2023-02-13 ----------------- - Noticket: enforce correct type of $storeId 3.4.0, 2023-02-07 ----------------- - Ticket #146493: check order hash to prevent sending duplicates to Voyado. - Ticket #149402: to avoid using cached data, load the customer always from the database. - Ticket #147317: upgrade to minimum voyado/sdk 2.2.0 which makes handlers plugable in Magento. 3.3.1, 2023-01-11 ----------------- - Ticket #149066: prevent an error during the soft login resulting in a non-working shop. 3.3.0, 2022-12-19 ----------------- - Ticket #146957: load product for specific store to have the correct URLs generated. - Ticket #146950: export complete address in order contact attributes. - Ticket #147243: don't let an empty default tracking url break the code. - Ticket #146987: set store ID in promotion / voucher message to redeem in correct Voyado account. - Ticket #138806: default to an empty string instead of 'f' when gender in Magento is empty. - Ticket #147245: for the credit receipt, take the created date from the credit memo. - Ticket #146720: only send accepts email, others are handled by Voyado internally. - Ticket #146864: reset cached subscriber if another one must be loaded. 3.2.1, 2022-11-15 ----------------- - Ticket #145753: add shipping costs incl. tax to the order header. 3.2.0, 2022-11-09 ----------------- - Ticket #145753: add refunded shipping tax to the total_tax and improve logic to detemine refunded quantity. 3.1.0, 2022-11-02 ----------------- - Ticket #144186: use a delay before sending create customer calls to Voyado. - Ticket #143416: load customer from quote if it isn't in the session (for use with GraphQL). - Ticket #145317: take the freigth fee from the credit memo as refunding it is optional and add refunded freight fee in credit memo receipt. - Ticket #143417: add URL to Magento Shipping Track page with configurable tracking information in the order body. - Ticket #145692: always load orders and creditmemos from database to prevent using cached data (as happens with get() ). 3.0.1, 2022-09-20 ----------------- - Ticket #143105: show contact attributes in log entry as normal array. 3.0.0, 2022-08-25 ----------------- - Ticket #132642: only send cart rule to Voyado if it has been changed. - Ticket #140836: support per store view API endpoint. Each queue message holds the store ID to be used. - Ticket #140654: fix deletion of customers in Voyado and always set contact type for customers to a member. - Ticket #130611: support multiple voucher codes using module amasty/coupons. 2.3.0, 2022-07-26 ----------------- - Ticket #138807: Send the export receipt at all times regardless of whether the order can be exported. 2.2.0, 2022-07-12 ----------------- - Ticket #138099: load customer with email and for it's own store to check subscription. - Ticket #140192: cast order store ID to int to avoid strict errors. - Ticket #138658: support Magento 2.4.4 and PHP 8.1 2.1.0, 2022-06-03 ----------------- - Ticket #137498: add configuration to redeem after invoicing or after placing the order. - Ticket #137573: support extra_data for customers which is extendable with an after plugin. 2.0.1, 2022-03-09 ----------------- - No ticket. Cast customer ID to required type int. 2.0.0, 2022-03-03 ----------------- - Ticket #125852: support Voyado promotions. - Ticket #126019: support Voyado vouchers. - Ticket #127419: export company and shipping customer name to Voyado. - Ticket #128392: keep current contactType when subscribing a customer to a newsletter. - Ticket #129665: support Magento commerce feature 'Giftwrap'. - Ticket #130181: set optional consents in the contact attributes. - Ticket #132775: Avoid duplicate api calls to Voyado. 1.0.2, 2021-09-15 ----------------- - Ticket #125197: product ID could be a string, remove strict type. 1.0.1, 2021-08-27 ----------------- - Ticket #11857: fix typo in module registration. 1.0.0, 2021-08-25 ----------------- - Ticket #118857: initial version.
1.3.3, 2023-11-23 ----------------- - Ticket #163698: allow any main property on a contact. 1.3.2, 2023-06-23 ----------------- - Ticket #137932: replace customer specific URL with a generic one. 1.3.1, 2023-05-02 ----------------- - Ticket #150355: export language as default contact property. 1.3.0, 2022-09-20 ----------------- - Ticket #143477: support Guzzle/Psr7 2.0.0 - Ticket #144186: drop support for PHP 7.x . 1.2.1, 2022-10-13 ----------------- - Ticket #144186: make 1.2.x compatible again with PHP 7.x. 1.2.0, 2022-07-12 ----------------- - Ticket #138658: support Magento 2.4.4 and PHP 8.1 1.1.0, 2022-06-03 ----------------- - Ticket #137573: support extra_data for customers. 1.0.1, 2021-08-27 ----------------- - No ticket. Update README. 1.0.0, 2021-08-25 ----------------- - Ticket #118857: initial version.
Prerequisites
Voyado Engage
You'll need an active Voyado Engage license, plus an API key to access the Engage API from Magento.
Magento
You'll need an active license for Magento 2.4.4 or higher.
RabbitMQ
Click here to see the supported versions.
Extension and SDK
You'll need an agreement with Voyado giving the right to use the Magento Extension and SDK. When that is in place, you will receive access to download the extension and the SDK.