What this integration does
- Contact and Order sync — syncs customer registrations, orders, cancellation, returns and shipment events to Engage
- Web activity tracking — captures product views, cart events, and order completion from identified contacts in real time
- Back-in-stock notifications — registers customer interest in out-of-stock products and pushes stock-level updates to Engage when inventory restores
- Personalised promotions — syncs Shopware promotions to Engage and surfaces assigned voucher codes to identified contacts in the cart
Who this is for
This documentation is for developers and implementation partners installing or extending the Voyado Shopware plugin. It covers installation, configuration, tracking behaviour, and the technical architecture of the integration.How it works at a high level
The Shopware plugin extends the storefront using Shopware’s Twig template inheritance system. This injects tracking scripts and structured data attributes into the relevant pages without modifying Shopware core files. When a visitor accepts consent and is identified as a known Voyado contact — either by logging in or arriving via a personalised email link — the integration begins sending behavioural events to the Voyado Accelerator API. Contact identification, session state, and cart snapshots are persisted in the browser’s local and session storage. Stock-level sync runs as a server-side pipeline: aproduct.written webhook triggers the Accelerator API, which detects restock events and pushes updated stock levels to Engage on a scheduled interval.
Promotions are created in Shopware, synced to Engage via the plugin configuration, and then activated and assigned in Engage.