• Channel Info
• Sending Text Message
• Send Image Message
• Send Document Message
• Send Video Message
• Send Interactive Message

Viber For Business API

Channel Info

PARAMETERS

Name	Description	type	Required
channels	This block contains information related messaging channel	N/A	Yes
name	Name of Messaging Channel. Ex: viber	string	Yes
from	Commercial Account Id	string	Yes
recipient	This block contains contacts information related to channel	N/A	Yes
meta	This block contains category information related to message type and additional information	N/A	Yes
category	transactional or promotional	string	Yes
ttl	If TTL value is set it should be min 30 to max 1,209,600 seconds	string	No
group_id	Segment id which contain list of phone numbers	string or array	Yes if to param is not present
to	Receiver mobile numbers	array	Yes, if group_id is not present
tags	opt-out the message based on the tags.	string	No

Note : The recipient block inside channel is related to particular communication channel and it is optional. The outside recipient channel contain common recipients for every channel.

{
  "channels": [
      {
          "name": "viber",
          "from": "700969ca-0cb2-11ec-a2cxxxx", //Account ID
          "meta": {
              "category": "category",
              "foreign_id": "your-custom-id",
              "ttl": 60,
              "tags": ["tag1", "tag2"]
          }
      }
  ],
	"recipient": {
        "group_id": "{segment_id}",
        "to": [
            "91XXXXXX",
            "91XXXXXX"
        ]
  }
}

Example Response

{
  "status": "OK",
  "message": "Message Queued successfully",
  "data": [
    {
      "id": "a418d672-9781-4d97-b517-a56f7d95ad8a",
      "channel": "viber",
      "from": "700969ca-0cb2-11ec-a2cxxxx",
      "to": "9190199xxxxx",
      "credits": 1,
      "created_at": "2021-06-18T14:48:06.886358Z",
      "status": "queued",
      "foreign_id": "your-message-id"
    }
  ]
}

HTTP Methods

It will support only POST requests.

API Endpoint

https://portal.mobtexting.com/api/v2/

Note: Few elements in the endpoint may change from service to service.

Message Category

Category	Supported Message Type
transactional	text and file
promotional	interactive, image and video

Validations

type	formats	limits
file	.doc, .docx, .rtf, .dot, .dotx, .odt ,odf, .fodt, .txt, .info, .pdf,.xps, .pdax, .eps, .xls, .xlsx, .ods, .fods, .csv, .xlsm, .xltx	Max 200 MB
image	.jpg, .jpeg, .png, .bmp, .gif, .svg, .webp. (recommended size 800x800)	No limit (gif - 24MB)
video	.3gp, .m4v, .mov, .mp4	200MB (duration max 600 seconds)

Sending Text Message

{endpoint}viber/message/send

PARAMETERS

Name	Description	Limits	Required
category	category of message (transactional)	NA	Yes
to	Destination mobile number with country code	NA	Yes
type	Message Type section (text)	N/A	Yes
payload	Message Payload section	N/A	Yes
text	Message Content you want to send	Max 1000 Characters	Yes

Example Request With Text Message

Send Image Message

API Endpoint

https://portal.mobtexting.com/api/v2/

Note: Few elements in the endpoint may change from service to service.

{endpoint}viber/message/send

PARAMETERS

Name	Description	Limits	Required
url	Public url of the image file. Either HTTP/HTTPS link.	N/A (gif-24MB)	Yes
type	image	YES	YES

Example Request With Image Message

Send Document Message

API Endpoint

https://portal.mobtexting.com/api/v2/

Note: Few elements in the endpoint may change from service to service.

We can send Document which is having valid MIME-type as attachment using below API. So anything not image or video will be transmitted as document message.

{endpoint}viber/message/send

PARAMETERS

Name	Description	Limits	Required
url	Public url of the document file. Either HTTP or HTTPS link.	Max File size 200MB	Yes
file_name	Media file name	Max 25 characters	Yes

Example Request With Document Message

Send Video Message

API Endpoint

https://portal.mobtexting.com/api/v2/

Note: Few elements in the endpoint may change from service to service.

We can send Video clips as attachment using below API. Video duration should not be over 600 seconds.

{endpoint}viber/message/send

PARAMETERS

Name	Description	Limits	Required
url	Public url of the video file. Either HTTP or HTTPS link.	Upto 200MB, duration 600 sec	Yes
type	video	YES	Yes
thumbnail	A static image that acts as the preview image for the video. Either HTTP or HTTPS link.	Max 1000 characters	Yes

Example Request With Video Message

Send Interactive Message

API Endpoint

https://portal.mobtexting.com/api/v2/

Note: Few elements in the endpoint may change from service to service.

{endpoint}viber/message/send

PARAMETERS

Name	Description	Limits	Required
choices	this block contains options of the message	N/A	Yes
choices.type	button	N/A	Yes
choices.payload.title	caption on the button	Max 30 chars	Yes
choices.payload.url	Either HTTP/HTTPS link	N/A	Yes

Example Request With Interactive Message