Cara Membuat Bot Telegram Pintar dengan API AI Python
Oleh Darus S Alfatah · 2025-09-08 · Tutorial · 10 menit
Catatan penulis: Bot Telegram yang rapi memotong balasan panjang; pengguna lebih suka potongan pendek daripada dinding teks.
Pendahuluan: Bot Telegram + AI
Telegram adalah platform favorit untuk bot karena API-nya gratis, mudah, dan mendukung banyak fitur. Menggabungkan bot Telegram dengan AI membuka banyak peluang: asisten pribadi, customer service otomatis, bot edukasi, sampai bot penjawab FAQ komunitas. Artikel ini memandu Anda membangun bot Telegram pintar menggunakan Python dan All in One API Key BankAI.
Persiapan
- Buat bot di Telegram via @BotFather, salin token bot.
- Install library:
pip install python-telegram-bot openai - Daftar di bankai.web.id dan salin API key.
Kode Bot Sederhana
import os
from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters
from openai import OpenAI
ai = OpenAI(base_url="https://bankai.web.id/api", api_key="sk-bankai-xxx")
async def start(update, context):
await update.message.reply_text("Halo! Kirim pertanyaan apa saja.✨")
async def chat(update, context):
user_text = update.message.text
resp = ai.chat.completions.create(
model="auto",
messages=[
{"role": "system", "content": "Kamu asisten Telegram yang ramah."},
{"role": "user", "content": user_text}
]
)
reply = resp.choices[0].message.content
await update.message.reply_text(reply)
app = Application.builder().token("TOKEN_BOT").build()
app.add_handler(CommandHandler("start", start))
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, chat))
app.run_polling()
Menambahkan Riwayat Percakapan
Agar bot "ingat" konteks percakapan, simpan riwayat chat di dictionary:
history = {}
async def chat(update, context):
uid = update.effective_user.id
if uid not in history:
history[uid] = []
history[uid].append({"role": "user", "content": update.message.text})
resp = ai.chat.completions.create(
model="auto",
messages=[{"role": "system", "content": "Asisten ramah."}] + history[uid][-10:]
)
reply = resp.choices[0].message.content
history[uid].append({"role": "assistant", "content": reply})
await update.message.reply_text(reply)
Ide Bot yang Bisa Dibuat
- Bot customer service untuk UMKM.
- Bot penjawab FAQ komunitas developer.
- Bot penerjemah bahasa otomatis.
- Bot asisten belajar untuk siswa.
Mulai bangun bot Telegram AI Anda sekarang dengan paket token BankAI — murah, QRIS, dan tanpa batas harian!
Menangani Percakapan Panjang
Telegram tidak membatasi panjang pesan pengguna secara ketat, tetapi model punya batas konteks dan biaya yang meningkat seiring riwayat. Simpan riwayat per pengguna di memori atau database, lalu kirim hanya beberapa pesan terakhir ditambah ringkasan percakapan sebelumnya. Ringkasan bisa dibuat otomatis ketika riwayat melewati ambang tertentu.
Markdown, Media, dan Batas Panjang Pesan
Jawaban model sering melebihi batas 4096 karakter per pesan Telegram. Pecah jawaban pada batas paragraf, bukan di tengah kata. Untuk format, gunakan mode HTML Telegram yang lebih mudah dikendalikan daripada Markdown, dan lakukan escape pada karakter khusus agar pesan tidak gagal terkirim.
Biaya dan Penyalahgunaan
Bot publik mudah disalahgunakan. Batasi jumlah permintaan per pengguna per jam, catat pemakaian token, dan sediakan perintah untuk mereset percakapan. Jika bot dipakai banyak orang, pertimbangkan sistem kuota harian yang jelas agar tagihan tetap terkendali.
Deployment
Gunakan long polling untuk memulai karena tidak memerlukan domain dan sertifikat. Setelah stabil, webhook lebih efisien untuk trafik tinggi. Pastikan proses berjalan dengan process manager agar otomatis restart, dan simpan token bot di environment, bukan di kode.
Menjaga Kualitas Jawaban
Bot yang menjawab cepat tetapi salah lebih merugikan daripada bot yang pelan tetapi akurat. Karena itu, selalu sertakan instruksi peran yang jelas, batasi topik yang boleh dibahas, dan minta format jawaban yang ringkas. Untuk pertanyaan di luar cakupan, arahkan pengguna ke kanal bantuan resmi alih-alih membiarkan model mengarang.
Uji bot dengan pertanyaan yang sengaja menjebak: pertanyaan ambigu, permintaan di luar topik, dan instruksi yang mencoba mengubah aturan sistem. Catat jawaban yang menyimpang, lalu perbaiki prompt atau tambahkan filter. Lakukan pengujian ini setiap kali model atau prompt berubah, karena perilaku dapat bergeser tanpa pemberitahuan.
Menyimpan Riwayat dengan Bijak
Riwayat percakapan adalah salah satu penyebab utama tagihan membengkak. Simpan hanya sepuluh pesan terakhir ditambah ringkasan, dan hapus data lama secara berkala. Jika bot dipakai untuk layanan pelanggan, pertimbangkan retensi maksimal tiga puluh hari agar sejalan dengan prinsip minimisasi data pada UU PDP.
Struktur Perintah yang Jelas
Sediakan perintah minimal: mulai, tanya, reset, dan bantuan. Batasi panjang input dan tampilkan pesan bantuan saat perintah tidak dikenali. Untuk percakapan panjang, gunakan tombol inline agar pengguna bisa memilih langkah berikutnya tanpa mengetik.
bot.on('message', async (msg) => {
const teks = (msg.text || '').slice(0, 2000);
if (!teks) return bot.sendMessage(msg.chat.id, 'Kirim teks ya.');
const riwayat = ambilRiwayat(msg.chat.id, 8);
const jawab = await chat([...riwayat, { role: 'user', content: teks }]);
simpanRiwayat(msg.chat.id, teks, jawab);
bot.sendMessage(msg.chat.id, potong(jawab, 4000));
});
Menjaga Biaya
Batasi riwayat yang dikirim, tetapkan kuota harian per pengguna, dan gunakan model murah untuk pertanyaan umum. Untuk grup besar, pertimbangkan hanya merespons ketika bot disebut.
Contoh balasan bertahap: Bot mengirim pesan sedang memproses, lalu mengirim hasil dalam potongan pendek. Pengguna tidak menunggu dalam sunyi.
Pertanyaan yang Sering Diajukan
Apakah tutorial ini bisa diikuti pemula?
Ya. Langkah-langkahnya dijelaskan berurutan dan menyertakan contoh kode, jadi bisa diikuti pemula maupun developer berpengalaman.
Apakah endpoint BankAI kompatibel dengan library yang sudah saya pakai?
Ya, BankAI 100% kompatibel dengan standar OpenAI, sehingga library seperti OpenAI SDK, LangChain, dan tools sejenis bisa dipakai tanpa mengubah kode selain Base URL dan API key.
Di mana saya mendapatkan API key untuk mengikuti tutorial ini?
API key (dan Secret Token) didapat setelah daftar dan menyelesaikan pembayaran di dashboard BankAI.