← All projects
GITHUB PROJECT / Open Source

PINGAT

Dari chat jadi jadwal. Bot Telegram untuk Google Calendar dan reminder H-, berjalan di Google Apps Script tanpa AI atau VPS.

JavaScript
PINGAT

Repository files

main
◉   README.md

Pingat — dari chat jadi jadwal

Kirim kalimat. Cek ringkasan. Tekan Ya.

Jadwal masuk Google Calendar, pengingat datang lewat Telegram.

Runtime Google Apps Script V8

Tanpa AI

193 tes mock

Bahasa Indonesia

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 butuhkanYang Pingat lakukan
Cepat mencatat agendaBuat event dari kalimat Indonesia dengan pola terbatas
Periksa sebelum tersimpanRingkasan dan tombol Ya/Batal; konfirmasi berlaku 10 menit
Lebih dari satu pengingatOffset 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 sendiriCalendar, spreadsheet, dan deployment ada pada akun Google kamu
Bot untuk penggunaan pribadiPemeriksaan 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.
BagianContoh
Tanggalhari ini, besok, lusa, 2 hari lagi, 2027-11-20, 20 Nov 2027
Jam09:00, 09.30, jam 9 pagi, jam 7 malam, 2pm
Durasiselama 60 menit, durasi 1 jam, selama satu setengah jam
Selesaisampai jam 15:30, hingga 16:00, 09:00-10:00
Pengingatingetin, ingatkan saya, pengingat, reminder, atau H- langsung
Offseth-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.

  1. Unduh kode lewat tombol Code → Download ZIP di GitHub.
  2. Buat project Apps Script, salin file .gs dan appsscript.json, lalu aktifkan Advanced Calendar v3.
  3. Isi konfigurasi di Config.gs. Paket publik memakai placeholder untuk ID pribadi; tidak berisi akun Calendar pembuatnya.
  4. Simpan rahasia di Script Properties: TELEGRAM_BOT_TOKEN dan WEBHOOK_SECRET. Tidak ada key AI yang diperlukan.
  5. Jalankan createSheets() dan runAllTests() dari editor.
  6. Deploy sebagai Web App: Execute as Me, Who has access Anyone. Isi URL /exec di konfigurasi setup.
  7. Jalankan setWebhook() dan installTrigger(), lalu kirim /help ke 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.