Text SMS

How to Send SMS via MSG91 panel

Follow the below steps to send SMS seamlessly—


i) Sender ID Approval (Some countries have specific rules and regulations for Sender ID) -

To send SMS globally - Follow sender ID rules for different countries
#Note - For Indian companies to send SMS in India - Follow DLT guide

ii) Template (To keep your communication secure, spam free, and easy to edit anytime)

Add a Template for transactional SMS in MSG91 - Follow its quick process

iii) Automate this SMS via RESTful APIs


​Integrate a single Campaign API for all channels - HelpDoc [Recommended]


OR

Integrate APIs separately for every channel -


For very specific use case which is not being solved by Campaign APIs - Use dedicated SMS API


#Note - If you are implementing OTP/Phone verification then use its dedicated service i.e. SendOTP - Follow its doc here

Step-by-step process to configure SMS 
Nov 19, 2024


You can follow the below-described steps to send SMS from MSG91 dashboard:


1. Login to MSG91 user panel.



2.     Click on “SMS” from the user panel.



3. Now click on the Send SMS (New) option.


4. You can send SMS by Segmento, uploading a CSV file, connecting a Google spreadsheet, or manually entering values.For sending SMS manually, please click on
 Enter manually.



5. Enter the mobile number. After entering the number, you have two options: "Use the SMS template" or "Enter message manually.". In the Use SMS template option, select the template and sender ID from the selection. If you have a URL in your SMS content, you can tick on the URL shortener option. 

NOTE: If sent without a country code, submission and deduction depend on the detected country based on the starting number: For, 91xxxxxxxxxx, etc

Screenshot 2025-02-20 214917.png

6. After adding the template and Sender ID, please go to the variable mapping option and enter the values for each variable in your SMS content.


7. After entering the values, click on Review & Send.



7. After clicking on Review & Send, a new window will pop up where you can enter a mobile number. The message will be sent, and you can check the delivery report after some time, or you can also check the logs.


8.  You will receive a success pop-up message, and you can check the logs for the delivery status.


How to send SMS from my MSG91 dashboard?
Feb 10, 2025

Custom SMS is a feature through which you can send messages to many people at one time by changing some fields such as the name of the receiver, mobile number, or other details. The content other than these fields will remain the same for all recipients.


You can follow the below-mentioned steps to send a custom SMS:


1. Create an Excel Sheet with the first row reserved for the heading of the respective column, and save the file in CSV format. (You can read about the CSV file on What is a CSV file?)


2. Select "Send SMS" on the panel, and click on the mobile number field to import the sheet created by using the Upload File option which appears on the right-hand side of the screen.



3. Enter the Sender ID through which you wish to send the SMS


4. Select the column in which the mobile numbers are present.



5. Type in the content of the SMS you wish to send. Select the variable field where you want the variable field to be inserted.



6. Set the name of the campaign, and Click on Preview and Send.


7. Once you are sure by checking the preview you can send the SMS by pressing the Start SMS process button.

NOTE: If sent without a country code, submission and deduction depend on the detected country based on the starting number: For, 91xxxxxxxxxx, etc

How can I send personalized/custom SMS?
Jan 21, 2025
  • Reasons for getting an error "Country code blocked":


1. You might be using an old authentication key for sending messages and its security settings(IP security) are turned off. [it is only applicable to countries except India (International)]


2. The specific country code prefix could be blocked in your settings.


3. You might have limit the specific pricing for the country.



  • Preventions that need to take to avoid getting the error:


1. Authkey: If you're using the old authentication key, you need to create a new authentication key (Auth Key) as a security measure. This practice enhances the security of your account in case the previous Auth Key gets compromised. - HelpDoc

 OR


If you are unable to change the auth key for some specific reason (not recommended) so start using the IP security then the current auth key will work for you. - HelpDoc


2. Country Blocked: Go to the Dashboard>> Company Name>> Settings>> Limit Communication and from here you can see the blocked countries and you can unblock it.


