Skip to main content
Version: 1.5

ViberContext

Send API

sendMessage(message) - Official Docs

Sending a message to the user.

ParamTypeDescription
messageObjectMessage and options to be sent.

Example:

context.sendMessage({
type: 'text',
text: 'Hello',
});

Note: Maximum total JSON size of the request is 30kb.


sendText(text [, options]) - Official Docs

Sending a text message to the user.

ParamTypeDescription
textStringThe text of the message.
optionsObjectOther optional parameters.

Example:

context.sendText('Hello');

sendPicture(picture [, options]) - Official Docs

Sending a picture message to the user.

ParamTypeDescription
pictureObject
picture.textStringDescription of the photo. Can be an empty string if irrelevant. Max 120 characters.
picture.mediaStringURL of the image (JPEG). Max size 1 MB. Only JPEG format is supported. Other image formats as well as animated GIFs can be sent as URL messages or file messages.
picture.thumbnailStringURL of a reduced size image (JPEG). Max size 100 kb. Recommended: 400x400. Only JPEG format is supported.
optionsObjectOther optional parameters.

Example:

context.sendPicture({
text: 'Photo description',
media: 'http://www.images.com/img.jpg',
thumbnail: 'http://www.images.com/thumb.jpg',
});

sendVideo(video [, options]) - Official Docs

Sending a video message to the user.

ParamTypeDescription
videoObject
video.mediaStringURL of the video (MP4, H264). Max size 50 MB. Only MP4 and H264 are supported.
video.sizeNumberSize of the video in bytes.
video.durationNumberVideo duration in seconds; will be displayed to the receiver. Max 180 seconds.
video.thumbnailStringURL of a reduced size image (JPEG). Max size 100 kb. Recommended: 400x400. Only JPEG format is supported.
optionsObjectOther optional parameters.

Example:

context.sendVideo({
media: 'http://www.images.com/video.mp4',
size: 10000,
thumbnail: 'http://www.images.com/thumb.jpg',
duration: 10,
});

sendFile(file [, options]) - Official Docs

Sending a file message to the user.

ParamTypeDescription
fileObject
file.mediaStringURL of the file. Max size 50 MB. See forbidden file formats for unsupported file types.
file.sizeNumberSize of the file in bytes.
file.fileNameStringName of the file. File name should include extension. Max 256 characters (including file extension).
optionsObjectOther optional parameters.

Example:

context.sendFile({
media: 'http://www.images.com/file.doc',
size: 10000,
fileName: 'name_of_file.doc',
});

sendContact(contact [, options]) - Official Docs

Sending a contact message to the user.

ParamTypeDescription
contactObject
contact.nameStringName of the contact. Max 28 characters.
contact.phoneNumberStringPhone number of the contact. Max 18 characters.
optionsObjectOther optional parameters.

Example:

context.sendContact({
name: 'Itamar',
phoneNumber: '+972511123123',
});

sendLocation(location [, options]) - Official Docs

Sending a location message to the user.

ParamTypeDescription
locationObject
location.latStringLatitude (±90°) within valid ranges.
location.lonStringLongitude (±180°) within valid ranges.
optionsObjectOther optional parameters.

Example:

context.sendLocation({
lat: '37.7898',
lon: '-122.3942',
});

sendURL(url [, options]) - Official Docs

Sending an URL message to the user.

ParamTypeDescription
urlStringURL. Max 2,000 characters.
optionsObjectOther optional parameters.

Example:

context.sendURL('http://developers.viber.com');

sendSticker(stickerId [, options]) - Official Docs

Sending a sticker message to the user.

ParamTypeDescription
stickerIdNumberUnique Viber sticker ID. For examples visit the sticker IDs page.
optionsObjectOther optional parameters.

Example:

context.sendSticker(46105);

sendCarouselContent(richMedia [, options]) - Official Docs

Sending a carousel content message to the user.

ParamTypeDescription
richMedia.buttonsGroupColumnsNumberNumber of columns per carousel content block. Default 6 columns. Possible values: 1 - 6.
richMedia.buttonsGroupRowsNumberNumber of rows per carousel content block. Default 7 rows. Possible values: 1 - 7.
richMedia.buttonsObject[]Array of buttons. Max of 6 ButtonsGroupColumns ButtonsGroupRows.
optionsObjectOther optional parameters.

