How to send SMS using Exotel with DLT Template Scrubbing?

this is only valid for sms sent to indian destination numbers (not applicable for ildo / international route) as per the trai regulation for sms in india, phase 2 (template scrubbing) of the dlt platform is planned to go live from april 1, 2021 (deadlines for each enforcement are detailed below) to be compliant with dlt scrubbing guidelines and send sms using exotel, follow the steps listed below all of your sms templates must be uploaded to an operator's dlt site the templates will be synchronized across all other operator platforms after they have been authorized the processes for registering your sms templates are as follows 1\ register your sms content templates with brand name(s) on the dlt operator portal check exotel for your current sms templates here you may also download your templates from exotel, which has a suggested dlt format for them please keep in mind that before forwarding the suggested template format to dlt for approval, you should thoroughly evaluate it because the variable requirements may change read the faqs below to learn more about exotel and the dlt template format add brand name(s) to your content templates on dlt every content template registered by a principal entity should have the content field 'brand name(s)' (complete business name/brand name/trademark) new templates registered from october 11, 2020, onwards should include 'brand name(s)', and if this is not done, the template may be refused by october 31, 2020 , any otp templates expressly (transaction and service related) that have been registered shall be updated with 'brand name(s)' after october 31, 2020 , content templates for otp without 'brand name(s)' would be regarded as invalid below are examples (as shared by vil dlt team) for your understanding in mentioning ‘brand name(s)’ scenario scenario 1 entities notably called with abbreviations and unique scenario 2 entities whose abbreviations represent 2 different names, must use the complete entity name at the footer scenario 3 entities whose registered name is different from their registered trademark name, can use their trademark name scenario 4 entities having multiples brands operated under their registered name, should use their complete brand name entity name entity name “state bank of india” entity name with same abbreviations national payments corporation of india (npci); nuclear power corporation of india ltd (npci) entity name bundl technologies private ltd (swiggy) or atria convergence technologies ltd (act fibernet) entity name aditya birla fashion and retail limited template examples template eg otp for online purchase of rs {#var#} at {#var#} thru state bank debit card {#var#} is {#var#} do not share this with anyone – sbi or state bank of india template eg 1 amt of {#var#} for {#var#} ({#var#}) will be credited to ur a/c of {#var#} national payments corporation of india template eg 2 amt of {#var#} for {#var#} ({#var#}) has been generated with the due date of {#var#} – nuclear power corporation of india template eg 1 dear customer, ₹{#var#} has been deducted from your swiggy money (powered by icici bank) balance at {#var#} updated swiggy money balance is ₹{#var#} – swiggy template eg 2 dear customer, thank you for choosing act our engineer will visit in the next {#var#} hours to confirm the feasibility at your location – act fibernet template eg 1 congratulations! \n your shopping has unlocked a gift voucher of rs 1000 redeemable on pantaloons com on rs 2499 spend valid till 15th dec tc use code {#var#} – pantaloons template eg 2 as we turn 2 in india, visit the american eagle store and get a {#var#} off on our entire collection, exclusively for you! limited period offer t\&c apply stay safe and keep shopping with us! learn more – american eagle template eg 3 congratulations! \n your shopping has unlocked a gift voucher of rs {#var#} redeemable at {#var#} on rs {#var#} spend valid till {#var#} tc use code {#var#} – louis philippe 2\ update your templates on exotel once you have updated your sms templates on the dlt portal with brand names(s), make sure you update the same on exotel (settings > sms templates) as well as add any missing templates to avoid failures 3\ configure your sms api requests with dlt parameters you can comply by integrating the additional dlt parameters while submitting messages to exotel in our sms api ‘dltentityid’ and ‘dlttemplateid’ are the new parameters added to our sms api which you need to pass detailed documentation can be found here ` dltentityid` is mandatory to be provided from october 19, 2020 otherwise, your sms may fail if you are unable to accommodate the api changes, you can follow the next approach temporarily 4\ add dlt information on exotel if you use the exotel dashboard (campaigns, sms button or sms applets) to send sms or are unable to accommodate the api changes at the moment , you can update your dlt information on exotel to configure your dlt entity id on exotel, set it on the dashboard settings this is mandatory to be provided by october 19, 2020, to avoid sms failure you can find the entity id on your dlt portal like vil (login >account setting >entity id) please note double check the entity id entered in case of incorrect id the smses will fail to configure template id on exotel, you can set it against each of your templates here once you have configured, both dlt entity id and template id, these will be passed to the operators while sending smses to your account while adding a template, you can use {#var#} as a placeholder for replacing alphanumeric text similar to dlt alternatively, %s continued to be supported as well read the faqs below to understand more about template format faqs how to map dlt sms type on exotel for sms templates? exotel supports 3 sms types, "transactional", "transactional opt in" and "promotional" for backward compatibility, we will continue to support all 3 as of now however, with dlt guidelines you can map your sms types on exotel as per the below table sms type on dlt sms type on exotel banking otp transactional service implicit transactional service explicit transactional / transactional opt in promotional promotional how to map the dlt template format on exotel? exotel supports 3 variable placeholders %d for numeric and %s for alphanumeric strings and {#var#} for both such a placeholder can be replaced with any number of characters whereas dlt supports variable format with {#var#} and it only allows a replacement of up to 30 characters please do note, that your traffic so far might be replacing more than 30 characters for your sms on exotel as a replacement of the placeholder %s or %d to be compliant on dlt, use multiple combinations of {#var#} to allow the number of character replacements your sms would need what all changes are required if i'm using exotel's send sms api? below are the api parameters which you need to review and adhere to as per dlt guidelines from this should be the sender id or the exophone (linked to a sender id) present in your exotel account and registered on the dlt portal body this is the actual content of your sms make sure the corresponding template is present in your exotel account and exactly matches with the template as registered on dlt dltentityid new entity id of your business as registered with the dlt (distributed ledger technology) portal in india dlttemplateid new content template id against the sms body registered with dlt (distributed ledger technology) portal in india such a template body should be linked with the sender id (from) on the dlt portal to read the complete api documentation, refer here i send sms using non api methods sms campaigns, sms applets or sms button, what should i do? sms template should be registered on dlt sms template should be present on exotel dlt template id and entity id should be configured on exotel as explained above how to identify if my sms are going alright? download sms report from exotel's dashboard and identify smses where `dlttemplateid` or `dltentityid` column is empty, indicating template id was not configured on exotel dashboard properly or not passed in the api request if `dlttemplateid` and `dltentityid` is set, but sms status is `failed` (post dlt enforcement), please validate the content exactly matches with the template registered on dlt some common pointers to ensure template matching succeeds ensure dltentityid is passed in api or set on exotel dashboard ensure dlttemplateid is passed in api or set on exotel dashboard against each template don't register templates with %s and %d on dlt, instead replace it with {#var#} or use download the templates (as mentioned in step 1) for the proposed format for dlt registration variable length i e text replacing {#var#} placeholder on dlt should not exceed more than 30 characters use multiple variables like {#var#}{#var#} in your templates on dlt to ensure the template match doesn't fail updated 10/05/2021 exotel now supports {#var#} as a placeholder to replace content similar to dlt along with %s and %d as placeholders for replacing string and digits respectively the text should exactly match the template registered on exotel as well as on dlt even a single character mismatch of space or special characters can result in mismatches header (sender id) mapping against each template should be verified in case the ‘x’ header is mapped on the dlt platform with a ‘y’ text, then it should be used accordingly if you wish to use any other header, changes on the dlt platform should be done accordingly