3. Pricing Limitation: If you have enabled blocking by price in your settings then any communication above that price limit will be blocked. To disable the blocking by price, simply remove the limit or just increase the limit, allowing all communications, regardless of price.




Note:  If you are still facing the issue you can contact us via chat or you can email us at [email protected] 



Error: Country Code Blocked
Nov 11, 2024


Send SMS is a feature using which you can send messages to many people at one time by using an excel file or manually entering them in the mobile number field available.


You can follow the below-mentioned steps to send an SMS using an excel file:


1. Create an Excel Sheet with the first row reserved for the heading of the respective column, and save the file in CSV format. (You can read about the CSV file on https://msg91.com/help/what-is-a-csv-file)


2. Login to the MSG91 panel and select SMS.



3. Select the Send SMS option from the sidebar and enter the Sender ID through which you want to send the SMS. 



4. Click on the mobile number field and upload the sheet created by using the browse file option which appears on the right-hand side of the screen. You can also type in the numbers here if required.



5. Enter DLT Template ID and type in the content of the SMS you wish to send.



6. Select the name of the campaign, and click on Send.



For a video tutorial, refer to the link: https://www.youtube.com/watch?v=mAOFd28ggBg&feature=youtu.be

NOTE: If sent without a country code, submission and deduction depend on the detected country based on the starting number: For, 91xxxxxxxxxx, etc

How to send SMS using an Excel file from the Send SMS option?
Jan 21, 2025


To send SMS worldwide you must make sure to:


1. comply with the respective Sender ID rules of the country you are sending SMS to as there are different Sender ID registration processes for different countries. Refer to this article to check these rules.


2. always add the correct country code to the mobile numbers while sending the SMS (e.g. 919999999999)

If sent without a country code, submission and deduction depend on the detected country based on the starting number.


Note- You don't need to add a '+' or '-' sign or include any space before the number.

How to send SMS worldwide?
Jan 21, 2025


If you are sending an SMS from your account and your account status is 'demo,' you will receive the content as:

"You have received this SMS as per your testing. To start sending actual content, kindly contact [email protected]. -- Team MSG91"


To activate your account, KYC verification is required. There are two options to do the KYC you can either do the E-KYC or You can upload the documents.


Once you log in to your MSG91 account, a pop-up will appear prompting you to update your KYC details. 


Note : If you do not see the pop-up, you can click on 'Complete Your KYC,' and the pop-up will appear.


1. If you want to do the E-KYC please click on the e-KYC option and complete the KYC process using the authorized person's Aadhaar card (e-KYC is only for India). Enter the Aadhaar Card number and click 'Next.' An OTP will be sent to the mobile number registered with your Aadhaar Card.


Once you have verified the OTP, you can click on allow and the KYC will be completed for your account.


                                                                              OR


2. You can also select the 'Verify' option to complete the process by uploading scanned copies of the required documents. 

There are two categories: 

  • DRIVING LICENSE/PASSPORT (of the authorized person)  

  • TRADE LICENSE/BUSINESS REGISTRATION. (Upload a clear copy of an original document of your organization.)


Please ensure you upload these documents accordingly and click on submit.


After uploading the documents, please wait at least one hour as our system processes them. It may take some time to complete the verification.


In case you encounter any issues while completing the KYC process, feel free to reach out to us at [email protected] for assistance.


My account status is in the demo, what can I do to make my account live?
Nov 11, 2024

Introduction: MSG91 is a leading communication platform that provides a wide range of services to businesses of all sizes. Its services include SMS, voice communication, email marketing, two-factor authentication, and more. We can configure MSG91 as a Custom Connector on the MoEngage Dashboard.


This guide will help you set MSG91 as a Custom Connector on the MoEngage dashboard.


                                                                          Integration 


Prerequisites - Ensure you have access to the MSG91 Dashboard and have an Authkey for your MSG91 account.

If not,


1. Create a New Account: For signup click on this link.

2. Get Your Authkey: Refer to this helpdoc on how to create an Auth key.


  • To set up MSG91 as a Custom Connector on the MoEngage dashboard, please follow these steps:


1. Log in to the MoEngage dashboard.

2. Navigate to Settings -> Channel -> SMS & Connectors and click on the SMS Connector Config tab.

3Click +CREATE beside the Custom Connectors option on the left menu to add a new connector.


Once you click Create, a new connector named ‘New Connector’ gets added to the left menu. Select this newly added connector to set up your custom connector.




Step 1: Set the Connector

Field
Description
Connector Name
Write the name to identify the connector - e.g. MSG91
Sender Name
Write the name to identify the sender


Step 2: Configure the API URL

- This field contains information about the URL that should be used to send an API request to the Sender. In the API URL field paste the below 


API URL- 

https://api.msg91.com/api/sendhttp.php?authkey=value&sender=value&mobiles=value&route=value&message=value&DLT_TE_ID=value&response=json&pluginsource=70


- Select: GET as a Method

- Here is the description of the above API URL Parameters:



Authkey



Enter your MSG91 Authkey


Sender
Enter your DLT-approved Header / Sender ID
Mobiles


Enter the value as “Moesms_destination” (This is the recipient or destination number on which the message will be delivered)

Route


4 (For Transactional Messages)


1 (For Promotional Messages)


Message

Enter the value “Moesms_message” (The message content will be passed in this field)

DLT_TE_ID


Enter the value of the DLT Template ID as “Moesms_dltTemplateId”

(This is only mandatory for users sending messages to Indian Numbers)

Response

Json (For getting a response in JSON format)

Pluginsource

70 (Fixed Value for Analytics)


Step 3: Test and Save the settings


Click Send Test SMS to verify whether the configuration is correct. After a successful test, Click Save to save the settings.


Step 4: Delivery Tracking


Delivery tracking allows you to track the delivery status of the SMS messages sent using custom connectors. Delivery tracking will show a metric - Delivered, which helps you understand whether messages have been delivered to the user and analyze delivery failures and errors.


You can configure delivery tracking after creating the sender in the MoEngage Dashboard. For information about Delivery Tracking, refer to Delivery Tracking in Custom Connectors.


Here is the sample response:

Mapping Guide: You can either map the fields from the delivery response or map the fields manually by choosing the desired option. This mapping helps MoEngage to understand the custom connector's delivery response.


Refer to the below image for reference:



Then, Click Save to Save the delivery tracking configuration for the custom connector.

How to use MSG91 SMS Connector for MoEngage:
Nov 8, 2024


Unicode is an encoding standard in which you can send SMS in different non-English scripts and target a wider audience. It uses UTF 8 encoding of international standards and provides a unique number to each character. A 

Unicode is a 4 Byte character that covers all the non-English languages in the world.
It is compatible with all the browsers, devices, search engines, operating systems, and other parts of the internet ensuring a seamless multi-platform system to convey text messages in different international languages.


A typical SMS credit consists of 70 Unicode characters unlike that of GSM-7 (English text characters) whose 160 characters make an SMS credit.  


Below are some of the characters which are treated as Unicode, along with this emojis or emoticons are also considered Unicode.


¿

À

Á

Â

Ã

Ä

Å

Æ

Ç

È

É

Ê

Ë

Ì

Í

Î

Ï

Ð

Ñ

Ò

Ó

Ô

Õ

Ö

×

Ø

Ù

Ú

Û

Ü

Ý

Þ

ß

à

á

â

ã

ä

å

æ

ç

è

é

ê

ë

ì

í

î

ï

ð

ñ

ò

ó

ô

õ

ö

÷

ø

ù

ú

û

ü

ý

þ

ÿ

Ā

ā

Ă

ă

Ą

ą

Ć

ć

Ĉ

ĉ

Ċ

ċ

Č

č

Ď

ď

Đ

đ

Ē

ē

Ĕ

ĕ

Ė

ė

Ę

ę

Ě

ě

Ĝ

ĝ

Ğ

ğ

Ġ

ġ

Ģ

ģ

Ĥ

ĥ

Ħ

ħ

Ĩ

ĩ

Ī

ī

Ĭ

ĭ

Į

į

İ

ı

IJ

ij

Ĵ

ĵ

Ķ

ķ

ĸ

Ĺ

ĺ

Ļ

ļ

Ľ

ľ

Ŀ

ŀ

Ł

ł

Ń

ń

Ņ

ņ

Ň

ň

ʼn

Ŋ

ŋ

Ō

ō

Ŏ

ŏ

Ő

ő

Œ

œ

Ŕ

ŕ

Ŗ

ŗ

Ř

ř

Ś

ś

Ŝ

ŝ

Ş

ş

Š

š

Ţ

ţ

Ť

ť

Ŧ

ŧ

Ũ

ũ

Ū

ū

Ŭ

ŭ

Ů

ů

Ű

ű

Ų

ų

Ŵ

ŵ

Ŷ

ŷ

Ÿ

Ź

ź

Ż

ż

Ž

ž

ſ

ƀ

Ɓ

Ƃ

ƃ

Ƅ

ƅ

Ɔ

Ƈ

ƈ

Ɖ

Ɗ

Ƌ

ƌ

ƍ

Ǝ

Ə

Ɛ

Ƒ

ƒ

Ɠ

Ɣ

ƕ

Ɩ

Ɨ

Ƙ

ƙ

ƚ

ƛ

Ɯ

Ɲ

ƞ

Ɵ

Ơ

ơ

Ƣ

ƣ

Ƥ

ƥ

Ʀ

Ƨ

ƨ

Ʃ

ƪ

ƫ

Ƭ

ƭ

Ʈ

Ư

ư

Ʊ

Ʋ

Ƴ

ƴ

Ƶ

ƶ

Ʒ

Ƹ

ƹ

ƺ

ƻ

Ƽ

ƽ

ƾ

ƿ

ǀ

ǁ

ǂ

ǃ

DŽ

Dž

dž

LJ

Lj

lj

NJ

Nj

nj

Ǎ

ǎ

Ǐ

ǐ

Ǒ

ǒ

Ǔ

ǔ

Ǖ

ǖ

Ǘ

ǘ

Ǚ

ǚ

Ǜ

ǜ

ǝ

Ǟ

ǟ

Ǡ

ǡ

Ǣ

ǣ

Ǥ

ǥ

Ǧ

ǧ

Ǩ

ǩ

Ǫ

ǫ

Ǭ

ǭ

Ǯ

ǯ

ǰ

DZ

Dz

dz

Ǵ

ǵ

Ƕ

Ƿ

Ǹ

ǹ

Ǻ

ǻ

Ǽ

ǽ

Ǿ

ǿ

Ȁ

ȁ

Ȃ

ȃ

Ȅ

ȅ

Ȇ

ȇ

Ȉ

ȉ

Ȋ

ȋ

Ȍ

ȍ

Ȏ

ȏ

Ȑ

ȑ

Ȓ

ȓ

Ȕ

ȕ

Ȗ

ȗ

Ș

ș

Ț

ț

Ȝ

ȝ

Ȟ

ȟ

Ƞ

ȡ

Ȣ

ȣ

Ȥ

ȥ

Ȧ

ȧ

Ȩ

ȩ

Ȫ

ȫ

Ȭ

ȭ

Ȯ

ȯ

Ȱ

ȱ

Ȳ

ȳ

ȴ

ȵ

ȶ

ȷ

ȸ

ȹ

Ⱥ

Ȼ

ȼ

Ƚ

Ⱦ

ȿ

ɀ

Ɂ

ɂ

Ƀ

Ʉ

Ʌ

Ɇ

ɇ

Ɉ

ɉ

Ɋ

ɋ

Ɍ

ɍ

Ɏ

ɏ

ɐ

ɓ

ɔ

ɕ

ɖ

ɗ

ɘ

ə

ɚ

ɛ

ɜ

ɝ

ɞ

ɟ

ɠ

ɣ

ɤ

ɥ

ɦ

ɧ

ɨ

ɩ

ɪ

ɫ

ɬ

ɭ

ɮ

ɯ

ɰ

ɱ

ɲ

ɳ

ɴ

ɵ

ɶ

ɷ

ɸ

ɹ

ɺ

ɻ

ɼ

ɽ

ɾ

ɿ

ʀ

ʁ

ʂ

ʃ

ʄ

ʅ

ʆ

ʇ

ʈ

ʉ

ʊ

ʋ

ʌ

ʍ

ʎ

ʏ

ʐ

ʑ

ʒ

ʓ

ʔ

ʕ

ʖ

ʗ

ʘ

ʙ

ʚ

ʛ

ʜ

ʝ

ʞ

ʟ

ʠ

ʡ

ʢ

ʣ

ʤ

ʥ

ʦ

ʧ

ʨ

ʩ

ʪ

ʫ

ʬ

ʭ

ʮ

ʯ

Φ

Χ

Ψ

Ω

Ϊ

Ϋ

ά

έ

ή

ί

ΰ

α

β

γ

δ

ε

ζ

η

θ

ι

κ

λ

μ

ν

ξ

ο

π

ρ

ς

σ

τ

υ

φ

χ

ψ

ω

ϊ

ϋ

ό

ύ

ώ

Ϗ

ϐ

ϑ

ϒ

ϓ

ϔ

ϕ

ϖ

ϗ

Ϙ

ϙ

Ϛ

ϛ

Ϝ

ϝ

Ϟ

ϟ

Ϡ

ϡ

Ϣ

ϣ

Ϥ

ϥ

Ϧ

ϧ

Ϩ

ϩ

Ϫ

ϫ

Ϭ

ϭ

Ϯ

ϯ

ϰ

ϱ

ϴ

ϵ

϶

Ϸ

ϻ

ϼ

Ͻ

Ͼ

Ͽ

Ѐ

Ё

Ђ

Ѓ

Є

Ѕ

І

Ї

ϸ

˥

˦

˧

˨

˩

Š

Œ

Ž

®

©

§

¥

¢

£

¤

¬

±

µ

¼

½

¾

º

±  

Note: All junk and hidden characters act as Unicode.

What is Unicode and which characters come under Unicode?
Jan 21, 2025


Surely you can. To send messages in languages other than English, you can use the "Unicode" option for this.


Unicode is not just the language, you can also send emojis. The use of emojis in your messages can take them to the next level. it is an energizing 🏂 and underused augmentation 🏠 of the standard instant message with regards to special SMS.

Check this link here for more info on emojis:
https://emojipedia.org/ (You can copy emojis from this link to add them to your messages)


Now if you are sending this SMS/campaign from the dashboard, you can simply select Unicode by clicking on the "English" button at the corner of the message box.



To send this using our APIs, all you need to do is pass an extra parameter "Unicode" in the API, the value for the same will be 1.
unicode=1 (for unicode SMS).

How to add emojis or send messages in other languages (except English)?
Nov 11, 2024


Scheduled SMS


You can follow these steps to schedule the SMS:

  1. Compose your message by the regular method by clicking on SMS<Send SMS or Send Custom SMS.

  2. After composing your message click on the Schedule SMS button.


  3. Select the Date, Hour & Minute according to which you wish to schedule your SMS.



  4. Click on Schedule- The balance required to deliver these SMS will be deducted at the same time.

  5. Your message will be delivered on the scheduled date and time.

Delivery Report of Scheduled SMS


You can find the delivery reports of your scheduled SMS under check SMS section > Logs & checkmark the option "show schedule SMS". If you cancel the Scheduled SMS the credits will be refunded to your account instantly. You can also send that message before the scheduled time by clicking on the Send Now button.



For sending it via API please pass the parameter as “schtime”: “YYYY-MM-DD HH:MM:SS“ schtimeschtime


NOTE: If sent without a country code, submission and deduction depend on the detected country based on the starting number: For, 91xxxxxxxxxx, etc

How can I schedule an SMS? Where can I see its delivery report?
Jan 21, 2025