Add an SSP
This document explains the procedure for adding an SSP on the Lemnisk platform on your own.
Lemnisk provides the convenience of adding an SMS vendor on your own on the platform itself to save the integration time and help going live with the campaigns faster.
This feature will help marketers configure the External API-led SMS vendors just by providing the authorization keys..
Pre-requisites
The vendor's API that works with -
HTTP POST Method
JSON payload.
The authentication mechanism and credentials that is a static key and not a refresh key.
Configuration procedures
To set up an SMS vendor, it is mandatory to map two configuration values: “To” and “Message Body”. These two fields are variable at the engagement level.
Ensure you assign the authorisation keys, senderID (if present), sender number 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 an engagement level, enter the variable name in curly braces {{variable_name}}, later you can also provide an alias as the display name as well.
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 SMS client
Step 1: Go to > Campaigns > Channels > SMS
Step 2: Click on the "+" Icon in the top row of the window.
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.
Configure your SMS 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 new SMS 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
API URL: Provide the API URL.
Also, 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.
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.
Now, select the SMS Configuration fields and map the mandatory values To* and Message Body* to the appropriate keys in the API Body.
Custom Field: You can add custom values to the Configuration by assigning variables in curly {{Example}} and mapping it to the Curl.
In this example, the vendor also expects the Template ID to be passed in the API request. This shall be a mandatory field, configured with the 'Custom Field' mapping.
Optional field: On adding the custom values you can choose to assign the variable to be optional and apply conditions from the following. Click here to learn more about optional fields.
Test API
Navigate to > Test API
Assign values to the payload and click "test"
You will receive the 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.
Response and Webhooks
The response and Webhooks screen is where you will map the relevant path of the response body to the internal MessageID identifier which supports Lemnisk to 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.
Congratulations! You've successfully added the SMS provider's API in the system and you can now create engagements to start your SMS campaigns.
Last updated
