Установка и настройка Telegram бота

Прежде чем начинать установку и настройку, необходимо зарегистрировать бота и получить его уникальный токен. Для этого в Telegram существует специальный бот — @BotFather.

Напишите команду /newbot, чтобы создать нового бота. BotFather спросит у вас название нового бота, которое будет отображаться в контактах и чатах и предложит придумать его логин на латинице, который используется для упоминаний бота и в ссылках на профиль. Логин должен состоять из букв латинского алфавита, подчёркиваний и цифр и быть длиной от 5 до 32 символов. Также логин обязательно должен заканчиваться на «bot», например: «tetris_bot» или «TetrisBot».

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

Ознакомиться с требованиями к серверу а так же получить дополнительную информацию по установке можно на официальном сайте фреймворка Laravel.

Основным конфигом приложения является файл .env, который расположен в корневой директории. Для редактирования содержимого файла подходит любой текстовый редактор. Ниже представлен список конфигураций, обязательных к заполнению.

APP_KEY

Секретный ключ приложения, используется в URL обработчика веб-хуков. Может содержать только цифры и латинские буквы.

APP_URL

URL адрес приложения.

APP_LOCALE

Язык приложения (бота) по умолчанию.

EXCHANGER_URL

URL адрес обменника:

EXCHANGER_DASHBOARD_API_TOKEN

Секретный ключ (токен) полученный в панеле управления обменником, в разделе "Настройки приложения" — "Настройка API панели управления".

EXCHANGER_PRIVATE_API_TOKEN

Секретный ключ (токен) полученный в панеле управления обменником, в разделе "Настройки приложения" — "Настройка приватного API".

TELEGRAM_BOT_TOKEN

Секретный ключ (токен) полученный при создании бота в Telegram.

TELEGRAM_BOT_BANLIST

Телеграм аккаунты (логин), для которых запрещено взаимодействие с ботом. Указывать через запятую.

TELEGRAM_BOT_LOG

Логирование сообщений в директории ./storage/logs.

Пример заполненного файла конфигураций:

APP_NAME=Exchanger-CMS-Telegram-Bot 
APP_VERSION=1.0.0 
APP_ENV=production 
APP_KEY=3ehPCZrnY6QmCWP32VdFBAWNn 
APP_DEBUG=false 
APP_SHOW_MODE=false 
APP_URL=https://tbot.exchanger-cms.com 
APP_TIMEZONE=UTC 
APP_LOCALE=ru 
CACHE_DRIVER=file 
CACHE_TIME=60 
QUEUE_CONNECTION=sync 
EXCHANGER_URL=https://demo.exchanger-cms.com 
EXCHANGER_DASHBOARD_API_TOKEN=0dce221415e9df012e148b424635c4f9 
EXCHANGER_PRIVATE_API_TOKEN=5280f40b255c9221d89138dc76021318 
TELEGRAM_BOT_TOKEN=110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw 
TELEGRAM_BOT_BANLIST= 
TELEGRAM_BOT_LOG=false 

Используя командную строку на сервере и интерфейс Artisan, выполните команду для установки URL обработчика веб-хуков. Убедитесь при этом что вы находитесь в корневой директории приложения.

Команда для выполнения:

php artisan set-webhook-url

Пример вывода:

[success] Webhook handler URL: https://tbot.exchanger-cms.com/webhook-handler-3ehPCZrnY6QmCWP32VdFBAWNn

Если на хостинге нет доступа к командной строке, вы можете использовать URL адрес ./setup, убедитесь что во время перехода по нему, значение параметра APP_DEBUG в файле конфигураций установлено на true, после успешной настройки значение необходимо изменить на false.

Директория с языковыми каталогами расположена по пути /resources/lang, каждый каталог содержит ряд языковых файлов:

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

Для удаления локализации достаточно удалить языковый каталог целиком.

Отключение команд может быть произведено в файле по пути /config/telegram.php, при помощи комментирования с использованием двойного слеша.

Пример отключенной команды:

'commands' => [ 
    ... 
    // App\Commands\SoftwareCommand::class, 
    ... 
];

Для обеспечения наилучшей безопасности рекомендуется подключить приложение к CDN сервису CloudFlare и произвести настройку фаервола, это можно сделать даже на бесплатном тарифе. Для этого после подключения сайта перейдите в раздел "Firewall" — "Firewall Rules", нажмите кнопку "Create a Firewall rule". Заполните форму как показано на изображении используя свои данные.

Страница настроек правил фаервола CloudFlare

В результате доступ к приложению будет разрешен только по URL адресу обработчика веб-хуков, который использует Bot API. В остальных случаях доступ будет заблокирован.

При отправке API запросов на сайт обменника, приложение телеграм бота устанавливает собственный HTTP заголовок User-Agent: Exchanger-CMS-Telegram-Bot/1.0.0, это может быть полезно для отслеживания заявок на обмен, созданных с использованием телеграм бота.