Menjalankan Bot Telegram Metode Polling di Ubuntu 24

Bot Telegram semakin banyak digunakan untuk berbagai kebutuhan, mulai dari layanan pelanggan, manajemen data, hingga penjualan produk digital. Salah satu pendekatan yang paling stabil dan profesional adalah menempatkan file bot Telegram langsung di server Linux, khususnya Ubuntu 24.04 LTS. Dengan cara ini, bot dapat berjalan non-stop 24 jam tanpa bergantung pada komputer pribadi.

Tulisan ini membahas secara lengkap konsep, manfaat, dan gambaran teknis menempatkan file bot Telegram di server Ubuntu 24, serta praktik terbaik agar aman, stabil, dan mudah dikelola.

Ubuntu 24.04 LTS merupakan sistem operasi server yang stabil, aman, dan memiliki dukungan jangka panjang. Beberapa keunggulannya antara lain:

Dengan Ubuntu 24, bot Telegram dapat dijalankan secara kontinu tanpa gangguan.

Secara umum, alur kerja bot Telegram di server adalah sebagai berikut:

Pendekatan ini membuat bot lebih rapi, terstruktur, dan profesional.

Agar mudah dikelola, gunakan struktur direktori yang jelas:

Struktur yang rapi memudahkan maintenance dan pengembangan lanjutan.

Menjalankan bot di server publik membutuhkan perhatian pada aspek keamanan:

Dengan praktik ini, risiko kebocoran data dapat diminimalkan.

Bot Telegram yang berada di server Ubuntu dapat diintegrasikan dengan:

Hal ini memungkinkan bot menjadi bagian dari sistem digital yang lebih besar, bukan sekadar chatbot sederhana.

Menjalankan bot di server memiliki banyak kelebihan:

Karena itu, server Ubuntu menjadi pilihan ideal untuk deployment bot Telegram.

1. Buat User Baru, silakan ganti namauser dengan nama yang Anda inginkan:

adduser namauser

2. Tambahkan user ke Grup sudo:

usermod -aG sudo namauser

3. Verifikasi grup user, pastikan ada sudo:

groups namauser

4. Login sebagai user baru:

su - namauser

5. Buat folder baru, misalnya bot:

mkdir ~/bot

Jika ingin langsung membuat folder lain didalamnya:

mkdir -p ~/bot/{quran}

6. Buka folder bot:

cd ~/bot

7. Contoh struktur folder dan file nantinya:

/home/namauser/bot/
└── quran/
    └── quran.py

8. Misalnya kita masuk ke folder quran:

cd ~/bot

9. Buat virtual environment(venv):

python3 -m venv venv

Akan muncul folder baru venv:

/home/namauser/bot/
└── quran/
└── venv/

10. Aktifkan virtual environment(venv):

source venv/bin/activate

11. Tanda venv aktif:

(venv) namauser@server:

12. Lakukan upgrade pip:

pip install --upgrade pip

Sebagai contoh library:

pip install pyTelegramBotAPI flask gunicorn cryptography openpyxl pandas speedtest-cli

13. Keluar dari venv:

deactivate

14. Download nodejs:

cd

curl -sL https://deb.nodesource.com/setup_22.x | sudo -E bash -

15. Instal nodejs:

sudo apt install nodejs -y

16. Perbarui npm:

sudo npm install -g npm@latest

17. Instal pm2:

sudo npm install -g pm2

18. Contoh script dengan nama quran.py:

sudo nano /home/namauser/bot/quran/quran.py

from telebot import TeleBot, types

# Ganti dengan token bot Anda
TOKEN = "ISI_TOKEN_BOT_ANDA"
bot = TeleBot(TOKEN, parse_mode="HTML")

# Handler untuk /start
@bot.message_handler(commands=['start'])
def send_welcome(message):
    markup = types.ReplyKeyboardMarkup(resize_keyboard=True, one_time_keyboard=False)
    markup.add('Daftar Surah', 'Jadwal Salat')
    markup.add('Bantuan Kami', 'Hubungi Kami')
    markup.add('Donasi', 'Hadis')
    bot.send_message(message.chat.id, f'Assalamu Alaikum, {message.from_user.first_name}')
    bot.send_message(message.chat.id, f"Silakan ketik kata yang ingin Anda cari atau gunakan format nomorSurah:nomorAyat untuk melakukan pencarian langsung", reply_markup=markup)

# Bot aktif
print('Bot sudah aktif')

# Polling
bot.polling()

19. Upload file quran.py dan quran.db dapat Anda cari di internet:

/home/namauser/bot/
└── venv/
└── quran/
    ├── quran.py
    └── quran.db

20. Kembali ke home:

cd

21. Buat file baru dengan nama ecosystem.config.js:

sudo nano ecosystem.config.js

22. Salin dan tempelkan kode dibawah ini pada ecosystem.config.js:

module.exports = {
  apps : [
    {
      name      : 'quran',
      script    : '/home/namauser/bot//quran/quran.py',
      interpreter: '/home/namauser/bot/venv/bin/python',
      cwd       : '/home/namauser/bot',
      env: {
        NODE_ENV: 'production'
      }
    }
  ]
};

23. Jalankan ecosystem.config.js menggunakan pm2:

pm2 start ecosystem.config.js

24. Konfigurasi pm2 agar bot aktif kembali setelah restart/reboot server:

pm2 startup

25. Simpan Konfigurasi pm2:

pm2 save

26. Salin dan tempelkan lagi ke terminal teks yang ditampilkan lalu enter, seperti:

sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u namauser --hp /home/namauser

23. Untuk melihat bot yang dijalankan pm2:

pm2 status

24. Untuk melakukan restart bot yang dijalankan pm2:

pm2 restart nama_bot

pm2 restart quran

25. Silakan buka aplikasi Telegram, buka bot Anda dan cobalah untuk memulai chat.

Menempatkan file bot Telegram di server Ubuntu 24 adalah langkah tepat bagi siapa pun yang ingin membangun bot secara serius dan berkelanjutan. Dengan sistem yang stabil, struktur rapi, dan keamanan yang baik, bot dapat berjalan optimal untuk jangka panjang.

Bagi pengembang, praktisi IT, maupun pemilik bisnis digital, pendekatan ini membuka peluang besar dalam otomasi dan layanan berbasis Telegram.