Buat Pencatat Pengeluaran Telegram dengan Google Sheets

Secangkir kopi, tiket bus, buku catatan. Pembelian kecil mudah terlupakan saat Anda baru sempat membuka spreadsheet. Bagaimana jika mencatatnya cukup dengan satu pesan Telegram, lalu memeriksa total bulanan cukup dengan satu pesan lagi?

Tutorial ini membuat Pocket Ledger, pencatat pengeluaran Telegram dengan Google Sheets. Kirim detail pembelian, konfirmasi usulan datanya, lalu tanyakan total bulanan Anda. Sheet menyimpan baris data dan menghitungnya; bot menangani percakapannya. Inilah hasil akhirnya.

Pocket Ledger di Telegram mengonfirmasi pembelian kopi dan memberikan total November terpisah dalam EUR dan USD — Percakapan Telegram yang sebenarnya: pembelian kopi yang dikonfirmasi, lalu dua total bulanan yang dibaca dari Google Sheets.

Tab Summary Google Sheets yang sebenarnya dengan total November EUR 12.20 dan USD 6.00 Hasil yang sama di Sheet. Kopi seharga EUR 4.50 menambah EUR 7.70 menjadi EUR 12.20; USD 6.00 tetap terpisah.

Tangkapan layar ini mengikuti demo langsung dengan pengeluaran fiktif. Kami memeriksa baris yang tersimpan terhadap panggilan Action di Inbox, lalu membandingkan kedua jawaban Telegram dengan nilai yang dikembalikan Google Sheets. Identitas pribadi dan kredensial disembunyikan dalam tangkapan layar yang dipublikasikan.

Target pertama adalah satu kopi tersimpan. Target kedua adalah total yang bisa diperiksa di Sheet. Anda juga akan mempelajari mengapa jawaban “tersimpan” dalam chat baru separuh bukti.

Unduh paket penyiapan Pocket Ledger untuk mendapatkan buku kerja awal yang sudah diformat, avatar, prompt, pengaturan Action, dan lembar pengujian. Impor buku kerja ke Sheet yang dibuat oleh Quickchat AI, lalu ikuti langkah-langkah di bawah. Contoh yang dapat disalin menggunakan bahasa Inggris dan November 2026 agar Anda dapat membandingkan hasilnya dengan tangkapan layar.

Apa yang dibutuhkan untuk membuat pencatat pengeluaran Telegram?

Anda memerlukan Telegram, akun Google, dan akun Quickchat AI. Konfigurasi menggunakan pengaturan dasbor dan rumus spreadsheet; tidak ada program yang perlu dihosting.

Buat akun Quickchat AI, selesaikan verifikasi, dan buat Agent bernama Pocket Ledger.
Siapkan akun Google untuk Sheet baru. Mulai dengan catatan fiktif di bawah.
Gunakan bot Telegram baru untuk latihan ini. Siapkan akun Telegram kedua yang tepercaya untuk pengujian akses di akhir.

Paket Free Quickchat AI ditujukan untuk pembelajaran pribadi nonkomersial dan memiliki kuota terbatas. Percakapan AI dan Simulation Testing menghabiskan kredit. Periksa paket dan kuota terkini sebelum memilih paket untuk penggunaan berkelanjutan.

Diagram satu Action menulis baris pengeluaran dan Action terpisah membaca ringkasan Dua arah, dua Actions. Menyimpan baris tidak memberi Agent kemampuan untuk membaca total sebelumnya.

Langkah 1: Bagaimana menghubungkan bot Telegram pribadi?

BotFather membuat identitas bot Anda. Quickchat AI menyediakan Agent yang menjawab pesannya.

Buka akun resmi @BotFather, kirim /newbot, beri nama bot Pocket Ledger, dan pilih nama pengguna yang tersedia dengan akhiran bot. Gunakan /setuserpic untuk mengunggah avatar dari paket. Simpan token secara rahasia; Anda akan menempelkannya langsung ke Quickchat AI.

BotFather membuat bot Pocket Ledger dengan token disembunyikan — Pilih nama tampilan dan nama pengguna yang unik. Token BotFather disembunyikan.

