Viber Business | Send & Receive Messages

• A tyntec API key from your tyntec account to authorize your requests

• A Viber Service ID, which works like a phone number for Viber Business

Send a message

To send Viber messages, you make HTTP requests to the tyntec’s Conversations API.

Authorize your API calls by adding the HTTP header apikey with your API key that you’ve got from your Business Center.

The REST API accepts data in the JSON format (Content-Type: application/json) and responds with JSON data as well (Accept: application/json). Setting these headers is optional, however, you need to set them if your HTTP client has other defaults.

The complete headers look like this:

To send a simple Viber text message, you should provide a recipient phone number (to), specify the channel and channel-specific data, such as your Service ID (from) and the text component of the message with content.

The rateType controls the charging by Viber and the available message types.

The simplest request with only required parameters looks as follows:

The initial response is synchronous and contains the ID of your message. This ID is valid for 48 hours if you want to retrieve the message and 90 days for status and history. If you received status 202, then you know your message was accepted for sending.

If you want to see the delivery status of your message, use the following HTTP GET request:

The response JSON contains status, deliveryChannel and timestamp. For example:

Using tyntec's API you can send more than simple text, it supports images and buttons. If you want to send an image, change the components to following:

The response is the same as with a text message and you can also check the delivery status the same way as mentioned above.

tyntec delivers messages from your customers via callbacks to your webhook URL.

Tip: You may use our webhook-starter written in Node.js and ngrok tunneling for development and testing.

To let tyntec know about your webhook URL, you need to update application information using a HTTP PATCH request to the default application endpoint like this:

If you’ve received a 204 status in a response, tyntec knows now that messages shall be delivered to that URL.

Tip: You can use our Postman collection (together with the Postman platform). Just unzip it, import the files, and use requests from the Application Management folder.

A callback request from tyntec looks like this:

If your message has issues with delivery, there are few things you can do before contacting our support team. It is usually a good idea to re-test, whether a problem occurs on more phone numbers. You can also retrieve your message to check if all parameters are correct. Go back to send a message for check or look at our API reference.

If this doesn't help, note the messageId. Our support team will appreciate it if you also add message history to your new ticket.

If you want to see details of your message, you can poll info through API using the following HTTP GET request:

The response is of the StoredMessage schema, which looks as follows:

To see the message status, you need to poll info through API with the following HTTP GET request:

The response displays the route of your message. You can see that it goes through 4 “nodes”. The following response shows a successful delivery.