Example:

context.sendCarouselContent({
type: 'rich_media',
buttonsGroupColumns: 6,
buttonsGroupRows: 7,
bgColor: '#FFFFFF',
buttons: [
{
columns: 6,
rows: 3,
actionType: 'open-url',
actionBody: 'https://www.google.com',
image: 'http://html-test:8080/myweb/guy/assets/imageRMsmall2.png',
},
{
columns: 6,
rows: 2,
text: '<font color=#323232><b>Headphones with Microphone, On-ear Wired earphones</b></font><font color=#777777><br/>Sound Intone </font><font color=#6fc133>$17.99</font>',
actionType: 'open-url',
actionBody: 'https://www.google.com',
textSize: 'medium',
textVAlign: 'middle',
textHAlign: 'left',
},
{
columns: 6,
rows: 1,
actionType: 'reply',
actionBody: 'https://www.google.com',
text: '<font color=#ffffff>Buy</font>',
textSize: 'large',
textVAlign: 'middle',
textHAlign: 'middle',
image: 'https://s14.postimg.org/4mmt4rw1t/Button.png',
},
{
columns: 6,
rows: 1,
actionType: 'reply',
actionBody: 'https://www.google.com',
text: '<font color=#8367db>MORE DETAILS</font>',
textSize: 'small',
textVAlign: 'middle',
textHAlign: 'middle',
},
{
columns: 6,
rows: 3,
actionType: 'open-url',
actionBody: 'https://www.google.com',
image: 'https://s16.postimg.org/wi8jx20wl/image_RMsmall2.png',
},
{
columns: 6,
rows: 2,
text: "<font color=#323232><b>Hanes Men's Humor Graphic T-Shirt</b></font><font color=#777777><br/>Hanes</font><font color=#6fc133>$10.99</font>",
actionType: 'open-url',
actionBody: 'https://www.google.com',
textSize: 'medium',
textVAlign: 'middle',
textHAlign: 'left',
},
{
columns: 6,
rows: 1,
actionType: 'reply',
actionBody: 'https://www.google.com',
text: '<font color=#ffffff>Buy</font>',
textSize: 'large',
textVAlign: 'middle',
textHAlign: 'middle',
image: 'https://s14.postimg.org/4mmt4rw1t/Button.png',
},
{
columns: 6,
rows: 1,
actionType: 'reply',
actionBody: 'https://www.google.com',
text: '<font color=#8367db>MORE DETAILS</font>',
textSize: 'small',
textVAlign: 'middle',
textHAlign: 'middle',
},
],
});

Keyboards - Official Docs

The Viber API allows sending a custom keyboard using the send_message API, to supply the user with a set of predefined replies or actions. Keyboards can be attached to any message type and be sent and displayed together. To attach a keyboard to a message simply add the keyboard’s parameters to the options:

context.sendText('Hello', {
keyboard: {
defaultHeight: true,
bgColor: '#FFFFFF',
buttons: [
{
columns: 6,
rows: 1,
bgColor: '#2db9b9',
bgMediaType: 'gif',
bgMedia: 'http://www.url.by/test.gif',
bgLoop: true,
actionType: 'open-url',
actionBody: 'www.tut.by',
image: 'www.tut.by/img.jpg',
text: 'Key text',
textVAlign: 'middle',
textHAlign: 'center',
textOpacity: 60,
textSize: 'regular',
},
],
},
});

Which in turn will look like this:


Get User Details

getUserDetails() - Official Docs

It will fetch the details of the user.

Example:

context.getUserDetails().then((user) => {
console.log(user);
// {
// id: '01234567890A=',
// name: 'John McClane',
// avatar: 'http://avatar.example.com',
// country: 'UK',
// language: 'en',
// primaryDeviceOs: 'android 7.1',
// apiVersion: 1,
// viberVersion: '6.5.0',
// mcc: 1,
// mnc: 1,
// deviceType: 'iPhone9,4',
// };
});

-->


Get Online

getOnlineStatus() - Official Docs

It will fetch the online status of the user.

Example:

context.getOnlineStatus().then((status) => {
console.log(status);
// {
// id: '01234567891=',
// onlineStatus: 1,
// onlineStatusMessage: 'offline',
// lastOnline: 1457764197627,
// }
});