Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

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

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

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

1) Заходим https://telegram.me/botfather . Если есть аккаунт нажимаем кнопку “Send message”. Если нету, то регистрируемся в Telegram-е, затем снова заходим и нажимаем “Send message”. Или можно сразу зайти в Telegram, в поиске вбить Botfather и перейти к диалогу с ним.

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

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

/newbot.

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

5) Следующий шаг нас спрашивают Имя пользователя бота. Это параметр будет использоваться для запросов к боту. От 5 до 32 символов, регистро-чувствительная латиница, цифры и нижние подчеркивания. Имя пользователя бота должно заканчиваться на bot. Вводим наше имя пользователя, например TestAbills_bot.

6) Мы зарегистрировали нашего бота. Мы получили линк на нашего бота https://telegram.me/TestAbills_bot, а так же очень важный параметр - токен.

Токен: 167953392:AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg-io .

7) Бот создан!

Настройка

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

Создайте директорию /usr/abills/cgi-bin/TelegramAAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg/

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

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

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

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

Если доступ есть - можно установить вебхук.

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


В config.pl нужно добавить токен и никнейм бота
$conf{TELEGRAM_TOKEN} = '167953392:AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg-io';

$conf{TELEGRAM_BOT_NAME} = 'Awesome_bot';


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

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


Code Block
languagebash
titleПример
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
Позволяет пользователю отвечать на сообщения (при включеной опции $conf{TELEGRAM_MSGS_BOT_ENABLE}=1;)



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

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

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

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

Для разработчиков

Code Block
languageperl
titleОтправка сообщения
$self->{bot}->send_message({
  text => "Текст сообщения",
});
Code Block
languageperl
titleОтправка сообщения с встроеной кнопкой
$self->{bot}->send_message({
  text => "Текст сообщения",
  reply_markup => {
    inline_keyboard => [[{
      text          => "Кнопка в сообщении",
      callback_data => "button_name&fn_name"
    }]],
  }
});
Code Block
languageperl
titleОтправка сообщения с ссылкой
$self->{bot}->send_message({
  text => "Текст сообщения",
  reply_markup => {
    inline_keyboard => [[{
      text => "Кнопка с ссылкой",
      url  => "http://abills.net.ua"
    }]],
  }
});
Code Block
languageperl
titleОтправка сообщения с заменой клавиатуры (многоуровневая операция)
# Внимание! Для использование многоуровневых операций необходимо полностью понимать что это такое. # Иначе вы рискуете сделать бота полностью неработоспособным. $self->{bot}->send_message({ text => 'Вы на втором шаге какой-то операции.\nОтправьте текст или нажмите <b>Отменить</b>', reply_markup => { keyboard => [[{ text => "Отменить", }]], resize_keyboard => "true", }, parse_mode => 'HTML' }); # Запись в базу о том, что пользователь находится на втором шаге операции. # При любом его действии будет вызываться &Button_name::fn_name # Не забудьте удалить после завершения операции. $self->{bot_db}->add({   UID => $self->{bot}->{uid},   BUTTON => "Button_name",   FN => "fn_name", ARGS



=> "дополнительные аргументы", });

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