Messages

Add Messages to optimize content from your destination templates by defining variants and letting agents control which version is sent, when, and to whom.

What you’ll learn

In this article, you’ll learn how to:

• Add messages from your destination
• Understand base vs optimized content
• Create and manage message variants
• Control variant eligibility with rules and tags
• Manage messages at scale with CSV uploads and bulk actions

Overview

Messages define the creative variations an agent can send. Each message is sourced from a destination (such as Braze or Iterable) and can include multiple variants for experimentation.

Agents continuously evaluate messages to determine which variant, timing, and channel perform best for each user.

Add a message

1. Open an agent and go to the Messages tab.
2. Click Add messages, then select Add messages individually.
3. In the Add messages window:
   1. Select a channel and destination.
      • A channel defines how a message is delivered (for example, email or push), while the destination defines where the content is managed (such as Braze or Iterable).
   2. Select the destination-specific identifier:
      • Braze: Choose a campaign
      • Iterable: Choose a template
      • Salesforce Marketing Cloud: Choose a triggered send or message
      • Custom (S3): Enter a resource identifier
   3. Enter a message name to identify the message in Hightouch.
4. Click Add messages.

The message is added to the agent and appears in the Messages list.

View and manage messages

The Messages page provides a centralized view of message configuration and performance for an agent.

From this view, you can:

• Review message status (Enabled or Draft)
• See the number of variants per message
• View applied tags
• Search messages by name
• Filter messages by status

Select a message to access three views:

Use these views together to confirm setup and understand how messages perform over time.

Message content

Each message includes two parts: base content and optimized content.

Base content

Base content is the underlying message content defined in your marketing destination.

Examples include:

• An email built in Iterable, Braze, or Salesforce Marketing Cloud
• A push or in-app message defined in your destination
• Destination-managed layout, variables, or logic

When you add a message, you select the destination and the campaign, template, or send to use. That destination-managed content becomes the base content for the message.

Optimized content

Optimized content includes the specific fields within a message that agents can vary and learn from over time.

Common optimized content types include:

• Subject
• Preheader
• Call to action (CTA)
• Other supported message fields

Each optimized content type can include multiple variants, which are evaluated against your agent’s goals.

Variants

A variant is one version of an optimized content type (for example, a subject line option).

Variants are the individual options that agents compare and learn from over time.

Variants differ from traditional A/B tests:

• Traffic allocation adapts over time
• There is no fixed test window
• No manual winner selection is required

Add and manage variants

Variants are added inside an individual message, in the Content tab.

1. Open an agent and go to the Messages tab.
2. Select a message.
3. Open the Content tab.
4. Expand an optimized content type (for example, Subject).
5. Click Add variant.
6. Enter the variant content.

You can add multiple variants to the same optimized content type.

Variant-level controls

Each variant includes controls that determine when it is eligible to send.

To manage variant-level settings, open a message and go to the Content tab. Under Optimized content, click Edit tags and rules.

From here, you can add or update:

• Tags
• Audience rules
• Date rules
• Send limits

Audience rules

Audience rules limit a variant to specific users.

Examples:

• Show a loyalty-focused subject line only to returning customers
• Restrict a discount variant to lapsed users

Audience rules apply at the variant level, not the message level.

Date rules

Date rules control when a variant is active.

Use date rules to:

• Run seasonal or time-bound messaging
• Automatically retire expired content
• Stage future variants ahead of launch

Expired variants remain visible but are no longer eligible to send.

Send limits

Send limits control how often the same variant can be sent to a single user.

Available options include:

• No limit
• Static limit (for example, once per user)
• Time window (for example, once every 30 days)

Send limits apply to variants individually, not to the entire message.

Tags

Tags describe the intent or attributes of a variant, such as:

• Tone (friendly, urgent)
• Offer type (discount, free gift)
• Value proposition (convenience, exclusivity)

Tags help agents group and analyze content and are used in Content Analysis and Insights.

See Tags → for guidance on tagging strategy.

Manage messages at scale

AI Decisioning supports two bulk workflows for managing messages:

• CSV upload for content and metadata updates
• Bulk actions for applying message guardrails

Use CSV upload for structured content changes and bulk actions for delivery controls.

Bulk upload and export messages (CSV)

Use bulk CSV upload to add or update messages in an agent at scale. This workflow is best for structured, repeatable updates that are easier to manage in a spreadsheet.

What you can manage with CSV upload

Using a CSV file, you can:

• Add new messages to an agent
• Update existing messages
• Add or modify:
  • Message content
  • Variables and variable options
  • Message- and variant-level tags

What CSV upload does not support

CSV upload does not support message guardrails, including:

• Eligibility filters
• Send limits
• Campaign attribution

Apply these settings in the product UI using bulk actions.

Upload messages with CSV

1. Go to AI Decisioning → Agents and select an agent.
2. Open the Messages tab.
3. Click Add messages, then select Bulk upload with CSV.
4. Download the provided CSV template.
5. Edit the template with your updates.
6. Upload the completed CSV to apply changes.

Apply message guardrails in bulk

Use bulk actions to apply message-level guardrails to multiple messages at once.

Supported bulk guardrails

You can apply:

• Eligibility filters
• Send limits
• Campaign attribution values

Apply guardrails in bulk

1. Go to AI Decisioning → Agents and select an agent.
2. Open the Messages tab.
3. Select one or more messages.
4. Click Actions.
5. Choose one of the following:
   • Add eligibility filters
   • Add send limits
   • Add campaign attribution
6. Configure the settings and apply them.

How Messages connect to Content Analysis

As your agent runs, message and variant data feeds into Content analysis and suggestions, where you can:

• Review content similarity before launch
• Identify overlapping or redundant variants
• Understand which themes or tones perform best
• Decide when to add, refresh, or retire content

See Content analysis and suggestions → for guidance.

What’s next

• Agents →
• Tags →
• Content analysis and suggestions →
• Insights →