# What can you do with our SFMC (Salesforce Marketing Cloud) connector?

[Salesforce Marketing Cloud](https://www.salesforce.com/fr/products/marketing-cloud/overview/) is an extensive marketing suite that allows marketers to create complex omnichannel journeys that are more tailor-made and more interesting for the end user.&#x20;

💡 In case you missed it, we just released a connector with them.

[Get in touch with us](mailto:partners@batch.com) to set up this integration.

## Looks great. How do I use it? <a href="#looks-great-how-do-i-use-it" id="looks-great-how-do-i-use-it"></a>

Once the integration has been set up on your account, you should see a new Batch Custom Activity in your Journey Builder, start by adding it to your Journey and click on it!

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2FqQqAC46vDMqGhlBwsLJi%2FGIF%20Recording%202024-05-22%20at%206.00.02%20.gif?alt=media&#x26;token=ee37f1d8-e4a4-4adf-952e-a4cbe7fa1737" alt="Batch custom activity"><figcaption><p>Add a Batch push activity</p></figcaption></figure>

### > Choose between an existing template and a new campaign <a href="#first-step-adding-the-campaign-name-and-apps" id="first-step-adding-the-campaign-name-and-apps"></a>

We let you either use Batch's interface or Salesforce's to create your campaign content. If you feel comfortable with Batch dashboard and feature, you can create a campaign there with Mobile Landings, personalization and previsualization, and **save it as a draft**.

Otherwise, you can choose "***New campaign**"* to create new campaign content from scratch.

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2FBwymBGXUR9Fh5wyfqUYR%2FCRM_CampaignDefinition_17042025.png?alt=media&#x26;token=adefa26e-3f20-4337-bed1-8ee35ed8a685" alt="Campaign definition"><figcaption><p>Campaign definition</p></figcaption></figure>

### Option A : Template <a href="#h_4caa420def" id="h_4caa420def"></a>

{% stepper %}
{% step %}

#### First step, adding the Campaign Name and Apps <a href="#second-step-choose-between-an-existing-template-and-a-new-campaign" id="second-step-choose-between-an-existing-template-and-a-new-campaign"></a>

Input a **unique** campaign name for this push notification and choose on which would you like to send a push notification to.

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2Fj1iE7xXSaV5xklB9PMsR%2FCRM_CampaingTemplate_17042025.png?alt=media&#x26;token=d72c2fee-9532-4be4-b4a0-23c7020a08d3" alt="Campaign template"><figcaption><p>Create a campaign by using a template</p></figcaption></figure>
{% endstep %}

{% step %}

#### Second step, choosing templates <a href="#third-step-choosing-templates" id="third-step-choosing-templates"></a>

If you've chosen the *Template* option on the second step, you will be asked now to choose for each app which draft campaign you wanna use for your push notification on Salesforce.

Note that it is also possible to override the draft content with new values if you choose the option in the bottom bar. Switching it on will bring you to the **fourth step**. Otherwise, you are done!

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2FHApWjoKcJ9WBzXO4V8xd%2FCRM_CampaingChoosingTemplate_17042025.png?alt=media&#x26;token=aa25cc27-8595-458c-b200-8a666109c7bf" alt="Choosing a template"><figcaption><p>Choosing a template</p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Option B : New Template <a href="#h_574696f9da" id="h_574696f9da"></a>

{% stepper %}
{% step %}

#### First step, adding the Campaign Name, Apps and optionnal features <a href="#h_67b7153c07" id="h_67b7153c07"></a>

Input a campaign name for this push notification and choose on which would you like to send a push notification to.

You can also add opptional features such as :

* Mobile landing
* Capping
* Payload

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2FMz5IlGZzARY5r8hmNwAT%2FCRM_SFMC_Campaign_AppSelection_17042025.png?alt=media&#x26;token=a8f4c5ef-21bb-4fb5-ad1c-f74a4f5af502" alt="App selection"><figcaption><p>App selection</p></figcaption></figure>
{% endstep %}

{% step %}

#### Second step, creating new campaign content <a href="#fourth-step-creating-new-campaign-content" id="fourth-step-creating-new-campaign-content"></a>

You are now prompted to write campaign content for your push notification. If a template was chosen in Step 3, these new values will override the template values.

Note that the image URL should be secured.

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2FgOB7mCYqmI0TnCAARgIT%2FCRM_SFMC_Campaign_PushMessage_17042025.png?alt=media&#x26;token=8f6a76d8-f2c9-47e8-8067-a8884c7c1c3d" alt="Push message"><figcaption><p>Define your message</p></figcaption></figure>

You can easily add other languages to your message using the "Add language..." module :

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2FJog6gWmVP0zr9QXIDtMa%2FCRM_SFMC_Campaign_AddingLanguage_17042025.gif?alt=media&#x26;token=28574985-6d8e-498c-8fd9-1d31eb11c475" alt="Adding language"><figcaption><p>Adding language</p></figcaption></figure>

* **Mobile landing :**

Mobile Landings allow you to easily introduce continuity between your app, and your pushes: A user opening a push will be greeted by a rich message related to what they opened, rather than just ending up on your app's main menu.

You can now manage them in the data activity:

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2Fv6MALjWVQdJDRo0SYHLG%2FCRM_SFMC_Campaign_MobileLanding_17042025.gif?alt=media&#x26;token=994ef34c-8282-4f4e-a73b-6535a35da911" alt="Adding a mobile landing"><figcaption><p>Adding a mobile landing</p></figcaption></figure>

* **Capping :**

Use the "Labels" field to implement capping define in your Batch dashboard and regulate your marketing pressure, ensuring your audience isn't overwhelmed with messages.

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2FwGHnB3AzIuAaYufNjz1M%2FCRM_SFMC_Campaign_Capping_17042025.gif?alt=media&#x26;token=912cdef0-ddea-496f-8f95-e390c25ff446" alt="Adding capping"><figcaption><p>Adding capping</p></figcaption></figure>

* **Payload :**

It's an optional JSON string that can contain **additional parameters** that your application can handle when receiving push notifications if configured to do so.

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2FAUQv17DhYjOUwYVsd1b2%2FCRM_SFMC_Campaign_payload_17042025.gif?alt=media&#x26;token=0de91fa9-b763-4268-8a1f-0fb0207eb306" alt="Using a payload"><figcaption><p>Using a payload</p></figcaption></figure>
{% endstep %}

{% step %}

#### Third step, preview and test your push <a href="#h_9a2324eddb" id="h_9a2324eddb"></a>

You can easily preview your pushes or send you a push of tests on your different platforms and in the languages defined in the previous section.

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2Fettkj6GtDwS8EuFjP7CT%2FCRM_SFMC_Campaign_TestPreview_17042025.gif?alt=media&#x26;token=a3be5bc3-951f-46ba-8a3f-e6f936e5a592" alt="Tests and preview"><figcaption><p>Test and preview your push</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Nice, but how do I run automated scenarios based on push reactions?  <a href="#nice-but-how-do-i-run-automated-scenarios-based-on-push-reaction" id="nice-but-how-do-i-run-automated-scenarios-based-on-push-reaction"></a>

Create a new Decision Split, and use the campaign ID below the Batch tile, and use it as a group-id to refer to a specific notification in your request.&#x20;

If you want to target users that received the push notification, add a  `event: sent` request. If you want to target users that opened the push notification, add a  `event: open` request as shown below :

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2F7WgmApLtmyHQCW00kGrL%2FCRM_SFMC_Journey_DesionSplit_17042025.png?alt=media&#x26;token=8b97b67f-ede7-4b4e-bf34-876327e06fbf" alt="Push open"><figcaption><p>Target the openers of a previous campaign</p></figcaption></figure>

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2Fl09hNg0WbZWXOTCzaLtz%2FCRM_SFMC_Journey_DesionSplit2_17042025.png?alt=media&#x26;token=167b9a5b-c931-4fe9-a931-1aaaa524911a" alt="Using a descion split in a journey"><figcaption><p>Using a decision split to retarget the openers</p></figcaption></figure>

### A few technical details ... <a href="#a-few-technical-details" id="a-few-technical-details"></a>

Every day, Batch will fill a Data Extension called BATCH\_PUSH with reaction events, so the day following the sending of the push notification, we will provide you with data concerning each push that has been sent.

In this database, the push is referred to by their group-id, which is a *slug* of the campaign name you've chosen (= a campaign ID). Note that this slug is available as the push tile name:

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2F64KYJjspCtw38ptUhM3C%2FCRM_SFMC_Campaign_GroupID_17042025.png?alt=media&#x26;token=24c58ebf-fcce-4e04-b711-704002129fb3" alt="Find your GroupID"><figcaption><p>Find your group-id</p></figcaption></figure>

In the BATCH\_PUSH data extension, this data is available as the group-id. Use it to retrieve information on the state of a push of a certain user such as demonstrated below:

<figure><img src="https://2998247023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwlQFpRAhaFR79zae6Jf%2Fuploads%2F0vPLH9SgoALL8eDqBRFh%2FCRM_SFMC_DE_FindInfo_17042025.gif?alt=media&#x26;token=b501679a-6e42-420f-89c1-db3d703e781d" alt="Find information about your sendings in the Batch Data Extension"><figcaption><p>Find information about your sendings in the Batch Data Extension</p></figcaption></figure>

There are four states in which a push can be, those states are represented by the **event** attribute :

* **accepted**: the push request has been accepted by Batch and will be processed asap.
* **sent**: the push notification has been sent to the user.
* **open**: the push notification has been opened by the user
* **error**: the push notification encountered an error (device unreachable in most cases).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.batch.com/integrations/marketing-platforms/what-can-you-do-with-our-sfmc-salesforce-marketing-cloud-connector.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
