Skip to end of metadata
Go to start of metadata

Настройка БД

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

mysql -D abills < /usr/abills/Abills/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), например TestAbills_bot.
  6. Вы зарегистрировали вашего бота – внимательно осмотрите финальное сообщение на предмет параметров:
    Линк Телеграм-бота
    Например: https://t.me/TestAbills_bot
    а так же очень важный параметр - токен.
    Например: 167953392:AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg
  7.  Бот успешно создан!

Настройка

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

    Создание конфигурации веб-сервера для Telegram-бота
    cd /etc/apache2/sites-enabled/
    touch telegram_httpd.conf
    cat abills_httpd.conf >> telegram_httpd.conf
  3. В telegram_httpd.conf меняем порт з 9443 на 8443.
  4. Создайте директорию со сложным названием:

    Создание каталога для Telegram-бота
    mkdir /usr/abills/cgi-bin/TelegramAAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/


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

  5. Скопируйте в эту директорию файл telegram_bot.cgi
    Привязка телеграм-бота
    ln -s /usr/abills/Abills/modules/Telegram/telegram_bot.cgi /usr/abills/cgi-bin/TelegramAAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/
  6. Необходимо прописать в config.pl обязательные параметры (ниже в таблице).

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

ПараметрОписание
$conf{TELEGRAM_TOKEN}=' ';

Обязательный параметр.
Токен доступа до вашего Telegram-бота.

Пример: 167953392:AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg

$conf{TELEGRAM_BOT_NAME}=' ';

Обязательный параметр.
Должен строго совпадать с "username", что вы указали боту BotFather.

Пример: TestAbills_bot

$conf{TELEGRAM_SUPPORT_PHONE}=' ';

Подпись и номер телефона разделяются знаком ' | ' а каждый следующий номер знаком ' ; '

Пример: 'MTC|09600000;Lifecell|123456789'

$conf{TELEGRAM_LINK_URL}=' ';

Подпись и url разделяются знаком ' | ' а каждый следующий url знаком ' ; '

Пример: 'Акция|https://test.ua;Магазин|https://shop.ua;'

$conf{TELEGRAM_CHANEL}=' ';

Ссылка на произвольный телеграм канал.

Пример: 'https://t.me/test_abills'

$conf{TELEGRAM_SITE}=' ';

Ссылка на сайт провайдера.

Пример: 'http://abills.net.ua'

$conf{TELEGRAM_LANG}=' ';

Локализация бота. По умолчанию, доступны три значения: "english", "russian", "ukrainian".

$conf{TELEGRAM_MSGS_BOT_ENABLE} = 1;Позволяет пользователю отвечать на сообщения тех. поддержки.
$conf{TELEGRAM_USER_PORTAL} = 'url';Прописать URL к личному кабинету пользователя (Портал абонента).
$conf{TELEGRAM_TERMINAL} = 'url';Прописать URL к сервису с картой где будут отображаться терминалы
$conf{TELEGRAM_PAYMENT_CREDENTIAL} = 'string'Здесь можно указать информацию для платежных реквизитов по оплате
$conf{MONEY_UNIT_NAMES}='грн.'Название валюты, используется ботом
$conf{TELEGRAM_NUMBER_EXPR} =  '^380/0';

Регулярное выражение для номера телефона.

В примере '^380/0' позволяет удалять код страны из номера

$conf{TELEGRAM_CARDS_MESSAGE} = 'ТЕКСТ';

Текст, который будет отображаться для ввода карт пополнения.


Проверьте появился ли доступ к файлу (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/abills/Abills/modules/Telegram/buttons-enabled/
Каждый файл - это отдельная кнопка, которая добавляется в меню.
Для подключения новых функций, необходимо скопировать  нужные вам кнопки (или создать ссылку) из папки /usr/abills/Abills/modules/Telegram/buttons-avaiable/


Пример
mkdir /usr/abills/Abills/modules/Telegram/buttons-enabled/
ln -s /usr/abills/Abills/modules/Telegram/buttons-avaiable/Send_message.pm /usr/abills/Abills/modules/Telegram/buttons-enabled/

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

Название файлаКнопкаОписание
Balance.pmБалансВыводит состояние счета, информацию о последнем пополнении счета и последнем списании
Internet_info.pmИнтернетВыводит информацию о подключенных услугах.
Isp_info.pmО компанииВыводит информацию о компании (Данные заполняются в Настройка>Другое>Параметры организации)
Make_payment.pmПополнить счетПодсказка о том как пополнить счет (текст нужно заполнять самому в файле)
Send_message.pmОтправить сообщениеПозволяет пользователю создать сообщение в службу поддержки.
Services_and_account.pmУслуги и счетРасширенная версия кнопки Интернет, включает в себя также информацию о счете. Есть возможность взять кредит или отменить приостановление.
Msgs_reply.pm
Позволяет пользователю отвечать на сообщения тех. поддержки.
Privat_payment.pmОплата PrivatBankПозволяет перейти на страницу оплаты PrivatBank  для совершения оплаты (Должен быть подключен модуль Privat_terminal.pm)
Easypay_payment.pmОплата EasypayПозволяет перейти на страницу оплаты Easypay  для совершения оплаты (Должен быть подключен модуль Easypay.pm)
City24_payment.pmОплата City24Позволяет перейти на страницу оплаты City24  для совершения оплаты (Должен быть подключен модуль City24.pm)
Crm_new_lead.pmОставить заявкуПозволяет добавлять потенциальных клиентов через Телеграм. Если пользователя не найдено по номеру телефона, ему будет предложено оставить заявку на подключение.
Set_credit.pmКредитВозможность взятия кредита.


Начало работы с ботом

Для того чтобы начать работать с ботом абонент должен подписаться на него. Сделать это можно двумя способами.

  1. Пользователь может нажать кнопку  в личном кабинете.
  2. Пользователь может открыть чат с ботом, и там подтвердить свой телефон. (Необходимо чтобы его телефон был занесен в базу биллинга).

Для корректной работы с ботом нужно, чтобы номер телефона абонента в биллинге был уникален.

Подписаться на бота можно только с одного логина.

Для проверки результата после установки бота, используйте эту команду:

Проверка работы Telegram-бота со стороны Bot API
curl https://api.telegram.org/bot<TELEGRAM_TOKEN>/getWebhookInfo



Разработчикам - Создание кнопок для бота  Тестирование бота

  • No labels