Msg91 Help Doc
Virtual Number

Virtual Number

Virtual/ Longcode Number


1. Virtual Number:


A Virtual Number is a 10 Digit Mobile Number (sometimes also called a Longcode Number) to which your clients or members can send an SMS starting with a keyword. 

You will be able to receive the messages in your MSG91 inbox, on your email, and also on your callback URL. You will also be able to set an auto-reply SMS to all the numbers from which you have received responses. Now if you want to send the reply SMS after some calculation on the text received from your client, you will need to integrate the SMS API in your software which will shoot your SMS after the calculation.

For eg. in Kaun Banega Crorepati, you are supposed to send an SMS to 56565 with KBC<SPACE>A/B/C/D


2. Keyword:


If someone sends an SMS starting with your keyword, you will be able to receive the messages in your MSG91 inbox, on your email, or also on your callback URL. So KBC is the keyword. You can choose any keyword for yourself.

You can also set an automatic reply for the SMS you receive. 

A keyword of 6 or more than 6 characters would be free of cost. Other than that the pricing would be as follows:

5 Character: 1,000 Rupees

4 Character: 2,000 Rupees

3 Character: 3,000 Rupees

2 Character: 4,000 Rupees

1 Character : 5,000 Rupees


3. Inbox Balance: 


That is the number of SMS you can receive in your Inbox. You need to purchase the inbox balance so as to receive the SMS your customer is sending to you.

For a video tutorial refer to this link:

https://www.youtube.com/watch?v=kNOb4qApnzw

What is a Virtual Number or Longcode? What is Keyword and Inbox balance?
Invalid Date


Longcode is a Virtual Number hosted by the Telecom Operators and can be used to receive responses from the mobile subscribers (consumers / end-users).
Some common use cases includes, voting, gathering feedback, placing orders etc.

The message received from the subscriber is send to the required URL of the Company along with timestamp and other necessary details.

Every Country has their own rules for Longcode numbers where some Countries only allow incoming SMS only on Longcode number and some Countries allow 2-way communication from the same number. Additionally, the pricing also varies for each Country.

How to subscribe the Longcode number?

To activate Longcode number services:

  1. Go to Numbers on MSG91 Dashboard

  2. Click on Upgrade on left bottom corner

  3. Select plan and choose Longcode number based on your requirement

Kb1729072709135953Sc

Kb1729072865942697Sc

For the integration please click on the Edit button and the page will be open.

Kb1729074693996358Sc

If you want to add any callback url please click on the Add Callback button.

Kb1729074638429378Sc

Here you can add the Keywords, Webhook Url of your choice and click on save button

Kb1729073480746439Sc

If you want to receive the Incoming SMS on Hello you can enable this toggle please be informed that incoming is not available for the Indian longcode number.

Kb1729073687350624Sc

​To check the logs please go to the Logs section:

Kb1729073967074216Sc

For checking the reports please go to the Reports section:

Kb1729074165403555Sc


Note: 2-way communication is only available for international long code number.

Feel free to reach out to the MSG91 Support team at

[email protected]

or you can Call or WhatsApp at 8818888733 in case of any queries: 

How to activate a dedicated Long Code number in your account?
Mar 11, 2025
Prev