Интеграция с Telegram Mini Apps

В этом гайде вы узнаете, как подключить уже существующее мини-приложение в Telegram Mini Apps к Платформеру — и как, наоборот, использовать Платформер как основу для работы внутри Telegram.

Подключение Telegram-приложения к Платформеру

Если у вас уже есть мини-приложение в Telegram, и вы хотите использовать возможности Платформера (лаунчер, маршрутизацию, приватность, тестовые группы и т.д.), выполните следующие шаги.

Шаг 1. Получите ID Telegram-бота

Платформеру нужен идентификатор вашего бота, чтобы корректно верифицировать init data, полученное от клиента Telegram.

1. Откройте диалог с @BotFather и отправьте команду /mybots;
2. Выберите нужного бота из списка;
3. Нажмите кнопку API Token, чтобы получить токен (например: 12345678:ABCdefGHI);
4. Число до двоеточия (12345678) — это ID бота, который нужно использовать.

Шаг 2. Создайте мини-приложение в Платформере

1. Перейдите в админ-панель Платформера;
2. В разделе «Приложения» нажмите «Создать приложение»;
3. Укажите название и подтвердите создание.

Шаг 3. Настройте интеграцию и получите ссылку на лаунчер

1. В информации о приложении откройте вкладку «Telegram» → «Интеграция»;
2. Введите ID Telegram-бота и сохраните изменения;
3. Перейдите в раздел «Настройка лаунчера» и нажмите «Скопировать ссылку» — это ссылка на ваш лаунчер, которую мы используем в Telegram.

Шаг 4. Установите ссылку через BotFather

1. В BotFather отправьте команду /myapps;
2. Выберите нужное мини-приложение;
3. Установите в его настройках ссылку, полученную от Платформера.

Готово! Теперь Telegram будет запускать ваш лаунчер, а Платформер — открывать актуальную версию приложения на основе заданных настроек.

Интеграция Платформера в Telegram

Если вы сначала создали приложение в Платформере, а теперь хотите отобразить его в Telegram Mini Apps — следуйте этой инструкции:

1. В интерфейсе приложения в Платформере перейдите в раздел «Telegram → Настройка лаунчера»;
2. Скопируйте полученную ссылку на лаунчер;
3. Перейдите к @BotFather;
4. Если у вас ещё нет бота, создайте его с помощью команды /newbot;
5. Получите ID вашего бота (см. выше);
6. Вставьте этот ID в разделе «Интеграция» Платформера;
7. Вернитесь в BotFather и создайте мини-приложение с помощью /newapp;
8. В поле ссылки на приложение вставьте ссылку на лаунчер Платформера.

Теперь при открытии мини-приложения Telegram будет направлять пользователя в Платформер, который сам обработает все детали запуска.