bangHasan

bangHasan

Peradaban dimulai dari terkecil, diri kita sendiri.

Bot Telegram - Bot Gedebug untuk Mengelola Sebuah Grup

7 menit saja |

Mengelola Sebuah Grup di Telegram Menggunakan Bot GeDebug

Akhirnya di bulan januari ini ada sebuah tulisan pada blog ini, semoga bermanfaat yak โ˜บ๏ธ

Pengantar

Update: Tutorial ini sudah gak berlaku, karena sudah diupdate versi 2. Dokumentasi dan perubahan bisa di cek di sini

Bot GeDebug awalnya saya buat untuk mendebug sebuah pesan saat developing sebuah bot di Telegram. Namun seiring waktu, malah ditambah-tambah fiturnya buat mengelola sebuah grup di Telegram. Yang kemudian malah menjadi bot utama buat grup @botphp.

Jika diliat tutorial atau manual book ini memang terlihat sangat panjang. Karena memang hal yang ditulis ternyata selalu menjadi lebih panjang jika dipraktekkan langsung :-D

Akan tetapi, dokumentasi tetap menjadi sesuatu yang sangat penting. Maka manual book ini diharapkan bisa dibaca pelan-pelan jika ada waktu dan senggang.

Jika ingin praktek secara cepat, langsung saja menuju ke Video Tutorialnya saja.

Start Gedebug

๐Ÿ’ Fitur

  • Mendebug Pesan
  • Menampilkan ulang media (foto, video, dokumen, sticker)
  • Mendapatkan link pesan super grup (public)
  • Membuat tombol secara inline
  • Membuat pesan berformat markdown dan html
  • Membuat peringatan jika seseorang di mention (username nya disebut orang) pada grup
  • Membuat pesan hashtags yang dapat dipanggil ulang
  • Menampilkan statistik hashtags yang sudah diseting di grup
  • Mengetahui admin grup, bisa untuk grup lain
  • Mengetahui status user (info ID telegram user) di grup
  • Menendang user (kick) di grup
  • Membuat pesan welcome atau sambutan user yang baru masuk ke grup
  • Membuat link/tombol inline pada pesan welcome
  • Informasi total user yang masuk ke grup
  • Dan fitur lainnya yang belum terdokumentasikan, bahkan sering saya lupa. Ingatnya kalau pas butuh lagi hehe

Start Help

๐Ÿž Debugging Pesan

Inilah awal tujuan gedebug dibuat. Diperuntukkan buat para developer bot, yang akan mempermudah saat proses membuat bot.

Hasil dari debugging pesan di tampilkan dalam format JSON yang mudah dibaca atau dilihat.

Penggunaannya:

Reply (balas) sebuah pesan yang ingin di debug, ketikkan !debug atau !d

Debug Pesan

Contoh Hasilnya:

    "message_id": 278098,
    "from": {
        "id": 213567634,
        "first_name": "โ€bangHasanโ€โ€ฎ",
        "username": "hasanudinhs"
    },
    "chat": {
        "id": 213567634,
        "first_name": "โ€bangHasanโ€โ€ฎ",
        "username": "hasanudinhs",
        "type": "private"
    },
    "date": 1484631764,
    "forward_from": {
        "id": 213567634,
        "first_name": "โ€bangHasanโ€โ€ฎ",
        "username": "hasanudinhs"
    },
    "forward_date": 1484631750,
    "video": {
        "duration": 18,
        "width": 400,
        "height": 230,
        "thumb": {
            "file_id": "AAQFABMYiMoyAARJROuMzZcseEUoAAIC",
            "file_size": 1128,
            "width": 90,
            "height": 52
        },
        "file_id": "BAADBQADzwADksi6DHMFxpcMtvSoAg",
        "file_size": 423595
    },
    "caption": "ini stylus note keren ๐Ÿ˜ƒ"
}
~~~~~~~~
From User ID= 213567634
From Chat ID= 213567634
Fwd User ID= 213567634

Dari data di atas, dapat diketahui pesan tersebut memiliki id pesan berapa, dikirim ke siapa, di jendela chat mana, dan di foward oleh siapa. Serta keterangan-keterangan lainnya.

Selain itu ada data penting lain yakni file ID sebuah video adalah : BAADBQADzwADksi6DHMFxpcMtvSoAg

ID video tersebut dapat dipanggil ulang dengan perintah: !video BAADBQADzwADksi6DHMFxpcMtvSoAg maka gedebug akan menampilkan ulang atau mengirim kembali file video tersebut.

Itulah yang dimaksud fitur mengirim ulang file, yang dapat juga berlaku untuk file dokumen, audio, ataupun sticker.

Notifikasi Mention

๐ŸŽญ Notifikasi Mention

