Shopware 6: Installation
Setup in emma
To use the Shopware integration, the emma module "Webservice (API)" must be booked and the account permission "Webservice (API) ⭢ HTTP Request JSON return" must be activated.
In addition, a emma user with the role permission "Permissions modules ⭢ Webservice (API) ⭢ Use" must be set up. Shopware logs in to emma with this user's credentials. We recommend setting up a separate user for this, to keep Shopware calls apart from other types of use.
Setup in Shopware
The plugin is installed via the Shopware online store.
Settings
Log in to the admin area of your Shopware shop. You find all relevant settings under the "Marketing ⭢ MAILINGWORK" tab. You make the settings separately for each SalesChannel.

Select a SalesChannel. Enter the login data of the emma user. Then select a setup for opt-in and for opt-out. These two setups are used for the export via the console and in the profile of the customer login.
In the last step, you have to assign (map) the subscriber data to be transferred. The plugin offers all subscriber fields that exist in the emma account. Select the subscriber fields to be transferred.
You must select at least the subscriber fields that are defined as mandatory fields in the emma opt-in setup.
Content
You can embed subscription and unsubscription forms directly as a content element. For this, the plugin provides its own content element "MAILINGWORK", which you find under "Forms". In it, you select the SalesChannel as well as an opt-in setup and an opt-out setup. With the form type, you determine whether a subscription form, an unsubscription form or both are displayed. All displayed fields are taken directly from the opt-in setup in emma. Please make any changes to the fields to be displayed in emma.
