Download the PHP package dannsbass/bot without Composer

PHP Bot Telegram

Modifikasi dari PHPTelebot by radyakaze

Cara Pasang

• Salin file Bot.php

• Lakukan include atau require (lebih disarankan) file Bot.php ke dalam file projek Anda:

Contoh Kode

Berikut ini beberapa contoh kode yang bisa Anda pakai:

Contoh 1 (Merespon Semua Pesan Teks dengan Satu Pesan Teks)

Keterangan contoh 1: seperti Anda lihat pada screenshot, bot hanya merespon pesan teks saja dan responnya hanyalah kalimat statis yaitu Anda mengirim pesan teks. Selain pesan teks, bot akan mengabaikannya alias tidak meresponnya sama sekali. Berikut ini kodenya:

Keterangan kode: Method yang digunakan untuk merespon semua pesan teks adalah text() dengan satu parameter (string) di dalamnya berisi respon/balasan kepada user.

Contoh 2 (Merespon Pesan Teks Tertentu dengan Pesan Teks yang Tertentu)

Keterangan contoh 2: bot merespon pesan teks Hai dengan Hai juga, Info dengan Ini adalah info dan /admin dengan Ini adalah admin. Selain itu, semua pesan teks akan direspon dengan kalimat statis Anda mengirim pesan teks. Berikut ini kodenya:

Keterangan kode: Method yang digunakan untuk merespon teks tertentu adalah chat() dengan dua parameter:

1. $request (kiri) yaitu pesan teks yang dikirim oleh user.
2. $respon (kanan) yaitu pesan teks balasan dari bot.

Contoh 3 (Mengirim Teks disertai Tombol/Keyboard)

Keterangan contoh 3: bot merespon perintah /start dengan pesan Silahkan pilih menu berikut ini disertai lima buah tombol (keyboard) yaitu TENTANG, MENU, ADMIN, NO REKENING dan HELP. Jika tombol ditekan, bot akan merespon dengan kalimat tertentu. Berikut ini kodenya:

Keterangan kode: Untuk me-reply pesan yang dikirim oleh user, tambahkan elemen 'reply'=>true pada array parameter kedua (kanan) dalam method sendMessage(). Untuk memodifikasi respon yang akan dikirim, gunakan function(){} pada parameter kedua dalam method chat(). Untuk membuat tombol/keyboard, method yang digunakan adalah static method keyboard() dengan satu parameter berupa string dengan pola [teks].

Contoh 4 (Membuat Tombol/Keyboard Inline yang Responsif)

Keterangan contoh 4: bot merespon perintah /start dengan kalimat Selamat user datang di Google (salah ketik, harusnya: selamat datang user hehe..). Perhatikan kata user ditebalkan dan kata Google berupa link yang merujuk ke situs https://www.googgle.com. Selain kalimat tersebut, bot juga menyertakan tombol-tombol (inline keyboard) yang responsif, yaitu jika diklik akan menghasilkan respon Anda menekan tombol <anu> kecuali tombol link yang berisi URL ke alamat situs tertentu.

Keterangan kode: untuk membuat inline_keyboard secara mudah dan cepat, gunakan method Bot::inline_keyboard() dengan satu parameter berupa string yang polanya adalah [teks|teks] atau [teks|URL]. Method start($respon, $options) adalah singkatan dari chat('/start', function() use($respon, $options){ return Bot::sendMessage($respon, $options);}), hasilnya sama. Method callback_query() diambil dari nama events pada Telegram Bot API (lihat daftarnya di bawah). Fungsinya untuk merespon tombol inline_keyboard jika diklik/ditekan. Sedangkan method answerCallbackQuery adalah salah satu method bawaan Telegram untuk menampilkan notifikasi pada layar chatting bagian atas sebagai alert (peringatan).

Contoh 5 (Membalas Foto dengan Teks)

Keterangan contoh 5: bot merespon teks /start dengan kalimat Selamat datang di bot ... dan merespon foto yang diunggah dengan kalimat Anda baru saja mengunggah foto dengan rincian sebagai berikut: lalu disebutkan rincian foto yang dikirim tersebut.

Keterangan kode: Bot merespon foto yang dikirim oleh user menggunakan method photo() yang berisi satu parameter berupa function. Cara mendapatkan rincian foto yang dikirim oleh user adalah dengan menggunakan static method bernama message() bawaan PHPTelebot. Output method tersebut berupa array sehingga perlu di-encode dengan json_encode supaya berubah menjadi string dan bisa dikirim ke user.

Contoh 6 (Membalas Foto dengan Foto yang Sama)

Keterangan contoh 6: bot merespon pesan teks /start dengan kalimat Silahkan kirim foto dan merespon foto yang diunggah dengan mengembalikan foto tersebut ke user yang mengirimnya. Berikut ini kodenya:

