Java Telegram Bot Course Guide

Table
of Contents
Introduction 1.1
Lesson 1. Simple echo bot 1.2
Lesson 2. PhotoBot 1.3
Lesson 3. Logging 1.4
Lesson 4. Emoji 1.5
Lesson 5. Deploy your bot 1.6
Lesson 6. Inline keyboards and editing message's text 1.7
Lesson 7. Creating users database with MongoDB 1.8
Lesson 8. Integrating with Redis 1.9
1
Introduction
Writing bots for Telegram on Java
Hello everyone! This course is for those, who wants to learn how to code bots for
Telegram's Bot Platform.
You can always contact me at Telegram: @MonsterDeveloper
You can find all sources at GitHub repository.
Table of contents
Lesson 1. Simple "echo" bot
Lesson 2. PhotoBot
Lesson 3. Logging
Lesson 4. Emoji
Lesson 5. Deploy your bot
Lesson 6. Inline keyboards and editing message's text
Lesson 7. Creating users database with MongoDB
Lesson 8. Integrating with Redis
Credits
Rubenlagus for his amazing library and support
Clevero for his amazing HOWTO guide
MasterGroosha for his amazing Python book
2
Lesson 1. Simple echo bot
Lesson 1. Writing your first "echo" bot

Hello! If you want to know, how to code Telegram Bots on Java, you are on the
right way!
Prepare to launch
Bot API is based on HTTP-requests, but in this book I will use Rubenlagus' library
for Java.
Install the library

You can install TelegramBots library with different methods:
Using Maven:
<dependency>
<groupId>org.telegram</groupId>
<artifactId>telegrambots</artifactId>
<version>Latest</version>
</dependency>
Using Jitpack
Or just download .jar file with dependencies from here
In this tutorial I will use next machines:
Ubuntu 16.04 Server with 1GB of RAM

My home Windows 10 laptop with IntelliJ Idea pre-installed
Lets go to code!
Well, enough for words. Let's get down to buisness. In this lesson we will write
simple bot that echoes everything we sent to him. Now, open IntelliJ Idea
and create a new project. You can call it whatever you want. Then, dont forget to
3
install TelegramBots library with preffered method. I think, that it is most easy to
just download .jar from here
Now, when you are in the project, create files MyAmazingBot.java and
Main.java within the src directory. Open MyAmazingBot.java and lets
write our actual bot:
Remember! The class must extends TelegramLongPollingBot and

implement necessary methods
import org.telegram.telegrambots.api.objects.Update;
import org.telegram.telegrambots.bots.TelegramLongPollingBot;
public class MyAmazingBot extends TelegramLongPollingBot {
@Override
public void onUpdateReceived(Update update) {
// TODO
}
@Override
public String getBotUsername() {
// TODO
return null;
}
@Override
public String getBotToken() {
// TODO
return null;
}
}
As you can understand, getBotUsername() and getBotToken() must return

bot's username and bot's token, obtained from @BotFather. So now, our
MyAmazingBot.java file will look like this:
4
@Override
// TODO
}
@Override
// Return bot username
// If bot username is @MyAmazingBot, it must return 'MyA
mazingBot'
return "MyAmazingBot";
}
@Override
// Return bot token from BotFather
return "12345:qwertyuiopASDGFHKMK";
}
}
Now, let's move on to the logic of our bot. As I said before, we want him to reply
every text we send to him. onUpdateReceived(Update update) method is for
us. When an update recieved, it will call this method.
5
@Override
// We check if the update has a message and the message has

text
if (update.hasMessage() && update.getMessage().hasText()) {
// Set variables
String message_text = update.getMessage().getText();
long chat_id = update.getMessage().getChatId();
SendMessage message = new SendMessage() // Create a mess

age object object
.setChatId(chat_id)
.setText(message_text);
try {
execute(message); // Sending our message object to u
ser
} catch (TelegramApiException e) {
e.printStackTrace();
}
}
}
Good! But how do I run the bot? Well, its a good question. Lets save that file and
open Main.java . This file will instantiate TelegramBotsApi and register our new
bot. It will look like this:
6
import org.telegram.telegrambots.ApiContextInitializer;
import org.telegram.telegrambots.TelegramBotsApi;
import org.telegram.telegrambots.exceptions.TelegramApiException
;
public class Main {
public static void main(String[] args) {
// TODO Initialize Api Context
// TODO Instantiate Telegram Bots API
// TODO Register our bot

}
}
Now, lets initialize Api Context
;
public class Main {
// Initialize Api Context
ApiContextInitializer.init();
// TODO Instantiate Telegram Bots API

}
}
Instantiate Telegram Bots API:
7
;
public class Main {
// Instantiate Telegram Bots API
TelegramBotsApi botsApi = new TelegramBotsApi();

}
}
And register our bot:
;
public class Main {

// Register our bot

try {
botsApi.registerBot(new MyAmazingBot());
}
}
}
8
Here is all our files:
src/Main.java
import org.telegram.telegrambots.exceptions.TelegramApiExcepti
on;
public class Main {

// Register our bot

try {
botsApi.registerBot(new MyAmazingBot());
}
}
}
src/MyAmazingBot.java
@Override
// We check if the update has a message and the message

