Настройка работы с базой данных и создание таблиц:
mysql -D abills < /usr/abills/Abills/modules/Telegram/Telegram.sql |
(если у вас уже есть бот, эту часть можно пропустить)
Эту операцию нужно делать с устройства где установлен Telegram.
/newbot
.TestAbills_bot
.https://t.me/TestAbills_bot
167953392:AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg
Необходимо создать конфигурацию доступа веб-сервера Apache для работы Telegram-бота.
Заходим в директории, где находится конфиг Apache.
cd /etc/apache2/sites-enabled/ touch telegram_httpd.conf cat abills_httpd.conf >> telegram_httpd.conf |
telegram_httpd.conf
меняем порт з 9443 на 8443.Создайте директорию со сложным названием:
mkdir /usr/abills/cgi-bin/TelegramAAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/ |
Название директории желательно сделать сложным и уникальным, для этого можно использовать токен (или его часть).
telegram_bot.cgi
ln -s /usr/abills/Abills/modules/Telegram/telegram_bot.cgi /usr/abills/cgi-bin/TelegramAAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/ |
config.pl
обязательные параметры (ниже в таблице).В config.pl нужно добавить:
Параметр | Описание |
---|---|
$conf{TELEGRAM_TOKEN}=' '; | Обязательный параметр. Пример: |
$conf{TELEGRAM_BOT_NAME}=' '; | Обязательный параметр. Пример: |
| Подпись и номер телефона разделяются знаком ' | ' а каждый следующий номер знаком ' ; ' Пример: |
| Подпись и url разделяются знаком ' | ' а каждый следующий url знаком ' ; ' Пример: |
| Ссылка на произвольный телеграм канал. Пример: |
| Ссылка на сайт провайдера. Пример: |
| Локализация бота. По умолчанию, доступны три значения: |
$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'; | Регулярное выражение для номера телефона. В примере |
| Текст, который будет отображаться для ввода карт пополнения. |
Проверьте появился ли доступ к файлу (https://YOUR.URL:YOURPORT/Telegram
AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/
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-сертификат:
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 |
Примечание:
Успешное выполнение команды установки вебхука выглядит примерно так:
{"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 | Баланс | Выводит состояние счета, информацию о плановых списания. При недостатке денег появляется кнопка "Пополнить счет". Обязательно добавить параметр с ссылкой на кабинет пользователя: $conf{TELEGRAM_BALANCE_URL} = 'https://localhost:9443/index.cgi'; | ||
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) | ||
Liqpay_payment.pm | Оплата Liqpay | Позволяет перейти на страницу оплаты Liqpay для совершения оплаты (Должен быть подключен модуль Liqpay.pm) | ||
Crm_new_lead.pm | Оставить заявку | Позволяет добавлять потенциальных клиентов через Телеграм. Если пользователя не найдено по номеру телефона, ему будет предложено оставить заявку на подключение. | ||
Set_credit.pm | Кредит | Возможность взятия кредита. | ||
Equipment_info.pm | Проверка связи | Информация о состоянии подключения оптического терминала (в сети или выключен терминал) и состоянии порта оптического терминала, подключен ли к нему роутер.
|
Для того чтобы начать работать с ботом абонент должен подписаться на него. Сделать это можно двумя способами.
Для корректной работы с ботом нужно, чтобы номер телефона абонента в биллинге был уникален. Подписаться на бота можно только с одного логина. |
Для проверки результата после установки бота, используйте эту команду:
curl https://api.telegram.org/bot<TELEGRAM_TOKEN>/getWebhookInfo |
Разработчикам - Создание кнопок для бота Тестирование бота
Пользователь должен быть подписан на бота, тогда будет работать авторизация.