JavaTelegramBotAPI

(Telegram Bot API for Java)

What is this?

This is a java library for writing telegram bots. It lets you to write telegram bots simply and quickly. For report bugs and suggestion feature add issue or contact me via [email protected] .

Usage :

Initialize Bot:

Bot.initialize(your_token);

Bot is a singleton class and you should initialize your bot only once.

Make replyKeyboard

KeyboardButton button1 = new KeyboardButton("btn 1");
KeyboardButton button2 = new KeyboardButton("btn 2");
KeyboardButton button3 = new KeyboardButton("btn 3");
KeyboardButton button4 = new KeyboardButton("btn 4");
List<KeyboardButton> buttonGroup1 = new ArrayList<>();
buttonGroup1.add(button1);
buttonGroup1.add(button2);
List<KeyboardButton> buttonGroup2 = new ArrayList<>();
buttonGroup2.add(button3);
buttonGroup2.add(button4);
  
List<List<KeyboardButton>> buttonList = new ArrayList<>();
buttonList.add(buttonGroup1);
buttonList.add(buttonGroup2);
ReplyKeyboardMarkup replyKeyboardMarkup = new ReplyKeyboardMarkup();
replyKeyboardMarkup.setKeyboard(buttonList);

Get updates (without webhook)

List<Message> messageList = Bot.getInstance().getUpdates(new RequestGetUpdate());
    messageList.forEach((message -> {
        System.out.println(message.getChat().getChatId() + " --- " + message.getMessageId() + " --- " + message.getText());
    }));

Send Message

RequestSendMessage requestSendMessage = new RequestSendMessage(new Chat(74619619), "blah blah blah");
Bot.getInstance().sendMessage(requestSendMessage);

Upload photo

RequestSendPhoto requestUploadPhoto = new RequestSendPhoto();
requestUploadPhoto.setChat(chat);
requestUploadPhoto.setInputFile(new InputFile("/Users/Gladiator/Desktop/1.jpg"));
requestUploadPhoto.setReplyMarkup(replyKeyboardMarkup);
requestUploadPhoto.setCaption("Hacked stamp.");
Message responseUploadPhoto = Bot.getInstance().sendPhoto(requestUploadPhoto);

Resend photo by file_id

RequestSendPhoto requestSendPhoto = new RequestSendPhoto(chat, responseUploadPhoto.getPhoto().get(0));
requestSendPhoto.setReplyMarkup(replyKeyboardMarkup);
Bot.getInstance().sendPhoto(requestSendPhoto);

Send audio file

RequestSendAudio requestSendAudio = new RequestSendAudio();
requestSendAudio.setChat(chat);
requestSendAudio.setDisableNotification(false);
requestSendAudio.setInputFile(new InputFile("/Users/Gladiator/Desktop/1.mp3"));
requestSendAudio.setReplyMarkup(replyKeyboardMarkup);
Message responseUploadAudio = Bot.getInstance().sendAudio(requestSendAudio);

Send document

RequestSendDocument requestSendDocument = new RequestSendDocument();
requestSendDocument.setChat(chat);
requestSendDocument.setInputFile(new InputFile("/Users/Gladiator/Desktop/url.txt"));
requestSendDocument.setReplyMarkup(replyKeyboardMarkup);
Bot.getInstance().sendDocument(requestSendDocument);

Send video

RequestSendVideo requestSendVideo = new RequestSendVideo();
requestSendVideo.setChat(chat);
requestSendVideo.setInputFile(new InputFile("/Users/Gladiator/Desktop/1.mp4"));
requestSendVideo.setCaption("caption of file.");
Bot.getInstance().sendVideo(requestSendVideo);

Send location

RequestSendLocation requestSendLocation = new RequestSendLocation(chat, new Location(51.3253434, 35.7346714));
Bot.getInstance().sendLocation(requestSendLocation);

Send venue

RequestSendVenue requestSendVenue = new RequestSendVenue(chat, new Venue(new Location(51.3253434, 35.7346714), "Title venue test", "Sadegiyeh sq, abozar, payambaran hostpiral, room 307"));
Bot.getInstance().sendVenue(requestSendVenue);

Send contact

RequestSendContact requestSendContact= new RequestSendContact(chat, new Contact("+982144286253", "home"));
Bot.getInstance().sendContact(requestSendContact);

Send chat action

RequestSendChatAction requestSendChatAction = new RequestSendChatAction(chat, ChatActionEnum.TYPING);
boolean result = Bot.getInstance().sendChatAction(requestSendChatAction);

Get user profile photos and download files.

RequestGetUserProfilePhotos requestGetUserProfilePhotos = new RequestGetUserProfilePhotos(74619619);
UserProfilePhoto userProfilePhoto = Bot.getInstance().getUserProfilePhotos(requestGetUserProfilePhotos);
System.out.println("count: " + userProfilePhoto.getTotalCount());
RequestGetFile requestGetFile = new RequestGetFile();
RequestDownloadFile requestDownloadFile = new RequestDownloadFile();
requestDownloadFile.setPath("/Users/Gladiator/Desktop/TelegramBotApi/out");
userProfilePhoto.getPhotos().forEach((item) -> {
    item.forEach((photoSize) -> {
        System.out.println(photoSize.getFileId());
        requestGetFile.setFile(new File(photoSize.getFileId()));
        try {
            File file = Bot.getInstance().getFile(requestGetFile);
            System.out.println(file.getFile_id() + " --- " + file.getFile_path());
            requestDownloadFile.setUri(file.getFile_path());
            Bot.getInstance().downloadFile(requestDownloadFile);
        } catch (IOException e) {
            e.printStackTrace();
        }
      });
});

Get chat

Chat chat1 = Bot.getInstance().getChat(new RequestGetChat(chat));

Get Chat Administrators

Bot.getInstance().getChatAdministrators(new RequestGetChatAdministrators(new Chat(-169011245)));

Get chat members count

int count = Bot.getInstance().getChatMembersCount(new RequestGetChatMembersCount(new Chat(-169011245)));

Get chat member

ChatMember chatMember = Bot.getInstance().getChatMember(new RequestGetChatMember(new Chat(-1001093498802L), new User(74619619)));