Gedebug akan memberikan notifikasi secara otomatis, kepada siapa saja yang telah klik START gedebug. Misalnya username saya adalah: @hasanudinhs di Telegram

Maka jika disebuah grup ada yang menyebut usernameku, maka gedebug akan memberitahu ada seseorang yang mention dan isi pesannya apa.

Fitur ini sangat berarti sekali jika kita ikut banyak grup dan kita sulit untuk memantau. Maka dengan bantuan mention akan segera kita ketahui ada orang yang memanggil namamu.

Notifikasi Mention ini memiliki 2 karakteristik hasil:

  • Super Grup Public akan diberi tahu pesan sekaligus link menuju pesannya
  • Super Grup Private atau Grup Biasa maka hanya diberi tahu isi pesannya saja

Notifikasi Mention

๐Ÿ”˜ Tombol Inline

Ini adalah fitur untuk membuat sebuah tombol inline, yang sering dipakai untuk pesan di grup maupun di channel. Dengan adanya bot inline, tidak perlu gedebug ada disebuah grup atau channel bisa memanfaat fitur ini.

Namun pesan yang ditampilkan tidak bisa panjang karena memang terdapat pembatasan oleh Telegram sendiri.

Tombol inline yang dihasilkan saat ini, dibatasi 1 tombol saja per pesan. Multiple tombol mungkin fitur berikutnya saja, kalau sempat dilanjutkan hehe.

Format: pesan|judul|url

  • pesan adalah tulisan teks yang akan dikirimkan
  • judul adalah judul tombolnya ketika akan di klik
  • url adalah arah URL ketika di klik

Contoh:

Ketikkan (copy paste aja biar gak ribet) seperti ini:

@GeDebugBot Ada channel bagus loh, mau tau?|klik aja ini|https://telegram.me/botkoleksi

Pas diklik hasilnya, maka sebuah tombol inline akan dibuatkan di grup atau channel.

Hasilnya:

Tombol Inline

Pastikan di depan @gedebugbot tidak ada karakter lain, termasuk spasi.

โš™ Format Pesan

Berfungsi untuk menampikan teks dengan format Markdown, HTML, atau sekadar ECHO.

Jenis Pesan dan Formatnya

  • Markdown gunakan !markdown atau !m
  • HTML gunakan !html atau !h
  • ECHO gunakan !echo atau !e

Contoh penggunaan :

!m Tulisan ini *tebal* dan ini _miring_ [google](https://google.com)
!h Tulisan ini <b>tebal</b> dan ini <i>miring</i> <a href="https://google.com">Buka Google</a>
!e Tulisan ini tanpa format, hanya menggaung tampilkan ulang

Hasilnya:

Format Pesan

๐Ÿ“ Hashtags

Fitur ini berlaku hanya untuk sebuah group. Dimana pentingnya sebuah interaksi dan sering terjadi sebuah pertanyaan yang berulang-ulang, atau jawaban yang berulang untuk diketikkan. Dengan hashtag ini dapat kita simpan dan munculkan kembali ketika diperlukan.

Ada kalanya kita butuh shortcut untuk menampikan sesuatu yang berulang di grup. Maka bisa memanfaatkan fitur hash tag ini.

โœ Membuat Tag

hak akses dibatasi minimal admin

Gunakan perintah :

 !tag #tag pesan untuk disampaikan

Contoh:

 !tag #ask _just ask, not asks for ask_
 /tag #tanya _silakan bertanya, bukan pertanyaan yang untuk bertanya_

๐Ÿ”จ Menghapus Tag

hak akses dibatasi minimal admin

Gunakan perintah:

 !untag #tag

๐Ÿ“‰ Statistik Tag

hak akses dibatasi minimal admin

Gunakan perintah: !tagstats

10 Tag akan ditampilkan.

  • !tagstats asc menghasilkan urutan terkecil
  • !tagstats desc menghasilkan urutan terbesar ```

๐Ÿ“ Tampilkan Pesan Tag

Semua user dapat mengetikkan #tag di group, maka bot akan membalasnya. Bisa juga dipakai untuk mereply atau membalas pesan, ketikkan #tag-nya.

โ‰๏ธ CATATAN:

  • pesan dibatasi 4000 karakter
  • hati-hati penggunaan charakter khusus markdown (bintang * garis bawah _ dan petik kebalik `)

Tags Statistik

๐Ÿ‘ฅ Mengelola Group

Inilah tambahan fitur gedebug untuk mengelola sebuah grup. Dimana sering saya mendapatkan, ingin kick seseorang tapi susah karena userlist sangat panjang, sulit mencari.

Beberapa fitur untuk Group :

๐Ÿ” Admin

!admin untuk melihat daftar admin suatu grup. Bot GeDEBUG bisa melacak pengelola suatu group bahkan tanpa harus bergabung ke dalam group tersebut.

