Skip to main content

Before you begin

Overview

Hightouch’s AI Decisioning (AID) helps you deliver real-time, personalized messages based on live customer context and predictions. By connecting AID with Salesforce Marketing Cloud (SFMC), you can:
  • Automatically trigger messages from AID Agents via SFMC Triggered Sends or Journeys
  • Personalize SFMC templates using dynamic variables from Hightouch—no custom code required
  • Centralize targeting and decision logic in Hightouch, while using SFMC to handle message delivery
1

Set up SFMC as a destination

Already configured SFMC? Even if you’ve previously set SFMC up as a destination, you’ll still need to apply the specific permissions and scopes outlined below.

Why these permissions matter

To send messages through SFMC using AID, Hightouch needs access to certain channels, content, and user data. These permissions allow Hightouch to:
  • Trigger messages via Triggered Send and Journey Builder
  • Read and update subscriber data
  • Access and personalize email, SMS, push, and in-app templates
  • Read Content Builder assets to list and preview your email templates

Connect SFMC and grant permissions

In SFMC:
  1. Create an installed package in SFMC until you reach Set Server-to-Server Properties.
  2. Under Channels, enable the permissions for each message type you want Hightouch to use (read, write, send, publish, or post). Add component
  3. Under Assets, select Documents and Images: Read.
  4. Select Save.
In Hightouch:
  1. Continue setting up the SFMC destination until you reach the Custom Scopes step.
  2. Under Advanced permissions > Custom Scopes, paste in the following:
email_read email_write email_send documents_and_images_read accounts_read data_extensions_read data_extensions_write journeys_read journeys_write journeys_aspr journeys_execute list_and_subscribers_write list_and_subscribers_read push_read push_write push_send
  1. Select Test Connection to verify that setup is complete.
2

Add channels in AI Decisioning

Once SFMC is set up as a destination, you can add channels. Channels define how Hightouch sends messages to SFMC—via Triggered Sends or Journeys.

Set up a channel

  1. Go to AI Decisioning > Configuration > Channels.
  2. Select Add channel. Add channel button
  3. Choose a channel type: Email, SMS, Push, or In-App.
  4. Select Salesforce Marketing Cloud as the destination.
  5. Select a sync type:
    • Triggered send – sends a 1:1 message in real time
    • Journey entry – sends as part of a journey workflow
    • Data extension (advanced) – batch sends managed within SFMC
  6. For Triggered send channels, choose an identifier that matches the Subscriber Key field in SFMC (for example, email or user ID). Hightouch sets the identifier automatically for Journey and Data extension channels.
  7. Select Add channel, then Save changes. New channel modal

Sync type comparison

The Sync Type determines how Hightouch sends messages through SFMC:
3

Add messages

After you add channels in AI Decisioning, you can add messages to your agents. Each message connects an agent’s decision to a specific template in SFMC.For full details on message configuration, variants, and tags, see Messages.

Add a message from SFMC

  1. Go to AI Decisioning > Agents and select your agent.
  2. Open the Messages tab.
  3. Select Add messages, then select Add messages individually.
  4. Select your configured SFMC channel and destination tile (for example, Email - Salesforce Marketing Cloud).
  5. Select the appropriate template or event identifier from SFMC.
  6. Enter a message name and select Add messages. Add message from SFMC
You can repeat this process for any channel and sync type. Continue the setup process in the channel-specific sections below:

Test a message

  1. Open the message and go to the Content tab.
  2. Under Optimized content, confirm your variants are configured. If your message uses dynamic variables, set values for testing.
  3. In the Preview panel, verify the rendered message looks correct.
  4. Select Send test to send the message to a test user. Send test
4

Configure SFMC Triggered Sends and Journeys for AID

Before adding a message in Hightouch, you need to configure the corresponding Triggered Send or Journey in SFMC.

Send emails via Triggered Send

  1. Add a channel with the sync type set to Triggered send. Email channel - Triggered Send
  2. Add a message from your SFMC email template. Add message
  3. Close the window that opens and return to the Messages tab.
  4. Select the link next to Base content to go to SFMC. Base content link
  5. This will prompt you to log in to SFMC and should open the Email Studio > Interactions page.
  6. Select Triggered Sends. Interactions
  7. Select the send name that corresponds with your newly created message.
  8. Select Start/Restart. Start
  9. Return to Hightouch and open your message.
  10. In the Content tab, set the variables and select Send test. Send test

Send emails via Journey

  1. Add a channel with the sync type set to Journey entry. Email channel - Journey entry
  2. Add a message from your SFMC email template. Add message
  3. In the Content tab, set the variables and select Send test. Send test

Send emails via Data Extension

  1. Add a channel with the sync type set to Data extension. Email channel - Data Extension
  2. Choose Insert (append new rows) or Mirror (keep in sync with your warehouse).
  3. Add a message from your SFMC email template. Add message
  4. In SFMC, configure your send logic (automation, query activity, or triggered automation) to read from the Data Extension that Hightouch populates.

Send SMS text messages via Journey

  1. Add a channel with the sync type set to Journey entry. SMS channel - Journey entry
  2. Add a message from your SFMC SMS template. Add message
  3. In the Content tab, set the variables and select Send test. Send test

Send SMS text messages via Data Extension

  1. Add a channel with the sync type set to Data extension. SMS channel - Data Extension
  2. Choose Insert or Mirror mode.
  3. Add a message from your SFMC SMS template. Add message
  4. In SFMC, configure your send logic to read from the Data Extension that Hightouch populates.

Send push (outbound) notifications via Triggered Send

Enable the push channel

  1. Add a channel with the sync type set to Triggered send. Push channel - Triggered Send

Configure your push template in SFMC

