Назад к blog
documentation

Использование Laraue Boards внутри Telegram

Laraue Boards построен как Telegram Mini App — веб-приложение, работающее внутри клиента Telegram. Это значит, что им можно пользоваться, не выходя из Telegram, без отдельного аккаунта и без переключения между приложениями.

Открытие Mini App

Найдите @msgboard_bot в Telegram и нажмите Start. Mini App откроется в нижней панели внутри Telegram. На мобильном она занимает почти весь экран; на десктопе открывается в боковой панели.

Кнопка запуска Mini App рядом с чатом бота

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

Как работает вход в Mini App

Когда вы открываете Mini App внутри Telegram, вы уже авторизованы. Telegram автоматически и безопасно передаёт приложению вашу учётную запись — нет ни кнопки входа, ни виджета, ни редиректа. Вы сразу попадаете на экран выбора организации, тот же самый, что описан в разделе Вход через Telegram.

Экран выбора организации со списком Personal, командной организации и кнопкой Create organization

Это работает через механизм initData Telegram: подписанный пакет с данными пользователя, который сервер проверяет с помощью криптографического хеша. Подделать эти данные нельзя.

Что работает в Mini App, а что в браузере

И Mini App, и веб-версия в браузере имеют одинаковую функциональность. Различия такие:

Telegram Mini App Веб-браузер
Вход Автоматический, без шагов Виджет Telegram + подтверждение
Сохранение сообщений Пересылка боту из любого чата Так же
Размер экрана Mobile-first, нижняя панель Полноценный десктоп или мобильный

Поддержка безопасной зоны и выреза экрана

Mini App учитывает безопасную зону устройства — на iPhone с вырезом или Dynamic Island и на Android с отверстием под камеру интерфейс автоматически подстраивается, так что контент не прячется за аппаратными вырезами.

Отправка issues из чатов

Внутри Telegram, если вы читаете сообщение и хотите превратить его в issue, перешлите его боту @msgboard_bot, не выходя из текущего разговора, — смахните сообщение и используйте кнопку Forward. Issue сразу появится в вашем Бэклоге.

Использование Laraue Boards без Telegram

Веб-приложение на boards.laraue.com работает независимо от клиента Telegram. Вы входите один раз через виджет Telegram, а дальше пользуетесь им как любым другим веб-приложением. Это полезно, когда:

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

Связанные страницы