com.asdamp.telegram.botapi

Class TelegramBot

java.lang.Object

com.asdamp.telegram.botapi.TelegramBot

public abstract class TelegramBot
extends java.lang.Object

This class represents a TelegramBot. To use it, use any of the available subclasses or subclass it yourself.

Constructor Summary

Constructors

Constructor and Description
TelegramBot(java.lang.String botToken) Constructs a TelegramBot using the provided botToken.

Method Summary

Methods

Modifier and Type	Method and Description
Message	forwardMessage(int chatId, int fromChatId, int messageId) Forwards a message with ID messageId from fromChatId to chatId.
User	getMe() A simple method for testing your bot's auth token.
UserProfilePhotos	getUserProfilePhotos(int userId)
UserProfilePhotos	getUserProfilePhotos(int userId, OptionalArgs optionalArgs) Returns a UserProfilePhotos for a user.
protected void	notifyNewMessage(Message message) This method is called by this class to process all new Messages .
void	notifyNewUpdate(Update update) This method is called by another class to process all new Updates asynchronously.
protected void	onMessage(Message message) This method is called when a new message has arrived.
protected void	onStart()
protected void	onStop()
Message	replyTo(Message message, java.lang.String text) Convenience method for sendMessage(message.getChat().getId(), text, new OptionalArgs().replyToMessageId(message.getMessageId()))
Message	sendAudio(int chatId, java.io.File audioFile)
Message	sendAudio(int chatId, java.io.File audioFile, OptionalArgs optionalArgs) Use this method to send audio files, if you want Telegram clients to display the file as a music playable with the internal player.
Message	sendAudio(int chatId, java.lang.String audioFileId)
Message	sendAudio(int chatId, java.lang.String audioFileId, OptionalArgs optionalArgs) This version takes a file id instead of a File, as a String argument.
java.lang.Boolean	sendChatAction(int chatId, ChatAction chatAction) Use this method when you need to tell the user that something is happening on the bot's side.
Message	sendDocument(int chatId, java.io.File documentFile)
Message	sendDocument(int chatId, java.io.File documentFile, OptionalArgs optionalArgs) Use this method to send general files.
Message	sendDocument(int chatId, java.lang.String documentFileId)
Message	sendDocument(int chatId, java.lang.String documentFileId, OptionalArgs optionalArgs) This version takes a file id instead of a File.
Message	sendLocation(int chatId, float latitude, float longitude)
Message	sendLocation(int chatId, float latitude, float longitude, OptionalArgs optionalArgs) Use this method to send point on the map.
Message	sendMessage(int chatId, java.lang.String text)
Message	sendMessage(int chatId, java.lang.String text, OptionalArgs optionalArgs) Use this method to send text messages.
Message	sendPhoto(int chatId, java.io.File photoFile)
Message	sendPhoto(int chatId, java.io.File photoFile, OptionalArgs optionalArgs) Use this method to send photos.
Message	sendPhoto(int chatId, java.lang.String photoFileId)
Message	sendPhoto(int chatId, java.lang.String photoFileId, OptionalArgs optionalArgs) This version takes a file id instead of a File
Message	sendSticker(int chatId, java.io.File stickerFile)
Message	sendSticker(int chatId, java.io.File stickerFile, OptionalArgs optionalArgs) Use this method to send .webp stickers.
Message	sendSticker(int chatId, java.lang.String stickerFileId)
Message	sendSticker(int chatId, java.lang.String stickerFileId, OptionalArgs optionalArgs) This version takes a file id instead of a File.
Message	sendVideo(int chatId, java.io.File videoFile)
Message	sendVideo(int chatId, java.io.File videoFile, OptionalArgs optionalArgs) Use this method to send video files, Telegram clients support mp4 videos (other formats may be sent as Document (sendDocument(int, File, OptionalArgs))).
Message	sendVideo(int chatId, java.lang.String videoFileId)
Message	sendVideo(int chatId, java.lang.String videoFileId, OptionalArgs optionalArgs) This version uses a file id rather than a File
void	start() Starts the bot.
void	stop() Stops the bot.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TelegramBot

public TelegramBot(java.lang.String botToken)

Constructs a TelegramBot using the provided botToken.

Parameters:

botToken - The token provided by @BotFather

Method Detail

start

public final void start()

Starts the bot.

onStart

protected void onStart()

stop

public final void stop()

Stops the bot.