has text
if (update.hasMessage() && update.getMessage().hasText()
) {
// Set variables
9
SendMessage message = new SendMessage() // Create a

message object object
.setChatId(chat_id)
try {
execute(message); // Sending our message object
to user
}
}
}
@Override
mazingBot'
return "MyAmazingBot";
}
@Override
}
}
Well done! Now we can pack our project into runnable .jar file and run it on
our computer/server!
You can find all sources to this lesson in GitHub repository.
java -jar MyAmazingBot.jar
Now we can see our bot running:
10
Well, thats all for now. Hope to see you soon!:)
11
Lesson 2. PhotoBot
Lesson 2. Photo bot.

Our today's mission - create a "photo" bot, that will send user a photo. It is just an
example so there there will be no photos from online, no group chat support. Just
local pics. But there is a good thing: we will learn how to create custom
keyboards, how to send photos and create commands.
Let's respect Telegram's servers

Okey, for a start, let's prepare our pictures. Lets download 5 completely unknown
photos. Just look: we will send same files to users many many times, so lets coast
our traffic and disk space on Telegram Servers. It is amazing that we can upload
our files at their server once and then just send files (photos, audio files,
documents, voice messages and etc.) by their unique file_id . Okey then. Now
lets know photo's file_id when we will send it to our bot. As always, create a
new project in IntelliJ Idea and create two files within the src directory:
Main.java and PhotoBot.java . Open up first file and type next:
Dont forget to install TelegramBots library
12
Lesson 2. PhotoBot
;
public class Main {

try {
botsApi.registerBot(new PhotoBot());
}
System.out.println("PhotoBot successfully started!");
}
}
This code will register our bot print "PhotoBot successfully started!" when it is
successfully started. Then, save it and open up PhotoBot.java . Paste the
following code from previous lesson:
Dont forget to change bot username and bot token if you created
another bot.
import org.telegram.telegrambots.api.methods.send.SendMessage;
;
public class PhotoBot extends TelegramLongPollingBot {

@Override
13
Lesson 2. PhotoBot
has text
) {
// Set variables
.setChatId(chat_id)
try {
sendMessage(message); // Sending our message obj
ect to user
}
}
}
@Override
mazingBot'
return "PhotoBot";
}
@Override
}
}
Now lets update our onUpdateReceived method. We want to send file_id

of the picture we send to bot. Lets check if message contains photo object:
14
Lesson 2. PhotoBot
@Override

text
// Set variables
age object object
.setChatId(chat_id)
try {
sendMessage(message); // Sending our message object
to user
}
} else if (update.hasMessage() && update.getMessage().hasPho
to()) {
// Message contains photo
}
}
We want our bot to send file_id of the photo. Well, lets do this:
else if (update.hasMessage() && update.getMessage().hasPhoto())

{
// Set variables
// Array with photo objects with different sizes

// We will get the biggest photo from that array
List<PhotoSize> photos = update.getMessage().getPhoto();
// Know file_id
String f_id = photos.stream()
.sorted(Comparator.comparing(PhotoSize::getF
15
Lesson 2. PhotoBot
ileSize).reversed())
.findFirst()
.orElse(null).getFileId();
// Know photo width
int f_width = photos.stream()
.findFirst()
.orElse(null).getWidth();
// Know photo height
int f_height = photos.stream()
.findFirst()
.orElse(null).getHeight();
// Set photo caption
String caption = "file_id: " + f_id + "\nwidth: " + Integer.
toString(f_width) + "\nheight: " + Integer.toString(f_height);
SendPhoto msg = new SendPhoto()
.setChatId(chat_id)
.setPhoto(f_id)
.setCaption(caption);
try {
sendPhoto(msg); // Call method to send the photo with ca
ption
}
}
Lets take a look:
16
Lesson 2. PhotoBot
Amazing! Now we know photo's file_id so we can send them by file_id. Lets make
our bot answer with that photo when we send command /pic .

