Documentation
APICreate a Ticket
  • 📔Documentation Guide
  • 📨Data & Engagement Platform
    • Data Model
      • Customer Data
      • Product Catalogue
      • Events
        • Onsite Events
        • Outbound Events
        • Transactions
    • App User Management
      • User Roles
      • App Users
    • Data Management
      • Data Management with API
      • Data Management with Data Feeds
        • Users
          • Import Users
          • Update or Delete a User Trait via File Upload
          • List of Standard User Traits/Attributes
        • Products
        • Events
          • Import Orders
          • Import Events
          • List of Events and Properties
      • Data Export
    • Web Tracking
      • Web Tracking v1 (Legacy)
        • Setup
        • Set up business Units
        • Tracking User Behavior
          • Identify Method
          • Page Method
          • Track Method
          • Opt-Out from Tracking
        • Testing & Debugging
      • Web Tracking v2
        • Setup using Google Tag Manager
        • Setup without a Tag Manager
        • Configuration & Config Commands
        • Tracking User Behavior
          • Identify Method
          • Update Method
          • Page Method
          • Track Method
          • Opt-Out from Tracking
        • Testing & Debugging
      • Migrate Tracking SDK v1 -> v2
      • Mobile Web Tracking
    • User Segmentation
      • Creating a Segment
      • Conditions
      • Combining Segments
    • Messages
      • Frequency Capping
      • Templates
        • Template Builder
      • Integrations
        • Channels
          • SMS
            • Twilio
              • Set up a Twilio Account
              • Set up Twilio Integration
              • Create a Campaign Message
            • Link Mobility
              • Set Up Link Mobility Account
              • Set up Link Mobility Integration
              • Create a Campaign Message
          • SFTP
            • Set up SFTP Integration
            • Create a Campaign Message
          • Direct Mail
            • Optilyz
              • Set up Optilyz Integration
              • Create a Campaign Message
          • Webhooks
            • Single Webhook
              • Set up Webhook Integration
              • Create a Campaign Message
              • Response Data and Custom Events
            • Batch Webhook
              • Set up Batch Webhook Integration
              • Create a Campaign Message
            • Zenloop via CrossEngage Webhook
              • Set up Zenloop Integration (via CrossEngage Webhook)
              • Set up Zenloop Survey
              • Create a Campaign Message
              • Set up Zenloop Survey via ESP
              • Obtain Response Data
            • Google Analytics via Webhook
          • Segment Transfer
            • Facebook
              • Set up Facebook Developer Account
            • Optimizely
              • Set up Optimizely Account
            • Google Analytics
              • Set up Google Analytics Integration
              • Create a Campaign with Google Analytics
              • Using the Google Analytics Integration
            • Airship
              • Set up an Airship Account
              • Set up an Airship Integration
              • Create a Campaign Message with Airship
          • Onsite Display
            • Trbo
              • Set up Trbo Integration
              • Create a Campaign Message in CrossEngage
              • Configure Campaign Message in Trbo
              • Obtain Response Data
          • Email
            • Mailjet
              • Set up Mailjet Integration
              • Obtain Response Data via Webhook
              • Create a Campaign Message
              • Personalize Preview Texts in Mailjet
            • Mandrill (by MailChimp)
              • Set up Mandrill Integration
              • Obtain Response Data via Webhook
              • Create a Campaign Messege
            • Inxmail
              • Set up Inxmail Integration
              • Create a Campaign Message
            • Sendgrid (by Twilio)
              • Set up SendGrid Integration
              • Obtain Response Data via Webhook
              • Create a Campaign Message
            • Mailgun
              • Set up Mailgun Integration
              • Obtain Response Data via Webhooks
              • Create a Campaign Message with Mailgun
            • Episerver (Optimizely)
              • Set up Episerver Integration
              • Create a Campaign Message with Episerver
          • Push Notifications
            • Airship
              • Set up an Airship Account
              • Set up an Airship Integration
              • Create a Campaign Message with Airship
        • Attachments
        • Delete an Integration
      • Personalization
        • Import Data
          • User Profile Data
          • Campaign Data
          • Cart Data
        • Formatting Functions
          • Date Formatting
          • Number Formatting
          • String Formatting
          • Hash Functions
        • General Helper Functions
          • Conditional Functions
          • Filtering Arrays
        • Product Helper Functions
          • Fetch from Product Feed
          • Fetch from Tracking Event
          • Fetch from User Journey
        • Misc. Helper Functions
          • Voucher Helper Function
            • Vouchers: Use Case
          • Event Helper Functions
          • Opt Out Helper Functions
        • Operators
      • Vouchers
        • Creating Vouchers
        • Using Vouchers
    • Campaign Management
      • Campaigns
        • Create an Audience Campaign
        • Create a Real-Time Campaign
        • Control Group
      • Stories
        • Building a Story
        • Use Case: Welcome Story
      • Segment Transfer
        • Create a Segment Transfer Campaign
    • Consent Management
      • Subscription/Consent Management
      • System Opt-Out/Opt-In
      • System Blacklist/Whitelist
    • Prediction Models
      • Create a new Model
      • Feature Engineering
      • SQL Filter
    • System Monitoring
      • Dashboard
        • Segment Tracker
      • Events Overview
      • Activity Log
      • Slack Notifications
        • Setting up Slack Notifications
    • Help & Support
      • System Status
      • Reach out to Customer Support
      • Suggest an Improvement
      • Privacy Policy
    • Glossary - Data & Engagement
  • 📈Predictions Platform
    • Data Model
      • Customer Data
      • Transactions
      • Activities
    • Overview
      • Data Tab
        • Data Tables in the Predictions Platform
      • Insights Tab
      • Model Builder Tab
        • Feature Engineering
        • Custom SQL Filter
        • Model Report
      • Prediction Tab
      • Selections Tab
    • Tutorials
      • Prepare and Validate Data
      • Analyze RFM Customers
      • Create a new Model
      • Predict Campaign Profit
    • Glossary - Predictions
