Panduan Lengkap: Membuat Bot Telegram Sederhana dengan Python untuk Notifikasi Keuangan Pribadi

Pendahuluan

Di era digital ini, mengelola keuangan pribadi menjadi semakin penting. Salah satu cara modern untuk mempermudah pengelolaan keuangan adalah dengan memanfaatkan teknologi, khususnya bot Telegram. Dengan Python, kita dapat membuat bot Telegram sederhana yang dapat memberikan notifikasi keuangan pribadi secara otomatis. Panduan ini akan membahas langkah demi langkah cara membuat bot Telegram dengan Python, mulai dari persiapan hingga implementasi.

Persiapan Awal

Sebelum memulai, ada beberapa hal yang perlu dipersiapkan:

• Python: Pastikan Python sudah terinstal di komputer Anda. Jika belum, unduh dan instal versi terbaru dari situs resmi Python.
• Library yang diperlukan: Kita akan menggunakan beberapa library Python, yaitu python-telegram-bot dan python-dotenv. Instal library ini menggunakan pip:

pip install python-telegram-bot python-dotenv

• Akun Telegram: Pastikan Anda memiliki akun Telegram yang aktif.
• Bot Telegram: Buat bot Telegram melalui BotFather dan dapatkan token API.

Langkah 1: Membuat Bot Telegram melalui BotFather

BotFather adalah bot resmi dari Telegram yang digunakan untuk membuat dan mengelola bot. Berikut langkah-langkahnya:

1. Buka aplikasi Telegram dan cari BotFather.
2. Ketik /start untuk memulai percakapan.
3. Ketik /newbot untuk membuat bot baru.
4. Ikuti instruksi yang diberikan BotFather untuk memberikan nama bot dan username bot.
5. Setelah selesai, BotFather akan memberikan token API bot Anda. Simpan token ini dengan aman karena akan digunakan dalam kode Python kita.

Langkah 2: Mengatur Environment Variables

Untuk menjaga keamanan token API bot, kita akan menggunakan environment variables. Buat file bernama .env di direktori proyek Anda dan tambahkan token API bot ke dalam file tersebut:

TELEGRAM_TOKEN=YOUR_TELEGRAM_BOT_TOKEN

Pastikan untuk mengganti YOUR_TELEGRAM_BOT_TOKEN dengan token API bot yang Anda dapatkan dari BotFather.

Langkah 3: Membuat File Python

Buat file Python, misalnya finance_bot.py, dan mulai tulis kode berikut:

import telegram
from telegram.ext import Updater, CommandHandler, MessageHandler, Filters
import os
from dotenv import load_dotenv

# Load environment variables
load_dotenv()
TELEGRAM_TOKEN = os.environ.get("TELEGRAM_TOKEN")

# Fungsi untuk memulai bot
def start(update, context):
    context.bot.send_message(chat_id=update.effective_chat.id, text="Halo! Saya adalah bot keuangan pribadi Anda.")

# Fungsi untuk menangani pesan teks
def echo(update, context):
    context.bot.send_message(chat_id=update.effective_chat.id, text=update.message.text)

# Fungsi untuk menampilkan bantuan
def help(update, context):
    help_text = "Berikut adalah perintah yang tersedia:\n"
    help_text += "/start - Memulai bot\n"
    help_text += "/help - Menampilkan bantuan\n"
    context.bot.send_message(chat_id=update.effective_chat.id, text=help_text)

# Fungsi untuk menangani error
def error(update, context):
    print(f"Update {update} menyebabkan error {context.error}")

# Main function
def main():
    # Buat updater dan pass token bot
    updater = Updater(TELEGRAM_TOKEN, use_context=True)

    # Dapatkan dispatcher untuk mendaftarkan handler
    dp = updater.dispatcher

    # Tambahkan handler untuk perintah /start
    dp.add_handler(CommandHandler("start", start))

    # Tambahkan handler untuk perintah /help
    dp.add_handler(CommandHandler("help", help))

    # Tambahkan handler untuk pesan teks (echo)
    dp.add_handler(MessageHandler(Filters.text, echo))

    # Tambahkan handler untuk error
    dp.add_error_handler(error)

    # Mulai bot
    updater.start_polling()

    # Jalankan bot sampai dihentikan secara manual
    updater.idle()

if __name__ == '__main__':
    main()

Langkah 4: Menjelaskan Kode

Mari kita bahas kode di atas:

• Import library: Mengimpor library yang diperlukan, yaitu telegram, Updater, CommandHandler, MessageHandler, Filters, os, dan load_dotenv.
• Load environment variables: Memuat token API bot dari file .env.
• Fungsi start: Menangani perintah /start dan mengirimkan pesan sapaan.
• Fungsi echo: Menangani pesan teks dan mengirimkan kembali pesan yang sama (echo).
• Fungsi help: Menangani perintah /help dan menampilkan daftar perintah yang tersedia.
• Fungsi error: Menangani error yang terjadi selama proses.
• Fungsi main:
  • Membuat Updater dan Dispatcher.
  • Menambahkan handler untuk setiap perintah dan pesan.
  • Memulai bot dengan updater.start_polling().
  • Menjalankan bot sampai dihentikan secara manual dengan updater.idle().