// Set variables
if (message_text.equals("/start")) {
// User send /start
age object object
.setChatId(chat_id)
try {
to user
}
} else if (message_text.equals("/pic")) {
17
Lesson 2. PhotoBot
// User sent /pic

.setChatId(chat_id)
.setPhoto("AgADAgAD6qcxGwnPsUgOp7-MvnQ8G
ecvSw0ABGvTl7ObQNPNX7UEAAEC")
.setCaption("Photo");
try {
sendPhoto(msg); // Call method to send the p
hoto
}
} else {
// Unknown command
age object object
.setChatId(chat_id)
.setText("Unknown command");
try {
to user
}
}
}
Now bot sends photo like this:
18
Lesson 2. PhotoBot
And he can even reply to unknown command!
Now lets take a look at ReplyKeyboardMarkup. We will now create custom

keyboard like this:
Well, you already now how to make our bot recognise command. Lets make
another if for command /markup .
19
Lesson 2. PhotoBot
Remember! When you press the button, it will send to bot the text on this
button. For example, if I put "Hello" text on the button, when I press it, it will
send "Hello" text for me
20
Lesson 2. PhotoBot
else if (message_text.equals("/markup")) {
SendMessage message = new SendMessage() // Create a message
object object
.setChatId(chat_id)
.setText("Here is your keyboard");
// Create ReplyKeyboardMarkup object
ReplyKeyboardMarkup keyboardMarkup = new ReplyKeyboardMarkup
();
// Create the keyboard (list of keyboard rows)
List<KeyboardRow> keyboard = new ArrayList<>();
// Create a keyboard row
KeyboardRow row = new KeyboardRow();
// Set each button, you can also use KeyboardButton objects
if you need something else than text
row.add("Row 1 Button 1");
// Add the first row to the keyboard
keyboard.add(row);
// Create another keyboard row
row = new KeyboardRow();
// Set each button for the second line
// Add the second row to the keyboard
keyboard.add(row);
// Set the keyboard to the markup
keyboardMarkup.setKeyboard(keyboard);
// Add it to the message
message.setReplyMarkup(keyboardMarkup);
try {
sendMessage(message); // Sending our message object to u
ser
}
}
21
Lesson 2. PhotoBot
Amazing! Now lets teach our bot to react on this buttons:
else if (message_text.equals("Row 1 Button 1")) {

.setChatId(chat_id)
.setPhoto("AgADAgAD6qcxGwnPsUgOp7-MvnQ8GecvSw0AB
GvTl7ObQNPNX7UEAAEC")
try {
sendPhoto(msg); // Call method to send the photo
}
}
Now, when user press button with "Row 1 Button 1" text on it, bot will send picture
by file_id to user:
And lets add "Hide keyboard" function when user send /hide command to bot.
This can be done with ReplyMarkupRemove .
22
Lesson 2. PhotoBot
else if (message_text.equals("/hide")) {
SendMessage msg = new SendMessage()
.setChatId(chat_id)
.setText("Keyboard hidden");
ReplyKeyboardRemove keyboardMarkup = new ReplyKeyboardRemove
();
msg.setReplyMarkup(keyboardMarkup);
try {
sendMessage(msg); // Call method to send the photo
}
}
Here is code of our files. You can also find all sources at GitHub repository.
src/Main.java
;
public class Main {

try {
botsApi.registerBot(new PhotoBot());
}
System.out.println("PhotoBot successfully started!");
}
}
23
Lesson 2. PhotoBot
src/PhotoBot.java
import org.telegram.telegrambots.api.methods.send.SendPhoto;
import org.telegram.telegrambots.api.objects.PhotoSize;
import org.telegram.telegrambots.api.objects.replykeyboard.Reply
KeyboardMarkup;
import org.telegram.telegrambots.api.objects.replykeyboard.Reply
KeyboardRemove;
import org.telegram.telegrambots.api.objects.replykeyboard.butto
ns.KeyboardRow;
;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;
public class PhotoBot extends TelegramLongPollingBot {

@Override

has text
) {
// Set variables
if (message_text.equals("/start")) {
SendMessage message = new SendMessage() // Creat
e a message object object
.setChatId(chat_id)
try {
sendMessage(message); // Sending our message
object to user
24
Lesson 2. PhotoBot
}
} else if (message_text.equals("/pic")) {
.setChatId(chat_id)
try {
hoto
}
} else if (message_text.equals("/markup")) {
.setChatId(chat_id)
.setText("Here is your keyboard");
// Create ReplyKeyboardMarkup object
ReplyKeyboardMarkup keyboardMarkup = new ReplyKe
yboardMarkup();
// Create the keyboard (list of keyboard rows)
List<KeyboardRow> keyboard = new ArrayList<>();
// Create a keyboard row
KeyboardRow row = new KeyboardRow();
// Set each button, you can also use KeyboardBut
ton objects if you need something else than text
// Add the first row to the keyboard
keyboard.add(row);
// Create another keyboard row
row = new KeyboardRow();
// Set each button for the second line
// Add the second row to the keyboard
25
Lesson 2. PhotoBot
keyboard.add(row);
keyboardMarkup.setKeyboard(keyboard);
message.setReplyMarkup(keyboardMarkup);
try {
object to user
}
} else if (message_text.equals("Row 1 Button 1")) {
.setChatId(chat_id)
try {
hoto
}
} else if (message_text.equals("/hide")) {
SendMessage msg = new SendMessage()
.setChatId(chat_id)
.setText("Keyboard hidden");
ReplyKeyboardRemove keyboardMarkup = new ReplyKe
yboardRemove();
msg.setReplyMarkup(keyboardMarkup);
try {
sendMessage(msg); // Call method to send the
photo
}
} else {
26
Lesson 2. PhotoBot
.setChatId(chat_id)
.setText("Unknown command");
try {
object to user
}
}
} else if (update.hasMessage() && update.getMessage().ha
sPhoto()) {
// Set variables
List<PhotoSize> photos = update.getMessage().getPhot

o();
String f_id = photos.stream()
.findFirst()
.orElse(null).getFileId();
int f_width = photos.stream()
.findFirst()
.orElse(null).getWidth();
int f_height = photos.stream()
.findFirst()
.orElse(null).getHeight();
String caption = "file_id: " + f_id + "\nwidth: " +
Integer.toString(f_width) + "\nheight: " + Integer.toString(f_he
ight);
.setChatId(chat_id)
.setPhoto(f_id)
.setCaption(caption);
try {
27
Lesson 2. PhotoBot
sendPhoto(msg); // Call method to send the messa

ge
}
}
}
@Override
mazingBot'
return "PhotoBot";
}
@Override
}
}
Now you can create and remove custom ReplyMarkup keyboards, create
custom commands and send photos by file_id ! You are doing very well! Hope
to see you soon:)
28
Lesson 3. Logging
Lesson 3. Logging.
Good afternoon everyone! Did you look into console? Kinda empty ya? Now, we
want to see something, isn't it? Let's make a logging function!
Creating project
As always, open IntelliJ Idea and create new project. Within the src
folder create 2 files: Main.java and LoggingTestBot.java . Let's create a
body of our bot:
src/LoggingTestBot.java
29
Lesson 3. Logging
public class LoggingTestBot extends TelegramLongPollingBot {

@Override

has text
) {
// Set variables

.setChatId(chat_id)
try {
to user
}
}
}
@Override
mazingBot'
return "LoggingTestBot";
}
@Override
}
}
30
Lesson 3. Logging
And our startup file:
src/Main.java
public class Main {


// Register our bot

try {
botsApi.registerBot(new LoggingTestBot());
}
System.out.println("LoggingTestBot successfully started!"
);
}
}
Logs, where are you?

