
Ingin mengintegrasikan Telegram dengan Google Spreadsheet untuk menerima pesan dan mengirimkan update secara otomatis? Skrip Google Apps Script ini solusinya! Artikel ini akan memandu Anda memasang dan menggunakan skrip untuk berinteraksi dengan pengguna Telegram.
Prakiraan Waktu: 15 menit
Skill yang Dibutuhkan:
- Akun Google Workspace
- Akun Telegram Bot
Persiapan
Buat Akun Telegram Bot:
- Kunjungi BotFather https://telegram.me/BotFather di Telegram
- Buat bot baru dan dapatkan token bot.
Buat Spreadsheet di Google Drive:
- Buat spreadsheet baru di Google Drive.
- Rename sheet pertama menjadi “Data Order” dan buat sheet baru bernama “Log”.
- Lalu Masukan ini di paling atas Data Order ” [NO.] [ID Order] [Tanggal Order] [Nama] [Kode Barang] [Alamat] [Resi] [Status Pengiriman] [Chat ID]”
- MAsukan ini di atas Sheet Log ” [Timestamp] [Log Message]”
Dapatkan URL Apps Script:
- Buka Script Editor di spreadsheet Anda (Tools > Script editor).
- Klik “File” > “Publish” > “Deploy” dan pilih “New project”.
- Beri nama project (misalnya, “Telegram-AppsScript”) dan pilih “Who has access” (sesuaikan kebutuhan Anda).
- Klik “Deploy” dan dapatkan URL project yang muncul.
Instalasi Skrip
Buka Script Editor:
- Buka kembali Script Editor di spreadsheet Anda (Tools > Script editor).
Tempel Script:
- Copy dan paste seluruh kode skrip yang disediakan di bagian akhir artikel ini ke dalam Script Editor.
Ganti Kredensial:
Cari dan ganti variabel berikut dengan informasi Anda:
spreadsheetId
: Ganti dengan ID spreadsheet Anda (dapat ditemukan di URL spreadsheet).botHandle
: Ganti dengan username bot Anda (tanpa “@”).botToken
: Ganti dengan token bot Anda yang didapat dari BotFather.appsScriptUrl
: Ganti dengan URL project Apps Script yang Anda dapatkan sebelumnya.
Simpan Perubahan:
- Klik “File” > “Save”.
Aktifkan Webhook Telegram
Jalankan Fungsi
setWebhook
:- Di Script Editor, pastikan Anda berada di file script.
- Klik “Run” > “setWebhook”.
- Periksa log untuk memastikan webhook berhasil dibuat.
Pengaturan Telegram Bot:
- Buka kembali BotFather di Telegram.
- Kirim perintah
/setwebhook
diikuti URL project Apps Script Anda (misalnya,/setwebhook https://script.google.com/macros/s/YOUR_SCRIPT_ID/exec
).
Fungsi-fungsi dalam Skrip
Skrip ini memiliki beberapa fungsi yang menangani berbagai hal:
log
: Untuk menulis pesan ke sheet “Log”.formatDate
: Untuk memformat tanggal ke format Indonesia.sendTelegramMessage
: Untuk mengirim pesan teks ke chat tertentu di Telegram.parseMessage
: Untuk memproses pesan yang diterima dari Telegram dan mengekstrak informasi.inputDataOrder
: Untuk memasukkan data order yang diterima ke sheet “Data Order”.cekResi
: Untuk mengecek status pengiriman berdasarkan nomor resi.handleUpdateDeliveryStatus
: Untuk menangani perubahan status pengiriman pada sheet “Data Order” dan mengirim update ke Telegram.doPost
: Fungsi utama yang dijalankan ketika menerima pesan baru dari Telegram.
Cara Menggunakan
Kirim Pesan ke Bot:
Buka chat bot Telegram Anda.
Kirim pesan dengan format berikut:
/start
: Untuk memulai interaksi dengan bot./input
: Untuk memasukkan data order baru (ikuti format yang diberikan skrip saat menggunakan perintah/format
)./resi [nomor resi]
: Untuk mengecek status pengiriman berdasarkan nomor resi./format
: Untuk melihat daftar format pesan yang tersedia.
Tanggapan Bot:
- Bot akan membalas pesan Anda sesuai dengan fungsinya.
- Update status pengiriman pada sheet “Data Order” akan otomatis memicu pengiriman pesan ke Telegram.
Kesimpulan
Dengan skrip ini, Anda dapat membuat sistem pemesanan dan update status pengiriman otomatis melalui Telegram yang terintegrasi dengan Google Spreadsheet. Jangan lupa untuk menyesuaikan dan mengembangkan skrip ini sesuai dengan kebutuhan Anda.