Blackthorn Enhanced Emails
  • 20 Mar 2024
  • 3 Minutes to read
  • Dark
    Light

Blackthorn Enhanced Emails

  • Dark
    Light

Article summary

Paid Feature

Our enhanced email feature is a paid add-on with Blackthorn Events. For more information, please reach out to our team at https://community.blackthorn.io/s/.

SendGrid Integration

With our SendGrid integration, you can send emails from Salesforce through SendGrid. Why is this a benefit? See the reasons below:

  • For Admins, you won't run into your 24-hour email limit (our Email Template Builder uses Apex to send the emails).
  • For Admins and Event Managers, significantly fewer emails will hit spam folders.
  • For Event Managers, you will be able to create your own Email Template, send the email through our integration, and receive metrics about your email. IE., opens, bounces, and clicks without having to solely use Pardot, Marketing Cloud, Mailchimp, etc.

Salesforce developers are now able to access a global method to use Blackthorn's SendGrid integration to send email from a custom component.

New Method

1 conference360.EmailService.sendEmailToAttendees(Id orgWideAddressId, Id eventId, String emailTemplateId,Set<Id> attIdSet);
2 orgWideAddressId => Id for org wide email address record
3 eventId - Id of the event
4 emailTemplateId - Id of the email_template__c record
5 attIdSet -> Id of attendee to whom the email needs to be sent

The following is a sample that can be used in a dev console. Replace with correct Id

Set<Id> attIdSet = new Set<Id>{'a0n1F000002MK8KQAW'};
Id orgWideAddressId = '0D21F000000CdMTSA0';
Id eventId='a1B1F000001tISSUA2';
String emailTemplateId='a0w1F000001T6kYQAS'; conference360.EmailService.sendEmailToAttendees(orgWideAddressId,eventId,emailTemplateId,attIdSet);

Admin Configuration

Before You Start

  • Please reach out to Blackthorn Support via our support form to create your account with SendGrid. In the support form, please include which email address you would like us to use in the account step.
  • Enable Enhanced Email.
  • Add "https://api.sendgrid.com/v3/mail/send" to Setup > Security > Remote site settings.

Setup

  1. Log into SendGrid and verify your email and account. The email will look like this:
    enhanced emails 1

  2. Set up Sender Authentication. Navigate to Settings > Sender Authentication.
    enhanced emails 2

  3. Click "Get Started" under Verify an Address. Fill in all requested information. You'll need to verify an address for each Salesforce organization-wide email address used in the email template builder.
    enhanced emails 3

  4. Create an API key for your SendGrid users. This will link your Salesforce instance to SendGrid.

    • Settings > API Keys > Create New API Key
    • This MUST be set to Full Access
      enhanced emails 4
  5. Navigate to Salesforce and click Setup > Custom Settings > Blackthorn | Email Settings > Manage > New.
    enhanced emails 5

  6. Add in the API Key provided in Step 4.

  7. Check the Enable SendGrid checkbox.

  8. Optional: Define the SendGrid Reply To Email for attendees that may reply to emails that have been sent to them.

  9. Create an Organization-Wide Email Address

    • The Organization-Wide Email Address must be the same as the Single Sender.
    • You can set up multiple Organization-Wide Email Addresses as well as multiple Single Senders to support more than one user.
    • Optional: Add a Special Purpose Organization-Wide Email Addresses this will be the same email as SendGrid Reply To Email.

Ta-da! That's all there is to setting up SendGrid!

Event Managers

Email Template Builder

For additional instructions for items 1-4, view our Email Template Builder documentation.

To test this feature out:

  1. Create an Email Template related to your Event.
  2. Once you have saved your Email Template, click the Send Email button on the Event.
  3. Define the email information and the Attendees should receive the email based on their Registration Status or Attendance Status.
  4. Click Send.
  5. Get access to SendGrid from your admin who set it up. You'll log into SendGrid to review your email metrics.
  6. Aggregated data shown on pages like the Overview and Stats Dashboards can be stored for up to three years. However, specific data such as which email was sent to whom and how the recipient engaged with the email can only be stored for up to 30 days.
  7. Once you are logged in, navigate to Category Stats on the left-hand side. This is where you'll see all the information you need about the email you sent.
    enhanced emails 6
Future Functionality

In the future, we will pull the metrics from the email sent into Salesforce on the mass email record. Once that is delivered, we'll pull individual Attendee metrics.

Notes and Troubleshooting

If you see the following error
* Send Grid was NOT properly configured
* User is not in a production org
enhanced emails 7

When using the Send Test option in the Email Template Builder, these emails do NOT come from SendGrid.
enhanced emails 8