Di Quickchat AI, buka External Apps → Telegram → Your own bot. Pada dialog Connect to Telegram, tempel kredensial ke Bot Token. Aktifkan Enable your own bot, lalu pilih Save. Panduan BotFather membahas layar tersebut secara terperinci.

Bot yang terhubung memiliki nama Pocket Ledger yang sama seperti yang akan Anda lihat di Telegram.

Buka tautan bot baru di Telegram, kirim /start, lalu kirim Hello dalam chat pribadi. /start mengirim pesan sambutan; pesan biasa membuat percakapan di Inbox dan metadata pengirim yang diperlukan pada langkah-langkah berikutnya. Biarkan Actions yang menangani data pribadi nonaktif selama konfigurasi.

Pocket Ledger membalas start dan Hello dalam percakapan pribadi Telegram yang sebenarnya — Balasan untuk Hello mengonfirmasi bahwa Telegram dapat menjangkau Agent Anda. Percakapan Hello juga muncul di Quickchat Inbox.

Buka percakapan ini di Quickchat AI melalui Inbox → Details → Visitor. Temukan Telegram User Id dan Telegram Chat Type (kunci metadatanya adalah telegram_user_id dan telegram_chat_type). Salin ID pengguna numerik melalui kontrol yang muncul saat kursor diarahkan ke sana, lalu pastikan tipe chat adalah private.

Detail pengunjung di Inbox menampilkan kolom Telegram User Id dan Telegram Chat Type bernilai private, dengan data pribadi disembunyikan Ambil ID pengirim Anda dari kolom ini. Identitas pribadi disembunyikan dalam tangkapan layar; gunakan nilai Anda yang sebenarnya.

ID berasal dari metadata pengirim Telegram. Nama pengguna Anda, angka yang diketik dalam pesan, dan ID bot sendiri merupakan hal berbeda. Anda akan memakai ID pengirim untuk membatasi kedua Actions pada langkah berikutnya.

Langkah 2: Bagaimana menyiapkan Google Sheet?

Integrasi Google Sheets membuat spreadsheet dan Action awal. Gunakan kembali file itu agar Action dan izin Google merujuk ke sumber daya yang sama.

Buka Actions & MCPs → Add Action → Google Sheets dan beri otorisasi akun Google. Panduan koneksi Google Sheets menjelaskan persetujuan dan konfigurasi awal.
Segera nonaktifkan Action awal. Action dibuat dalam keadaan aktif. Pertahankan nama log_lead_to_google_sheet, karena koneksi ulang menggunakan nama tersebut untuk menemukannya. Kita akan mengubah fungsinya menjadi penyimpanan pengeluaran.
Buka spreadsheet yang dibuat dan beri nama Pocket Ledger demo. Dalam file demo baru ini, pilih File → Import → Upload, pilih pocket-ledger-starter.xlsx dari paket, lalu pilih Replace spreadsheet. Setelah itu, klik Import data. Langkah ini menyiapkan Expenses dan Summary di dalam file yang dapat diakses Quickchat AI. Gunakan opsi ini hanya pada spreadsheet demo baru.
Periksa tiga baris awal di bawah. Di Summary, total awal seharusnya EUR 7.70 dan USD 6.00. Langkah 6 menjelaskan rumusnya dan menghubungkan Action pembaca.

Dialog koneksi Google Sheets Quickchat AI yang menjelaskan spreadsheet dan Action awal yang dibuat Mulailah dengan koneksi Google Sheets. Otorisasinya membuat spreadsheet yang digunakan oleh kedua Action.

Ingin membuat tab sendiri? Ubah nama tab awal menjadi Expenses. Untuk contoh berbahasa Inggris ini, atur File → Settings → Locale → United States. Format A:D dan F:H sebagai Plain text, serta E sebagai Number dengan dua angka desimal, lalu tempel blok di bawah ke A1. Bekukan baris judul dan lebarkan kolom. Tambahkan Summary mengikuti Langkah 6. Google juga mendokumentasikan cara mengimpor buku kerja Excel ke Sheet yang sudah ada.

Salin tiga pengeluaran awal

