Changes in C2SMS Send API
You have to pass the DLT approved Template Id as an additional parameter, along with all other parameters as you are passing currently.
How to find its value?
Numeric Value (This DLT Template Id can be found from your DLT platform)
1 (This is used for DLT Testing purposes) When you pass this additional parameter, the SMS will be delivered via DLT scenario.
Sample Encoded API URLs:
If you are using Sendhttp API, pass DLT_TE_ID parameter in your API base URL
If you are using the V2 API, pass DLT_TE_ID parameter as below:
If you are using Old SendOTP API, pass DLT_TE_ID parameter as below:
Testing of SMS Content Template in DLT scenario:
1. Send an SMS bypassing DLT_TE_ID and dev_mode=1 on your mobile number
2. Now, check your phone for this SMS; if you have received this SMS, that means that this Template, Header, and Template Id combination will work in the right way once the DLT Template is LIVE.
3. If you have not received this SMS, login to the C2SMS panel, go to the logs section, and search for this particular number. You will be able to see the exact reason for failure when you bring the cursor on the red failure sign.
4. Based on the failure reason, correct your mistake and try again.
a) Do not pass dev_mode=1 on LIVE traffic, this is just for testing purposes.
b) Kindly start passing your DLT Template Id in your APIs today itself, so you don’t have to make any changes on the Go-LIVE date!
As per the rules of Telecom Regulatory Authority of India (TRAI), OPT-OUT SMS is sent to every DND number so that the user can unsubscribe receiving SMS from a particular sender ID.
Every country has its own strict rules and, according to the rules in India, we send this SMS on your behalf. This SMS differs on the basis of every country’s rules.
How the receiver can unsubscribe: If the user will go through the link provided, then s/he will be able to confirm her/his choice of opting out and if s/he wishes then s/he can also give a missed call to the number provided in the same message. Both methods will result in blocking the number for future messaging.
Why is OPT-OUT important: This SMS is an additional security to avoid the risk of complaints. If you are unable to provide proper registration details, you will be charged Rs. 25,000 for every complaint.
Note: This SMS will be sent every 3 months for a particular Sender ID.
The following are the listed differences between Transactional and Promotional routes:
|1. These can be used for|
sending any type of information.
Ex. Order updates, Bank Transactions etc.
|1. These are specifically used for|
Ex. Sale, Offers etc.
|2. Transactional SMS|
can be sent any time
|2. Promotional SMS are sent|
between 9 AM to 9 PM only
|3. SMS can be sent on DND numbers||3. SMS cannot be sent on DND numbers|
|4. In API route=4||4. In API route=1|
The route is for SendOTP. if you are looking for OTP services, we would suggest you opt for SendOTP because it has various advantages over the traditional transactional route:
A request ID is a unique 24 character alpha-numeric ID which lets us get the full report of the SMS submitted by the user.
You can find the request ID of any specific message in the Log section by moving your cursor on the log.
A typical request ID looks like, 558255015263edec108b459
Absent subscriber: Absent subscriber due to the phone being switched off, due to phone out of coverage, due to roaming restriction/restricted area.
Absent subscriber (HLR Access Denied: Postponed): Subscriber cannot be reached at the time of broadcast or unknown subscriber. The Home Location Register is a database. It provides routing information for MT (Mobile Terminated) calls and SMS (Short Message Service) Absent subscriber (No acknowledgment): Absent subscriber due to the phone being switched off, due to phone out of coverage, due to roaming restriction/restricted area without acknowledgment.
Absent subscriber (Destination resource shortage): The message is rejected because there was no paging response, the IMSI record is marked detached, or the MS is subject to roaming restrictions.
Absent subscriber (SMS delivery postponed): User’s mobile number not reachable or out of network coverage area.
Absent subscriber (Destination out of service): Mobile number barred at the carrier end.
Absent subscriber SM: Out of coverage area (or) switched off. The error might be due to the poor network coverage area and the same flag was updated in the HLR.
Note: Important Abbreviations:
|MT||Mobile Terminating||CUG||Closed User Group|
|MS||Mobile Subscriber||HLR||Home Location Register|
|SRI||Send Routing Information||VLR||Visitor Location Register|
|FSM||Forward Short Message||PDU||Protocol Data Unit|
|SGSN||Serving GPRS Support Node|
1. Login in to your C2sms account, select SendOTP on the left-hand sidebar.
2. Go to the Reports tab.
3. Here you get to see all the reports, you can also search using ‘Mobile number’. You can also check if a number has been verified or if a retry attempt has been made.
Different colors in status have different meanings :
Note: Messages which are pending for more than 15 minutes are logged, else the entry is made only when the message is finally updated as delivered or failed
There are two processes. You can choose either,
1. OTP verification at SendOTP server
Once you call the OTP API we generate OTP and save it in the secured database for defined seconds and then send the SMS to the user. If the user does not receive the SMS, they can ask for resending.
Once you call the same API with the same mobile number, we automatically generate voice call and read OTP.
2. OTP verification on your server
In this process, once you call the OTP API from your server, we give you OTP in response and you can save it on your server. You can use it for the verification process on your server only.
Both the processes are secure from our end, but process number 2 is dependent on your security protocols.
Sender ID is a set of characters that represent the identity of a sender. For example, when you receive a regular SMS from a friend, her/his name (as stored in your contacts) is displayed as a Sender. Similarly, when a business sends an SMS to its customers, a numeric or alphabetic set of characters represents the company or brand name.
Sender ID for Promotional SMS is numeric and is decided by the operator. For example 777777
Sender ID for Transactional SMS is 6 alphabetic characters in India. For example: NOTIFY, MSGIND. For other countries, sender ID format may vary according to the rules of a particular country.
Create a website for selling SMS
You can white-label your domain/sub-domain and customize your website as per the themes available.
How To Design
1. Go to the My website option available at the bottom section of the sidebar. (Refer screenshot)
2. Add the domain name of your choice in the field.
3. Select a theme of your choice from the available options.
4. You can also add a logo of your website if you wish to.
You can white-label your website by pointing CNAME to our domain. You can point CNAME on your domain/subdomain with our domain “map.txtapi.com” by following these steps:
1. Sign in to your domain’s account at your domain host. Who is my domain host?
2. Locate the page for updating your domain’s DNS records.
The page might be called something like DNS Management, Name Server Management, or Advanced Settings.
3. Locate the CNAME records for your domain. You may already have one or more records resembling:
Name / Time to Live Record Value / Answer /
Host / Alias (TTL) Type Destination
www 86400 CNAME yourdomain.com. or @
mail 86400 CNAME yourdomain.com. or @
4. Add a CNAME record with the correct values for your desired use case. Or modify an existing CNAME record if the one you want to change is already there. To find out exactly what values to enter, see CNAME record values.
5. Save your changes and wait until they take effect.
The client Search option lets the re-seller get the information about all his clients.
Following steps and screenshots will help you use Client Work:
1. Find and click the option of Client Search which is available in the options menu. (Refer screenshot)
2. Among the list of various filter options on the right side of your screen, select the ones appropriate for your need and then click on the search button.
3. The results will be displayed according to your entries.
If you wish to disable any client, kindly follow the steps written below:
Disable your client by clicking on the option of disable.
Excel Plugin empowers you to send SMS directly from the excel sheet. You do not need to upload your excel sheet on the panel. You are allowed to send SMS from the sheet itself without going online.
Just follow the below-mentioned steps:
1. From the panel, you need to download the Excel Plugin. You can find the download option on the ‘Send SMS’ page.
2. Look for all the requirements to be met, so as to use the Excel Plugin:
3. Install the downloaded file and you will be able to find an option of C2sms- SMS Plugin in your Excel. For login, use your company username and password.
4. Complete the entries to be filled in the sheet and click on Send SMS. Then the complete procedure is the same as the panel.
You need to close all the sheets opened at your end and then clear your cache memory.
1. Click Wrench icon (at the top right of the browser)..>Select the option Tools..>Click ‘Clear Browsing Data’..>Mark ‘Empty the cache’ option..>Click the button ‘Clear Browsing Data’
2. The keyboard shortcut is Shift+Ctrl+Delete.
Once you have done the same, please open a single sheet and then try to send the messages.
Magento is an E-commerce platform built on open source technology which provides online merchants with a flexible shopping cart system, as well as control over the look, content, and functionality of their online store. C2sms Magento SMS extension is an SMS plugin which can be utilized to send SMS to customers. Whether it is about placing orders or dispatching them, now the users will receive every detail on their mobile phone.
For Magento 1: https://meetanshi.com/magento-sms-notification.html
In order to make a refund request, you can directly write to our support team.
Your amount will be refunded within 7-10 working days.
The charges of any message depend on the number of credits consumed, the pricing per credit according to the country to which you are sending the message. You can see the price per credits on our pricing page.
Also, failed messages are charged but NDNC and Blacklisted numbers are not charged.
Credits are the number of SMS you currently have in your account. When you send an SMS, your credits get deducted accordingly. Credit Deduction refers to the number of credits deducted from your balance for sending the message.
When you send an SMS in English the credit limit is 150-160 characters whereas in the Unicode option i.e. when you send SMS in other languages, the limit is 55-70 characters.
In case, of transactional messaging, an OPT-OUT SMS is sent to the DND numbers for which an extra credit is deducted.
You will be able to see the credits consumed by your content on the top right corner of the Text box.
The value for a single credit in English is 160 characters. With the number of characters increasing, the second credit consists of 306 characters and moving on in this manner the value of credit deduction increases by adding 153 characters in the SMS every time. As the number of characters keeps on increasing the number of credits deducted will also increase according to that.
For Unicode the credit calculation as below:
You can see the number of credits as well as a deduction in the delivery report of your SMS.
Yes, you can export the reports of a particular keyword from the panel by following the steps written below:
1. Click on the option of Virtual Number.
3. Click on the option of Export them and the report will be sent to your e-mail ID.
You can send a personalized SMS to all the numbers who send an SMS to your Longcode number.
1. You need to put in a callback URL in our webhook on which we will push the data of the SMS received from the client.
2. You can fetch the data and store it from that URL and integrate an API to customize your SMS according to the SMS received.
To add a new keyword, follow the below-mentioned steps:
1. Go to the Virtual Number option.
4. Send it for approval and we’ll let you know if this keyword is available.
NOTE: The maximum character limit for a keyword is 20.
Shared Long-Code is the common number for a group of people. For C2sms the shared Long-Code is 9229224424. Using this number will be free of cost, you will be charged only for the incoming SMS. Incoming SMS is differentiated by keyword, and hence your keyword must be unique.
Dedicated Long -Code will be 10 digits mobile number of your choice. There will be a one-time set-up cost for the new mobile number. The keyword can be of your choice as the incoming SMS is differentiated by the mobile number in this case.
When someone sends an SMS on your keyword and you aren’t receiving it, there can be three main reasons behind this situation:
You can contact our support team for the same.
1. Virtual Number:
Virtual Number is a 10 Digit Mobile Number (sometimes also called as 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 C2sms 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 A/B/C/D
If someone sends an SMS starting with your keyword, you will be able to receive the messages in your C2sms 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.
SendOTP is an integrated platform of C2sms through which you can easily integrate 2-factor authentication/mobile verification service in your application to generate, send and verify one time passwords for ‘n’ number of users, never letting your end-user go.
SendOTP maintains the database for the sent OTPs and they can be easily filtered. It reduces a significant amount of coding on the application part making it lighter.
With SendOTP all a user needs to do is:
1. Verify the phone number
2. Enter the verification code
The user is verified in just two steps and all it takes is 120 seconds.
Here are the details to use SendOTP APIs:
1. Click on SendOTP at the left-hand sidebar.
2. You can check the details on Reports page and for API documentation click on the button below:
For other queries, contact Support at [email protected]
SendOTP is a ‘one-time password’ (generating, delivering and verifying) mechanism. Copy pasting a couple of codes allow you to integrate the 2-factor authentication facility. Once this is done, then we generate, deliver and verify one-time password of your clients.
SendOTP is a flagship product of C2sms.
SendOTP offers you high-quality premium services that let you save on:
P.S. SendOTP uses the integrated services of C2sms.
You can choose Group option to send SMS in bulk. The Send SMS on Group feature saves your time, just save your group once with the numbers of data and you can use it anytime to send the bulk SMS.
1. Select “Send SMS” on the panel.
2. Select/Enter the Sender ID through which you want to send the SMS.
4. Type in the content of the SMS you wish to send.
5. Select the name of the campaign (optional), and click on Send.
To send SMS to selected numbers you need to follow these steps:
1. Select any group from which you wish to choose numbers.
2. When you get the list of contacts, check the box beside them to send an SMS on them.
3. Click on the option of Send SMS on the right side of the screen.
4. All your selected numbers will be displayed and you can type and send your SMS on those.
Go through the following steps to add a group:
2. Type the group name you wish to choose and press ENTER.
3. You may add contacts individually by filling in the details or by directly importing a CSV file of your stored contacts.
Also, there is no limit on importing contacts. You may import any number of contacts in one go.
NOTE: The only restriction is that the file size should be limited to 32MB.
A comma-separated values (CSV) file stores tabular data (numbers and text) in plain text. In general terms, it is just an Excel file which is saved in different type. You can save your file as .csv by just changing its type in the following manner:
The CSV file format is supported by:
Follow these simple steps to add contacts to a group:
3. Now, enter the group name in the top field, select the category of all the columns and click on Finish Import.
There can be different reasons for the failure of an SMS such as exception time out, message inbox full or if the number is out of reach.
These are the basic reasons for the failure of an SMS:
EXP Abssubs – Subscriber is not available at that time
EXP Memexcd – Inbox memory is full or exceeded
EXP Smstmout – SMS timeout after all retry
EXP Nwfail – Network failed
ABSENT SUBSCRIBER- Unidentified subscriber, No response from the handset
NUMBER TEMPORARILY UNAVAILABLE- Number out of coverage area/ Switched off
CALL BARRED- The recipient cannot receive incoming messages
SYSTEM FAILURE- Network or Protocol failure other than the listed. The task cannot be performed because of a problem in another entity. The type of entity or network resource may be indicated by a network resource.
HLR/ MSC Timeout- If HLR (Home Location Register) does not get the response from the MSC (Mobile Switching Centre) then there will be a timeout
INBOX CAPACITY EXCEEDED- Short message rejected by MS because of no memory capacity to store the messages
SBSCRIBR BSY FOR MT SMS- Congestion encountered at the visited MSC or the SGSN
TLESERVCE NOT PROVSND- Recipient MS has no SMS subscription.
Services temporarily blocked- Terminated due to mobile subscriber operator (services blocked by the network operator)
UNKNWN SBCRIBR- No allocated IMSI or directory number for the mobile subscriber in the HLR
ILEGAL SBSCRIBR- The PLMN has rejected the short message because the MS failed authentication
EXPIRED MAXIMUM RETRIES EXCEEDED- All the retries from different operators have been made
SM DELIVERY FAILURE- It can be due to below-mentioned reasons,
1.Unknown Service Center Address
2.Service center congestion
3.Invalid short message entity address
Failed – No specific reason found for non-delivery (after certain attempts by multiple operators)
Rejected by Provider – The SMS were rejected by the provider due to the promotional content through transactional route
Error codes are displayed if there’s an issue in the message sent by you. Click on the respective code to find out the reason for failed SMS and also to know what that particular code means.
You can also find the reasons for all the error codes for API v1 below:
101 Missing mobile number
102 Missing message
104 Missing username
105 Missing password
201 Invalid username or password. 201 also appears in case the XML code
triggered is incorrect.
202 Invalid mobile number
203 Invalid sender ID
207 Invalid authentication key
208 IP is blacklisted
209 Default route not found
210 Route could not be determined. Please contact support
301 User does not have sufficient balance to send SMS
302 Expired user account
303 Banned user account
306 This route is currently unavailable
307 Schedule time is incorrect
308 Campaign name cannot be more than 32 characters
309 Selected group(s) does not belong to you
310 SMS is too long. System paused this request automatically
311 When the same SMS content is sent to the same number within 10 seconds. This
is a security feature used to avoid multiple deliveries.
The first SMS will be delivered and the second will be rejected. The balance
will also be deducted only once.
418 IP not whitelisted
506 Internal error, please contact your account manager
601 Internal error, please contact your account manager
602 Your current route is disabled, kindly select another route
603 This sender ID is blacklisted, please use a different sender ID
604 Please enter at least one correct number to send SMS
606 Scheduled date cannot be more than three weeks
607 Please enter campaign name
608 Scheduled SMS cannot be less than current end time
There can be different reasons behind your API not working properly. We provide error codes according to the reason of API failure.
On hitting the API, if you face any issue, you can debug the API in the following manner:
Check the response received on calling the API.
If a Request ID is generated on hitting the API, this means that your SMS is successfully submitted to C2sms. If your message gets failed due to any problem with API you can find the reason for the failure in the failed API section.
An error will be displayed instead of request ID* if your SMS is not submitted successfully. You can find the reason behind it in our list of error codes and remove the error accordingly.
You may contact our support for any related query.
While submitting any request to our server we first generate the request ID and then process it further so at the same instance we will not be able to provide the exact reports of the ID and can only provide the below-mentioned status,
If the API is successfully submitted at our server the response is Type: “SUCCESS” and String: “REQUEST ID”.
For checking the complete reports, you need to check the delivery reports or can use webhooks to get the delivery details in real-time for the same and during the case of Failed API, an email is sent to your registered ID mentioning the error code and its description.
Note: By default, you will get the response in string format but if you want to receive in other formats (JSON, XML) then set this parameter. for example: &response=json or &response=xml
There are various statuses in the Delivery Report, their meanings are as follows:
Submitted/Sent to carrier – Your message has been submitted to the Carrier’s SMSC (Short Message Service Center) and is waiting for the delivery status confirmation from the Carrier
Sent/Pending- Sent/Pending is shown when SMS is forwarded from our operator but they still need approval from the operator on your end. If mobile is out of network until 4 hours until then the reports will be displayed as Pending.
Delivered- When the messages are received by the user successfully, delivered is displayed.
Failed- A message can fail due to different reasons and stops it from getting delivered.
Expired – Your message validity period has expired. This happens when the destination mobile is either switched off or out of coverage area for a certain period of time. The SMSC failed to deliver even after its final attempt as per its retry scheme
Blocked number- If a number is blacklisted then the SMS will not be delivered to that number. You can see the blocked number in the section of a Blacklisted number of Phonebook.
Opt-out- This is shown when an opt-out SMS is sent
Undelivered – Your message was not delivered. This happens when the Carrier encounters an inactive or unidentified or untraceable destination mobile number mobile handset memory or inbox full.
Auto failed- If the messages are getting failed on the same number from a very long time then the system automatically fails it and adds it to the AutoFailed directory and we don’t charge for auto failed SMS.
Rejected – Your message was rejected at the SMSC of the Carrier. This happens when the destination network is not available or blocked to the Carrier
NDNC- The NDNC status only comes under the promotional route as the Promotional route doesn’t allow sending SMS to DND number, so all DND numbers show this status and credits are also not deducted for the same.
Please visit the API page using the ‘API’ option in the sidebar.
On this page at the top left corner, you will find a ‘KEY’ which you can use in your APIs
You can also generate multiple auth keys for your account and name them, this can be useful if you are using the same account for 2 or more applications/websites and you can disable/enable any of the auth keys if required.
Following are the rules and features related to Sender ID in different countries:
**The following details are required for Sender ID registration:
—> Sender ID
—> Company Name
—> Company URL
—> Type of Content
—> Sample Content
For any further information, contact us at [email protected]
What is bulk messaging? How does bulk SMS help your business?
Bulk SMS also referred as bulk messaging simply means sending out a large number of SMS for delivery to targeted mobile numbers. A good bulk SMS Service provider will make the process of sending out these many messages easy with the click of a button. Bulk SMS helps businesses and enterprises to send out important information to their customers. Bulk messaging is widely used for transactions, promotions and mobile marketing.
What’s the difference between transactional and promotional SMS?
Transactional SMS are those that the users have opted to receive and they are usually generated by machine/API whereas promotional SMSs are bulk messages not specific to optin users.
What are the benefits of bulk SMS for business?
Most businesses usually look for cheap bulk messaging, free bulk SMS or cheap SMS Service provider in India. What they don’t realize is bulk messaging by default is less expensive than any other medium of transactional or promotional communication. The following are the benefits of messaging that’s how business can use bulk SMS services–
How to choose the best bulk messaging partner?
A good messaging partner will care for your recipients as much as you do. The following can be the parameters to choose the best Bulk SMS Service provider–
Does C2SMS have dedicated OTP service and does it supports International SMS?
Yes, we do have OTP sms for International with voice otp backup.
Is DLT mandatory and can I able to send SMS with DLT registration ?
Yes, DLT registration is mandatory, and you can still able to send API sms with our default sender id for few days.