CatatKu tetap dapat digunakan seperti biasa tanpa mengaktifkan fitur tambahan. Jika ingin memakai ChatKu (Gemini AI) atau Google Sheets, ikuti panduan di bawah ini. Tidak perlu mengaktifkan keduanya sekaligus.
ChatKu merupakan asisten AI di dalam CatatKu untuk membantu Anda memahami dan menganalisis data keuangan. Fitur ini menggunakan API Key milik pengguna sendiri.
Sederhananya, API Key adalah semacam “kunci akses”. CatatKu membutuhkan kunci tersebut agar dapat meminta bantuan Gemini AI.
Setiap pengguna CatatKu sebaiknya menggunakan API Key miliknya sendiri. Jangan menggunakan API Key milik pembuat CatatKu.
Buka Google AI Studio menggunakan browser. Jika diminta masuk, masuk menggunakan akun Google Anda.
Berhasil jika: Anda sudah melihat halaman Google AI Studio.
Di Google AI Studio, cari bagian API Keys atau menu yang mengarah ke pengelolaan API Key.
Tekan Create API key. Google mungkin meminta Anda memilih atau membuat sebuah Project. Tidak perlu bingung: Project adalah wadah Google untuk mengatur penggunaan layanan Anda. Ikuti pilihan yang disediakan Google.
Setelah dibuat, Google akan menampilkan kode panjang, misalnya diawali dengan AIzaSy.... Salin hanya kode API Key milik Anda. Jangan menyalin tulisan “API Key”, tanda kutip, atau penjelasan lain.
Anggap API Key sebagai informasi rahasia. Jangan mengirimkannya kepada orang lain, memasukkannya ke postingan internet, membagikannya di grup, atau membuat screenshot yang memperlihatkan key tersebut.
Jika Anda merasa API Key sudah diketahui orang lain, buat API Key baru melalui Google AI Studio, masukkan key baru ke CatatKu, lalu nonaktifkan atau hapus key lama sesuai pilihan yang tersedia.
Ada penggunaan gratis, tetapi bukan berarti tanpa batas. Batas penggunaan dapat berbeda berdasarkan model dan project. Jika penggunaan melewati batas atau Anda menggunakan layanan berbayar, penggunaan dapat dikenakan biaya. Untuk penggunaan CatatKu biasa, Anda dapat memulai dari Free Tier terlebih dahulu.
Periksa apakah seluruh key sudah tersalin, hapus spasi di awal/akhir, atau buat API Key baru.
Bisa jadi penggunaan API sudah mencapai batas. Coba tunggu dan periksa penggunaan/quota di layanan Google.
Jika key lama tidak lagi diterima, buat API Key baru melalui Google AI Studio dan masukkan key baru tersebut ke CatatKu.
Buat API Key baru, masukkan kembali ke CatatKu, tutup dan buka kembali aplikasi, lalu coba lagi.
Google Sheets dapat digunakan sebagai tempat tambahan untuk menyimpan atau mencadangkan data CatatKu. Fitur ini opsional; CatatKu tetap dapat digunakan tanpa Google Sheets.
Data keuangan adalah data pribadi. Karena itu, CatatKu menggunakan model 1 pengguna → 1 Google Sheet → 1 konektor milik pengguna. Dengan begitu, spreadsheet berada di akun Google Anda sendiri.
Buka Google Sheets menggunakan komputer/laptop jika memungkinkan, lalu login dengan akun Google yang ingin digunakan.
Pilih Blank / Kosong atau tombol +.
Misalnya Data CatatKu, CatatKu Saya, atau Backup CatatKu. Namanya bebas.
Di Google Sheet, pilih Extensions / Ekstensi → Apps Script. Google akan membuka halaman baru.
Di halaman Apps Script, Anda akan melihat file Code.gs. Hapus kode contoh yang ada di dalamnya.
Untuk versi CatatKu yang dibagikan kepada pengguna, gunakan kode konektor final yang disediakan bersama aplikasi. Jangan menggunakan kode contoh dari internet atau kode lama yang tidak sesuai dengan versi CatatKu.
Struktur konektor CatatKu saat ini memang dirancang untuk menyimpan beberapa bagian data, termasuk transaksi, hutang, piutang, dan ringkasan. Konektor yang dipakai aplikasi tidak boleh diganti dengan contoh konektor sederhana yang hanya menerima tanggal, jenis, kategori, keterangan, dan jumlah.
Tekan Save / Simpan. Jika Google meminta nama project, Anda dapat memberi nama CatatKu atau CatatKu Google Sheets.
Saat pertama kali digunakan, Google mungkin meminta izin. Ini normal karena Apps Script membutuhkan izin untuk mengakses Google Sheet.
Di Apps Script, tekan Deploy → New deployment.
Pada jenis deployment, pilih Web app.
Pilih Me. Artinya script berjalan menggunakan akun Google yang membuat script.
Gunakan pengaturan akses yang ditentukan oleh konektor CatatKu. Pada konektor saat ini, pengaturan yang digunakan adalah Anyone agar aplikasi dapat mengirim request ke Web App.
Tekan Deploy dan selesaikan proses izin jika diminta.
Setelah berhasil, Google memberikan alamat Web App yang kurang lebih berbentuk:
https://script.google.com/macros/s/XXXXXXXXXXXXXXXXXXXX/execSalin URL tersebut. Yang dibutuhkan CatatKu adalah URL deployment yang berakhir dengan /exec.
Menyimpan perubahan pada Code.gs tidak selalu berarti deployment Web App yang sedang dipakai otomatis menggunakan versi terbaru. Jika pembuat CatatKu memberikan kode konektor baru dan meminta Anda memperbarui konektor, buka Deploy → Manage deployments → Edit, lalu perbarui deployment ke versi terbaru sesuai petunjuk yang diberikan.
Pastikan URL yang dimasukkan adalah URL Web App dan berakhir dengan /exec.
Ikuti proses otorisasi Google. Pastikan Anda menggunakan akun yang membuat spreadsheet dan Apps Script.
Periksa URL, deployment, izin, dan pastikan kode konektor yang digunakan memang versi CatatKu yang sesuai.
Periksa kembali deployment Web App dan perbarui versinya melalui Manage deployments jika memang diperlukan.
Tidak apa-apa. Google Apps Script memang terasa rumit bagi pengguna yang belum pernah menggunakannya.
Kalau Anda sudah mencoba mengikuti panduan tetapi tetap bingung atau gagal menghubungkan Google Sheets, silakan minta bantuan Ahmad Zubair, pembuat CatatKu.
Anda tidak perlu mengirim API Key Gemini kepada Ahmad. Untuk bantuan Google Sheets, cukup sampaikan masalah atau tunjukkan bagian yang membuat Anda bingung.
Kontak bantuan: Ahmad Zubair
WhatsApp Ahmad Zubair: 0857 0286 1262