Welcome to the
BSG Developer Docs.
Whether you're looking to use our REST APIs, receive
notifications with webhooks, or build an app for the
Intercom Messenger, you've come to the right place.
Send a VIBER message
Creates a new message object. BSG returns the created message object with each request. Per request, a max of 50 phones can be entered.
REQUIRED PARAMETERS
The array of VIBER message objects.
The array of recipients msisdn's & reference's.
The telephone number.
The body of the VIBER message.
The sender of the message.
OPTIONAL PARAMETERS
The amount of seconds that the message is valid.
Tariff code of a price grid.
A client reference.
An hash with VIBER options.
DEFINITION
PUT (POST) https://app.bsg.hk/rest/viber/create
RETURNS
Returns a message object if the request was successful. If the request failed, an error object will be returned.
EXAMPLE REQUEST
{ “tariff”:”0″,
“validity”:”1″,
“messages”:[
{
“to”:[
{
“msisdn”:”380972920000″,
“reference”:”ext_id_19″
}
],
“text”:”My Viber messages is shinier than your SMS messages”,
“alpha_name”:”BSG”,
“is_promotional”:false,
“options”:{
“viber”:{
“img”:”http://mysite.com/logo.png”,
“caption”:”See Details”,
“action”:”http://mysite.com/”
}
}
}
]
}
EXAMPLE RESPONSE
{ “result”:[
{
“error”:0,
“errorDescription”:”No errors”,
“reference”:”ext_id_19″,
“id”:”217″,
“price”:0.23,
“currency”:”EUR”
}
],
“currency”:”EUR”,
“total_price”:0.23
}
IN ERROR CASE
{ “result”:[
{
“error”:43,
“errorDescription”:”External ID already exists”,
“reference”:”ext_id_19″
}
]
}