Lets set additional variables for logging:
31
Lesson 3. Logging

text
// Set variables
String user_first_name = update.getMessage().getChat().g
etFirstName();
String user_last_name = update.getMessage().getChat().ge
tLastName();
String user_username = update.getMessage().getChat().get
UserName();
long user_id = update.getMessage().getChat().getId();

age object object
.setChatId(chat_id)
try {
ser
}
}
}
Create logging function:
Dont forget to import:
import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.util.Date;
Add new private function:
32
Lesson 3. Logging
private void log(String first_name, String last_name, String use

r_id, String txt, String bot_answer) {
System.out.println("\n ----------------------------");
DateFormat dateFormat = new SimpleDateFormat("yyyy/MM/dd
HH:mm:ss");
Date date = new Date();
System.out.println(dateFormat.format(date));
System.out.println("Message from " + first_name + " " +
last_name + ". (id = " + user_id + ") \n Text - " + txt);
System.out.println("Bot answer: \n Text - " + bot_answer
);
}
Now we need just call this function when we want to log
33
Lesson 3. Logging

text
// Set variables
String user_first_name = update.getMessage().getChat().g
etFirstName();
String user_last_name = update.getMessage().getChat().ge
tLastName();
String user_username = update.getMessage().getChat().get
UserName();
String answer = message_text;
age object object
.setChatId(chat_id)
.setText(answer);
log(user_first_name, user_last_name, Long.toString(user_
id), message_text, answer);
try {
ser
}
}
}
Our files:
src/Main.java
34
Lesson 3. Logging
;
public class Main {


// Register our bot

try {
botsApi.registerBot(new LoggingTestBot());
}
System.out.println("LoggingTestBot successfully started!"
);
}
}
src/LoggingTestBot.java
;
public class LoggingTestBot extends TelegramLongPollingBot {

@Override
35
Lesson 3. Logging

has text
) {
// Set variables
String user_first_name = update.getMessage().getChat
().getFirstName();
String user_last_name = update.getMessage().getChat(
).getLastName();
String user_username = update.getMessage().getChat()
.getUserName();
long user_id = update.getMessage().getChat().getId()
;
.setChatId(chat_id)
.setText(answer);
log(user_first_name, user_last_name, Long.toString(u
ser_id), message_text, answer);
try {
to user
}
}
}
@Override
mazingBot'
36
Lesson 3. Logging
return "LoggingTestBot";
}
@Override
}
private void log(String first_name, String last_name, String
user_id, String txt, String bot_answer) {
HH:mm:ss");
);
}
}
You can also find all sources at GitHub repository.
Now it will do ugly log for us:)
Well, thats all for now. In the next lesson we will learn how to make your
messages more beautiful with unicode emojis:).
37
Lesson 4. Emoji
Lesson 4. Emoji
Welcome back! Now your know, how to log messages from users. But how to
make bot's messages more user-friendly and beautiful? The answer is - emoji. I
think you know what is emoji, so let's move forward.
Now, open IntelliJ Idea and create a new project. Create files Main.java
and EmojiTestBot.java within the src directory. Here is first look of our
files:
src/Main.java
;
public class Main {


// Register our bot

try {
botsApi.registerBot(new EmojiTestBot());
}
System.out.println("EmojiTestBot successfully started!")
;
}
}
src/EmojiTestBot.java
38
Lesson 4. Emoji
;
public class EmojiTestBot extends TelegramLongPollingBot {

@Override

has text
) {
// Set variables
().getFirstName();
).getLastName();
;
.setChatId(chat_id)
.setText(answer);
try {
to user
}
39
Lesson 4. Emoji
}
}
@Override
mazingBot'
return "EmojiTestBot";
}
@Override
}
HH:mm:ss");
);
}
}
Okey. Now lets install emoji library:
Via Maven :
40
Lesson 4. Emoji
<dependency>
<groupId>com.vdurmont</groupId>
<artifactId>emoji-java</artifactId>
<version>3.1.3</version>
</dependency>
Via Gradle :
compile 'com.vdurmont:emoji-java:3.1.3'
Or just download .jar from here
Once library is installed, import it to your bot class:
import com.vdurmont.emoji.EmojiParser;
Now you can view list of emojis at EmojiPedia or Emoji Cheat Sheet. To insert
emoji, do this:
String answer = EmojiParser.parseToUnicode("Here is a smile emoj

i: :smile:\n\n Here is alien emoji: :alien:");
Where :smile: or :alien: is emoji alias or emoji short code. You can also
view them at EmojiPedia or Emoji Cheat Sheet.
Here is source code. You can also find it on GitHub.
src/Main.java
41
Lesson 4. Emoji
;
public class Main {


// Register our bot

try {
botsApi.registerBot(new EmojiTestBot());
}
System.out.println("EmojiTestBot successfully started!")
;
}
}
src/EmojiTestBot.java
import com.vdurmont.emoji.EmojiParser;
;
public class EmojiTestBot extends TelegramLongPollingBot {

@Override
42
Lesson 4. Emoji

has text
) {
// Set variables
().getFirstName();
).getLastName();
;
String answer = EmojiParser.parseToUnicode("Here is
a smile emoji: :smile:\n\n Here is alien emoji: :alien:");
.setChatId(chat_id)
.setText(answer);
try {
to user
}
}
}
@Override
mazingBot'
return "EmojiTestBot";
43
Lesson 4. Emoji
@Override
}
HH:mm:ss");
);
}
}
Now you can see our beautiful messages:
Our lesson came to an end. Thank you for reading this. See you soon!
44