date	month	item	category	amount	currency	note	conversation_url
2026-11-01	2026-11	coffee	food	4.50	EUR	synthetic example
2026-11-02	2026-11	bus ticket	transport	3.20	EUR	synthetic example
2026-11-03	2026-11	notebook	stationery	6.00	USD	synthetic example

Tab Expenses yang sebenarnya sebelum penyimpanan dari Telegram, dengan tiga contoh pembelian fiktif Tiga pengeluaran awal, siap menerima yang keempat. Nilai pengeluaran berupa angka di E; kode mata uang berupa teks terpisah di F.

Kolom conversation_url akan menautkan setiap pengeluaran baru ke percakapannya. Kosongkan kolom ini untuk tiga contoh yang dimasukkan manual. Izin drive.file Google mencakup file yang dibuat aplikasi atau diberi akses secara eksplisit; resep ini memakai Sheet buatan integrasi dan tidak memberi akses ke seluruh Drive Anda.

Langkah 3: Bagaimana membatasi pengeluaran ke chat Anda sendiri?

Atur Run only when pada setiap Action yang membaca atau menulis buku catatan. Kedua kondisi harus terpenuhi, jadi ID Anda saja tidak cukup dalam chat grup.

Kunci metadata	Perbandingan	Nilai
`telegram_user_id`	equals	ID pengirim numerik Anda yang sebenarnya dari langkah 1
`telegram_chat_type`	equals	`private`

Buka Action nonaktif log_lead_to_google_sheet dan temukan Run only when.
Tambahkan kedua kondisi di atas. Gunakan kunci metadata yang tepat dan digit ID Anda, tanpa nama pengguna atau awalan @.
Simpan Action sambil tetap menonaktifkannya. Terapkan kondisi yang sama pada Action pembaca saat membuatnya di langkah 6.

Editor Action pengeluaran dengan kondisi eksekusi ID pemilik dan chat pribadi Kondisi Action penyimpan dalam demo lokal. Ganti ID fiktif dengan ID pengirim asli Anda, lalu ulangi kedua kondisi pada Action pembaca.

Diagram konsep yang mensyaratkan identitas pemilik dan chat Telegram pribadi sebelum kedua Actions data pribadi dapat berjalan Kedua kondisi harus ada pada kedua Actions. Pengirim lain atau chat grup harus ditolak sebelum permintaan HTTP mencapai Google Sheets.

Ini adalah kondisi Action yang ditegakkan server. Menulis “hanya jawab saya” pada prompt bukan pemeriksaan akses. Batasi pula pengaturan berbagi Sheet dan akses ke akun Quickchat AI Anda.

Langkah 4: Bagaimana membuat bot menyimpan pengeluaran yang dikonfirmasi?

Ubah Action awal agar menambahkan satu baris sesuai urutan kolom Sheet. Atur When to run → AI decides agar dapat menunggu konfirmasi. Lalu berikan aturan konfirmasi kepada Agent sebelum mengaktifkannya.

Konfigurasikan kolom pengeluaran

Pada What to ask the user first, ganti kolom prospek dengan parameter ini. Pertahankan nama parameter persis seperti yang ditunjukkan.

Nama parameter	Jenis data	Wajib	Deskripsi yang dimasukkan
`date`	Text	Ya	Tanggal pengeluaran dalam YYYY-MM-DD, dikonfirmasi pemilik. Tanyakan jika belum ada.
`month`	Text	Ya	YYYY-MM diambil dari tanggal yang dikonfirmasi.
`item`	Text	Ya	Nama singkat pembelian.
`category`	Text	Ya	Kategori sederhana yang disepakati pemilik, seperti makanan atau transportasi.
`amount`	Decimal Number	Ya	Nominal numerik positif tanpa simbol mata uang.
`currency`	Text	Ya	Kode mata uang ISO yang dikonfirmasi, seperti EUR atau USD. Klarifikasi simbol ambigu.
`note`	Text	Tidak	Catatan opsional. Kosongkan jika tidak ada.