onStop

protected void onStop()

forwardMessage

public final Message forwardMessage(int chatId,
                     int fromChatId,
                     int messageId)

Forwards a message with ID messageId from fromChatId to chatId.

Parameters:

chatId - Unique identifier for the message recipient — User or GroupChat id

fromChatId - Unique identifier for the chat where the original message was sent — User or GroupChat id

messageId - Unique message identifier

Returns:

The sent Message

See Also:

https://core.telegram.org/bots/api#forwardmessage

getMe

public final User getMe()

A simple method for testing your bot's auth token. Requires no parameters. Returns basic information about the bot in form of a User object.

Returns:

this bot's information, in the form of a User

See Also:

https://core.telegram.org/bots/api#getme

getUserProfilePhotos

public final UserProfilePhotos getUserProfilePhotos(int userId)

See Also:

getUserProfilePhotos(int, OptionalArgs)

getUserProfilePhotos

public final UserProfilePhotos getUserProfilePhotos(int userId,
                                     OptionalArgs optionalArgs)

Returns a UserProfilePhotos for a user. For any optional arguments, refer to the Telegram documentation.

Parameters:

userId - Unique identifier of the target user

optionalArgs - Any optional arguments for this method

Returns:

The requested UserProfilePhotos

See Also:

https://core.telegram.org/bots/api#getuserprofilephotos, OptionalArgs

sendAudio

public final Message sendAudio(int chatId,
                java.io.File audioFile)

See Also:

sendAudio(int, File, OptionalArgs)

sendAudio

public final Message sendAudio(int chatId,
                java.io.File audioFile,
                OptionalArgs optionalArgs)

Use this method to send audio files, if you want Telegram clients to display the file as a music playable with the internal player. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. For any optional arguments, refer to the Telegram documentation.

Parameters:

chatId - Unique identifier for the message recipient - User or GroupChat id

audioFile - Audio File to send

optionalArgs - Any optional arguments for this method

Returns:

The sent Message

See Also:

https://core.telegram.org/bots/api#sendaudio

sendAudio

public final Message sendAudio(int chatId,
                java.lang.String audioFileId)

See Also:

sendAudio(int, String, OptionalArgs)

sendAudio

public final Message sendAudio(int chatId,
                java.lang.String audioFileId,
                OptionalArgs optionalArgs)

This version takes a file id instead of a File, as a String argument.

See Also:

sendAudio(int, File, OptionalArgs)

sendChatAction

public final java.lang.Boolean sendChatAction(int chatId,
                               ChatAction chatAction)

Use this method when you need to tell the user that something is happening on the bot's side. The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status).

Parameters:

chatId - Unique identifier for the message recipient - User or GroupChat id.

chatAction - The target ChatAction

Returns:

True if the request was successful

See Also:

https://core.telegram.org/bots/api#sendchataction

sendDocument

public final Message sendDocument(int chatId,
                   java.io.File documentFile)

See Also:

sendAudio(int, File, OptionalArgs)

sendDocument

public final Message sendDocument(int chatId,
                   java.io.File documentFile,
                   OptionalArgs optionalArgs)

Use this method to send general files. On success, the sent Message is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. For any optional arguments, refer to the Telegram documentation.

Parameters:

chatId - Unique identifier for the message recipient - User or GroupChat id

documentFile - File to send

optionalArgs - Any optional arguments

Returns:

The sent Message

See Also:

https://core.telegram.org/bots/api#senddocument

sendDocument

public final Message sendDocument(int chatId,
                   java.lang.String documentFileId)

See Also:

sendDocument(int, String, OptionalArgs)

sendDocument

public final Message sendDocument(int chatId,
                   java.lang.String documentFileId,
                   OptionalArgs optionalArgs)

This version takes a file id instead of a File.

See Also:

sendDocument(int, File, OptionalArgs)

sendLocation

public final Message sendLocation(int chatId,
                   float latitude,
                   float longitude)

See Also:

sendLocation(int, float, float, OptionalArgs)

sendLocation

public final Message sendLocation(int chatId,
                   float latitude,
                   float longitude,
                   OptionalArgs optionalArgs)

Use this method to send point on the map. For any optional arguments, refer to the Telegram documentation.

Parameters:

chatId - Unique identifier for the message recipient - User or GroupChat id

latitude - Latitude of location

longitude - Longitude of location

optionalArgs - Any optional arguments

