Page History

Image Added

Возможности

• Мультиязычность
• Автоопределение языка клиента Telegram (добавлено в 1.39.03)
• Основной функционал личного кабинета

Настройка БД

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

mysql -D abills < /usr/abills/Abills/modules/Telegram/Telegram.sql

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

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

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

1. Заходим https://

1. t.me/botfather .
   Если есть аккаунт нажимаем кнопку “Send message”.
   Если нету, то регистрируемся в Telegram-е, затем снова заходим и нажимаем “Send message”

1. ,
   или можно сразу зайти в Telegram, в поиске вбить

1. BotFather и перейти к диалогу с ним.

1. На главном экране бота нажимаем “Start”.

1. Покажется список возможных команд для обращения к BotFather.
   Нам нужно ввести команду

1. /newbot.

1. BotFather спросит имя нашего бота.
   Это имя будет отображаться в деталях контакта. Вводим имя бота, например,

1. Testbot.

1. Следующий шаг нас спрашивают Имя пользователя бота (username).

1. 
   Этот параметр будет использоваться для запросов к боту.
   От 5 до 32 символов,

1. регистр-чувствительная латиница, цифры и нижние подчеркивания.
   Имя пользователя бота должно заканчиваться на bot. Вводим

1. имя пользователя (username),

1. например TestAbills_bot.

1. Вы зарегистрировали

1. вашего бота – внимательно осмотрите финальное сообщение на предмет параметров:
   Линк Телеграм-бота
   Например: https://

1. t.me/TestAbills_bot

1. 
   а так же очень важный параметр - токен.
   

1. Например: 167953392:AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg

2.  Бот успешно создан!

Настройка

1. Для нормальной работы через webhook вам необходимо открыть

1. порт 443,или 80, 88

1. , 8443 для входящих POST запросов.

1. 
   Важно: Телеграм не работает с портом 9443

1. . Обязательно включить шифрование.

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

   Code Block
   language bash title Создание конфигурации веб-сервера для Telegram-бота linenumbers true collapse true
   cd /etc/apache2/sites-enabled/ touch telegram_httpd.conf cat abills_httpd.conf >> telegram_httpd.conf

   
   

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

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

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

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

5. Скопируйте в эту директорию файл telegram_bot.cgi
   

   
   

   
   

   Code Block
   language bash title Привязка телеграм-бота
   ln -s /usr/abills/Abills/modules/Telegram/telegram_bot.cgi /usr/abills/cgi-bin/TelegramAAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/

   
   

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

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

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

Image Added

Если доступ есть - – можно установить вебхук, соединение с 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

В Примечание:

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

В config.pl нужно добавить токен и никнейм бота

Awesome_bot

(Строго должен совпадать с тем именем что вы указали боту botfather)

$conf{TELEGRAM_SUPPORT_PHONE}

MTC|09600000;Lifecell|123456789

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

$conf{TELEGRAM_LINK_URL}

Акция|https://test.ua;Магазин|https://shop.ua;

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

$conf{TELEGRAM_CHANEL}

https://t.me/test_abills

(Ссылка на телеграм канал)

$conf{TELEGRAM_SITE}

http://abills.net.ua

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

$conf{TELEGRAM_LANG}

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

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

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

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

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

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

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

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

1. Пользователь может нажать

Image Removed

1. кнопку в личном кабинете.
   

1. Image Added
   Дополнительно, при нажатии на правую подкнопку может открыться QR-код на подписку:
   Image Added
2. Пользователь может открыть чат с ботом, и там подтвердить свой телефон. (Необходимо чтобы его телефон был занесен в базу биллинга).
   Image Modified

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

curl https://api.telegram.org/bot<TELEGRAM_TOKEN>/getWebhookInfo

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

Авторизация через кабинет пользователя с помощью телеграмм

Пользователь должен быть подписан на бота, тогда будет работать авторизация.

Как настроить?

Функция напоминания для неактивных пользователей

Данный функционал предназначен для автоматической отправки напоминаний пользователям, которые не отвечают в течение определенного времени (не более 3-х уведомлений на одно действие пользователя).

Если клиент не отвечает на вопрос бота более двух минут (не более суток), система отправляет ему напоминание с вопросом, нуждается ли он в дополнительной помощи.

Это помогает поддерживать непрерывное взаимодействие и повышает удовлетворенность клиентов.

Image Added

Для активации этого функционала необходимо запустить плагин telegram_ping, расположенный по пути /usr/abills/libexec/billd.

Добавьте следующую строку для запуска плагина каждые 5 минут (или с другой необходимой периодичностью):

*/5 * * * * /usr/abills/libexec/billd telegram_ping

QR-коды для Telegram-ботов

Для отображения установите модуль:

В файле config.pl :

@MODULES = (
             'Telegram'
            );

Image Added