Send Viber message

Example of request to send Viber message to the specified number.

URI: /api/http.php

All requests to the gateway API are sent in JSON using the GET or POST method.

URI parameters

keystringrequired Your API key, which can be obtained in your personal cabinet

commandstringrequired Request type: send

fromstringrequired The name (phone number) of the sender Latin characters or numbers up to 11 characters, dot, dash, underscore

tostringrequired Recipient's phone number in international format format

messagestringrequired Message text in UTF8 encoding

viberstringrequired Fixed value - 1 or true

viber_typestringrequired Message type: text, image, button

viber_messagestringrequired UTF8 encoded message text for Viber Up to 1000 symbols

viber_fromstringrequired Sender's name for Viber

viber_lifetimestringrequired Viber message lifetime in seconds From 60 to 86400

viber_smsstringrequired Value = 1 if it is necessary to redirect the message via SMS in case of impossibility to deliver via Viber

viber_imagestringrequired Link to image Supported extensions: .jpg, .jpeg, .png, .gif

viber_urlstringrequired Resource link to go to by clicking on the image or button

viber_buttonstringrequired Button caption 1 to 19 characters

wapstring Link to the site. To send Wap-Push messages

flashstring Send a message as a Flash message

ask_datestring Date and time the message was sent in ISO-8601 format: 2024-08-15T15:52:01+0200

Request example

/api/http.php?version=http&key=APIKEY&command=send&from=test&to=380501234567
&message=test&viber=1&viber_type=text&viber_message=test&viber_from=test
&viber_lifetime=60&viber_sms=true

Response parameters

idstring SMS identifier generated by the gateway

smd_countstring Amount of messages sent

errorsstring Error message

Response examples

Successful

id:84523377 sms_count:1

Unknown command

errors:Unknown command