Установка и настройка 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

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

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

APP_NAME=Exchanger-CMS-Telegram-Bot 
APP_VERSION=1.0.0
APP_ENV=local
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
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=
Настройка веб-хуков

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

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

php artisan set-webhook-url

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

[success] Webhook handler URL: https://tbot.exchanger-cms.com/webhook-handler-3ehPCZrnY6QmCWP32VdFBAWNn
Языковые файлы

Директория с языковыми каталогами расположена по пути /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. В остальных случаях доступ будет заблокирован.

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

Сделано с от Exchanger CMS © 2019 - 2020

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

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