The implementation of sending Viber messages through the official channel thanks to the API protocol makes it possible to send a message with a length of 1,000 characters with an illustrated picture and a button to a website (portal)

Sending message to Viber

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/im/send/

Request params:

If number does not have Viber account you can use a possibility to send your message in this number as SMS with alternative Sender ID and message content. To do it you need:

1. sms_source – optional, a 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”
2. sms_message – optional, urlencoded message body. A long message will be split into multiple sms. The price of the message will be multiplied by parts count. Use together with sms_source.

Example request:

curl “http://api.sms.intel-tele.com/im/send/?username=foo&api_key=bar123&to=7123456789&im_sender=IntelTele.com&im_message=Test+123&im_image=https%3A%2F%2Fintel-tele.com%2Fimages%2Flogo.png&im_button_text=Click&im_button_link=https%3A%2F%2Fintel-tele.com&im_ttl=120”

Example response:

{“reply”: [{“status”: “OK”, “cost”: “0.200000”, “country”: “ru”, “mcc”: “250”, “number”: “7123456789”, “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:

errors per submitted number:

success response per sms:

Field values:

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:

Synchronous MT messages status

URL (for GET or POST):

http://api.sms.intel-tele.com/im/status/

Request parameters:

Example request:

curl “http://api.sms.intel-tele.com/im/status/?username=foo&api_key=bar&requests=3c32257b-e0b8-4be9-b0e6-e871116b4bdf&timezone=UTC&timeformat=datetime”

Example response:

{“3c32257b-e0b8-4be9-b0e6-e871116b4bdf”: {“date”: “17-02-2013 12:08:29”, “status”: “rejectd”, “time_zone”: “UTC”}}

Balance checking

URL (for GET or POST):

http://api.sms.intel-tele.com/balance/

Request parameters:

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:

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:

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:

success response:

{“user”: {“ru”: {“01”: [0.123456, 0], “”: [0.234567, 0]}}}