Salesforce Marketing Cloud Postback

Drive revenue and list growth at scale by connecting Attentive to Salesforce Marketing Cloud (SFMC). You can sync your contacts from Attentive to Salesforce so that you can use Attentive's high performing sign-up units to collect emails and text messaging sign-ups.

Step 1. Create an API user in SFMC

Log in to your admin Salesforce account and complete the steps to create a Marketing Cloud API user. Ensure that the following are configured for the user:

  • Roles: Ensure that you selected both Administrator and Marketing Cloud Administrator as your roles.
  • Reply Email Address: We recommend adding your work email address. This ensures that you have access to the email inbox of the account.

Step 2. Create an Event Entry Source

Note that you must complete this section if you plan to use Attentive in the Salesforce Journey Builder. Attentive relies on existing Entry Sources to properly connect the integration to SFMC Journey Builder.

If an Event Entry Source is present, you can skip this step and continue to Step 3. If an Event Entry Source isn’t present, you can create an event of any type in the SFMC Journey Builder. Complete the following procedure:

  1. Navigate to your Salesforce Journey Builder account.
  2. Select the Entry Sources tab, and then click New Event.
  3. Select API Event from the list of options; then click Next.
  4. Enter details for the Name and Description fields. Note that the Event Definition Key is automatically generated. Then, click Next.
  5. Select an existing Data Extension, and then click Next. If there are no Data Extensions in your account, see Create a Data Extension in Marketing Cloud.
    Note: Attentive doesn’t reference or read data from this Data Extension. However, SFMC requires you to select an existing Data Extension in order for this setup to work. We recommend creating a separate, empty Data Extension for this step.
  6. Click Next in the Contact Filter step. Note that you're not required to select a contact filter.
  7. Click Done.

Step 3. Collect SFMC information

Log in to your admin Salesforce account and collect the relevant information you’ll need to set up the integration in Attentive.

  1. Ensure you have Installed Package > Administrator permissions in Salesforce.
  2. In Marketing Cloud, go to Setup > Apps > Installed Packages.
  3. Click New.
    • Name the package Attentive Data Feed.
  4. Save the package.
    Note: After you save the package, you can view the package details.
  5. Under Components, click Add Component.
  6. Make the following selections:
    • Component Type: API Integration
    • Integration Type: Server to Server Integration
  7. Once you’ve created the new API Integration, click Edit and select the following permissions to add to the API Integration:
    • Journeys > Read
    • List and Subscribers > Read & Write
    • Email > Read & Send
    • Data Extensions > Read & Write
  8. Click Save.
  9. Navigate to the installed Attentive application to find:
    • Client Id
    • Client Secret
  10. Copy the section of the Rest Base URI between https:// and .rest. (This will be the Subdomain you need in Step 4.)
    SFMC-PB-01.png
  11. Click the drop-down in the upper-right corner, and copy the MID number. (This will be the Account Id you need in Step 4).
    Clicking dropdown in upper right corner and copying MID number.

Step 4. Set up the integration in Attentive

Now, complete the following procedure to set up the integration in Attentive:

  1. Ask your CSM or White Glove (whiteglove@attentivemobile.com) to turn on the Salesforce Marketing Cloud feature flag in your account.
  2. Navigate to the integrations setup page and select Salesforce Marketing Cloud.
  3. Enter the following information, which you collected in Step 3:
    • Client ID
    • Client Secret
    • Account Id
    • Subdomain

Note: The Salesforce integration connection expires after 60 days if no new emails are captured.

Step 5. Verify connection

Log in to your Salesforce Marketing Cloud account and check for the new Data Extension—Complete the procedure to View Marketing Cloud Data Extension Records. A new Data Extension, AttentiveAPIEvent, should appear. This is the new destination for email postbacks.

Salesforce API event postback

With the Attentive and Salesforce Marketing Cloud (SFMC) integration, Attentive offers the ability to post back email addresses and phone numbers collected through Attentive’s sign-up units to your SFMC account. With this integration, you install the Attentive app that adds emails to a data extension called AttentiveAPIEvent, which can be used in the Salesforce Journey Builder. Each of the following event types (as described below) triggers a call to the Salesforce Marketing Cloud endpoint and populates the associated data extension. You can learn more about the data extension in Step 5.

View the following section to learn more about what data can be passed to your SFMC account.

Parameters

Parameter Description Type Notes
ContactKey Attentive External Subscriber ID. string If you want to change this to the client’s email address, contact your CSM.
EventDefinitionKey

The external identifier used to populate the Data Extension and trigger Salesforce Journeys related to the integration.

There are two auto-generated EventDefinitionKeys. One for Subscription Events (begins with “AttentiveAPIEvent”) and one for Message Events (begins with “AttentiveMessageLinkClickEvent”).

string  
Data This includes a list of objects about the subscriber. object  
  EmailAddress The email address of the subscriber. string  
  Phone The phone number of the subscriber. string Passing phone numbers must be approved by the White Glove team at Attentive.
  AttentiveSubscriberID Attentive External Subscriber ID. string  
  Source Where the event is coming from. string  
  DateAdded The date that the subscriber opted in. date ISO 8601 format

 

Event types

There are two event types that trigger a call to the Salesforce Marketing Cloud endpoint: SUBSCRIPTION_OPT_IN_COMPLETED(channel=email) and SUBSCRIPTION_OPT_IN_COMPLETED(channel=phone). The following sections outline each event type and provide an example payload.

SUBSCRIPTION_OPT_IN_COMPLETED(channel=email)

This event occurs when an email address is captured through Attentive’s sign-up unit. The following is an example of the SUBSCRIPTION_OPT_IN_COMPLETED(channel=email) payload:

  {
"ContactKey": "972619350",
"EventDefinitionKey":"AttentiveAPIEvent-XXXX",
"Data": {
"EmailAddress":"user@client.com",
"Phone": null,
"AttentiveSubscriberID": "972619350",
"Source": "Attentive",
"DateAdded": "2020-09-21T12:00:00:00Z"
}
}

SUBSCRIPTION_OPT_IN_COMPLETED(channel=phone)

This event occurs when a user subscribes to SMS through Attentive’s sign-up unit. Note that this information is sent to Salesforce only if Attentive has an email associated with the subscriber. For example, this would occur when a user submits their email address and phone number through Attentive’s sign-up unit. The following is an example of the SUBSCRIPTION_OPT_IN_COMPLETED(channel=phone) payload:

  {
"ContactKey": "972619350",
"EventDefinitionKey":"AttentiveAPIEvent-XXXX",
"Data": {
"EmailAddress":"user@client.com",
"Phone": "+15555555555",
"AttentiveSubscriberID": "972619350",
"Source": "Attentive",
"DateAdded": "2020-09-21T12:00:00:00Z"
}
}

Questions?

We’re here to help! Contact our White Glove team (whiteglove@attentivemobile.com) to ask about the Attentive + Salesforce Marketing Cloud integration.

Articles in this section

Was this article helpful?
0 out of 0 found this helpful