Send message

Send Viber Message

post

Send a Viber message. Supports Text, Image, Video, and File types, with optional buttons.

Message Types & Pricing

• Transactional: Only text messages without any buttons, images, or videos.

• Promotional: Any message containing buttons, images, videos, or files. These are charged at promotional rates.

Supported Combinations

• Text Only: A simple text message.

• Text + Button: A text message with a CTA button.

• Image Only: An image without any caption.

• Image + Text: An image with a text caption.

• Image + Button: An image with a CTA button.

• Image + Text + Button: A rich card with image, caption, and button.

• Video Only: A video without any caption.

• Video + Text: A video with a text caption.

• Video + Button: A video with a CTA button.

• Video + Text + Button: A rich card with video, caption, and button.

• File Only: A document file.

Callbacks

The API sends webhook events to the configured callback_url.

Payload Example

{
  "error": "000",
  "message_id": "8bd71f49-6f42-4729-bf5e-ecf857747633",
  "status": "DELIVERED",
  "to": "16197012345",
  "type": "DLR"
}

Field Details

• type:

  • DLR: Delivery Report (e.g., status is DELIVERED or SEEN).

  • MO: Incoming Message (status is RECEIVED).

• text: The content of the incoming message (only present when type is MO).

Note: Read receipts (SEEN status) are only sent if the user has enabled them in their Viber settings.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

or

or

or

Responses

200

200

application/json

or

400

400

application/json

401

401

application/json

429

429

application/json

500

500

application/json

post/v1.0/viber/send

HTTPcURLJavaScriptPython

POST /v1.0/viber/send HTTP/1.1
Host: messaging-api.bind.hr
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "destination": "447916123456",
  "text": "Hello world",
  "callback_url": "https://example.com/callback"
}

Text MessageText + ButtonImage MessageImage + TextImage + ButtonImage + Text + ButtonVideo MessageVideo + TextVideo + ButtonVideo + Text + ButtonFile Message

{
  "status": "ACCEPTED",
  "request_id": "a122dc95-ce76-40ab-b596-a4bca4d43936",
  "error_message": "OK"
}