Viber API Documentation7.3.0

Docs / Tools / Deep Links

Deep Links

Public Accounts can create deep links and other links schemes to direct users to different parts of the account.

There are three types of deep link available.

Tapping this type of link will open a conversation with the Public Account and trigger a conversation started event. This link will only work for Public Accounts who have implemented a form of 1on1 chat - either CRM or bot.

The scheme for this link is:


Tapping this link will open the Public Account on the info screen. This link will work for all Public Accounts.

The scheme for this link is:


Tapping on this link will direct a user to the Public Account’s Public Chat screen. This link will only work for Public Accounts (and not bots), as the account must have a Public Chat.

The scheme for this link is:


Every published Public Account is assigned a landing page. This link is best used when sending links that will be opened on a computer. From there the user can decide whether to open the account on their phone by using the QR code on the page, or to download Viber for Desktop.

The scheme for this link is:<URI>

Additional parameters

The public account will be able to attach two additional parameters to the deep link:


The value of this parameter will be forwarded to the account 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 account 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.