Pertahankan ID spreadsheet asli dari API Endpoint yang ada. Ubah rentang ke Expenses!A:H, pertahankan metode POST, dan atur Query Params ke valueInputOption=RAW dan insertDataOption=INSERT_ROWS. Hapus parameter kueri ganda jika sudah ada di URL.

Salin referensi permintaan append

POST https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Expenses!A:H:append
Query Params:
valueInputOption = RAW
insertDataOption = INSERT_ROWS
Headers:
Authorization = Bearer {{google_sheets_access_token}}
Content-Type = application/json

YOUR_CREATED_SHEET_ID adalah placeholder penjelas. Pertahankan ID asli yang sudah ada pada URL awal; jangan menimpanya dengan placeholder itu. Pilih System Token Google Sheets yang sudah ada pada nilai Authorization, dan variabel URL percakapan bawaan pada isi permintaan.

Pada tab Body, masukkan:

{"values":[["{{date}}","{{month}}","{{item}}","{{category}}","{{amount}}","{{currency}}","{{note}}","{{conversation_url}}"]]}

Editor Body API Endpoint asli yang menampilkan baris pengeluaran dan chip parameter Konfigurasi Action pengeluaran lokal. Isi permintaan menentukan urutan sel; format parameter nominal menentukan tipe numeriknya.

Pertahankan tanda kutip di sekitar {{amount}} dalam editor. Placeholder yang persis ini merujuk ke parameter Decimal Number, sehingga substitusi menghasilkan angka JSON seperti 4.5. Menghapus tanda kutip membuat JSON editor tidak valid. Pada Sheet hasilnya, periksa bahwa E numerik dan termasuk dalam rumus.

API append Google menambahkan baris. RAW mempertahankan teks seperti catatan yang diawali = secara literal, bukan mengevaluasinya sebagai rumus. Parameter numerik memberikan tipe nominalnya.

Salin deskripsi Action penyimpan

Save one personal expense to the configured Google Sheet. Call only after the owner explicitly confirms the proposed date, item, category, amount and currency. Ask for missing or ambiguous fields before saving. After confirmation, append one row once. Report success only after a successful API response. If the outcome is uncertain, tell the owner to inspect the Sheet before submitting again.

Berikan instruksi kepada Pocket Ledger

Buka Identity → Main Prompt dan tempel berikut ini. Kedua Actions disebutkan agar target kedua bekerja setelah pembaca ringkasan ditambahkan.

Editor Main Prompt Pocket Ledger di Quickchat AI Main Prompt berada di Identity. Tangkapan lokal ini menunjukkan letak kolom; gunakan blok lengkap yang dapat disalin di bawah.

Aturan konfirmasi memberi Anda kesempatan untuk memeriksa. Anda dapat memperbaiki “EUR 4.50” menjadi “EUR 5.00” sebelum menyetujui pembelian; Agent seharusnya memperbarui usulan dan meminta konfirmasi lagi.

Salin Main Prompt Pocket Ledger

You are Pocket Ledger, a personal expense notebook.

For an expense, collect its date, item, positive amount and ISO currency code. Suggest a simple category and include an optional note only when supplied. Ask for an explicit YYYY-MM-DD date if it is missing or relative; do not guess today's date or the owner's timezone. Clarify ambiguous currency symbols. Derive month as YYYY-MM from the confirmed date.

Show the proposed date, item, category, amount and currency. Wait for explicit confirmation. Apply corrections and ask for confirmation again. Only then call log_lead_to_google_sheet once for that expense. Do not claim it was saved unless the Action succeeds. If a request fails or its outcome is uncertain, explain that and ask the owner to inspect the Sheet before retrying.

For monthly totals, ask for an explicit month and currency when unclear, then call read_expense_summary. Quote the matching month, currency and total returned from the Sheet. Keep currencies separate. A missing summary row is unavailable, not zero. Never calculate totals from remembered conversation messages.

Personal-data Actions are restricted to the owner's private Telegram chat. If a condition blocks an Action, do not claim success or suggest changing identity values in chat. This notebook handles typed expenses, not bank accounts, voice transcription or PDF receipts.

