Technical Guide for PE ID and TM ID Chain in Bulk SMS as per TRAI Guidelines

Karan T

20th November 2024

Find Best Bulk SMS Marketing Services

PE-TM chain-code associated with your SMS messages is either missing or incorrectly mapped with your delivery telemarketer. Starting December 1 , 2024, your SMS will start failing without correct PE-TM mapping as directed by TRAI.

What You Need to Do:

1. Initiate the Telemarketer (TM) chain on the DLT portal you’re registered with.

2. Notify the TM to confirm the mapping.

3. You’ll receive an email once the chain is completed by the telemarketer.

FAQs

Q: What is PE-TM chain-code?

A: TRAI’s directive, dated August 20, 2024, mandates all Telecom Service Providers (TSPs) to ensure traceability for SMS messages sent by Principal Entities (PEs). From December 1, 2024, any SMS without a clearly defined or correctly matched chain of Telemarketers (TMs) will be automatically rejected. (Refer to Para 10 (c) of TRAI’s Direction dated 20.08.2024)

Q: Why am I receiving this notice when I’ve already added my Telemarketer?

A: This notice may appear if your telemarketer has not completed or incorrectly completed the chain on their end. Please reach out to them to close this on priority. You’ll stop receiving these emails once all your chains are correctly done.

PE->TM chain-code is mandatory for SMS validation and processing.

Please complete these actions promptly to ensure uninterrupted messaging services. For any further assistance with Airtel DLT, feel free to contact us at support@turaingrp.com can find us for the solution as we are experienced in this topic - Turain Software Pvt Ltd

We would like to bring to your attention the recent TCCCPR 2018 Guidelines. Here's an update on the PE-TM traceability directive - TRAI has extended the timelines to 30th Nov'24 (from 1st" Nov previously). Now, it’ll come into action from 1st Dec 24. Meanwhile, we’ll continue to remind and support all the customers to build the chains at the earliest to avoid last minute hiccups and service disruption.

Moreover we request you to start using your chains in TLV parameter Scrubbing will pass if in case hash is sent or not.

Key Requirements and Timelines:

Starting from October 22, 2024, all Principal Entities will be required to define their Telemarketer (TM) on the TSP DLT portal. Example - JIO, Airtel, Tata, BSNL, Smart Ping, MTNL,
Telemarketers (TM) must then either:
1. Define whether they themselves are acting as the Telemarketer Delivery (TMD) with a direct connection to the Telecom Service Provider (TSP), or
2. Select another TM who will further define their role as TMD or select an additional TM in the chain.

Approval Process:

Once the entire PM -> TM -> TM -> TMD chain is defined, both the TM and TMD must approve the chain.
The TMD must then hash the entire workflow to ensure compliance during SMS submission for DLT scrubbing.

SMS Delivery and Scrubbing Compliance:

When sending an SMS, the TMD is required to submit the complete telemarketer chain for verification.
If the submitted chain matches the predefined workflow on the DLT platform, the SMS will be delivered. If there is a mismatch, the DLT scrubbing process will fail, and the SMS will not be sent.

Hashing Algorithm SHA256 which contains input string as (PEID,TM1ID,TM2ID,TMDID) needs to be pushed by TMD in API or SMPP TLV parameter while sending the requests to Gateway sharing below example:-

Madatory Parameters	Tag value Decimal	Tag value Hex
PE_ID	5120	1400
TEMPLATE_ID	5121	1401
HASH_ID	5122	1402

Optional Parameter	Tag value Decimal	Tag value Hex
MESSAGE_PAYLOAD	1060	0424

Hashing code for Golang and Java and Node Js:-

Input String : <PEID>, <TM1ID>,<TM2ID>,<TM3ID>

Sample: 1000000000,10000000001,100000002,1000000004

PE-TM Chain Error code list

811:-PE-TM chain is inactive.

812:-Invalid PE-TM hash.

813:-Hash does not match with PE-TM Chain.

For Golang:

//GenerateSHA256Signature returns SHA256 string of the input string

import (

"crypto/sha256"

"encoding/hex"

)

func GenerateSHA256Signature(input string) string {

hasher := sha256.New()

hasher.Write([]byte(input))

hexHash := hex.EncodeToString(hasher.Sum(nil))

return hexHash

}

For Java:

import java.security.MessageDigest;

String getHash(String input) {

String hash = "";

try {

MessageDigest digest = MessageDigest.getInstance("SHA-256");

byte[] valbyte = digest.digest(input.getBytes());

StringBuilder hexString = new StringBuilder(2 * valbyte.length);

for (byte b : valbyte) {

String hex = Integer.toHexString(0xff & b);

if (hex.length() == 1) {

hexString.append('0');

}

hexString.append(hex);

}

hash = hexString.toString();

} catch (Exception e) {

logger.info("Cta update MessageDigest parsing error. Input string : " + input);

}

return hash;

}

For Node Js:-

cid:image016.png@01DB2A04.97219D80

We strongly advise you to begin defining and approving your telemarketer chain as soon as possible to avoid any disruptions to your SMS delivery operations.

Bulk SMS Marketing Services

Why Choose Turain Software as your Bulk SMS Service Provider in Kolkata?

One of the best bulk SMS service company with TRAI authorization is Turain Software. We are a leading bulk sms marketing agency in Kolkata because of the following attributes: