Call us
+38(056)767-31-98 +7(499)649-49-99
Developers – More about SMS-API
API description
SMPP 3.4
1С-Bitrix Bitrix24

HTTP API documentation for developer

Interaction with the API is carried out via the HTTP protocol, the parameters are passed using the GET or POST method.
This is one of the most convenient (elementary, available) integrations for sending messges Protocol functionality allows you to send SMS messages, receive delivery statuses, check message statuses by msg_id, check balance.

Sending message

To start sending messages via HTTP API, do the following:
  1. Refill your balance, if it’s empty;
  2. Generate a new API key. You can have as much as 5 of them and create/delete them at any time;
  3. State your IP (single, several, or range) that the requests will be coming from.
HTTP API URL:
http://api.sms.intel-tele.com/message/send/
Request params:
usernamerequired
api_keyrequired
froma sender addr that a alternative message appears to come from. Use together with sms_message. Can be one of the following: “fully numeric, up to 15 digits, not less than 3 digits”, “alpha-numeric, up to 11 latin symbols, not less than 3 symbols”
torequired, a destination address. Several destinations can be provided, separated by comma (“,”)
messagerequired, urlencoded message body. A long message will be split into multiple sms (max 4 parts). The price of the message will be multiplied by parts count
priorityoptional, can take values from 0 (lowest) to 3 (highest). default is 0
system_typeoptional, can be latin chars or number, up to 8 symbols, allows you to logically group your traffic in the reports
Example request:
curl “http://api.sms.intel-tele.com/message/send/?username=foo&api_key=bar&from=test&to=7123456789&message=Test+123”
Example response:
{“reply”: [{“status”: “OK”, “cost”: “0.123456”, “country”: “ru”, “mccmnc”: “250XX”, “number”: “7123456789”, “parts”: 1, “message_id”: “3c32257b-e0b8-4be9-b0e6-e871116b4bdf”}]}

The response of our system is JSON, and can be one of the following:

errors for the whole request:
ResponseDescription
{'reply':[{'status': 'error: wrong username/api_key'}]}the auth is wrong
{'reply':[{'status': 'error: bruteforcing detected'}]}too many unauthorized requests had been made, this IP will be blocked for 5 minutes
{'reply':[{'status': 'error: ip not allowed'}]}the request initiator’s IP is not listed in our system
{'reply':[{'status': "error: can't send message"}]}no “message” or “to” parameters, sending is not possible
{'reply': [{'status': 'error: message is too long'}]}message length exceeds the allowed number of parts (4)
{'reply':[{'status': "error: sender addr is banned"}]}sender name is blocked as spam. For clarifications, please contact tech support
{'reply':[{'status': 'error: wrong sender addr'}]}“from” parameter exceeds 15 digits or 11 alphanumeric characters
errors per submitted number:
ResponseDescription
{"reply": [{"number": "7123456789", "status": "error: number is blacklisted"}]}the subscriber had chosen to opt-out from receiving the messages. For clarifications, please contact tech support.
{"reply": [{'number': '7123456789', 'status': "error: repeat detected"}]}a message has been blocked from being repeatedly sent to the same number within 1 minute
{'reply':[{'number':'7123456789', 'status':"error: can't determine country"}]}the country of the given number can’t be determined
{'reply':[{'number':'7123456789', 'status':"error: no route to country"}]}your profile has no active route to this number’s country
{'reply':[{'number':'7123456789', 'status':"error: route can't handle the message"}]}some providers imply restrictions for sending messages with numeric sender addr
{'reply':[{'number':'7123456789', 'status':"error: low balance", 'parts':1, 'cost':'0.04'}]}not enough balance
success response per sms:
ResponseDescription
{"reply": [{"status": "OK", "cost": "0.186440", "country": "ru", "mccmnc": "250XX", "number": "7123456789", "parts": 1, "message_id": "3c32257b-e0b8-4be9-b0e6-e871116b4bdf"}]}the message has entered the outgoing queue, msgid is ‘f3e76f4e-d4e3-424b-b26b-c0ebc72892cd’, message consists of 1 part!
Field values:
statusSend status, “OK” means that the message was correctly processed and queued for sending to an external SMS provider
partsparts of sms
costSMS cost per number
numberthe number for which the status is transmitted. if there are several numbers, then everyone will have their own hash “{}” inside the “reply” list
message_idThe message id assigned by the system. will be transmitted in asynchronous calls of the status handler
countrytwo-letter country code, ISO 3166 code list
mccmncCountry Code, Mobile Country Code