Simpan prompt, periksa kembali kedua kondisi eksekusi, lalu aktifkan Action pengeluaran. Namanya tetap log_lead_to_google_sheet; parameter, deskripsi, dan isi barunya kini menentukan alur pengeluaran.

Langkah 5: Bagaimana menyimpan pengeluaran pertama?

Sekarang tambahkan entri baru pertama ke buku catatan. Biarkan Telegram, Inbox, dan Sheet terbuka: Anda akan mengikuti kopi yang sama melalui ketiganya.

Dalam chat Telegram pribadi, kirim Coffee, 4.50 euros on 2026-11-04.
Periksa usulannya: tanggal 2026-11-04, barang Coffee, kategori Food, jumlah 4.50, mata uang EUR. Action menentukan month sebagai 2026-11 saat menyimpan baris.
Sebelum mengonfirmasi, periksa Expenses: hanya tiga baris awal yang seharusnya ada.

Telegram menampilkan usulan pengeluaran kopi sebelum pemilik mengonfirmasinya — Usulan ini memberi kesempatan untuk memeriksa tanggal, kategori, dan jumlah.

Telegram menampilkan Save it, diikuti konfirmasi sebenarnya bahwa kopi EUR 4.50 telah disimpan — Kirim Save it satu kali. Dalam pengujian ini, Agent menyimpan kopi setelah konfirmasi tersebut.

Kirim Save it satu kali, lalu buka percakapan di Inbox Quickchat AI. Balasan yang mengonfirmasi penyimpanan memiliki bagian 1 action called yang dapat dibuka. Buka bagian itu untuk melihat apa yang terjadi di balik jawaban singkat di Telegram.

Balasan penyimpanan kopi di Quickchat Inbox dengan bagian satu Action dipanggil yang dapat dibuka Konfirmasi yang sama di Inbox, dengan Action yang dapat diperiksa.

Buka Result → Show full. Periksa tanggal, bulan yang ditentukan dari tanggal, jumlah numerik, mata uang, dan status HTTP. Dalam pengujian langsung ini, Google mengembalikan HTTP 200, updatedRows: 1, dan updatedRange: Expenses!A5:H5.

Action pengeluaran yang dibuka di Inbox menampilkan input sebenarnya dan respons penambahan satu baris yang berhasil, dengan identitas pribadi disembunyikan Action penyimpanan mengirim jumlah 4.5 sebagai angka dan menulis satu baris. Identitas pribadi disembunyikan; rentang dan hasil yang dikembalikan tetap terlihat.

Terakhir, buka Expenses. Baris 5 seharusnya berisi kopi yang sama, dengan 2026-11 di kolom bulan, 4.50 di jumlah, dan EUR di mata uang. Kolom terakhir menautkan kembali ke percakapan Inbox, sehingga Anda dapat menelusuri entri ke pesan yang membuatnya.

Google Sheets setelah konfirmasi di Telegram, dengan kopi baru di baris 5 Expenses Pengeluaran keempat masuk melalui Telegram. Tautan Inbox pribadi disembunyikan dalam gambar yang dipublikasikan.

Kini Anda memiliki kebiasaan sehari-hari yang berguna: kirim, konfirmasi, periksa. Berikutnya, beri bot sumber yang dapat dipercaya untuk dibaca ketika Anda menanyakan penggunaan uang bulan ini.

Langkah 6: Bagaimana menanyakan total bulanan?

Biarkan Google Sheets menghitung total, lalu Action pembaca mengambilnya. Menyimpan perhitungan di Sheet membuat jawaban tetap dapat diperiksa setelah percakapan berakhir.

Tambahkan tab Summary

Jika Anda mengimpor buku kerja awal, Summary dan rumusnya sudah disiapkan. Nilai awalnya adalah EUR 7.70 dan USD 6.00; menyimpan kopi hanya mengubah baris EUR. Jika Anda membuat Sheet secara manual, ikuti langkah-langkah di bawah.

Tab Summary awal menampilkan EUR 7.70 dan USD 6.00 sebelum kopi disimpan Titik awal: dua mata uang, dua total yang terpisah.

