FAQs About DLT

The registration process for the DLT platforms can be broadly classified into 5 steps –

  • Getting Entity
  • Registering Headers
  • Adding Telemarketer
  • Registering Content and Consent Templates
  • Uploading Consent Data (only for promotional and service explicit SMS).

There is an additional step required only for VILPOWER and BSNL DLT platforms. Know the detailed registration process here.

Please reach out to the DLT support teams for assistance.

  • Videocon DLT – please contact dlt.helpdesk@vmipl.in
  • Jio DLT – please contact jio.ISOMCCSupport@ril.com
  • Vodafone Idea Ltd DLT – please contact support@vilpower.in or +91-9619500900
  • BSNL DLT – please refer https://www.ucc-bsnl.co.in/spoc_support/

You can also check the status of your application and headers on Videocon here- Open https://smartping.live/entity/particular > Click on the option required and click Next > Enter Entity Reference ID and click Submit > Insert OTP received on Mobile and Click Submit > Pending  Status > Get Token and Verify.

Registering on DLT is mandatory for everyone that wants to send SMS (promotional, service or ) and only entities with DLT-approved headers (sender names) and templates will be able to send SMS. Please register on any of the DLT platforms to start sending SMS. Know more about the DLT registration process here.

To add Telemarketer:

  • In the Videocon DLT platform – Select ‘Telemarketer Request’ (side nav)> Enter the telemarketer ID “110200001293” > Click view details > Tick the check box “I hereby authorize IMI mobile Cloud Communications (India) Private Limited for on-boarding with us on VMIPL DLT Panel as our Telemarketer partner. ” > Click Submit request.
  • In the Jio DLT platform – Select Campaign > My Telemarketers > Manage Telemarketers > Search for telemarketer ID “110200001293” or “IMI Mobile” > Drag to the right side > Click Apply.
  • In the VILPOWER DLT & BSNL DLT platforms – Select Telemarketer from the dashboard > Click on Add > Type “IMI Mobile” or “IMI mobile Cloud Communications (India) Private Limited” In the “Select your Telemarketer” text box > Wait for the drop-down to appear > Select “IMI mobile Cloud Communications (India) Private Limited” from the drop-down > Add ”110200001293” in the Enter your Telemarketer ID textbox > Click Add.

Registering with one DLT operator is enough. We recommend registering on Videocon DLT as it is free to register on and has an easier registration process.

See how to find your Entity ID:

  • In Videocon DLT Platform: Click on Profile (side nav bar) > Registration ID. View sample image.
  • In Jio: In the top left corner, under entity name. View sample image.
  • In VILPOWER/BSNL DLT Platform: Click on the Profile Icon > Account Settings > Under Business Entity Name. View sample image.

There are 5 more steps that need to be completed before you can start sending SMS. Please see the details of these steps below:

  1. Add your Entity ID/Registration ID here.
  2. Register your headers in the DLT platforms. Please view the header registration process here.
  3. Add Telemarketer –
    • In the Videocon DLT platform – Select ‘Telemarketer Request’ (side nav)> Enter the telemarketer ID “110200001293” > Click view details > Tick the check box “I hereby authorize IMI mobile Cloud Communications (India) Private Limited for on-boarding with us on VMIPL DLT Panel as our Telemarketer partner. ” > Click Submit request.
    • In the Jio DLT platform – Select Campaign > My Telemarketers > Manage Telemarketers > Search for telemarketer ID “110200001293” or “IMI Mobile” > Drag to the right side > Click Apply.
    • In the VILPOWER DLT & BSNL DLT platforms – Select Telemarketer from the dashboard > Click on Add > Type “IMI Mobile” or “IMI mobile Cloud Communications (India) Private Limited” In the “Select your Telemarketer” text box > Wait for the drop-down to appear > Select “IMI mobile Cloud Communications (India) Private Limited” from the drop-down > Add ”110200001293” in the Enter your Telemarketer ID textbox > Click Add.
  4. Register your content templates in the DLT and Textlocal platforms. View the template registration process here.
  5. Only for Promo/Service Explicit SMS- Register your consent templates and add customer consent data in DLT platforms. View the consent template registration process here.

Please check if you have completed OTP and email verification. If yes, then contact DLT support using the details given below.

  • Videocon DLT – please contact dlt.helpdesk@vmipl.in
  • Jio DLT – please contact jio.ISOMCCSupport@ril.com
  • Vodafone Idea Ltd DLT – please contact support@vilpower.in or +91-9619500900
  • BSNL DLT – please refer https://www.ucc-bsnl.co.in/spoc_support/

While sending an email to the DLT support team, mention the details given below.

  • Registered business name:
  • Temporary id:
  • Registered PAN number:
  • Registered email id:
  • Customer concern:
  • Entity’s SPOC contact No:

