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

Общие сведения

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

Lumen

Файл конфигураций

Расположенный в корне файл ".env" является основным конфигом приложения.

Exchanger CMS

Для редактирования его содержимого подходит любой текстовый редактор.

КлючОписание
APP_NAMEНазвание приложения
APP_VERSIONВерсия приложения
APP_ENVРежим работы
APP_KEYСекретный ключ приложения
APP_DEBUGОтладка ошибок
APP_SHOW_MODEРежим демонстрации
APP_URLURL адрес приложения
APP_LOCALEЯзык приложения по умолчанию
CACHE_TIMEВремя кеширования
EXCHANGER_URLURL адрес обменника
EXCHANGER_DASHBOARD_API_TOKENСекретный ключ API панели управления
EXCHANGER_PRIVATE_API_TOKENСекретный ключ приватного API
EXCHANGER_WEBHOOKS_SECRET_KEYСекретный ключ веб-хуков
TELEGRAM_BOT_TOKENСекретный ключ полученный после регистрации бота в Telegram
TELEGRAM_BOT_BANLISTСписок заблокированных Telegram аккаунтов
TELEGRAM_BOT_LOGЛогирование диалогов
Регистрация бота

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

Запустить BotFather

Exchanger CMS

Напишите команду /newbot, чтобы создать нового бота. Бот спросит у вас название нового бота и предложит придумать его логин на латинице. Логин должен состоять из букв латинского алфавита, подчёркиваний и цифр и быть длиной от 5 до 32 символов. Также логин обязательно должен заканчиваться на "bot", например: "exchanger_bot" или "ExchangerBot".

Exchanger CMS

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

Настройка обменника

Перейдите в панель управления, в раздел "Настройки приложения" — "Настройка API панели управления". Выпустите секретный ключ и активируйте API.

Exchanger CMS

Перейдите в панель управления, в раздел "Настройки приложения" — "Настройка приватного API". Выпустите секретный ключ и активируйте API.

Exchanger CMS

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

Exchanger CMS

Используя командную строку на сервере и интерфейс 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, каждый каталог содержит ряд языковых файлов:

ФайлОписание
buttons.phpТексты кнопок
commands.phpОписания команд
keyboards.phpТексты главного меню
languages.phpНазвания языков
messages.phpТексты сообщений
words.phpПрочие слова

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

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

Команды

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

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

'commands' => [ 
    ...
    // App\Commands\SoftwareCommand::class,
    ...
];
Безопасность

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

Скрипт обменника валют - Exchanger CMS

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

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

Идентификация

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

APP_NAME=Exchanger-CMS-Telegram-Bot APP_VERSION=1.1.0 APP_ENV=production APP_KEY=bu5Ahbu6yai9vaibeeweiyeofie1phai APP_DEBUG=false APP_SHOW_MODE=false APP_URL=https://tbot.exchanger-cms.com APP_LOCALE=ru CACHE_TIME=60 EXCHANGER_URL=https://prod.exchanger-cms.com EXCHANGER_DASHBOARD_API_TOKEN=ioX7keu1peesi4junes0chaifaig2cha EXCHANGER_PRIVATE_API_TOKEN=ioX7keu1peesi4junes0chaifaig2cha EXCHANGER_WEBHOOKS_SECRET_KEY=xoohiiXohk3fohcheingieXie7mae5Ep TELEGRAM_BOT_TOKEN=1359008999:AAEx5MW94Ehneo6oCpM69U-VHG1oyD_YWVs TELEGRAM_BOT_BANLIST= TELEGRAM_BOT_LOG=true https://tbot.exchanger-cms.com/exchanger-webhook/bu5Ahbu6yai9vaibeeweiyeofie1phai/call-handler

График работы пн. — вс. 08:00 — 20:00 (GMT+03:00)

© 2019 - 2021. Сделано с , публичное API

Telegram чатОбратная связь

Мы в социальных сетях