I think, when you are reading this, you have created your own bot with the help
from my book. So now, its time to run it not on your home computer with Intel
Pentium II, but on professional server hardware. I will show how to deploy your
bot on DigitalOcean hosting.
Creating droplet
Firstly, you need to create account on DigitalOcean. Open this link to get 10$ as
gift from me, enter your email and password and click "Create an account"
45
Then, follow register insctructions. Once you are in your control panel, create a
new droplet.
Select OS. I recommend using Ubuntu 16.04.01 x64. Then choose preffered plan.
For Java bot, you can select 512-1GB RAM (its enough for start). Select
datacenter's region (I recommend to choose nearest city), scroll down and click
"Create". Check your email inbox for letter like this:
Connecting via SSH

You will need next software for that:
PuTTY SSH Client

FileZilla FTP Client
When you install it, open PuTTY and write server IP and port (default 22).
46
And click "Open". You will see something like:
Click "Yes". Then login as "root" user and with password that you have recieved
via email. Now we need to install Java on your server. Type following:
sudo apt-get update

sudo apt-get upgrade
sudo apt-get install default-jre
sudo apt-get install default-jdk
sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java8-installer
Type java -version to check installation. You will see something like that:
47
Creating and uploading JAR

Now, open IntelliJ Idea and go to File>Project Structure>Artifacts> + (Add
artifact)>JAR>From modules with dependencies>Select main class
( Main.java )>OK>Apply. Then Build>Build Artifacts>Build. Then in the
out/artifacts/ folder you will see your JAR.
Uploading to the server

