Telegram Bot

В системе так-же предусмотрен бот для монтажников (в зачаточном состоянии)

Настройка БД

 Настройка работы с базой данных и создание таблиц:

mysql -D acp < /usr/acp/ACP/modules/Telegram/Telegram.sql

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

(если у вас уже есть бот, эту часть можно пропустить)

Эту операцию нужно делать с устройства где установлен Telegram.

1. Заходим https://t.me/botfather .
   Если есть аккаунт нажимаем кнопку “Send message”.
   Если нету, то регистрируемся в Telegram-е, затем снова заходим и нажимаем “Send message”,
   или можно сразу зайти в Telegram, в поиске вбить BotFather и перейти к диалогу с ним.
2. На главном экране бота нажимаем “Start”.
3. Покажется список возможных команд для обращения к BotFather.
   Нам нужно ввести команду /newbot.
4. BotFather спросит имя нашего бота.
   Это имя будет отображаться в деталях контакта. Вводим имя бота, например, Testbot.
5. Следующий шаг нас спрашивают Имя пользователя бота (username).
   Этот параметр будет использоваться для запросов к боту.
   От 5 до 32 символов, регистр-чувствительная латиница, цифры и нижние подчеркивания.
   Имя пользователя бота должно заканчиваться на bot. Вводим имя пользователя (username), например TestWork_bot.
6. Вы зарегистрировали вашего бота – внимательно осмотрите финальное сообщение на предмет параметров:
   Линк Телеграм-бота
   Например: https://t.me/TestWork_bot
   а так же очень важный параметр - токен.
   Например: 167953392:AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg
7.  Бот успешно создан!

Настройка

1. Для нормальной работы через webhook вам необходимо открыть порт 443,или 80, 88, 8443 для входящих POST запросов.
   Важно: Телеграм не работает с портом 9443. Обязательно включить шифрование.

2. Необходимо создать конфигурацию доступа веб-сервера Apache для работы Telegram-бота.
   Заходим в директории, где находится конфиг Apache.
   Создание конфигурации веб-сервера для Telegram-бота

3. В telegram_httpd.conf меняем порт з 9443 на 8443.

4. Создайте директорию со сложным названием:
   
   Создание каталога для Telegram-бота

   mkdir /usr/acp/cgi-bin/TelegramAAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/

   
   Название директории желательно сделать сложным и уникальным, для этого можно использовать токен (или его часть).

5. Скопируйте в эту директорию файл telegram_bot.cgi
   
   Привязка телеграм-бота

   ln -s /usr/acp/ACP/modules/Telegram/telegram_bot.cgi /usr/abills/cgi-bin/TelegramAAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/

6. Необходимо прописать в конфиге обязательные параметры (ниже в таблице).
   
   

В config.pl нужно добавить:

