🆕Add an ESP

This document explains the procedure for adding an ESP on Lemnisk CDP on your own.

Lemnisk offers you the capability of adding an Email vendor API on your own on the platform, saving a good chunk of engineering effort and time that goes into the integration; enabling the marketer take campaigns live faster than ever. This capability also allows any marketer to set up a private ESP on the CDP.

This feature will help marketers configure the External API-led Email provider APIs by just providing the authorization keys, and mapping the designated Email fields to the payload.

Pre-requisites

  • The vendor's API that works with -

    • HTTP POST.

    • JSON payload.

  • The authentication mechanism and credentials that is a static key and not a refresh key.

Configuration Steps

  • To set up an Email API, it is mandatory to map atleast 3 configuration values: “To”, “Subject” and "Sender Email". Subject and Sender Email is to be provided at engagement level.

  • Ensure you assign the authorisation keys and other essential global constants in the respective places in the API. Usually, these are configured in the URL parameters or header parameters.

  • To configure a field at engagement level, assign that key with "Custom Field" and then provide a static value or define it at engagement-level by entering the variable name in curly braces like {{Custom Value}}.

  • A default value is not mandatory, but recommended when the value does not change frequently. This value will be displayed again those parameters when creating engagements. You can also assign a Macro value to fields by type.

Setup new Email client

Step 1: Go to > Campaigns > Channels > Email

Step 2: Click on the "+" Icon in the top row of the window.

Add your own ESP

Step 3: Select "+ Add Client" from the list of clients.

Step 4: Enter your client name in the given input box.(Ensure you put the business name of the vendor. This is for the sanity of the records)

Step 5: Name your configuration in the given input box.

Image: Add Client

Configure your Email client

Step 1: Basic details

Name of configuration: The name you entered in the previous step will be displayed here

Description: Add a description for your the new Email client.

Step 2: API Details

You can set up the Vendor API in the same way as you set up an External API with a global payload.

HTTP Method: Select the HTTP method as POST or GET.

API URL: Provide the API URL.

Image: API Details

Alternatively, You can simply import the cURL of the API and skip to the next step! Let's understand how "Detect from cURL" works.

Clicking the +detect from URL button will pop up the following window.

Image: Detect from cURL

Once you enter the curl, it will automatically fetches the Headers and Payload from the API and populate in the relevant fields and the tree-view will occur based on the values in the payload.

Step 3: Map API Keys to Email Fields

Now, select the Email Configuration fields and map the mandatory values To* and Message Body* to the appropriate keys in the API Body.

Image: Email configuration fileds mapping

Custom Field: You can add custom values to the Configuration by assigning variables in curly braces {{Example}}.

Demo: Add your own ESP

Send Test Email

  • Navigate to > Test API.

  • Assign working values like Email Body, Subject, Recipient Email to the payload wherever applicable and click "test".

  • You will receive the success confirmation as shown below once your API is validated.

This is the same functionality we implemented in External API. Click here to know in detail.

Image: Test an Email

Response and Webhooks

The response and Webhooks screen is where you will map the relevant path of the unique ID in the response body to the internal MessageID identifier which helps Lemnisk identify every message trigger and account for the delivery reports.

  • Navigate to > Response and Webhooks.

  • Enter values to the payload and Click " Test Configuration".

  • You will receive the confirmation once your API is validated.

  • Select the mapping key to map the Unique message ID.

Image: Response and Webhooks

Click on Save Configuration to successfully save the message_ID path of the response.

Last updated