Buat tab bernama Summary. Atur A:B sebagai Plain text, lalu masukkan month, currency, total pada A1:C1.
Masukkan 2026-11 dan EUR pada A2:B2, lalu 2026-11 dan USD pada A3:B3.
Masukkan rumus ini pada C2 dan isi ke bawah sampai C3. Format C sebagai angka dengan dua desimal.

=SUMIFS(Expenses!$E$2:$E$501,Expenses!$B$2:$B$501,A2,Expenses!$F$2:$F$501,B2)

Fungsi SUMIFS menjumlahkan nominal yang bulan dan mata uangnya cocok dengan baris ringkasan. Jika lokal Sheet mengharuskan titik koma antarargumen, ganti koma rumus dengan titik koma. Angka pada permintaan JSON tetap menggunakan titik desimal.

Rumus Summary yang sebenarnya dan total November yang diperbarui setelah kopi disimpan Pilih C2 untuk melihat rumus di balik EUR 12.20. Baris USD tetap 6.00.

Contoh perhitungan yang memisahkan total November EUR 12,20 dari USD 6,00 EUR 7,70 awal ditambah kopi baru EUR 4,50 menghasilkan EUR 12,20. Buku catatan USD 6,00 masuk ke totalnya sendiri.

Rumus awal mencakup baris 2 sampai 501. Dalam pengujian yang direkam ini, ketiga rentangnya berakhir di 502 setelah baris baru disisipkan. Sheets dapat menyesuaikan referensi saat penyisipan; pastikan ketiga rentang Expenses tetap sejajar dan perluas semuanya bersama-sama sebelum entri berada di luar rentang yang tercakup. Tambahkan baris ringkasan bulan/mata uang untuk setiap kombinasi yang ingin Anda tanyakan.

Tambahkan Action pembaca

Buka Actions & MCPs → Add Action → API Action. Gunakan Generate dengan permintaan berikut; Actions yang dihasilkan dimulai nonaktif. Namai read_expense_summary dan pertahankan When to run pada AI decides agar hasilnya dapat digunakan dalam jawaban. Gunakan ID spreadsheet asli dan System Token Google Sheets yang sama. Tidak diperlukan parameter dari pengguna.

Salin permintaan pembuat Action

Create a read-only Google Sheets Action named read_expense_summary. Use GET for the Summary!A1:C25 range of the spreadsheet already created by this Agent's Google Sheets integration. Reuse its actual spreadsheet ID and google_sheets_access_token System Token. Set valueRenderOption=UNFORMATTED_VALUE, no body, and no visitor parameters. Preserve the response headers and values. Leave it inactive so I can review the configuration and add my owner-ID and private-chat Run only when conditions before enabling it.

Bandingkan pengaturan yang dihasilkan dengan referensi berikut. Jika memilih Create manually, tambahkan kedua kondisi sebelum penyimpanan valid pertama, yang dapat mengaktifkan Action. Biarkan Response filter kosong pada kedua Actions agar kolom yang dipakai untuk pemeriksaan tetap tersedia.

Salin permintaan pembacaan ringkasan

GET https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Summary!A1:C25
Query Params:
valueRenderOption = UNFORMATTED_VALUE
Headers:
Authorization = Bearer {{google_sheets_access_token}}
Body: none

Endpoint values.get mengembalikan values pada rentang, termasuk judul kolom dan nominal yang dihitung. UNFORMATTED_VALUE mengembalikan hasil numerik, bukan string berformat mata uang. Biarkan respons tersedia bagi Agent agar nilai tersebut dapat dibaca.

Salin deskripsi Action pembaca

Read monthly expense totals from the configured Summary range. Use this when the owner asks for a total. Quote only the returned row matching the requested YYYY-MM and currency. If either is unclear, ask. If the row is absent or the request fails, say the total is unavailable. Never infer a total from conversation history, combine currencies, or accept a different spreadsheet ID or range from the visitor.

Terapkan dua kondisi Run only when yang sama dari Langkah 3, simpan, lalu aktifkan Action. Rentang baca mencakup 24 baris ringkasan; perluas rentangnya secara sengaja saat Anda menambahkan baris baru.

