Kirim kalimat. Cek ringkasan. Tekan Ya.
Jadwal masuk Google Calendar, pengingat datang lewat Telegram.
Contoh chat · Mulai pakai · Dokumentasi lengkap · Format pesan
Pingat adalah bot Telegram pribadi untuk membuat event Google Calendar dan menjadwalkan pengingat dari satu kalimat. Seluruh bot berjalan di Google Apps Script, dengan Google Sheets sebagai penyimpan jadwal reminder.
Tidak perlu menyewa VPS, menjalankan server sendiri, atau menyediakan API key AI. Parser membaca pola kalimat yang ditentukan, lalu meminta penjelasan jika formatnya belum tegas.
Coba bayangkan chat ini
Kamu:
Besok jam 09:00 rapat tim selama 1 jam,
ingetin h-1 jam dan h-15 menit.
Pingat menampilkan ringkasan:
Periksa event berikut (belum dibuat):
rapat tim
Mulai: [tanggal besok] 09:00 WIB
Selesai: [tanggal besok] 10:00 WIB
Pengingat:
- 08:00 WIB — 60 menit sebelum mulai
- 08:45 WIB — 15 menit sebelum mulai
[ Ya ] [ Batal ]
Ilustrasi di atas disingkat. Bot menampilkan tanggal dan waktu lengkap pada ringkasan sebenarnya.
Tekan Ya: event dibuat dan reminder dijadwalkan. Tekan Batal: tidak ada event yang dibuat. Setelah waktunya tiba, Pingat mengirim judul event, jam mulai, dan waktu yang tersisa ke Telegram.
Kenapa Pingat?
| Yang kamu butuhkan | Yang Pingat lakukan |
|---|---|
| Cepat mencatat agenda | Buat event dari kalimat Indonesia dengan pola terbatas |
| Periksa sebelum tersimpan | Ringkasan dan tombol Ya/Batal; konfirmasi berlaku 10 menit |
| Lebih dari satu pengingat | Offset per event, termasuk h-1 jam dan h-15 menit |
| Tidak bingung format | /help berisi format, contoh, dan cara konfirmasi |
| Tahu kenapa input ditolak | “Format tidak dikenali” disertai alasan dan contoh perbaikan |
| Menggunakan akun sendiri | Calendar, spreadsheet, dan deployment ada pada akun Google kamu |
| Bot untuk penggunaan pribadi | Pemeriksaan owner chat ID dan secret webhook |
Format yang bisa dipakai
Besok jam 09:00 rapat tim selama 1 jam, ingetin h-30 menit.
Lusa jam 14:00 review desain sampai jam 15:30,
ingetin h-1 jam dan h-15 menit.
Olahraga tanggal 20 November 2027 jam 07:00,
pengingat 15 menit sebelumnya.
Buat acara kelas besok jam 7 malam selama 90 menit.
Rapat besok jam 09:00-10:00, ingetin saat mulai.
Besok jam 09:00 acara "Review Besok Pagi" selama 1 jam.
| Bagian | Contoh |
|---|---|
| Tanggal | hari ini, besok, lusa, 2 hari lagi, 2027-11-20, 20 Nov 2027 |
| Jam | 09:00, 09.30, jam 9 pagi, jam 7 malam, 2pm |
| Durasi | selama 60 menit, durasi 1 jam, selama satu setengah jam |
| Selesai | sampai jam 15:30, hingga 16:00, 09:00-10:00 |
| Pengingat | ingetin, ingatkan saya, pengingat, reminder, atau H- langsung |
| Offset | h-30 menit, h-1 jam, h-1 hari, saat mulai |
H- wajib menyebut satuan. h-30 menit valid; h-30 diminta diperjelas.
Satu atau beberapa reminder:
1 jam 15 menit sebelumnya → satu reminder, 75 menit sebelumnya
h-1 jam dan h-15 menit → dua reminder, 60 dan 15 menit sebelumnya
Tanpa durasi: 60 menit. Tanpa pengingat: 15 menit sebelumnya. Semua waktu menggunakan WIB / Asia/Jakarta. Keterangan reminder ditempatkan di akhir kalimat.
Nama hari tanpa tanggal, tanggal angka seperti 03/04/2027, dan jam tanpa menit/periode mempunyai pilihan aturan tersendiri. Jika aturan belum dipilih, bot meminta format yang lebih tegas. Lihat kamus lengkap dan Open decisions.
Kalau salah format?
Misalnya kamu mengirim Besok rapat tim, Pingat membalas:
Format tidak dikenali.
Belum ada jam mulai yang dikenali.
Contoh format:
Besok jam 09:00 rapat tim selama 1 jam, ingetin h-30 menit.
...
Belum ada event dibuat dan konteks parsial tidak disimpan.
Kirim ulang kalimat lengkap. Ketik /help untuk format lainnya.
Kesalahan input mendapat balasan untuk setiap pesan baru. Kamu tidak perlu menunggu throttle alert sistem untuk melihat contoh format.
Mulai pakai
Siapkan akun Google pribadi, bot Telegram dari BotFather, dan sebuah Google Spreadsheet.
- Unduh kode lewat tombol Code → Download ZIP di GitHub.
- Buat project Apps Script, salin file
.gsdanappsscript.json, lalu aktifkan Advanced Calendar v3. - Isi konfigurasi di Config.gs. Paket publik memakai placeholder untuk ID pribadi; tidak berisi akun Calendar pembuatnya.
- Simpan rahasia di Script Properties:
TELEGRAM_BOT_TOKENdanWEBHOOK_SECRET. Tidak ada key AI yang diperlukan. - Jalankan
createSheets()danrunAllTests()dari editor. - Deploy sebagai Web App: Execute as Me, Who has access Anyone. Isi URL
/execdi konfigurasi setup. - Jalankan
setWebhook()daninstallTrigger(), lalu kirim/helpke bot.
➡️ Buka panduan setup lengkap untuk mendapatkan chat ID, memahami konfigurasi, OAuth scopes, migrasi, dan melakukan tes pada akunmu.
Untuk upgrade kode, pilih Manage deployments → Edit → New version → Deploy. Jangan menimpa konfigurasi pribadi dengan placeholder dari paket.
Cara kerjanya
flowchart LR
A[Chat Telegram] --> B[Apps Script: otorisasi & parser]
B --> C[Ringkasan: Ya / Batal]
C -->|Ya| D[Google Calendar]
D --> E[Google Sheets: jadwal reminder]
E --> F[Trigger setiap menit]
F --> G[Pengingat ke Telegram]
Hanya event yang dibuat bot yang mendapat reminder Telegram. Tidak ada scan event Calendar lama. Jika penulisan jadwal gagal setelah event dibuat, bot mencoba rollback dan memberitahukan statusnya.
Pengujian dan batas yang perlu diketahui
193 tes mock mencakup parser, H-, konfirmasi berulang, pembatalan, expiry, rollback, retry, grace, dedup, dan respons format. Jalankan dari editor Apps Script:
runAllTests()
Atau gunakan Node.js untuk tes lokal saja—runtime bot tetap Apps Script:
node scripts/test.cjs
Konfigurasi tes terisolasi dari konfigurasi pemilik. Laporan editor mencetak ringkasan dan kegagalan agar tidak terpotong oleh daftar seluruh tes yang lulus. Lihat hasil tes mock.
- Parser berbasis aturan; kalimat di luar grammar perlu ditulis ulang.
- Trigger dijadwalkan setiap menit, dengan grace 10 menit untuk keterlambatan. Kuota dan ketersediaan layanan Google/Telegram tetap berlaku.
- Lock dan status transaksi mencegah pengulangan akibat run tumpang tindih atau tombol Ya ditekan berulang. Crash antara pengiriman Telegram dan pencatatan status masih bisa menyebabkan pesan ganda.
- Tes mock tidak menggantikan uji webhook dan izin layanan pada akunmu. Pemilik telah melaporkan bot berfungsi; paket publik tetap perlu dikonfigurasi dan diuji pada tiap akun.
Detail pemulihan dan batas jaminan tersedia di dokumentasi keandalan.
Ruang lingkup
Pingat berfokus pada satu pemilik, satu event per pesan, dan reminder Telegram untuk event tersebut. Perintah yang tersedia: /start dan /help.
Recurring event, edit/hapus event lewat bot, attendees, Google Meet, pesan suara, multi-user, dan reminder tanpa event belum termasuk cakupan.
Agenda sudah tercatat. Tinggal jalani harimu.