Skip to content
Mapp Connect edited this page Sep 13, 2021 · 1 revision

Install

The newest version of the plugin is on GitHub. https://github.com/mappconnect/shopware-plugin

Download plugin zip file and then install it in the Shopware - Extensions - My Extensions - Upload Extension

Plugin setup

To access the Mapp Connect plugin settings page go left nav bar, click on the Extensions → My Extensions → Mapp Connect

Authentication

The connection can be setup for all sales channels or for each one separately. To setup a connection between Shopware and Mapp Engage you need to previously create Shopware Addon in Mapp Connect (see how). Below Integration ID and API secret should be copied from this integration.

Mapp Connect plugin supports Shopware Sales Channels - that means you can setup integration for all channels or for every separate one. Example - different languages versions.

Services

Integration Configuration

Create a new integration Shopware type. Copy and paste Integration Id and Integration Secret Key (remember it will be visible just once - save it offline)

Data Synchronisation

Select what data types you would like to send to Mapp Engage.

  • Customers data - creates user event and adds/updates contact profile in Engage and he's added to the Customers group
  • Guest data - creates guest event and adds/updates contact profile in Engage for users who create the order as a guest and he's added to the Guest group
  • Orders data - customers - create Transaction event and store order data in Transactional Related Data for customers orders. If in Business Events settings you set prepared message (email) for event checkout.order.placed also order an email will be sent to the user
  • Orders data - guests- create Transaction event and store order data in Transactional Related Data for guests orders. If in Business Events settings you set prepared message (email) for event checkout.order.placed also order an email will be sent to the user
  • Newsletter - creates newsletter event and adds/updates contact profile in Engage and he's added to the Newsletter group. double opt-in can be setup on the group level

Every event has a separate mapping which can be edited in the Mapping tab. See below in the events section default mapping settings

Groups

Select which groups should add users as Customers, guests and Newsletter.

Business Events Setup

To access the Mapp Connect Business Events setup go to the Shopware administration panel, click on the Settings→ Extensions → Mapp Connect Events

You can set up a handler for every Shopware Event and set it either to send a prepared message (EMAIL) or automation (trigger Whiteaboad plan which has to be setup before). It's possible to set more than one set for the same event however it's not supported by Mapp Connect.

To add new Event Click on Add Event. You can also Edit and delete rules.

Add New

To Add new rule for Shopware Event add:

  • Title - the name of this setup
  • Set it to Active
  • Choose Business Event from the dropdown list
  • Choose Message - automation is first on the list and it creates an automation event with the name of this Business event. If you would like to send an email (prepared message) choose it from the list.
  • Please check the list below with the events which does not support automation. Those events - like order or user register can only send email message within same API call however Whiteboard plan can still be setup with other blocks then External Event