Action pembaca ringkasan pengeluaran dengan kondisi ID pemilik dan chat pribadi yang sama Action kedua membutuhkan kondisinya sendiri. Ini tangkapan pengaturan lokal, bukan pengujian otorisasi pengirim sungguhan.

Tanyakan What is my November 2026 total in EUR?, lalu tanyakan total USD. Dalam percakapan Telegram kami, Pocket Ledger mengembalikan 12.2 EUR dan 6 USD, sesuai dengan nilai Sheet yang diformat sebagai 12.20 dan 6.00. Bot membaca ringkasan yang tersimpan untuk setiap jawaban.

Jawaban Telegram yang sebenarnya untuk total November dalam EUR dan USD setelah kopi disimpan — Satu pertanyaan untuk setiap mata uang. Pocket Ledger membaca Sheet, bukan menjumlahkan pesan percakapan yang diingatnya.

Buka balasan total bulanan di Inbox dan buka detail Action-nya. Bandingkan baris yang dikembalikan dengan Summary!C2. Respons langsung di bawah mencakup 2026-11, EUR, 12.2, dan baris USD, 6 yang terpisah, dengan HTTP 200.

Action pembaca ringkasan pengeluaran di Inbox mengembalikan total November EUR dan USD yang sebenarnya dari Google Sheets Balasan, nilai yang dikembalikan, dan Sheet sekarang cocok. Inilah hasil akhir yang Anda lihat di bagian atas.

Bagaimana memeriksa kesalahan sebelum memakai pengeluaran nyata?

Uji permintaan yang tidak lengkap dan pengirim yang diblokir seteliti pengujian kopi yang berhasil. Pertahankan data demo sampai pemeriksaan di bawah lulus.

Coba ini	Yang perlu diperiksa
`Lunch, $12 yesterday`	Agent menanyakan mata uang dan tanggal sebenarnya. Tidak ada baris baru.
Koreksi nominal yang diusulkan sebelum mengonfirmasi	Usulan yang diperbaiki dikonfirmasi sebelum satu baris ditambahkan.
Tanyakan total November dalam EUR, lalu USD	Hasil terpisah: EUR 12,20 dan USD 6,00 untuk data contoh.
Tanyakan Desember 2026 tanpa baris ringkasan Desember	Agent menyatakan total tidak tersedia, bukan mengarang nol.
Pengirim kedua menanyakan total dan mencoba menyimpan pengeluaran	Kedua Actions ditolak dan tidak ada nilai pribadi yang diungkapkan.
Pemilik membuat permintaan yang sama di grup	Kedua Actions ditolak karena chat tidak pribadi.
Penyimpanan gagal atau melewati batas waktu	Jawaban menyatakan kegagalan atau ketidakpastian. Periksa Sheet sebelum mencoba lagi.

Untuk tes bahasa yang dapat diulang, buka Testing → Create Dataset → Paste messages dan gunakan pesan serta kriteria evaluasi dari kit. Jalankan percakapan lengkap secara terpisah untuk urutan konfirmasi. Metadata Preview atau Simulation adalah data uji; tidak membuktikan bahwa pengirim Telegram kedua yang sebenarnya diblokir.

Dataset pengujian Pocket Ledger dalam antarmuka Testing Quickchat AI yang sebenarnya Dataset lokal telah disiapkan untuk pengujian. Keberadaannya bukan bukti Simulation selesai atau penulisan ke Google Sheets.

Jika perilaku tidak sesuai, ubah satu instruksi yang relevan, ulangi input yang sama, lalu periksa kembali panggilan dan Sheet. Misalnya, append terlalu dini memerlukan pemeriksaan lebih dekat pada kalimat konfirmasi Action penyimpan. Konfirmasi adalah instruksi, bukan jaminan keunikan database. Setelah timeout, memeriksa Sheet lebih penting daripada mengirim lagi.

Setelah alur berfungsi, hapus baris pengeluaran fiktif, pertahankan judul kolom dan rumus, lalu tambahkan ringkasan untuk bulan serta mata uang yang benar-benar dipakai. Pembelian nyata pertama Anda dapat mengikuti rutinitas kecil yang sama seperti kopi.

