Overview

Configuration of the notification messages for a business service based on the channel for the same event.

Key Functionalities

• For a specific action of the user, he/she will get an SMS and email as an acknowledgement.

• Users can get SMS, Event, and email based on different channels.

• The application allows one to either send different messages across all channels based on their actions.

Configuration Details

• To have this functionality for different business services, a channel names file was created and added to the MDMS data.

• It contains information about the combination of different actions and channels for a particular business service. Example below:

 "channelList": [
 {   "businessService": "PT.CREATE",
     "module": "PT",
     "action" : "OPEN",
     "channelNames": ["SMS", "EMAIL", "EVENT"]
 },
 {
      "businessService": "BPA.CREATE",
      "module": "BPA",
      "action" : "SENDBACKTOCITIZEN",
      "channelNames": ["SMS", "EMAIL", "EVENT"]
  },
  {
      "businessService": "NewTL",
      "module": "TL",
      "action": "FORWARD",
      "channelNames": ["SMS", "EMAIL", "EVENT"]
  },
  {
      "businessService": "WS.CREATE",
      "module": "WS",
      "action" : "ACTIVATE_CONNECTION",
      "channelNames": ["SMS", "EMAIL", "EVENT"]
  },
   {
      "businessService": "SW.CREATE",
      "module": "SW",
      "action" : "APPROVE_CONNECTION",
      "channelNames": ["SMS", "EMAIL", "EVENT"]
    }
]

• The different channels are

  • SMS: ID (Mobile Number)

  • Event

  • Email: ID (Email ID)

• This feature enables the functionality that checks for the channels present in the file and sends the notifications accordingly.

• For the SMS event, it would send the SMS notification and log “Sending SMS Notification” for the Event it would log, “Event Notification Sent”, and for Email, it would log, “Email Notification Sent”.

Steps To Enable/Disable Channels

To add/delete any particular channel for a business service -

• Update channelNames array in the Channel List file and add/delete the channel you want a business service’s action to have.

• Restart egov-mdms-service to apply the changes.

• Configure your business service - follow the steps mentioned below.

Configure Business Service

• Adding details about the particular action and the channels you want that action to trigger in the Channel List file in egov-mdms-data repository.

• For any record that comes into the topic first, the service should fetch all the required data like user name, property id, mobile number, tenant id, etc from the record that we fetched from the topic.

• Respected localization templates should be upserted before in the required environment using the localization service. Restart the localization service to have the newly updated templates available.

• Then we should fetch the message content from localization and the service replaces the placeholders with the actual data.

• Then put the record in whichever channel’s Kafka topic that the sms, event or email service is listening to.

• Then the respective channel services (sms, event, email) will send out the notifications.

Overview

According to TRAI’s regulation on unsolicited commercial communication, all telecoms must verify every SMS content before delivering it (Template scrubbing). For this, all the businesses using SMS must register Entities, SenderIDs, and SMS templates on a centralised DLT portal.

Steps

Below are the steps to register the SMS template in a centralised DLT portal and to add the template in the SMS country portal (Service provider).

Step 1: Visit the Airtel DLT portal (AIRTEL DLT ) and select your area of operation as Enterprise then click on next.

Step 2: Login into the portal by entering the proper credentials and OTP.

Step 3: Select the Template from the option and click on Content Templates.

Click on the Add button to go to the next section.

Step 4: Select the option mentioned in the image below.

After clicking on the Save button, the template is added to the portal. Wait for the approval of the template. Once the template gets approved save the template ID and the message.

Step 5: Repeat the process from Step 3 to Step 4 to register the template in the DLT portal.

Step 6: Enter the credentials to log into the SMS Country portal (SMS Marketing Solution Provider | SMS & Voice Marketing APIs - SMSCountry ).

Step 7: Select the option Features, then click on the Manage button under the Template section.

Then click on the Add DLT Template button.

Step 8: Mention the template ID and message of the approved template which we saved earlier in step 4. Select the Sender ID as EGOVFS.

After adding all the above details click on Add Template button. The DLT-approved template is added to the SMS Country portal and is ready to use.

Step 9: Repeat the process from Step 7 to Step 8 to add the approved template in the SMS Country portal.