Any further process can only be completed once you have received your Entity ID, and you will get your Entity ID/Registration ID post verification of your documents by the operator. See detailed DLT registration process here.

  • GST Document which includes the name of Authorizing Signatory
  • Ministry of Corporate Affairs Document
  • Board Resolution mentioning the name of Authorizing Signatory signing LOA on letter head
  • MOU/MOA

The following documents are accepted as proof of identity and proof of address on various DLT platforms.

For Individual –

  • Aadhar or Unique Identity number
  • Election commission id
  • Passport
  • Driving License
  • Income Tax PAN Number

For Sole Proprietor & Private Ltd.-

  • Shops & Establishment Registration Certificate
  • GST Reg Document (Please ensure org. name matched the document)
  • FSSAI License
  • Certificate of Incorporation

You can find a sample LoA here. Please make sure to change the content as needed for the respective DLT platform.

 

Once your headers are approved on any of the DLT platforms, please reach out to us at with a screenshot of your approved headers so that we can add them to your account. You will also need to start registering content and consent templates in the DLT and Textlocal platforms. Please view the rest of DLT registration process here.

If the header name is different from your registered entity name, please justify the same and add your mobile number in the description box. The mobile number will help the DLT support team to contact you in case of any queries.

For Videocon only – You can attach a document proving the relation between your entity name and your requested header.

Airvoice staff has no visibility on why and where the entity (PE) registrations are stuck. The respective DLT portals will directly communicate with you over email regarding approval status, any missing documentation etc. Please check your emails and provide additional docs as needed.

Post header approval, please email a screenshot of your DLT account displaying the approved headers to noc@airvoicetel.com.

Click “Template” (side nav bar) > Click “Active” in the Status column of the required template > Template ID

According to new guidelines shared by operators, all content templates must include your brand name/complete business name/trademark in the message footer. See how to add your brand name/entity name here.

Airvoice staff has no visibility on why and where the entity, header or template registrations are stuck. The respective DLT portals will directly communicate with you over email regarding approval status.

Post template approval, please add your DLT-approved templates and template IDs in your Airvoice . See how to add templates in Airvoice here.

Once your templates are approved on any of the DLT platforms, please add them with DLT template IDs in your Airvoice account. Please ensure you change the variables to a Airvoice-supported syntax. See how to add templates in Airvoice . After completing this step, you are all set to send service implicit and transactional SMS.

Register Consent Templates and Consent Data for Service Explicit/Promo SMS- Before you can start sending service explicit or promotional SMS, you need to register consent templates in the DLT platforms by following the process given here. Please read the operator comms (see emails from Jio, Videocon, VIL, BSNL here) for more details on consent templates.

The syntax of variables is different in DLT and Airvoice. So, you will need to change the variable to a Airvoice-supported syntax when adding templates in Airvoice. See how to change the variable parameter in Airvoice here.

