Getting Started With Shopware and Mapp Connect

General information

The Mapp Engage plugin for Shopware allows you to:

• Send emails or transactional messages based on Shopware events. 

• Send external event triggers to your Whiteboard.

Procedure

Setup in Mapp Engage

A) Create Groups

You must create two groups for data synchronization. You will need them later during the plugin setup.

1. Click Groups > Create New and create two groups:

   1. one for customers called, for example, "Shopware_customer"

   2. one for subscribers called, for example, "Shopware_subscriber"

B) Prepare messages

To create the message in Engage, follow these steps:

1. Go to Messages > Prepared Messages > Email and create a new message.

2. Compose the transactional emails you want to send. For example, for order creation, update, refund, or cancellation. You will need them at a later stage of the configuration. For more information, see Prepared Messages.

C) Create integration between Engage and Shopware

The connection can be set up for all sales channels or each one separately.

1. Go to Data Management > Mapp Connect.

2. Click Add New Integration.

3. Select Type Shopware.

4. Enter the name of the connection and click Create.

5. The Integration Settings tab opens to the Overview tab. You can still change the name of the integration here and add a description.

6. (optional) Check the box if you want a Whiteboard to be triggered when the contact's mapping attributes change.

7. Click Regenerate Secret. Copy the secret key and save it for future reference. You will need it to authenticate the connection between Mapp Engage and your plugin.

8. Click Save.
   

D) Configure Mapping

A mapping is a list of imported data objects from Shopware. The default types of import for Shopware, as well as standard attributes, have already been added. The mapping for the Shopware integration only supports the subtypes Transaction, Newsletter, and User.

For more information, see Mapping.

Setup in Shopware

E) Install the Plugin on Shopware

1. Download the Shopware plugin from Github.

2. Log in to your Shopware account and go to Plugin > Upload.

3. Upload the zip from GitHub.

4. In Shopare Admin, navigate to Extensions > My extensions > Mapp Connect.

5. Click on the three dots and then on Configure. 
    

E) General Configuration

Enable the module and choose the environment.

F) Integration Configuration

1. Enter the Integration ID and Integration Secret generated in Mapp Engage. Click Save.

    

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

   Field	Description
   Customers data	Creates a user event and adds/updates contact profile in Engage, and he's added to the "Customers" group.
   Guest data	Creates a 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	Creates Transaction events and stores order data in Transactional Related Data for customers' orders. If in the 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	Creates Transaction events and stores 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 set up on the group level
   Newsletter - double opt-in	Allows you to Enable or Disable double opt-in for the newsletter. For more information, see Set up Double Opt-in with the Email Channel.

3. Select which groups should add users into categories such as customers, guests, and newsletters.
   

4. Click Save.

You can now set up events in Shopware and start using the Shopware business events.