TamTam Bot SDK

TamTam Bot SDK is a simple library built on top of tamtam-bot-api that helps you to develop bots for TamTam quickly.

Both long-polling and webhook are supported.

Requirements

Minimum required version of Java is 8.

Long-polling

Long-polling is the easiest way to receive updates for your bot because it does not require running web server.

To start your bot just extends LongPollingBot class and add methods annotated by @UpdateHandler annotation.

These methods should have only one parameter of type Update. Every method will handle update of such type.

For example, simple bot that just does print incoming message to system console:

public class LoggingBot extends LongPollingBot {
    public LoggingBot(String accessToken) {
        super(accessToken);
    }

    @UpdateHandler
    public Object onMessageCreated(MessageCreatedUpdate update) {
        System.out.println(update.getMessage());
        return null; // return null if we do not want to reply
    }
}

All other updates will be ignored. If you want to handle all update types just override onUpdate method of LongPollingBot.

Alternatively, you can directly create instance of LongPollingBot and pass handlers in constructor:

LongPollingBot bot = new LongPollingBot("%ACCESS_TOKEN%", handler1, handler2); // handler can be any object that has methods annotated with `@UpdateHandler`

As soon as you created instance of this class you should start it:

LoggingBot bot = new LoggingBot("%ACCESS_TOKEN%");
bot.start();

This method starts separated non-daemon thread that polls Bot API in cycle. Call stop as soon as you ready to shutdown it:

bot.stop();

Check out EchoBot for more complete example.

Webhooks

TamTamIntegrationTest.setUp

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

This project is licensed under the Apache 2.0.