Viber API Documentation7.3.0

Docs / Tools / Deep Links

Deep Links

Bot can have deep links to direct users to different parts of the bot.

Deeplinks require specifying the URI of your bot. It can be found in the your bot’s Admin Panel or in the response to the get-account-info API request.

There are three types of deep link available.

Tapping this type of link will open a conversation with the bot and trigger a conversation started event.

The scheme for this link is:


Tapping this link will open the bot on the info screen. This deeplink is supported on Android and iOS, and is not supported on Desktop.

The scheme for this link is:


Additional parameters

The bot is able to accept two additional parameters in the deep link:


The value of this parameter will be forwarded to the bot under the context parameter in the conversation started callback (see conversation started for additional details). The context will be transferred as a string and has no length limit (up to URL length limit).


The value of this parameter will appear in the text input field when the 1-on-1 chat with the bot is opened by pressing the deep link. The user will be able to send the text as it is, edit it, or delete it.

A deep link with context parameter will look as follows:

viber://pa?chatURI=<URI>&context=<Your Context>&text=<Your Text>

Note: Some browsers might have a problem identifying the deep link. To make sure the link works try sending it as a Viber message and pressing it from within Viber.