Criando um bot do Telegram em JavaScript: guia para iniciantes

Bot do Telegram em JavaScript: por onde começar e como não se confundir

Você já se perguntou como funcionam aqueles bots inteligentes no Telegram que enviam a previsão do tempo, lembram de prazos ou simplesmente fazem piadas engraçadas? E se eu te dissesse que escrever seu próprio bot do Telegram em JavaScript pode ser feito em uma noite? Sim, mesmo se você for iniciante. Neste guia, vamos analisar o processo de criação de um bot passo a passo, com exemplos de código reais e sem enrolação.

Por que JavaScript? Porque é uma linguagem versátil que funciona em qualquer lugar: em servidores, no navegador e até no Raspberry Pi. E com a biblioteca Telegraf, criar um bot do Telegram se torna um verdadeiro prazer. Pronto? Vamos lá!

O que precisamos para criar um bot do Telegram em JS

Antes de escrever código, vamos preparar as ferramentas. Você vai precisar de:

\n
• Node.js (versão 14 ou superior) — ambiente de execução JavaScript no servidor.
\n
• Editor de texto — Visual Studio Code, Sublime Text ou qualquer outro.
\n
• Conta no Telegram — claro, não dá para viver sem ela.
\n
• Terminal — linha de comando para instalar pacotes.
\n

Se o Node.js ainda não estiver instalado — baixe-o do site oficial. O processo de instalação é trivial: basta clicar em "Avançar".

Registro do bot e obtenção do token

O primeiro passo para criar um bot do Telegram em JavaScript é obter o token da API. É uma chave secreta que conecta seu código ao Telegram.

\n
1. Abra o Telegram e encontre o bot @BotFather.
\n
2. Envie o comando /newbot.
\n
3. Escolha um nome para o bot (por exemplo, MeuPrimeiroTestBot).
\n
4. Escolha um username único, terminando com bot (por exemplo, meu_primeiro_teste_2025_bot).
\n
5. Salve o token recebido — ele será mais ou menos assim: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz.
\n

Importante: o token é sua senha. Não mostre a ninguém e não o carregue no GitHub de forma exposta.

Instalação das bibliotecas e configuração do projeto

Agora vamos para o código. Crie uma pasta para o projeto, abra-a no terminal e execute:

npm init -y

Este comando criará o arquivo package.json. Agora instale a biblioteca principal — Telegraf:

npm install telegraf

Telegraf é uma biblioteca poderosa e simples para trabalhar com a Telegram Bot API em JavaScript. Ela suporta comandos, teclados, modo inline e muito mais.

Para facilitar, instale também o dotenv — ele ajudará a armazenar o token em um arquivo separado:

npm install dotenv

Crie um arquivo .env na raiz do projeto e escreva seu token:

BOT_TOKEN=seu_token_aqui

Não se esqueça de adicionar .env ao .gitignore se planeja publicar o código.

Escrevendo seu primeiro bot do Telegram em JavaScript

Crie um arquivo bot.js e abra-o no editor. Vamos começar com o mais simples — um bot que responde ao comando /start.

require('dotenv').config();\nconst { Telegraf } = require('telegraf');\n\nconst bot = new Telegraf(process.env.BOT_TOKEN);\n\nbot.start((ctx) => {\n    ctx.reply('Olá! Eu sou seu primeiro bot em JavaScript!');\n});\n\nbot.launch();\nconsole.log('Bot iniciado!');

Inicie o bot com o comando:

node bot.js

Abra seu bot no Telegram e clique em Start. Se tudo estiver correto, o bot responderá com uma saudação. Parabéns — você acabou de criar um bot do Telegram em JavaScript funcionando!