Asynchronous MT messages status

Provide us with the URL and method (GET or POST) in order to receive the message statuses to your system asynchronously. Our request will have the following params:
msgidthe ID of the message that our system assigned earlier at submit, e.g. f3e76f4e-d4e3-424b-b26b-c0ebc72892cd
statuscan be one of the following:
  • delivrd – the message has been delivered to the handset.
  • unknown , rejectd , expired , undeliv , deleted – the message delivery failed.
dlr_timestampthe timestamp when the status has been received by or system. The timezone is UTC

Synchronous MT messages status

URL (for GET or POST):
http://api.sms.intel-tele.com/message/status/
Request parameters:
usernamerequired
api_keyrequired
requestsrequired, one or several msg_ids, separated by a comma.
timeformatoptional, urlencoded. Defines the format of the status timestamp. Please refer to the table of formatting characters at Python’s documentation. If not set, no timestamp will be passed in the response. For example, timeformat=’%d/%m/%Y %H:%M:%S’ will yield this date: 17/02/2013 19:08:29
timezoneoptional, urlencoded. Please refer to. the list of available timezones. If not set, the timezone from your profile will be used
Example request:
curl “http://api.sms.intel-tele.com/message/status/?username=foo&api_key=bar&requests=3c32257b-e0b8-4be9-b0e6-e871116b4bdf&timezone=UTC&timeformat=%25d-%25m-%25Y%20%25H:%25M:%25ST%25z”
Example response:
{“3c32257b-e0b8-4be9-b0e6-e871116b4bdf”: {“date”: “17-02-2013 12:08:29T+0000”, “status”: “rejectd”}}

Balance checking

URL (for GET or POST):
http://api.sms.intel-tele.com/balance/
Request parameters:
ParameterDescriptionRequired
usernameYes
api_keyYes
Request example:
curl “http://api.sms.intel-tele.com/balance/?username=foo&api_key=bar”
Response example:
{“balance”: “-0.42”}

Credit checking

URL (for GET or POST):
http://api.sms.intel-tele.com/credit/
Request parameters:
ParameterDescriptionRequired
usernameYes
api_keyYes
Request example:
curl “http://api.sms.intel-tele.com/credit/?username=foo&api_key=bar”
Response example:
{“credit”: “1.23”}
Rates
URL (for GET or POST):
http://api.sms.intel-tele.com/rates/
Request parameters:
ParameterDescriptionRequired
usernameYes
api_keyYes
Request example:
curl “http://api.sms.intel-tele.com/rates/?username=foo&api_key=bar”
The response of our system is JSON, and can be one of the following:
errors for the whole request:
FieldDescription
{'message': 'Invalid auth', 'error': true}the auth is wrong
{'status': 'bruteforcing detected', 'error': true}too many unauthorized requests had been made, this IP will be blocked for 5 minutes
{'status': 'ip not allowed', 'error': true}the request initiator’s IP is not listed in our system.
success response:
{“user”: {“ru”: {“01”: [0.123456, 0], “”: [0.234567, 0]}}}
FieldDescription
userusername
rucountry ISO-code
"01": [0.123456,0],MNC Network: 1st param: price per 1 sms 2nd param: 0: pay for all sms, 1: pay only for delivered sms * empty key – all networks
Talk to sales
Thank you, we will contact you soon.
Talk to sales
Thank you, we will contact you soon.
Let's get acquainted
Thank you, we will contact you soon.
Talk to sales
Thank you, we will contact you soon.