Настройка Telegram

Введение

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

На текущий момент существует 2 способа создать бота в Telegram. С помощью текстовых команд в чате через @BotFather, либо использовать официальный Mini App, который прикреплён к BotFather. Использование Mini App намного удобнее. В этой статье будет описан второй способ.

Минимально необходимые действия, чтобы получить работающий Telegram-магазин:

Создание бота
Создание Mini App внутри Telegram Bot
Выполнить настройку модуля TeleCart через админку OpenCart.

Ниже я максимально подробно и со скриншотами распишу каждый из этих пунктов.

Создание бота

В Telegram для этого используется специальный сервисный аккаунт — @BotFather. Найдите его через поиск в Telegram, откройте и нажмите Start.

Для того чтобы открыть BotFather как Mini App, нужно нажать на кнопку Open, слева от поля ввода сообщения.

Откроется Min iApp приложение.

BotFather Telegram MiniApp — BotFather Telegram Mini App

Нажмите на кнопку "Create a New Bot" чтобы создать нового бота. Здесь нужно задать Bot Name и Bot username. Остальные поля по желанию.

Изображение для бота (аватар) — будет видно в списке чатов и на рабочем столе мобильного устройства, если пользователь добавит приложение туда. Рекомендуется использовать логотип своего магазина.

Внимание

Ни в коем случае не используйте логотип Telegram на изображении бота. Бот будет удалён, а Ваш аккаунт можеть быть подвержен блокировке. Об этом они явно пишут в условиях: You must not use the official Telegram logo for your app
Bot Name. Это отображаемое имя и может быть произвольной длины, обычно до ~64 символов (ограничения UI, точной цифры Telegram официально не указывает).
About (About info) — не обязательное. Максимум 120 символов. Пользователи видят его в профиле бота.
Bot Username - уникальный username, используемый для ссылок. Длина от 5 до 32 символов, латиница, цифры, подчёркивания, обязательно оканчивается на bot.

Нажмите кнопку "Create Bot" чтобы создать бота.

Появится окно только что созданного бота. Из того, на что стоит сразу обратить внимание это

BotToken, который потребуется на следующих этапах для интеграции TeleCart модуля с Telegram Bot.
Кнопка создания Mini Apps.
Введённый ранее Bot username. Это ссылка для запуска бота. Нажмите на неё, чтобы открыть информацию о боте.

В окне нажмите на кнопку "Отправить сообщение", чтобы запустить бота.

Запустится бот, там нажмите кнопку "Старт", чтобы начать общение с ботом, либо отправьте команду /start в чат.

Отправка /start боту — Отправка команды `/start` боту

Создание Mini App

Для создания Mini App, нужно зайти в @BotFather, выбрать своего бота и в разделе Settings нажать на кнопку Mini Apps, чтобы перейти в форму просмотра и создания.

На данный момент Telegram предлагает 3 способа запуска вашего приложения:

Menu Button - это кнопка для запуска магазина, которая отображается рядом с полем для ввода сообщения боту.
Main App - это кнопка для запуска магазина, которая отображается в форме информации о боте.
Direct Link - ссылка, с помощью которой можно будет напрямую запустить магазин. Эту ссылку удобно пересылать в группы, в личные сообщения.

Каждый из этих способов требуется ссылку для Telegram Mini App. Эту ссылку можно найти в настройках TeleCart на вкладке Telegram.

Это кнопка для запуска магазина, которая отображается рядом с полем для ввода сообщения боту.

Требует 2 значения:

URL - Ссылка для Telegram Mini App. Берётся из настроек TeleCart.
Title - Текст на кнопке, любой текст, например "Магазин".

Теперь в чате с ботом появилась кнопка "Магазин"

Демонстрация кнопки открытия магазина в чате с ботом

Информация

Возможно нужно подождать несколько минут, прежде чем Telegram обновит свои конфигурации и сбросит кеш, прежде чем появится кнопка.

Main App

Эта кнопка, которая отображается в форме информации о боте.

Здесь требуется задать только ссылку для Telegram Mini App. Берётся из настроек TeleCart.
Так же желательно выставить полноэкранный режим работы.

В пункте "Launch Screen" вы можете более детально кастомизировать экран загрузки магазина, добавив свои иконки и изображения. Но это уже больше вопрос дизайна.

После нажатия на кнопку "Save", результат работы можно посмотреть, открыл информацию о Вашем боте.

Информация

Возможно нужно подождать несколько минут, прежде чем Telegram обновит свои конфигурации и сбросит кеш, прежде чем появится кнопка.

Кнопка запуска магазина из формы информации о боте

Direct Link

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

Нужно ввести следующие данные:

Direct Link - ссылка для Telegram Mini App. Берётся из настроек TeleCart.
Metadata - картинка, заголовок и описание. Это будет использоваться при отображении ссылки в чатах и личных сообщениях. Лучше задать, для того, чтобы ссылки вызывали доверие.
Link for app - нужно ввести значение URL, которое будет добавлено к основному URL вашего Telegram бота. Благодаря этому значению, будет открываться не бот, а сразу ваш магазин. Введите например store;

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