Eg: An OTP template will look like “Your OTP is {#var#}” in DLT platforms and “Your OTP is %%|text^{“inputtype” : “text”, “maxlength” : “6”}%%” in Textlocal.

As part of TCCCPR 2018, TRAI introduced 2 new message categories. Please see the type of messages allowed in each category below:

  • Service Implicit – For SMS such as OTPs, order confirmations, important notifications regarding product and services such as purchase confirmation messages, order status, alerts, reminder SMS, etc.
  • Service Explicit – Promotional messages to existing customers after receiving their consent. If at any point of time, the customer withdraws and opt-out of receiving these texts, then the SMS will be considered Promotional.
  • Promotional – Any message with an intention to promote or sell a product, goods, or service.
  • Transactional – This is reserved for Banks only.

Please see a detailed comparison of Promotional, Service and Transactional SMS here.

 

DLT platforms allow 30 characters for each variable. We recommend registering your templates with multiple variables if you wish to use Textlocal shortlinks or more than 30 characters per variable in your message content.

You need to register consent templates and upload consent data only for promotional and service explicit messages.

A consent template is a standard message that you show your end users to get their consent to receive communications from your business.

Example:

  • ABC Solutions” needs Your Consent in Order to Serve You Better. We May Send You Messages About Your Account Information, Activity and Our Best Offers
  • We will send you updates, transactions, recommendations of our services or products being a registered customer with us [Brand Name]
  • Dear Customer, thanks for visiting The Design Studio in Andheri (W) today. We would love to stay in touch with you about our new launches and promotions. To continue receiving exciting offers from us on call/SMS, please submit your consent.

You can view the process to register consent templates in each of the DLT platforms here.

If the API/server error is: “The request was aborted: Could not create SSL/TLS secure channel” or “The underlying connection was closed”, it means that the server is currently using an outdated TLS version. We support Transport Layer Security (TLS) version 1.2 and above, so you will need to update your servers.

We’re also adding some points below that have helped users diagnose and resolve these errors.

  • Upgrade to the latest code libraries, if available.
  • Ensure to use the recent TLS/SSL versions as the older versions may depreciate with time.
  • Try DNS-Flush as this can help resolve security, internet connectivity, and other propagation-related issues.
  • Ensure to use the updated versions of the code/framework (Java, PHP, .net, etc).
  • Add the below ciphers in your server(s).

Ciphers List : 

  •  ECDHE-ECDSA-AES128-GCM-SHA256
  •  ECDHE-RSA-AES128-GCM-SHA256
  •  ECDHE-ECDSA-AES256-GCM-SHA384
  •  ECDHE-RSA-AES256-GCM-SHA384
  •  ECDHE-ECDSA-CHACHA20-POLY1305
  •  ECDHE-RSA-CHACHA20-POLY1305
  •  DHE-RSA-AES128-GCM-SHA256
  •  DHE-RSA-AES256-GCM-SHA384 

Delivery Receipts are no longer provided by operators for promotional sends. Delivery status for all promo SMS submitted to operators will be shown as ‘Pushed’ initially and changed to ‘Expired’ after 48 hours due to lack of Delivery Receipts.

When I try to send SMS using Airvoice API, I receive an
error message saying “Error code 3: Invalid login”. What am I doing
wrong?

Error code 3: Invalid login is thrown when one of
your login parameters is incorrect. The login parameters include
‘username’ and ‘hash’ or ‘apikey’. Here are a few quick checkpoints to
identify the problem:

  • Incorrect URL? Please make sure you call https://api.airvoicetel.in/ and not https://api.airvoicetel.com
  • Incorrect ‘username’? Please check if you correctly entered your registered email ID of Airvoice in the ‘username’ field.
  • Incorrect ‘hash’? Every account will have a unique
    hash key. Your hash key will be available in your messenger under Help
    -> All Documentation -> Your hash key. Please ensure you entered
    this hash key accurately in the ‘hash’ parameter. Note that your hash
    key changes whenever your password changes. At the time of password
    change, stop your API calls, update your hash key once the change is
    done and then, restart the API calls.
  • Incorrect ‘apikey’? You can generate your API keys
    from Settings -> All Settings -> API keys. API keys can be
    restricted to a set of IP address. The API key entered in ‘apikey’
    parameter should match one of the active API keys in your list and if
    that particular API key is restricted to a set of IPs, your
    machine/server/system IP should be in the IP set.
  • If the Airvoice API has been called multiple times with incorrect
    credentials, your account will be temporarily blocked to prevent any
    malicious exploitation. Please contact the support team to unblock your
    account.

         If the error still persists, please contact noc@airvoicetel.com

I converted my account to non-promotional and now, when I try to send an SMS using Airvoice API, I receive an error “Error code 80: Invalid Template”. How can I correct it?

You can only send messages that match a DLT-approved template. Please ensure that you also add your DLT-approved templates in Airvoice. Once our support team reviews and approves your template, you can start sending messages based on that template. Get detailed information on how to add templates and send messages via API.

We recommend testing your added DLT templates with a single send to your mobile number trying to use the template to send SMS via Airvoice API. To send SMS via UI: Log in to Airvoicetel > Click Send > Click Send Text Messages > Select the template you want to use from the dropdown > Select the Sender Name you added for this template in DLT > Add your phone number in the Paste List > Send Message.

If your error persists, please contact noc@airvoicetel.com

I want my messages to be delivered with my company name as the header. But, when I mention my company name as the ‘sender’ parameter in Airvoice API, the API response is “Error code 43: Invalid sender name”. What am I doing wrong?

To send SMS from your headers (sender names), you must register your sender name on DLT platforms -Promotional SMS can be delivered with a 6-digit numeric headers and Service SMS such as Service Implicit and Service Explicit can be delivered with a 6-character alpha header.

If you would like to send promotional or service SMS, please register your business, headers, and templates on DLT platforms. Once your headers are approved on DLT platforms, please share a screenshot of your DLT account displaying the approved headers with us at noc@airvoicetel.com. Our team will verify the headers and add them to your account. You can then use one of the added headers in your account to send SMS.

For Airvoice control panel users:

The option to choose and assign a Sender ID will be available on the Send screen once your account is converted to a promotional or non-promotional account.

For Airvoice API users:

This is an error response when incorrect value is passed on to ‘sender’ parameter. We recommend confirming the sender ID added for the template you are trying to use in Airvoice portal before sending an SMS via Airvoice API.

 

When I upload an excel file to a contact group in Messenger, I receive an error – ‘Nothing has been imported. Either there is no new data to import, or you have selected the wrong column headings.’ Where am I going wrong?

This error might be observed due to one of the following reasons:

  • Special characters or spaces in the mobile numbers column. Please clean the data and try uploading again.
  • If your excel file has additional merge fields (i.e. custom parameters along with mobile numbers), there might be a problem with the column headings. Ensure that the column with mobile numbers is correctly assigned the ‘number’ field.
  • If your excel file has column headings, please uncheck the header name from Airvoice Messenger before clicking on ‘import’ button.

If the error still persists, reach out to us at noc@airvoicetel.com