Open FileZilla and enter IP address, username, password and port (default 22)
and click "Connect". Create new folder on your server (right window), open it and
upload you JAR by dragging it from left window (local computer) to right window
(server). Open PuTTY and type:
screen
Press ENTER and then go to your folder:
cd FOLDER_NAME
48
And just run your JAR:
java -jar FILE.jar
Well done! You are now hosting your bot at DigitalOcean. To exit terminal, press
CTRL + A + D and then type exit . To return, connect via SSH, type screen
-r and you will be returned to your screen session. To stop the bot: CTRL + C .
Well, that's all for now. See you soon!
49
Lesson 6. Inline keyboards and editing

message's text
I published poll in our Telegram chat about next lesson. So, as you are reading
this, Bots API 2.0 won.
On April 9, 2016, Telegram released Bot API 2.0 which allows you to edit
message's text and send new Inline Keyboards. So, let's implement it to your bot
and see how its beautiful. Now as always open IntelliJ Idea , within src
folder create files Main.java and BotApi20.java . First look:
src/BotApi20.java
50
public class BotApi20 extends TelegramLongPollingBot {

@Override

has text
) {
if (update.getMessage().getText().equals("/start"))
{
// Set variables
String message_text = update.getMessage().getTex
t();

.setChatId(chat_id)
try {
execute(message); // Sending our message obj
ect to user
}
} else {
}
}
@Override
mazingBot'
return "BotApi20Bot";
51
@Override
}
}
src/Main.java
;
public class Main {


// Register our bot

try {
botsApi.registerBot(new BotApi20());
}
}
}
I recommend you always look in the Bot API description so you know every
method and type. Okey, lets make bot answer to the /start command:
52

has text
) {
{

.setChatId(chat_id)
.setText("You send /start");
try {
ect to user
}
} else {
} else if (update.hasCallbackQuery()) {}
}
And now lets add Inline Keyboard to this message:

has text
) {
53
{

.setChatId(chat_id)
InlineKeyboardMarkup markupInline = new InlineKe
yboardMarkup();
List<List<InlineKeyboardButton>> rowsInline = new
ArrayList<>();
List<InlineKeyboardButton> rowInline = new Array
List<>();
rowInline.add(new InlineKeyboardButton().setText(
"Update message text").setCallbackData("update_msg_text"));
rowsInline.add(rowInline);
markupInline.setKeyboard(rowsInline);
message.setReplyMarkup(markupInline);
try {
ect to user
}
} else {
} else if (update.hasCallbackQuery()) {}
}
It looks like this now:
54
We want to edit message text right? Let's do it when user press our button. Add a
Callback Query handler to your bot:
else if (update.hasCallbackQuery()) {}
So if update has Callback query, it call this else if operator. Moving forward:
else if (update.hasCallbackQuery()) {
// Set variables
String call_data = update.getCallbackQuery().getData
();
long message_id = update.getCallbackQuery().getMessa
ge().getMessageId();
long chat_id = update.getCallbackQuery().getMessage(
).getChatId();
if (call_data.equals("update_msg_text")) {
String answer = "Updated message text";
EditMessageText new_message = new EditMessageTex
t()
.setChatId(chat_id)
.setMessageId(toIntExact(message_id))
.setText(answer);
try {
execute(new_message);
}
}
}
55
Now when user press our button it will change it's text:
Source:
src/Main.java
;
public class Main {


// Register our bot

try {
botsApi.registerBot(new BotApi20());
}
}
}
src/BotApi20.java
import org.telegram.telegrambots.api.methods.updatingmessages.Ed
itMessageText;
56
import org.telegram.telegrambots.api.objects.replykeyboard.Inlin
eKeyboardMarkup;
import org.telegram.telegrambots.api.objects.replykeyboard.butto
ns.InlineKeyboardButton;
;
import java.util.ArrayList;
import java.util.List;
import static java.lang.Math.toIntExact;
public class BotApi20 extends TelegramLongPollingBot {

@Override

has text
) {
{

.setChatId(chat_id)
InlineKeyboardMarkup markupInline = new InlineKe
yboardMarkup();
List<List<InlineKeyboardButton>> rowsInline = new
ArrayList<>();
List<InlineKeyboardButton> rowInline = new Array
List<>();
rowInline.add(new InlineKeyboardButton().setText(
"Update message text").setCallbackData("update_msg_text"));
57
rowsInline.add(rowInline);
markupInline.setKeyboard(rowsInline);
message.setReplyMarkup(markupInline);
try {
ect to user
}
} else {
} else if (update.hasCallbackQuery()) {
// Set variables
String call_data = update.getCallbackQuery().getData
();
long message_id = update.getCallbackQuery().getMessa
ge().getMessageId();
long chat_id = update.getCallbackQuery().getMessage(
).getChatId();
if (call_data.equals("update_msg_text")) {
String answer = "Updated message text";
EditMessageText new_message = new EditMessageTex
t()
.setChatId(chat_id)
.setMessageId(toIntExact(message_id))
.setText(answer);
try {
execute(new_message);
}
}
}
}
@Override
58