Returns:

the sent Message

See Also:

https://core.telegram.org/bots/api#sendlocation

sendMessage

public final Message sendMessage(int chatId,
                  java.lang.String text)

See Also:

sendMessage(int, String, OptionalArgs)

sendMessage

public final Message sendMessage(int chatId,
                  java.lang.String text,
                  OptionalArgs optionalArgs)

Use this method to send text messages. For any optional arguments, refer to the Telegram documentation.

Parameters:

chatId - Unique identifier for the message recipient - User or GroupChat id

text - Text of the message to be sent

optionalArgs - Any optional arguments

Returns:

the sent Message

See Also:

https://core.telegram.org/bots/api#sendmessage

sendPhoto

public final Message sendPhoto(int chatId,
                java.io.File photoFile)

See Also:

sendPhoto(int, File, OptionalArgs)

sendPhoto

public final Message sendPhoto(int chatId,
                java.io.File photoFile,
                OptionalArgs optionalArgs)

Use this method to send photos.

Parameters:

chatId - Unique identifier for the message recipient - User or GroupChat id

photoFile - Photo to send

optionalArgs - Any optional arguments

Returns:

The sent Message

See Also:

https://core.telegram.org/bots/api#sendphoto

sendPhoto

public final Message sendPhoto(int chatId,
                java.lang.String photoFileId)

See Also:

sendPhoto(int, String, OptionalArgs)

sendPhoto

public final Message sendPhoto(int chatId,
                java.lang.String photoFileId,
                OptionalArgs optionalArgs)

This version takes a file id instead of a File

See Also:

sendPhoto(int, File, OptionalArgs)

sendSticker

public final Message sendSticker(int chatId,
                  java.io.File stickerFile)

See Also:

sendSticker(int, File, OptionalArgs)

sendSticker

public final Message sendSticker(int chatId,
                  java.io.File stickerFile,
                  OptionalArgs optionalArgs)

Use this method to send .webp stickers. For any optional arguments, refer to the Telegram documentation.

Parameters:

chatId - Unique identifier for the message recipient - User or GroupChat id

stickerFile - Sticker to send.

optionalArgs - Any optional arguments

Returns:

The sent Message

See Also:

https://core.telegram.org/bots/api#sendsticker

sendSticker

public final Message sendSticker(int chatId,
                  java.lang.String stickerFileId)

See Also:

sendSticker(int, String, OptionalArgs)

sendSticker

public final Message sendSticker(int chatId,
                  java.lang.String stickerFileId,
                  OptionalArgs optionalArgs)

This version takes a file id instead of a File.

See Also:

sendSticker(int, File, OptionalArgs)

sendVideo

public final Message sendVideo(int chatId,
                java.io.File videoFile)

See Also:

sendVideo(int, File, OptionalArgs)

sendVideo

public final Message sendVideo(int chatId,
                java.io.File videoFile,
                OptionalArgs optionalArgs)

Use this method to send video files, Telegram clients support mp4 videos (other formats may be sent as Document (sendDocument(int, File, OptionalArgs))). Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. For any optional arguments, refer to the Telegram documentation.

Parameters:

chatId - Unique identifier for the message recipient - User or GroupChat id

videoFile - Video to send

optionalArgs - Any optional arguments.

Returns:

The sent Message

See Also:

https://core.telegram.org/bots/api#sendvideo

sendVideo

public final Message sendVideo(int chatId,
                java.lang.String videoFileId)

See Also:

sendVideo(int, File, OptionalArgs)

sendVideo

public final Message sendVideo(int chatId,
                java.lang.String videoFileId,
                OptionalArgs optionalArgs)

This version uses a file id rather than a File

See Also:

sendVideo(int, File, OptionalArgs)

replyTo

public final Message replyTo(Message message,
              java.lang.String text)

Convenience method for sendMessage(message.getChat().getId(), text, new OptionalArgs().replyToMessageId(message.getMessageId()))

onMessage

protected void onMessage(Message message)

This method is called when a new message has arrived. It can safely be overridden by subclasses.

Parameters:

message - The newly arrived Message

notifyNewMessage

protected void notifyNewMessage(Message message)

This method is called by this class to process all new Messages .

Parameters:

message - The newly arrived Message

notifyNewUpdate

public void notifyNewUpdate(Update update)

This method is called by another class to process all new Updates asynchronously.

Parameters:

update - The newly arrived Updates