Como criar um bot do Telegram em Java: guia completo com código

Treinador Online de Python para Iniciantes

Aprenda Python facilmente sem sobrecarga teórica. Resolva tarefas práticas com verificação automática e escreva código diretamente no navegador.

Start Course

Bot do Telegram em Java: por onde começar e como não desistir no meio do caminho

Você já quis escrever seu próprio bot do Telegram, mas achou que era muito complicado? Apresso-me em alegrá-lo: criar um bot do Telegram em Java é uma tarefa que até um iniciante consegue realizar. Nada de mágica, apenas um plano claro e um pouco de código.

Neste guia, percorreremos todo o caminho, desde o registro do bot no Telegram até a publicação do aplicativo pronto. Você aprenderá como conectar a biblioteca TelegramBots, processar comandos, enviar mensagens e evitar erros comuns. No final, um modelo pronto que você poderá adaptar para suas próprias tarefas.

Por que Java? Esta linguagem oferece estabilidade, desempenho e uma enorme quantidade de soluções prontas. Para um bot do Telegram em Java, não é necessário instalar dezenas de dependências — tudo cabe em um único projeto Maven/Gradle. Vamos lá!

Passo 1: Registro do bot e obtenção do token

Antes de escrever código, você precisa "criar" o bot. Isso é feito através do bot principal do Telegram — BotFather.

Inicie o BotFather no Telegram e envie o comando:

/newbot

Em seguida, siga as instruções: escolha um nome (que será visível para os usuários) e um username (deve terminar com _bot). Após a criação bem-sucedida, você receberá um token — uma longa string no formato:

1234567890:ABCdefGHIjklmNOPqrstUVwxyz-1234567

Importante: o token é a chave para o seu bot. Não o mostre a ninguém, não o carregue em repositórios públicos. É melhor armazená-lo em variáveis de ambiente ou arquivos de configuração.

Passo 2: Criação do projeto e conexão das dependências

Usaremos o Maven — é prático e padrão para projetos Java. Se você prefere Gradle, o princípio é o mesmo, apenas reescreva as dependências para o seu formato.

Crie um projeto Java comum em sua IDE (IntelliJ IDEA, Eclipse ou NetBeans) e abra o arquivo pom.xml. Adicione a seguinte dependência:

<dependency>    <groupId>org.telegram</groupId>    <artifactId>telegrambots</artifactId>    <version>6.9.7.1</version></dependency>

Esta biblioteca — TelegramBots — é a mais popular para criar bots em Java. Ela suporta todas as funções principais: envio de mensagens, imagens, botões, trabalho com modo Inline e Webhooks.

Após adicionar a dependência, execute mvn clean install ou atualize o projeto na IDE para baixar a biblioteca.

Passo 3: Escrevendo o primeiro bot — classe base

Crie uma classe que herda de TelegramLongPollingBot. Esta classe será responsável por receber atualizações dos servidores do Telegram. Aqui está a estrutura mínima:

import org.telegram.telegrambots.bots.TelegramLongPollingBot;import org.telegram.telegrambots.meta.api.objects.Update;import org.telegram.telegrambots.meta.exceptions.TelegramApiException;

public class MySimpleBot extends TelegramLongPollingBot {

    @Override    public String getBotUsername() {        return "YourBotUsername"; // sem @    }

    @Override    public String getBotToken() {        return "YOUR_TOKEN_HERE";    }

    @Override    public void onUpdateReceived(Update update) {        // Aqui processaremos as mensagens        if (update.hasMessage() && update.getMessage().hasText()) {            String messageText = update.getMessage().getText();            long chatId = update.getMessage().getChatId();            System.out.println("Mensagem recebida: " + messageText + " do chat: " + chatId);        }    }}

Por enquanto, o bot apenas registra as mensagens recebidas. Vamos adicionar uma ação de resposta.