Dapat dipergunakan juga untuk grup lain. Misal: !admin @namagrup

Contoh Hasil:

๐Ÿ‘ฅ Telegram Bot PHP - Indonesia
๐Ÿ†” -1001054519222
ใ€ฐใ€ฐใ€ฐใ€ฐใ€ฐใ€ฐใ€ฐ
๐Ÿ”ฐ Creator
๐Ÿ‘ค โ€bangHasanโ€โ€ฎ
๐Ÿšน @hasanudinhs

๐Ÿ”ฐ Administrator
1. ๐Ÿ‘ค gojigeje @gojigeje
2. ๐Ÿ‘ค Aprilianno Rukma @aprilianno
3. ๐Ÿ‘ค โ€Radyaโ€โ€ฎ @error_log
4. ๐Ÿ‘ค Mochamad Taufan Febriawan @tukangdezain
5. ๐Ÿ‘ค GeDebug @Gedebugbot
6. ๐Ÿ‘ค tsabat @save_aleppo
7. ๐Ÿ‘ค Zamzam Badruzaman @papihsharla
8. ๐Ÿ‘ค Deddy Sandi @Abu_Asadulloh
9. ๐Ÿ‘ค Muh Fitrah @fitrahmuh

๐Ÿ’น Total 9 administrator.

๐Ÿ™‹ Status

!status untuk melihat status keanggotaan di group, sebagai member, admin, atau creator.

Contoh hasil:

๐Ÿ‘ฅ Telegram Bot PHP - Indonesia
๐Ÿ‘ค โ€bangHasanโ€โ€ฎ
๐Ÿ†” 213567634
๐Ÿšน @hasanudinhs
๐Ÿ”ฐ creator

๐Ÿ’ฅ KICK

Ketentuan kick di grup:

  • Syarat: Bot harus di add menjadi ADMIN GROUP.
  • Akses dibatasi hanya untuk minimal ADMIN.
  • Sesama admin tidak akan mengkick admin lainnya.

Cara penggunaan, reply pesan user yang akan ditendang, ketikkan !kick

Bot akan mengeksekusi user tersebut.

Admin Grup

โžฟ Mendapatkan Link

Berfungsi untuk mendapatkan link sebuah pesan di SUPERGROUP PUBLIC. Link dapat di klik, sehingga bisa dipergunakan untuk membuat tombol inline, ataupun penunjuk baca pada welcome.

Penggunaannya: reply atau balas sebuah pesan, kemudian ketikkan :

!link atau !l

Maka sebuah link akan ditampilkan yang menuju ke pesan tersebut.

Fitur ini tidak bekerja pada Channel. Untuk channel, gunakan TGDesktop atau non official telegram client.

Mendapatkan Link

๐Ÿ—ฃ Welcome Grup

Jika memerlukan bot GeDEBUG untuk menyambut user yang baru bergabung, gunakan fitur text welcome ini.

๐Ÿ’ Set Pesan Welcome

Hanya di group, minimal level admin.

Seting welcome hanya 1 baris saja, jika butuh pindah baris gunakan $br.

Format: !welcome [pesan]

Variable yang disediakan $nama, $user, $grup, $hit dan $br (ganti baris).

Contoh:

    !welcome Hai $nama $user. Selamat datang di *$grup*. Kamu adalah user ke-$hit. $br$br_Enjoy ya!_

โ‰๏ธ CATATAN:

  • pesan dibatasi 4000 karakter
  • hati-hati penggunaan charakter khusus markdown (bintang * garis bawah _ dan petik kebalik `)

Contoh lain, yang lebih sederhana:

   /welcome Halo $name !!

๐Ÿ”ด Aktifkan / Matikan

~~~~~~~~~~~~~~~~~~~~~

Format: !aktifwelcome [0/1]

0 = mati, 1 = aktif

Contoh:

  • !aktifwelcome 1 untuk mengaktifkan (default aktif)
  • !aktifwelcome 0 untuk mematikan

๐Ÿ”ข Seting Jumlah HIT

Dibatasi hanya creator group.

Format: !hit [angka]

Contoh: !hit 10000

INGAT User ke- (hit) itu berbeda dengan jumlah user!

๐ŸŒ Seting Link Welcome

Berguna untuk membuat tombol inline saat sambutan welcome.

Format: !setlink URL

contoh: !setlink https://telegram.me/botphp/16428

Welcome Bot

๐Ÿ“ฝ Video Tutorial

Agar tidak mumet, ini contoh prakteknya.. langsung simak dan tonton saja ya.

Mungkin kamu juga suka

Website Baru

1 menit saja

Yuhu.. akhirnya, setelah sekitar 5 tahun (dari tahun 2016), akhirnya web utamanya keluar penampakannya.