Como criar um bot no Telegram e integrar com linguagens de programação

Introdução

E aí, pessoal! Se você sempre quis criar um bot no Telegram, mas achou que seria complicado, estou aqui para mostrar que é bem mais fácil do que parece. Neste post, vou te ensinar como criar um bot e fazer duas integrações diferentes: uma para enviar alertas via webhook e outra para criar um chatbot que conversa e responde. Vamos nessa?

Passo 1: Criando o bot no Telegram

1. Abra o Telegram e encontre o BotFather. O BotFather é o cara que vai te ajudar a criar e gerenciar o seu bot. Basta procurar por ele na busca do Telegram e iniciar uma conversa.
2. Crie o bot com o comando /newbot. O BotFather vai pedir um nome e um username para o bot. Lembre-se que o username precisa ser único e terminar com “bot” (por exemplo, MeuBotLegal).
3. Guarde o token de acesso. Após configurar tudo, o BotFather vai te dar um token. Esse token é a chave que permite que você controle o bot via código

Passo 2: Pegando o chat_id

Antes de começar a enviar mensagens ou configurar o bot para responder, você precisa pegar o chat_id, que é o identificador do chat onde o bot vai enviar mensagens.

Use a API do Telegram para pegar o chat_id. Você pode pegar o chat_id usando o seguinte script:

Python

Inicie uma conversa com o seu bot. Abra o chat com o seu bot no Telegram e envie uma mensagem, qualquer coisa, só para iniciar a interação.

import requests

# Substitua pelo seu token
TOKEN = 'seu_token_aqui'

# Pega as últimas atualizações do bot
response = requests.get(f'https://api.telegram.org/bot{TOKEN}/getUpdates').json()

# Extrai o chat_id da resposta
chat_id = response['result'][0]['message']['chat']['id']
print(f'Seu chat_id é: {chat_id}')

JavaScript (Node.js)

const axios = require('axios');
const token = 'seu_token_aqui';

axios.get(`https://api.telegram.org/bot${token}/getUpdates`)
  .then(response => {
    const chatId = response.data.result[0].message.chat.id;
    console.log('Seu chat_id é: ', chatId);
  })
  .catch(error => {
    console.error('Erro ao pegar chat_id: ', error);
  });

Anote o chat_id. Execute o script acima e você verá o chat_id no console. Anote esse ID porque você vai usá-lo nos próximos passos.

Passo 3: Exemplo 1 – Enviando alertas via webhook

Agora que você tem o chat_id, vamos começar com algo simples: enviar alertas pro Telegram usando um webhook. Isso é útil quando você quer ser notificado automaticamente sobre alguma coisa, tipo um erro no seu sistema.

Python

Instale a biblioteca requests.

pip install requests

Crie um script para enviar mensagens.

import requests

# Token e ID do chat
TOKEN = 'seu_token_aqui'
CHAT_ID = 'seu_chat_id_aqui'

def enviar_alerta(mensagem):
    url = f'https://api.telegram.org/bot{TOKEN}/sendMessage'
    data = {'chat_id': CHAT_ID, 'text': mensagem}
    requests.post(url, data=data)

enviar_alerta('⚠️ Alerta: Algo deu errado no sistema!')

JavaScript (Node.js)

Instale o axios para fazer as requisições.

npm install axios

Crie um script básico para enviar alertas.

const axios = require('axios');
const token = 'seu_token_aqui';
const chatId = 'seu_chat_id_aqui';
const message = '⚠️ Alerta: Algo deu errado no sistema!';

axios.post(`https://api.telegram.org/bot${token}/sendMessage`, {
    chat_id: chatId,
    text: message
}).then(response => {
    console.log('Mensagem enviada: ', response.data);
}).catch(error => {
    console.error('Erro ao enviar mensagem: ', error);
});

Execute o script e teste o envio do alerta.

Passo 4: Exemplo 2 – Criando um chatbot com interação

Agora, vamos deixar o negócio mais interessante: vamos criar um bot que responde às mensagens que você enviar para ele.

Python

Instale a biblioteca python-telegram-bot.

pip install python-telegram-bot

Crie um bot que responde a comandos.

from telegram import Update
from telegram.ext import Application, CommandHandler

# Token do Bot
TOKEN = 'seu_token_aqui'

async def start(update: Update, context):
    await update.message.reply_text('Oi! Como posso ajudar?')

async def help_command(update: Update, context):
    await update.message.reply_text('Aqui está a lista de comandos: /start, /help')

if __name__ == '__main__':
    # Cria a aplicação e adiciona os handlers
    application = Application.builder().token(TOKEN).build()

    application.add_handler(CommandHandler("start", start))
    application.add_handler(CommandHandler("help", help_command))

    # Inicia o bot
    application.run_polling()

JavaScript (Node.js)

Instale a biblioteca node-telegram-bot-api.

npm install node-telegram-bot-api

Crie um bot que responde aos comandos.

const TelegramBot = require('node-telegram-bot-api');
const token = 'seu_token_aqui';
const bot = new TelegramBot(token, {polling: true});

bot.onText(/\/start/, (msg) => {
    bot.sendMessage(msg.chat.id, "Oi! Como posso ajudar?");
});

bot.onText(/\/help/, (msg) => {
    bot.sendMessage(msg.chat.id, "Aqui está a lista de comandos: /start, /help");
});

Teste a interação com o seu bot.

Considerações finais

Pronto! Agora você sabe como criar um bot no Telegram, tanto para enviar alertas via webhook quanto para criar um chatbot interativo. Com esses exemplos, você pode começar a explorar mais funcionalidades e personalizar seu bot para fazer o que você quiser. Adicione suas capturas de tela onde indicado e compartilhe com a galera o que você criou!

---

Dica: Sempre proteja o token do seu bot e evite compartilhá-lo publicamente para garantir a segurança.