Keterangan kode: untuk mengirim foto ke user, gunakan static method sendPhoto() dengan parameter $photo yang diambil dari _fileid foto tesebut. Baca keterangan selengkapnya tentang method sendPhoto

Contoh 7 (Merespon pesan berupa foto, video, dokumen, stiker, dll)

Keterangan contoh 7: bot merespon pesan teks /start dengan pesan teks Assalamualaikum, pesan teks Hai dengan pesan teks Hai juga dan pesan teks /help dengan kalimat Cara menggunakan bot ini adalah sebagai berikut.... Selain teks itu, bot akan merespon setiap pesan teks dengan pesan teks Kalau ada pertanyaan silahkan hubungi 08123456789. Bot juga merespon foto yang diunggah oleh user dengan pesan teks Kamu baru saja mengunggah foto, merespon dokumen yang diunggah oleh user dengan pesan teks Kamu baru saja mengunggah dokumen dan seterusnya.

Contoh 8 (Menggunakan fitur parse_mode dan reply dalam respon)

Contoh 9 (Menggunakan tombol dalam baris / inline keyboard)

Contoh 10

Contoh 11 (Mengedit dan Menghapus pesan)

Cara Mudah Membuat Inline Keyboard

Ada cara mudah untuk membuat inline keyboard dengan menggunakan method Bot::inline_keyboard()

Cara Mudah Membuat Keyboard

Ada cara mudah membuat keyboard biasa (bukan _inlinekeyboard) menggunakan method Bot::keyboard($string)

Daftar Method Biasa

• start($sambutan) untuk menyambut user baru yang menekan tombol START atau user yang mengirim pesan teks /start kepada bot. Parameternya bisa satu berupa string, contoh start('Assalamualaikum user'), bisa juga berupa function, contoh start(function(){ return Bot::sendMessage('Assalamualikum user');}) dan bisa juga disi dengan dua parameter (string dan array), contoh: start('Assalamualaikum *user*', ['parse_mode'=>'markdown']) di mana array berisi rincian pesan yang dikirim (lihat dokumentasinya di: Telegram).
• chat($request, $response) untuk me-response teks tertentu yang di-request oleh user, contoh chat('Hai', 'Hai juga') untuk merespon teks Hai dengan teks Hai juga atau chat('Hai', function(){return Bot::sendPhoto('fotoku.jpg');}) untuk merespon teks Hai dengan file fotoku.jpg. Kalau untuk merespon semua teks yang dikirim oleh user, gunakan string satu bintang ( * ) pada parameter pertama seperti ini chat('*', 'Silahkan hubungi Admin') atau bisa juga begini text('Silahkan hubungi Admin'), dua-duanya sama hasilnya.
• chat_array($array) untuk membuat array chat dengan format chat_array([$request => $response]), contoh: chat_array(['hai' => 'hai juga', 'info' => function(){return Bot::sendMessage('ini adalah info')}, 'oke' => 'terima kasih']) dan semisalnya.
• cmd($request, $response) alias chat($request, $response).
• all($response) untuk me-response semua event yang belum diatur sebelumnya.
• Events (lihat daftarnya di bawah).

Daftar Method Static

• keyboard($pola) untuk membuat keyboard dari string dengan pola [tombol], contoh:

• inline_keyboard($pola) untuk membuat inline keyboard dari string dengan pola [teks|URL] atau [teks|teks] atau [Teks], contoh:

• name() untuk mengambil username bot.
• user() untuk mengambil nama user.
• from_id() untuk mengambil user id.
• chat_id() untuk mengambil chat id.
• message_text() untuk mengambil teks yang dikirim oleh user (hanya berlaku jika user mengirim pesan teks).
• message_id() untuk mengambil message id

Daftar Events

Ada method-method yang diambil dari nama-nama events pada Telegram Bot API. Cara menggunakannya sama dengan menggunakan method biasa, yaitu $bot->nama_method() contoh: $bot->text() untuk merespon pesan teks, $bot->animation() untuk merespon pesan animasi, $bot->audio() untuk merespon pesan audio dan seterusnya. Berikut ini daftarnya:

• text
• animation
• audio
• document
• photo
• sticker
• video
• video_note
• voice
• contact
• dice
• game
• poll
• venue
• location
• new_chat_members
• left_chat_members
• new_chat_title
• new_chat_photo
• delete_chat_photo
• group_chat_created
• supergroup_chat_created
• channel_chat_created
• message_auto_delete_timer_changed
• migrate_to_chat_id
• migrate_from_chat_id
• pinned_message
• invoice
• successful_payment
• connected_website
• passport_data
• proximity_alert_triggered
• voice_chat_scheduled
• voice_chat_started
• voice_chat_ended
• voice_chat_participants_invited
• inline_query
• callback_query
• edited_message
• channel_post
• edited_channel_post