Перейти к содержанию

Токены

Раздел Токены относится не к чату напрямую, а к конкретному приложению.

Токен — это секретный ключ, который выпускается внутри приложения и затем используется внешней системой для обращения к API.

Где создаются токены

Токены создаются в карточке приложения:

  1. Откройте бота в личных сообщениях.
  2. Перейдите в /settings.
  3. Откройте Личные настройки.
  4. Перейдите в Мои приложения.
  5. Выберите нужное приложение.
  6. Нажмите кнопку выпуска токена.

Сам раздел управления токенами находится внутри приложения, а не внутри настроек конкретного чата.

Что есть у токена

У токена есть:

  • название
  • внутренний идентификатор
  • значение токена
  • набор прав

Права токена выбираются при создании.

Как создать токен

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

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

Как выбираются права токена

Токен не может получить права, которых нет у самого приложения.

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

Это позволяет:

  • держать разные токены с разным уровнем доступа
  • выпускать отдельные токены под разные сервисы
  • не выдавать каждому токену все доступные права

Как посмотреть токен

  1. Откройте приложение.
  2. Выберите нужный токен из списка.

В карточке токена можно посмотреть:

  • его название
  • его идентификатор
  • выданные ему права

Как удалить токен

  1. Откройте приложение.
  2. Выберите нужный токен.
  3. Нажмите кнопку удаления.

После удаления токен перестанет работать.

Когда лучше выпускать отдельные токены

Отдельные токены лучше создавать, если:

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

Обычная практика — один токен на одну интеграцию.

Важно

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

Связанные статьи: