Привет! Меня зовут Боровков Евгений и я предприниматель. В этой статье я расскажу про свой pet-проект. Или как я решил проблему вечного поиска информации прямо в уютном Телеграммчике.
Скажу сразу: я не программист. Я скорее менеджер, который работает в команде с программистами. Поэтому прошу меня простить, если технической глубины в статье не будет хватать.
Бизнесовая часть и проблематика
Идея не нова. Скорее всего вы или уже пользовались такими ботами, или пробовали написать такого своего. Но в поиске оптимального решения своей проблемы, мы пришли именно к такой конфигурации.
Суть бота очень проста и видна на видео ниже:
Если смотреть не хочется, то вкратце:
Еду, значит, я в метро\такси\автобусе на работу. И тут новому подрядчику\коллеге\клиенту срочно потребовалось скинуть наши реквизиты. Для счета\договора\акта\чего угодно.
Где мне их найти быстро? В закладках? В автозамене? В загрузках в телефоне? В “Избранном”? Думаю вы уловили, или сталкивались с таким сами 🙂
У нас даже в какой то момент появилось специальное удобное хранилище таких файлов и информации. Но достаточно быстро оно все равно забилось и проблему не решило. Пример с реквизитами тут взят исключительно как пример. Ведь всем вокруг постоянно нужны кроме реквизитов еще и логотип в “линиях”, ссылки на какие-то сайты, или, в конце концов, смешные гифки.
В какой-то момент я пробовал подключить стороннего похожего бота. Но он то не работал, то как-то криво отвечал, то вообще слал рекламную рассылку. Пробовали других ботов: тоже самое. Некоторых неудобно настраивать, где-то нет списка всех триггеров, где-то нет русского языка.
В итоге решили писать своего. Чат-ботов мы делаем уже больше 4 лет, видение уже +- сформировалось, на серверах место для еще одного бота найдется. Поехали!
Бизнесовая логика работы бота
Второе видео как продолжение первого:
Бот работает на столько просто, что разберется даже ребенок:
Добавляем бота @trigger_new_bot в чат (можно не делать админом).
Пишем какое-то сообщение или кидаем гифку\файл\видео — что угодно.
Делаем реплай нужного сообщения и пишем команду /set_trigger ключевое слово (или триггер) например «/set_trigger реквизиты».
Бот пришлет сообщение «триггер установлен».
Все, пишем то ключевое слово которое только что писали (ровно так же прям), и он пришлет то сообщение, куда был реплай.
Больше бот не делает НИ ЧЕ ГО. И тем самым соблюдает две основные заповеди ботостроения: имеет простой функционал и молчит когда его не спрашивают.
Количество чатов не ограничено, количество триггеров внутри чата не ограничено.
Как это работает под капотом
Основной ЯП, который мы используем, это Java. По нему у нас накоплена самая большая компетенция. Поэтому бот построен на Spring boot стеке:
<dependency>
<groupId>org.telegram</groupId>
<artifactId>telegrambots-spring-boot-starter</artifactId>
<version>5.7.1</version>
</dependency>База: MongoDB. Бот не хранит сами сообщения и не скачивает файлы. Ему достаточно хранить только ссылки на них.
Теперь по пунктам
Пишем сообщение: гифку\файл\видео — что угодно
Делаем реплай нужного сообщения и пишем команду /set_trigger ключевое слово (или триггер) например «/set_trigger реквизиты».
После этого бот:
Достает имя триггера из сообщения
String command = userText.replace("/set_trigger", "").trim();2. Достает ссылку на само сообщение, которое должно быть сохранено
if (reply.hasText()) {
Message reply = update.getMessage().getReplyToMessage();
String triggerMessage = reply.getText();
}Собирает триггер и сохраняет его в БД
Trigger trigger = Trigger.builder()
.chatId(chatId)
.commandName(command)
.triggerMessage(triggerMessage)
.triggerType(triggerType)
.build();
triggerRepository.save(trigger);4. Отправляет ответ, что все сделано
Bot.send(new SendMessage(
chatId.toString(),
EmojiParser.parseToUnicode(":white_check_mark:") + createdInfo + "\n + triggerMessage));Другие технические тонкости
Собирается проект с помощью Maven. Просто так вышло, не спрашивайте почему. Другие проекты мы собираем, как правило, с помощью Gradle.
Собранный jar запущен на vps как unix-сервис. Для комфортной работы бота хватает 512 мб памяти. Не смотря даже на количество пользователей и количество заведенных триггеров, этого пока вполне достаточно.
Кому нужны исходники, можете написать, мы готовы ими поделиться. В общий доступ выкладывать не хочется. Хотя и секрета там особого нет. И да, сидим мы на гитлабе в приватных репозиториях, а не на гитхабе.
Бот не требует никакого обслуживания и внимания. Единственное, что недавний переход телеги на 64-битный идентификатор заставил перелопатить некоторых наших ботов. В том числе и этого.
В отличие от других ботов, тут мы не использовали свою State машину. Но в других проектах, где используется более 5 стейтев бота рекомендуем уже использовать либо спринговскую State машину либо самописную. Иначе с развитием проекта, код быстро превращается в набор спагетти методов.
Что еще
На данный момент, мы думаем как улучшить бота, не уничтожив его “шарм минималистичности”. Если есть идеи, пишите в комментарии.
