> For the complete documentation index, see [llms.txt](https://docs.messageflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.messageflow.com/integrations/marketing-automation-and-enterprise/sap-engagement-cloud-formerly-sap-emarsys.md).

# SAP Engagement Cloud (formerly SAP Emarsys)

### When to integrate MessageFlow with SAP Engagement Cloud (formerly SAP Emarsys)

It is worth carrying out the integration if you are using SAP Engagement Cloud as your main marketing automation platform and wish to send SMS campaigns directly from within it, without maintaining a separate SMS tool or integrating with another provider.

## 1. Prerequisites

Before you start, you will need:

1. An active SAP Engagement Cloud account with administrative rights to the Data Management section.
2. An active MessageFlow (Vercom) account and the access details provided by the MessageFlow team: Application Key and Authorisation.
3. A configured and verified SMS sender on the MessageFlow side — its name must be identical to the sender specified in the SAP Engagement Cloud campaign; otherwise, messages will not be sent.
4. An SMS rate (fee per SMS) agreed with MessageFlow for the selected country/region - optional, but recommended for cost calculations in SAP Engagement Cloud
5. A prepared CSV file containing a list of contacts (mobile numbers in international format, e.g. +48…) - required during the contact import stage.

### 2. Configuring the integration

1. Ensure your Application Key and Authorization credentials are configured in MessageFlow.
2. Log in to SAP Engagement Cloud (Emarsys).
3. From the side menu, select Data Management -> SMS Settings, then click Start Setup.
4. From the drop-down list, select the currency and the provider – MessageFlow.

<figure><img src="https://1762163817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDIGjHYIXYoHyJoOeeUgD%2Fuploads%2FDPmeyjs6sGBsHk8UXVXY%2F1.png?alt=media&amp;token=da82bb46-811d-431f-8b57-3c240d322e58" alt=""><figcaption></figcaption></figure>

5. Enter the Application Key and Authorisation details obtained in step 1.
6. Save the configuration.
7. Return to Data Management -> SMS Settings.

<img src="https://1762163817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDIGjHYIXYoHyJoOeeUgD%2Fuploads%2FwgLNtZLWvGdgEgfY1d5d%2Funknown.png?alt=media&amp;token=212b5bd5-5f88-4600-abb3-af71b40c225e" alt="" height="322" width="185">

8. In the General tab, add at least one country or region (Add Country or Region) - you must specify the region itself; the other fields can be left as they are, although it is worth filling in the SMS price (Fee per SMS) straight away. You can add several regions at once.

<figure><img src="https://1762163817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDIGjHYIXYoHyJoOeeUgD%2Fuploads%2FpFu0MlHVQWmEz3N2FXM2%2F3.png?alt=media&amp;token=ddd1611b-9bd4-4750-b575-77b5eb4ba8fc" alt=""><figcaption></figcaption></figure>

8. The integration configuration is complete.

### 3. Importing contacts

1. Prepare an import file in CSV format. The structure does not need to match the example exactly - the file may contain additional columns. Below is a minimal working example (it is important that it includes a telephone number in the ‘Mobile’ column):

<img src="https://1762163817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDIGjHYIXYoHyJoOeeUgD%2Fuploads%2FIbek4z2x5timRkkZkhDK%2Funknown.png?alt=media&amp;token=b84bd7d0-f08e-4e35-b800-b66511489e42" alt="" height="237" width="602">

2. Go to Contacts -> Data Import -> Import File -> Import File Manually.

<img src="https://1762163817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDIGjHYIXYoHyJoOeeUgD%2Fuploads%2FZOuzfsTQHdF5a4Xe1ilL%2Funknown.png?alt=media&amp;token=5c8713d8-0d4e-4a22-a2d6-0e9537f8fcea" alt="" height="357" width="602">

3. Select the import file you have prepared.
4. Set the contact’s unique identifier (Unique Identifier) and opt-in declarations - consents can also be imported directly from a file.

<img src="https://1762163817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDIGjHYIXYoHyJoOeeUgD%2Fuploads%2F0OuTBQeH6Pl0QWFztUFD%2Funknown.png?alt=media&amp;token=ebc3e3ca-0ef5-4eac-a149-4437262493ac" alt="" height="279" width="602">

5. Give the contact list you are creating a name.
6. Please wait until the import is complete.

### 4. Sending messages (SMS campaign)

1. From the side menu, select Channels -> Mobile -> SMS Campaigns.
2. Go to Campaigns -> Create New SMS.
3. Select your recipients, for example by using the contact list created during the import.
4. Prepare the text of your message.<br>

<img src="https://1762163817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDIGjHYIXYoHyJoOeeUgD%2Fuploads%2FosFzpm21HWJ8Kj2RQNN5%2Funknown.png?alt=media&amp;token=44795331-423a-4c28-a1e3-29566829b191" alt="" height="171" width="602">

5. In the ‘From’ field, enter the name of an existing sender configured in MessageFlow. Important: if the sender’s name does not match the sender in MessageFlow, the SMS will not be sent.
6. You can test the campaign using the button at the top of the screen - when you click it, you’ll be asked to enter the target phone numbers.
7. Send a test message - it should be delivered to the test number provided.
8. Once you have finalised your campaign, go to ‘Scheduling’ - you can schedule the send, generate a pre-launch report, or launch the campaign straight away (‘Launch Now’).
9. Once you have sent it, return to the list of campaigns - after a while, a summary (report) of the campaign will be available there.

### 5. Configuring two-way messaging (optional)

The integration can optionally support two-way messaging, so recipients can reply to your SMS messages and you can read their replies in SAP Engagement Cloud. To use it, you need a two-way sender that has been approved on the MessageFlow side.

1. From the side menu, select Data Management -> SMS Settings. In the General tab, edit an existing country/region or add a new one (Add Country or Region).
2. Click Add Inbound Number and enter your approved two-way sender. The number must be identical to the two-way sender approved in MessageFlow and must be in international format without the “+” sign, e.g. 48123456789. Save the changes.

<figure><img src="https://1762163817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDIGjHYIXYoHyJoOeeUgD%2Fuploads%2FBU5CTqCNoS9Wq2DDtIl8%2F8.png?alt=media&amp;token=cf6512d5-f89f-47b1-a0d9-231c64e4f844" alt=""><figcaption></figcaption></figure>

1. Go to Channels -> Mobile -> SMS Campaigns, create a new campaign and open the content creation step.

<figure><img src="https://1762163817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDIGjHYIXYoHyJoOeeUgD%2Fuploads%2Fj6uGVuSGFVH1Y11IQhzo%2F9.png?alt=media&amp;token=cb72f524-40bf-4253-81a5-10508cf02e16" alt=""><figcaption></figcaption></figure>

Your inbound number should now appear under Message Basics. Depending on your SAP Engagement Cloud settings, the inbound number may override the manually entered sender name, or you may still be able to enter the sender name as before.

4. Send a test message. Once it is delivered, reply to it from the receiving phone. Replies work for both test messages and campaign messages.
5. After a moment, the reply will appear in Channels -> Mobile -> SMS Campaigns -> Inbox.

<figure><img src="https://1762163817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDIGjHYIXYoHyJoOeeUgD%2Fuploads%2FoidtqogjhT2gGlMZPvBO%2F10.png?alt=media&amp;token=aacc9406-cc43-42d4-b581-c17fde109d06" alt=""><figcaption></figcaption></figure>

<br>