Bisakah asisten AI membantu mengonfigurasi Pocket Ledger?

Asisten pengelolaan akun yang terhubung dapat membantu menyiapkan Agent dan memeriksa pengaturan Actions. Ikuti Manage with AI melalui listing ChatGPT atau listing Claude Quickchat AI. Berikan kit konfigurasi dan permintaan ini:

Help me configure Pocket Ledger from this setup kit. Inspect the available Quickchat AI tools first. Prepare the Main Prompt and the two HTTP Actions using the exact field names, numeric amount type and fixed ranges. Keep log_lead_to_google_sheet as the starter name. Ask me to complete Google OAuth and Telegram Bot Token setup in the dashboard. Apply both owner/private run conditions before enabling either Action. Do not run credit-consuming tests or append expenses until I ask. Report any setting your tools cannot configure so I can complete it in the dashboard.

Pemilik menyelesaikan persetujuan Google dan koneksi Telegram. Periksa pengaturan dan jalankan pemeriksaan yang sama di atas, siapa pun yang memasukkannya.

Pertanyaan umum

Bagaimana mencatat pengeluaran di Telegram dengan Google Sheets?

Hubungkan bot Telegram ke Quickchat AI Agent dan beri otorisasi Google Sheets. Konfigurasikan satu Action untuk menambahkan pengeluaran setelah konfirmasi dan satu lagi untuk membaca ringkasan bulanan berbasis rumus. Batasi kedua Actions ke ID pengguna Telegram Anda dan chat pribadi.

Bisakah bot memberi tahu total pengeluaran bulan ini?

Bisa, jika bulan dan mata uang yang diminta memiliki baris dalam rentang Summary yang dikonfigurasi. Google Sheets menghitung total dengan SUMIFS; Action pembaca mengambilnya. Action yang hanya menambahkan baris tidak dapat mengambil total, dan baris ringkasan yang tidak ada bukan berarti nol.

Bisakah orang lain membaca pengeluaran saya melalui bot Telegram?

Kedua Actions data pribadi harus mensyaratkan telegram_user_id Anda yang terverifikasi dan telegram_chat_type sama dengan private. Kondisi ini memblokir panggilan pengirim lain dan grup. Uji kedua kasus sebelum memasukkan data pribadi, serta batasi akses ke Sheet dan akun Quickchat AI.

Apakah pencatat pengeluaran Telegram ini gratis?

Membuat bot Telegram gratis. Paket Free Quickchat AI mendukung pembelajaran pribadi nonkomersial dengan kuota kredit AI terbatas. Jawaban AI dan Simulation Testing memakai kredit; penggunaan berkelanjutan bergantung pada kuota dan paket yang tersedia.

Apakah saya perlu Apps Script, Python, atau server otomatisasi?

Resep ini memakai Quickchat AI Actions dan rumus Google Sheets. Anda menempelkan pengaturan permintaan, isi JSON, dan prompt yang disediakan ke dasbor; tidak perlu men-deploy Apps Script, bot Python, atau server otomatisasi.

Bisakah saya memakai spreadsheet pengeluaran yang sudah ada?

Resep ini memakai spreadsheet yang dibuat oleh integrasi Google Sheets Quickchat AI. Otorisasi drive.file tidak memberi akses tanpa batas ke Drive. Jangan mengganti ID spreadsheet dengan file lama sembarang dan menganggapnya dapat diakses.

Bisakah bot membaca foto struk atau pesan suara?

Tutorial ini mencakup pengeluaran yang diketik. Ekstraksi struk memerlukan pengujian pengiriman gambar dan konfirmasi Telegram tersendiri sebelum dapat diandalkan. Transkripsi suara dan pembacaan struk PDF bukan bagian dari konfigurasi ini.

Bagaimana penanganan beberapa mata uang dan entri ganda?

Setiap mata uang memiliki total bulanan terpisah; resep ini tidak mengonversi mata uang. Konfirmasi mengurangi entri tidak sengaja tetapi tidak memberikan pencegahan duplikat atomik. Jika penyimpanan timeout, periksa Sheet sebelum mengirimkannya lagi.