Привязанные приложения

Раздел Привязанные приложения нужен для управления тем, какие внешние приложения могут работать с конкретным чатом.

Здесь не создаются сами приложения. Здесь настраивается только их связь с выбранным чатом.

Что делает привязка

Привязка приложения к чату нужна, чтобы:

разрешить приложению работать с этим чатом
выбрать, какие именно права приложение получит в рамках этого чата
при необходимости позже посмотреть активные привязки и снять их

Даже если у приложения есть нужные права и у вас уже есть токен, без привязки к чату запросы к API для этого чата работать не будут.

Где находится список привязанных приложений

Откройте /settings для нужного чата.
Перейдите в Кастомизация.
Откройте Привязанные приложения.

В этом разделе видно:

какие приложения уже привязаны к чату
карточку каждой привязки
права, выданные этой привязке
возможность отвязать приложение

Как начать привязку

Привязка запускается командой в самом чате:

/settings applink <app_id>

Пример:

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

После этого бот отправит вам в личные сообщения кнопку открытия мастера привязки.

Что нужно для привязки

Чтобы привязка сработала:

приложение с таким ID должно существовать
вы должны иметь право settings в этом чате
бот должен иметь возможность написать вам в личные сообщения

Если личный диалог с ботом не открыт, бот не сможет отправить интерфейс привязки.

Как проходит привязка

После открытия мастера в личных сообщениях:

бот покажет название приложения и название чата
бот предложит список доступных прав
вы сможете включить или отключить нужные права
после подтверждения привязка будет создана

По умолчанию в мастере выбираются все управляемые права, которые уже есть у приложения.

Как работают права при привязке

Права в привязке — это не просто копия прав приложения.

Здесь действует двойное ограничение:

приложение задаёт максимальный набор прав
привязка к чату задаёт фактический набор прав именно для этого чата

Например:

у приложения может быть право чтения информации о пользователях и право выдачи ограничений
при привязке к одному чату вы можете оставить только чтение
а при привязке к другому чату оставить и чтение, и ограничения

Это удобно, если одно и то же приложение используется в нескольких чатах с разным уровнем доступа.

Что видно в карточке привязки

В карточке привязанного приложения обычно можно увидеть:

название приложения
ID приложения
дату создания привязки
список прав, выданных для этого чата

Этого достаточно, чтобы быстро понять, какое приложение к чему подключено.

Как отвязать приложение

Откройте Привязанные приложения.
Выберите нужное приложение из списка.
Нажмите кнопку отвязки.
Подтвердите действие.

После этого приложение перестанет работать с данным чатом.

Само приложение при этом не удаляется, его токены тоже не удаляются.

Когда лучше отвязать, а не удалять

Если приложение:

больше не должно работать только в одном конкретном чате
переезжает в другой чат
должно временно потерять доступ

обычно достаточно снять привязку.

Полное удаление приложения имеет смысл только тогда, когда оно больше не нужно вообще.