Skip to content

Linked Applications

The Linked Applications section is used to control which external applications are allowed to work with a specific chat.

Applications themselves are not created here. This section only manages their connection to the selected chat.

Linking an application to a chat is required to:

  • allow the application to work with this chat
  • choose which permissions the application will actually have in this chat
  • later review active links and remove them if needed

Even if the application already has the required permissions and you already have a token, API requests for this chat will not work until the application is linked to the chat.

Where the List of Linked Applications Is

  1. Open /settings for the required chat.
  2. Go to Customization.
  3. Open Linked Applications.

In this section you can see:

  • which applications are already linked to the chat
  • the card of each link
  • the permissions granted through that link
  • the ability to unlink the application

How to Start Linking

Linking is started with a command in the chat itself:

/settings applink <app_id>

Example:

/settings applink 6868a708-3f7e-4b72-9570-aa68a867202d

After that, the bot sends you a button in private messages to open the linking wizard.

Requirements for Linking

For linking to work:

  • an application with that ID must exist
  • you must have the settings permission in that chat
  • the bot must be able to message you in private

If you have not opened a private dialog with the bot, it will not be able to send the linking interface.

How the Linking Flow Works

After opening the wizard in private messages:

  1. the bot shows the application name and the chat title
  2. the bot shows the list of available permissions
  3. you can enable or disable the permissions you need
  4. after confirmation, the link is created

By default, the wizard selects all manageable permissions that already exist on the application.

How Permissions Work During Linking

The permissions on the link are not just a copy of the application permissions.

There is a double limit here:

  • the application defines the maximum set of permissions
  • the chat link defines the actual set of permissions for this specific chat

For example:

  • the application may have permission to read user information and permission to issue restrictions
  • when linking it to one chat, you can leave only reading
  • when linking it to another chat, you can leave both reading and restrictions

This is useful when the same application is used across several chats with different access levels.

The linked application card usually shows:

  • the application name
  • the application ID
  • the date when the link was created
  • the list of permissions granted for this chat

That is enough to quickly understand what is connected where.

  1. Open Linked Applications.
  2. Select the required application from the list.
  3. Click the unlink button.
  4. Confirm the action.

After that, the application will stop working with this chat.

The application itself is not deleted, and its tokens are not deleted either.

If the application:

  • should stop working only in one specific chat
  • is being moved to another chat
  • should temporarily lose access

then removing the link is usually enough.

Deleting the whole application only makes sense when it is no longer needed anywhere.