mazingBot'
return "BotApi20Bot";
}
@Override
}
}
You can also find all source code to all of my lessons at GitHub.
Thank you for reading this! Now you can send Inline Keyboards and edit
message's text and extra: handle callback queries. I hope you liked this lesson.
Next time I will show how to create users database using MongoDB. Bye!
59
Lesson 7. Creating users database with

MongoDB
Hey! As you're reading this, you know that I returned from Italy. It was very nice,
but okey - you want to create users database for your bot. Disputes about what
DB is better can live very long time, but I will choose MongoDB. It is high-
performance, schema-free document-oriented database. Let's create actual 'body'
of our bot. Well, as always. I will skip this step as I know you have your own bot
and there is no need to pollute the great lesson unnecessary amount of code. If
not, you can find all sources at GitHub repo. Now, import MongoDB's driver for
Java. You can download it here or import it from Maven. With IntelliJ Idea it is
easier than you expect. Just go to File < Project Structure... < Libraries < + <
From Maven and search for org.mongodb:mongo-java-driver . That's all.
Import it in your bot file:
import com.mongodb.MongoClient;
import com.mongodb.MongoClientURI;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import org.bson.Document;
import org.json.JSONObject;
You will also need org.slf4j:slf4j-nop library to disable additional logging,

like this:
11:01:15.406 [pool-1-thread-1] DEBUG org.mongodb.driver.protocol