Проверьте появился ли доступ к файлу (https://YOUR.URL:YOURPORT/TelegramAAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/telegram_bot.cgi).

Если доступ есть – можно установить вебхук, соединение с Bot API Telegram.

Если используется действующий SSL-сертификат:

curl -F "url=https://YOUR.URL:YOURPORT/TelegramAAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/telegram_bot.cgi" https://api.telegram.org/bot<YOURTOKEN>/setWebhook

Если используется самоподписанный SSL-сертификат:
Установка WebHook

curl -F "url=https://YOUR.URL:YOURPORT/TelegramAAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/telegram_bot.cgi" -F "certificate=@/usr/abills/Certs/server.crt" https://api.telegram.org/bot<YOURTOKEN>/setWebhook

Примечание:

• в поле CN (Common Name) сертификата должен быть ваш домен или IP, иначе Telegram его не примет.
• при любом изменении/обновлении самоподписанного сертификата, его необходимо обновить с помощью команды выше (сертификат указываем явно).

Успешное выполнение команды установки вебхука выглядит примерно так:

{"ok":true,"result":true,"description":"Webhook was set"}

После настройки телеграм бота нужно перезапустить бота "Остановить и блокировать/Остановить бота", а затем нажать кнопку "Перезапустить бота".

Интерфейс бота

Бот загружает файлы из папки /usr/acp/ACP/modules/Telegram/buttons-enabled/
Каждый файл - это отдельная кнопка, которая добавляется в меню.
Для подключения новых функций, необходимо скопировать  нужные вам кнопки (или создать ссылку) из папки /usr/acp/ACP/modules/Telegram/buttons-avaiable/



Пример

mkdir /usr/acp/ACP/modules/Telegram/buttons-enabled/
ln -s /usr/acp/ACP/modules/Telegram/buttons-avaiable/Send_message.pm /usr/acp/ACP/modules/Telegram/buttons-enabled/

На сегодняшний день доступны следующие функции.

Установка и работа Telegram-пуллера (без webhook)

В АСР Казна-39 боты работают БЕЗ webhook. Вместо webhook используется отдельный сервис kazna-telegram-poll, который сам опрашивает Telegram методом long-polling (getUpdates) и передаёт полученные апдейты в CGI-скрипты бота. Это позволяет работать без публичного HTTPS-порта и внешнего доступа к серверу.

Как это работает:

1. Сервис kazna-telegram-poll запускает скрипт telegram_poll_to_cgi.pl.
2. Скрипт читает токены ботов из config.pl ($conf{TELEGRAM_TOKEN} — бот абонентов, $conf{TELEGRAM_ADMIN_TOKEN} — бот админов/монтажников).
3. Для каждого бота запускается свой цикл long-polling: скрипт вызывает getUpdates и получает новые апдейты (сообщения, нажатия кнопок).
4. Полученный апдейт (JSON) передаётся в CGI-скрипт бота (telegram_bot.cgi или telegram_admin_bot.cgi) — так, будто пришёл webhook.
5. CGI-скрипт выполняет логику бота (отправляет ответ абоненту через Bot API и т.д.).
6. Скрипт запоминает offset обработанного апдейта в файле var/Telegram/telegram_offset_user.txt (и _admin.txt), чтобы не обрабатывать один апдейт дважды.

Что переделано для работы (важно):

• При старте пуллер снимает webhook у бота (deleteWebhook) — иначе getUpdates возвращает ошибку 409 Conflict.
• Пуллер автоматически создаёт в cgi-bin каталог Telegram<префикс_токена>/ и симлинк на telegram_bot.cgi (нужен для совместимости с логикой бота).
• Доставка апдейтов идёт через FastCGI-пул (acp-fcgi-index): апдейт отправляется как FastCGI-запрос в сокет /run/acp-fcgi-index/index.sock — как это делает nginx. В пуле код биллинга уже скомпилирован, поэтому НЕТ повторной компиляции биллинга на каждый апдейт (раньше пуллер запускал perl telegram_bot.cgi — это давало заметную постоянную нагрузку на CPU). Если FastCGI-пул недоступен — пуллер автоматически откатывается на прямой запуск perl.

Что требуется для работы с ботами Telegram:

• Созданный бот и его токен (получить у @BotFather).
• Токены прописаны в config.pl: $conf{TELEGRAM_TOKEN} и $conf{TELEGRAM_ADMIN_TOKEN}.
• Параметр $conf{BILLING_URL} — используется для формирования HTTP_HOST при доставке апдейтов.
• Модуль Perl JSON (libjson-perl) и IO::Socket::UNIX.
• Настроенный FastCGI-пул (acp-fcgi-index) — для работы без повторной компиляции.
• Таблицы БД модуля Telegram (см. раздел «Настройка БД» выше).

Установка пуллера (идемпотентно):

sudo bash misc/telegram/install.sh

Инсталлер сам: определяет каталог установки, копирует пуллер в cgi-bin, ставит systemd-юнит kazna-telegram-poll и запускает сервис.

Файлы:

• Эталон пуллера: misc/telegram/telegram_poll_to_cgi.pl
• Инсталлер: misc/telegram/install.sh
• systemd-юнит: misc/telegram/kazna-telegram-poll.service
• Рабочая копия: <PREFIX>/cgi-bin/telegram_poll_to_cgi.pl

Проверка:

systemctl status kazna-telegram-poll
journalctl -u kazna-telegram-poll -n 30

Отключение (при необходимости):

systemctl disable --now kazna-telegram-poll