Creating Hard Bounces for Sitecore Email Experience Manager in code

This week I’ve been working on integrating with a 3rd party API for when Sitecore Email Experience Manager receives a hard bounce from a contact’s email account.

Creating the processor for the <exm.recipientListManagement.add> pipeline is quite easy as per usual but mimicking a hard bounce isn’t as easy as I thought.

Over on Sitecore Slack, Pete Navarra had a good idea of sending an email to a hard bounced account like this stack overflow answer but that wasn’t an option for me as on my dev machine all the EXM emails are getting caught by my local Papercut SMTP server.

Luckily with a few messages to the rest of the team I’m working with, someone had already done this by building up a bounce message, encrypting the details and then passing it into a BouncedMessageHandler.

Here’s a snippet of code to do it:

IStringCipher stringCipher = 
  Factory.CreateObject("exmAuthenticatedCipher", true) as IStringCipher;

if (stringCipher != null)
{
    BouncedMessageHandler bouncedMessageHandler = 
      new BouncedMessageHandler(
    Factory.CreateObject("exm/bouncedMessagesTaskPool", true) 
       as ShortRunningTaskPool,
    Factory.CreateObject("exm/recipientListManagementTaskPool", true) 
       as ShortRunningTaskPool);

    Random random = new Random();
    string messageId = "5beff565-cccb-4a36-83ba-17f66872d770";
    string contactId = "0a53d8ce-77e1-4c30-a903-9f128535fa99";
    string emailAddress = "test@test.com";

    List<Bounce> bouncedMessages = new List<Bounce>
    {
        new Bounce
        {
            Id = random.Next().ToString(),
            BounceReason = "reason",
            BounceType = BounceStatus.HardBounce,
            CampaignId = "",
            ContactId = stringCipher.Encrypt(contactId),
            EmailAddress = emailAddress,
            MessageId = stringCipher.Encrypt(messageId)
        }
    };

    bouncedMessageHandler.HandleReportedMessages(bouncedMessages);
}

 

Creating Hard Bounces for Sitecore Email Experience Manager in code