In SFMC:
  1. Go to Mobile Studio > MobilePush.
  2. Select Create Message. Mobile push
  3. Select the Outbound template and select Next.
  4. Name your message and select your app.
  5. Select API Triggered as the Send Method.
  6. Select Alert as the Push Method and select Next. API Triggered
You can only trigger Alert Only or Inbox Only messages, not Alert + Inbox.
  1. Create the template for your push alert.
  2. Save your message. Save alert
  3. Select Send in the top right-hand corner.
  4. An activation window should pop up with an API key. Copy this API key to make it easier to find the template in Hightouch in a later step. Activate

Add a message in Hightouch

In Hightouch:
  1. Add a message from your SFMC push template. Add message

Preview content

Hightouch automatically creates the variables for push notification title, subtitle, and body. The values you supply here are used directly in the push notification without any need for code snippets in the template. If these are left blank, Hightouch uses the default values in the template.
Hightouch uses the override capabilities in the API. If even one variable has a value supplied, the default values in the template for all variables get overridden. Make sure to supply at least the default value for all variables, even if you only want AID to vary one.

Send tests

  1. To test push notifications, paste the contact key you use in your SFMC contacts. Send test
  2. Personalization strings can be supplied directly in the values for the variables without any need for code snippets in the template.
Personalization stringsPersonalization strings demo

Send push (app inbox) notifications via Triggered Send

Enable the push channel

  1. Add a channel with the sync type set to Triggered send. Push channel - Triggered Send

Configure your push template in SFMC

In SFMC:
  1. Go to Mobile Studio > MobilePush.
  2. Select Create Message. Mobile push
  3. Select the Inbox template and select Next.
  4. Name your message and select your app.
  5. Select API Triggered as the Send Method.
  6. Select Alert as the Push Method and select Next. Define message
You can only trigger Alert Only or Inbox Only messages, not Alert + Inbox.
  1. Create the template for your push alert.
  2. Save your message. Save alert
  3. Select Send in the top right-hand corner.
  4. An activation window should pop up with an API key. Copy this API key to make it easier to find the template in Hightouch in a later step. Activate

Add a message in Hightouch

In Hightouch:
  1. Add a message from your SFMC push template. Add message

Send push notifications via Journey

  1. Add a channel with the sync type set to Journey entry. Push channel - Journey entry
  2. Add a message from your SFMC push template. Add message
  3. In the Content tab, set the variables and select Send test. Send test

Send push notifications via Data Extension

  1. Add a channel with the sync type set to Data extension. Push channel - Data Extension
  2. Choose Insert or Mirror mode.
  3. Add a message from your SFMC push template. Add message
  4. In SFMC, configure your send logic to read from the Data Extension that Hightouch populates.

Send in-app notifications via Journey

Enable the in-app channel and add a message

  1. Add a channel with the sync type set to Journey entry. In-App channel - Journey entry
  2. Add a message from your SFMC in-app template. Add message
In these next steps, you will link your newly created message to an associated Journey in SFMC.In Hightouch:
  1. Go to the Content tab within your message to add the variables you would like Hightouch to control.
In SFMC:
  1. Go to Journey Builder > Journey Builder.
  2. Select Create New Journey. Create journey
  3. Select Multi-Step Journey.
  4. Select API Event as the entry source. Drag it onto the Journey Builder. API Event
  5. Select the grey API Event icon in the Journey Builder. This will open a list of API Events.
  6. Select the message name you chose when adding the message in Hightouch.
Hightouch automatically creates the required Data Extension with the event so you don’t have to set that up.
Select
  1. Select Done.
  2. Next, drag In-App Message to the Journey Builder. Drag message
  3. Select the grey In-App Message icon in the Journey Builder.
  4. Select (or create) your desired in-app message template.
  5. In the In-App Message Activity Summary, edit the required settings for Message Configuration and Display Trigger. Optionally, configure Display Options and Advanced Options as desired. See SFMC documentation for more details. Activity summary
  6. Optional: If you would like Hightouch to control aspects of the In-App Message, follow the instructions for using variables in SFMC templates.
    • Paste the variable code snippets from Hightouch into SFMC:
      • Select a message in Message Definition
      • Select Edit Selected Message
    Message definition
  7. Paste the copied code snippets from Hightouch into the Content tab that opens. Code snippet
  8. Save your changes.
  9. Optional: To continuously test sends, click the Gear icon > Journey Settings and select re-entry any time.
  10. Activate your journey. Activate
In Hightouch:
  1. Return to Hightouch and refresh the Content tab within your message.
  2. Preview your content to ensure everything is accurate.
  3. You can now Send test to subscribers. Send test

Send in-app notifications via Data Extension

  1. Add a channel with the sync type set to Data extension. In-App channel - Data Extension
  2. Choose Insert or Mirror mode.
  3. Add a message from your SFMC in-app template. Add message
  4. In SFMC, configure your send logic to read from the Data Extension that Hightouch populates.

Use variables in SFMC

Hightouch variables allow you to personalize SFMC messages using live warehouse data, any variable you’ve defined within the message such as subject line variations, or different content blocks.

Access variables

  1. Open a message in Hightouch and go to the Content tab.
  2. Under Optimized content, expand a content type (for example, subject or body) and add your variants.
  3. Select the ... menu on a content type and select Copy code snippet to get the variable code.
  4. Paste the code into your SFMC template. These snippets render with real values for each user when the message is sent.
Copy code snippet

Important notes

  • Triggered Sends: Variables are fully supported.
  • Journeys: Variables are available via Data Extension fields synced by Hightouch.

Troubleshooting

Next steps

  • Messages to create and manage the message variants each agent sends through SFMC.
  • QA guide to validate messages before you launch.
  • Agents to configure the agents that decide which messages to send.
  • Insights to measure how your agents and messages perform.
Last modified on September 23, 2026