---
title: "Getting Started With Shopware and Mapp Connect"
slug: "getting-started-with-shopware-and-mapp-connect"
updated: 2024-11-13T12:06:18Z
published: 2024-11-13T12:06:18Z
canonical: "docs.mapp.com/getting-started-with-shopware-and-mapp-connect"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/v1/docs/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**. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/c929307a-2f09-4bc9-8e08-765a01515cfb.png)

#### 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.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/334823e9-8a9d-46b8-be35-598dd1b2cfce.png)

For more information, see [Mapping](/v1/docs/mapping).

### Setup in Shopware

#### E) Install the Plugin on Shopware

1. Download the Shopware plugin from [Github](https://github.com/mapp-digital/shopware-plugin).
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. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/689c98bc-c088-43a5-a20d-5bd0fa39060d.png)

#### E) General Configuration

Enable the module and choose the environment.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/23da7089-b5bb-44cb-bec5-17a31c2e1012.png)

| Setting | Details |
| --- | --- |
| **Module Enable** | Here, you can activate and deactivate the Mapp Engage module. |
| **Mapp Connect API URL** | - EU L3: [https://jamie/](https://jamie/).**g**.[shortest-route.com/charon/api/v1/](http://shortest-route.com/charon/api/v1/) - EU EMC: [https://jamie/](https://jamie/).**h**.[shortest-route.com/charon/api/v1/](http://shortest-route.com/charon/api/v1/) - US L3: [https://jamie/](https://jamie/).**a**.[shortest-route.com/charon/api/v1/](http://shortest-route.com/charon/api/v1/) - US EMC: [https://jamie/](https://jamie/).**c**.[shortest-route.com/charon/api/v1/](http://shortest-route.com/charon/api/v1/) For more information, see [Mapp Engage Clusters and Time Zones](/v1/docs/mapp-engage-clusters-and-time-zones). |

#### F) Integration Configuration

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

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/293e1cee-af5a-4dce-afd5-c9bf0952679e.png)
2. Select what data types you would like to send to Mapp Engage. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/3907a18d-29cd-441d-901d-551efff7b2a5.png)

| 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 | We don’t currently support this feature using our Shopware integration. If you want to use double opt-in, please use Shopware internal DOI messages or the Mapp Connect API. If you need assistance, please reach out to our Customer Support team. |
3. Select which groups should add users into categories such as customers, guests, and newsletters. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/38865918-60d2-470b-ab29-a3d7bcea649f.png)
4. Click **Save**.

You can now [set up events in Shopware](/v1/docs/external-event-setup-with-shopware) and start using the [Shopware business events](/v1/docs/shopware-business-events).