.query - Query completed
11:01:25.174 [cluster-ClusterId{value='554dbecb1b554f11e86c3a69'
, description='null'}-localhost:27017] DEBUG org.mongodb.driver.
cluster - Checking status of localhost:27017
60
Install it from Maven as you did with MongoDB Java Driver. Let's write our "check"
function, that will check if user exists in database. If not, write it.
private String check(String first_name, String last_name, int us

er_id, String username) {
MongoClientURI connectionString = new MongoClientURI("mo
ngodb://host:port");
MongoClient mongoClient = new MongoClient(connectionStri
ng);
MongoDatabase database = mongoClient.getDatabase("db_nam
e");
MongoCollection<Document> collection = database.getColle
ction("users");
long found = collection.count(Document.parse("{id : " +
Integer.toString(user_id) + "}"));
if (found == 0) {
Document doc = new Document("first_name", first_name
)
.append("last_name", last_name)
.append("id", user_id)
.append("username", username);
collection.insertOne(doc);
mongoClient.close();
System.out.println("User not exists in database. Wri
tten.");
return "no_exists";
} else {
System.out.println("User exists in database.");
return "exists";
}
Don't do kernel panic, I will explain everything now.
Here we set new connection to MongoDB's server:
61
MongoClientURI connectionString = new MongoClientURI("mongodb://

host:port");
Replace host:port with your Mongo's host and port. You can find how to setup
MongoDB server for Ubuntu here. Then we set our database and collection.
Replace this names with your own.
MongoClient mongoClient = new MongoClient(connectionString);

MongoDatabase database = mongoClient.getDatabase("db_name");
MongoCollection<Document> collection = database.getCollection("u
sers");
We search users like this:
long found = collection.count(Document.parse("{id : " + Integer.

toString(user_id) + "}"));
And just check if user exists or not.
if (found == 0) {
)
tten.");
return "no_exists";
} else {
return "exists";
}
62
So now our full function looks like this:
private String check(String first_name, String last_name, int us

er_id, String username) {
// Set loggers
java.util.logging.Logger.getLogger("org.mongodb.driver")
.setLevel(Level.OFF);
MongoClientURI connectionString = new MongoClientURI("mo
ngodb://host:port");
MongoClient mongoClient = new MongoClient(connectionStri
ng);
MongoDatabase database = mongoClient.getDatabase("db_nam
e");
MongoCollection<Document> collection = database.getColle
ction("users");
long found = collection.count(Document.parse("{id : " +
Integer.toString(user_id) + "}"));
if (found == 0) {
)
tten.");
return "no_exists";
} else {
return "exists";
}
Just check if user exists in database by calling this function when user sends
/start :
63
import static java.lang.Math.toIntExact;
// Set variables
String user_first_name = update.getMessage().getChat().getFirstN
ame();
String user_last_name = update.getMessage().getChat().getLastNam
e();
String user_username = update.getMessage().getChat().getUserName
();
try {
sendMessage(message);
check(user_first_name, user_last_name, toIntExact(user_id),
user_username);
}
Well, that's all for now. Hope to see you soon!
Thanks for reading this.
MonsterDeveloper
64
search: keywords: ['lesson 8', '8', 'redis', 'database', 'fast database', 'lettuce']

Hi! Long time I haven't posted lessons. Sorry for that:) Today we are integrating
our highload bot with lighting fast database called Redis. I am using it for data that
needs quick access.
Library
For driver I chose Lettuce because of its popularity and good documentation. You
can download it here or install with Maven:
<dependency>
<groupId>io.lettuce</groupId>
<artifactId>lettuce-core</artifactId>
<version>Latest</version>
</dependency>
Establish connection
Then, you need to connect to Redis:
RedisClient redisClient;
StatefulRedisConnection<String, String> redisConnection;
RedisCommands<String, String> syncCommands;
redisClient = RedisClient.create("redis://localhost:6379/0"); //
Format: redis://ip:post/dbNumber
redisConnection = redisClient.connect();
syncCommands = this.redisConnection.sync();
65
Connection established
And thats all! Now you can execute commands like that:
syncCommands.get("key");
syncCommands.set("key", "value");
syncCommands.lrange("key", 0, -1);
Also, don't forget to close connection with Redis when you done your work:
redisConnection.close();
redisClient.shutdown();
Very short lesson, but I think useful :D Thanks for your time, hope to see you
soon!
66

Java Telegram Bot Course Guide

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Java Telegram Bot Course Guide

Hochgeladen von

Copyright:

Verfügbare Formate

Table

Writing bots for Telegram on Java

You can always contact me at Telegram: @MonsterDeveloper

You can find all sources at GitHub repository.

Lesson 1. Writing your first "echo" bot

Install the library

In this tutorial I will use next machines:

Ubuntu 16.04 Server with 1GB of RAM

Remember! The class must extends TelegramLongPollingBot and

As you can understand, getBotUsername() and getBotToken() must return

// We check if the update has a message and the message has

SendMessage message = new SendMessage() // Create a mess

// TODO Initialize Api Context

// TODO Instantiate Telegram Bots API

// TODO Register our bot

Now, lets initialize Api Context

// TODO Instantiate Telegram Bots API

// TODO Register our bot

Instantiate Telegram Bots API:

// TODO Register our bot

And register our bot:

// Instantiate Telegram Bots API

// Register our bot

Here is all our files:

// Instantiate Telegram Bots API

// Register our bot

// We check if the update has a message and the message

SendMessage message = new SendMessage() // Create a

You can find all sources to this lesson in GitHub repository.

java -jar MyAmazingBot.jar

Now we can see our bot running:

Well, thats all for now. Hope to see you soon!:)

Lesson 2. Photo bot.

Let's respect Telegram's servers

Dont forget to install TelegramBots library

public class Main {

TelegramBotsApi botsApi = new TelegramBotsApi();

public class PhotoBot extends TelegramLongPollingBot {

// We check if the update has a message and the message

Now lets update our onUpdateReceived method. We want to send file_id

// We check if the update has a message and the message has

else if (update.hasMessage() && update.getMessage().hasPhoto())

// Array with photo objects with different sizes

Lets take a look:

if (update.hasMessage() && update.getMessage().hasText()) {

// User sent /pic

Now bot sends photo like this:

And he can even reply to unknown command!

Now lets take a look at ReplyKeyboardMarkup. We will now create custom

Amazing! Now lets teach our bot to react on this buttons:

else if (message_text.equals("Row 1 Button 1")) {

public class Main {

TelegramBotsApi botsApi = new TelegramBotsApi();

public class PhotoBot extends TelegramLongPollingBot {

// We check if the update has a message and the message

List<PhotoSize> photos = update.getMessage().getPhot

sendPhoto(msg); // Call method to send the messa

public class LoggingTestBot extends TelegramLongPollingBot {

// We check if the update has a message and the message

SendMessage message = new SendMessage() // Create a

And our startup file:

public class Main {

// Instantiate Telegram Bots API