Langkah 5: Menjalankan Bot

Buka terminal atau command prompt, arahkan ke direktori proyek Anda, dan jalankan file Python:

python finance_bot.py

Bot Anda sekarang seharusnya sudah berjalan. Buka Telegram dan cari bot Anda, lalu kirim perintah /start untuk memulai percakapan.

Implementasi Notifikasi Keuangan

Setelah bot dasar berjalan, kita dapat menambahkan fitur notifikasi keuangan. Berikut adalah beberapa langkah untuk mengimplementasikan fitur ini:

1. Membuat Fungsi untuk Mengirim Notifikasi

Buat fungsi yang akan mengirimkan notifikasi keuangan ke pengguna. Misalnya, kita ingin mengirimkan notifikasi setiap kali ada pengeluaran baru:

def send_expense_notification(chat_id, expense_description, expense_amount):
    message = f"Pengeluaran baru tercatat:\nDeskripsi: {expense_description}\nJumlah: {expense_amount}"
    bot.send_message(chat_id=chat_id, text=message)

2. Menyimpan Data Keuangan

Untuk menyimpan data keuangan, kita dapat menggunakan database sederhana seperti SQLite atau file teks. Dalam contoh ini, kita akan menggunakan file teks:

def save_expense(description, amount):
    with open("expenses.txt", "a") as file:
        file.write(f"{description},{amount}\n")

3. Menambahkan Handler untuk Menerima Input Pengeluaran

Tambahkan handler yang akan menerima input pengeluaran dari pengguna:

def add_expense(update, context):
    chat_id = update.effective_chat.id
    try:
        # Mendapatkan deskripsi dan jumlah dari argumen
        description = context.args[0]
        amount = float(context.args[1])

        # Menyimpan pengeluaran
        save_expense(description, amount)

        # Mengirim notifikasi
        send_expense_notification(chat_id, description, amount)

        context.bot.send_message(chat_id=chat_id, text="Pengeluaran berhasil ditambahkan!")

    except (IndexError, ValueError):
        context.bot.send_message(chat_id=chat_id, text="Penggunaan: /add_expense [deskripsi] [jumlah]")

Kemudian tambahkan handler ini ke dispatcher:

dp.add_handler(CommandHandler("add_expense", add_expense, pass_args=True))

4. Menguji Fitur Notifikasi

Jalankan kembali bot Anda dan coba tambahkan pengeluaran dengan perintah /add_expense [deskripsi] [jumlah]. Misalnya:

/add_expense MakanSiang 25000

Anda akan menerima notifikasi di Telegram yang berisi deskripsi dan jumlah pengeluaran yang baru saja Anda tambahkan.

Fitur Tambahan

Selain fitur notifikasi pengeluaran, Anda dapat menambahkan fitur lain untuk memperkaya fungsionalitas bot keuangan Anda:

• Menampilkan Riwayat Pengeluaran: Menambahkan perintah untuk menampilkan riwayat pengeluaran dari file expenses.txt.
• Kategori Pengeluaran: Mengelompokkan pengeluaran berdasarkan kategori (misalnya, makanan, transportasi, hiburan).
• Target Anggaran: Menetapkan target anggaran bulanan dan memberikan notifikasi jika anggaran hampir habis.
• Integrasi dengan API Keuangan: Mengintegrasikan bot dengan API keuangan untuk mendapatkan data pasar saham, nilai tukar mata uang, dan informasi keuangan lainnya.

Keamanan

Keamanan adalah aspek penting dalam pengembangan bot Telegram, terutama yang berhubungan dengan data keuangan. Berikut adalah beberapa tips untuk menjaga keamanan bot Anda:

• Simpan Token API dengan Aman: Jangan pernah membagikan token API bot Anda kepada siapa pun. Simpan token API di environment variables dan hindari menyimpannya langsung di kode.
• Validasi Input Pengguna: Selalu validasi input yang diberikan oleh pengguna untuk mencegah serangan injeksi.
• Gunakan HTTPS: Pastikan semua komunikasi antara bot dan server Telegram menggunakan HTTPS untuk melindungi data dari penyadapan.
• Batasi Akses: Batasi akses ke bot hanya untuk pengguna yang terpercaya. Anda dapat menggunakan whitelist pengguna atau mekanisme otentikasi lainnya.

Kesimpulan

Membuat bot Telegram sederhana dengan Python untuk notifikasi keuangan pribadi adalah cara yang efektif untuk mempermudah pengelolaan keuangan Anda. Dengan mengikuti panduan ini, Anda dapat membuat bot yang sesuai dengan kebutuhan Anda dan menambahkan fitur-fitur yang bermanfaat. Selamat mencoba dan semoga berhasil!