Powered by GitBook
On this page
  • Value Mapping
  • Using Variables (Substitution Tags)
  1. Data & Engagement Platform
  2. Messages
  3. Integrations
  4. Channels
  5. Email
  6. Sendgrid (by Twilio)

Create a Campaign Message

PreviousObtain Response Data via WebhookNextMailgun

Last updated 2 years ago

  • Log in to your CrossEngage account.

  • Go to Campaigns and click Create new campaign in the top right corner of the page.

  • Choose whether you want to create an Audience or a Realtime campaign. Information about the distinction between these types of campaigns found .

  • Once you have created your campaign and filled in the “Campaign setup” and “Target group” sections, go to the Messages section and click Create new message.

  • Select Email from the dropdown menu. The message setup screen will open.

  • Name the new email message.

  • Under the “Send via integration” heading, select the SendGrid integration that you set up earlier.

  • Fill in the Sender Information:

    • “Sender email address” - the address from which the email will be sent;

    • “Reply-to email address” - the address where replies will be sent to;

    • “Sender name” - the name of the message sender.

  • Choose an existing template from SendGrid or create one in CrossEngage.

    • If you choose the SendGrid template, do not forget to map your values.

While you can use handlebars to personalize sender and reply-to email addresses in Sendgrid messages, personalization can only be applied to the local side of an email address (the part before the @), but not the domain part after the @.

Value Mapping

For example, to include your customer’s first name in your SendGrid email, you would place the[first_name] standard substitution tag where you want your customer’s first name to appear in the content of the message. When your customer receives the campaign, they will see their own name where the merge tag was placed.

Using Variables (Substitution Tags)

  • Include the substitution tag of your choice in the content of your SendGrid Template. To ensure values are mapped correctly, follow the value-mapping structure outlined in the section above.

  • Once your template is saved, you can use it in the CrossEngage campaign set-up. Select +Add key to add the variables that you have used in this particular campaign’s SendGrid Template. You can use both user attributes and handlebars to fill out your variables. SendGrid, unlike Mailjet, Mandrill and MailChimp, requires you to map the entire placeholder in CrossEngage. Therefore, when mapping variables in CrossEngage you have to copy the whole variable, in the same form as it is written in your SendGrid template (see the screenshot below).

​ may be useful when creating templates in CrossEngage.

Value-mapping fills out variables (called in SendGrid) in your SendGrid template with personalized content adjusted for individual customers. Note: CrossEngage only supports "Legacy Transactional Templates" in Sendgrid.

Apart from the reserved substitution tags that are preloaded into your account, you can also and map them in the following structure: [%EXAMPLE%]. Write the variables in this structure, only substitute “EXAMPLE” with the Merge Tag you wish to use.

To learn more about the SendGrid Templates, check the .

📨
Handlebars
substitution tags
create your own custom substitution tags
SendGrid Templates Documentation
here