ID
Panduan · Pemilik outlet
Tanyakan omzet, agenda, atau siapa yang perlu dihubungi, dan minta buatkan promo atau kelas, dari aplikasi AI yang sudah Anda pakai. Bukujanji menyediakan server MCP per outlet; Anda yang memilih aplikasi AI-nya dan Anda yang memberi izin.
Koneksi AI menghubungkan aplikasi AI pihak ketiga (misalnya ChatGPT, Claude, Gemini, atau Grok) ke SATU outlet Bukujanji melalui protokol MCP (Model Context Protocol). Setelah terhubung, aplikasi AI dapat memanggil sejumlah tool yang kami sediakan untuk membaca data outlet, dan, bila Anda mengizinkan, membuat atau mengubah sebagian data.
Koneksi AI ditujukan untuk pemilik outlet, bukan untuk pelanggan. Aplikasi AI-nya Anda pilih dan Anda bayar sendiri; Bukujanji hanya mengirim data yang diminta aplikasi itu, sebatas izin yang Anda berikan.
Pengingat WhatsApp dan Inbox WhatsApp bekerja dari nomor WhatsApp outlet sendiri dan memerlukan add-on Easy Booking by WhatsApp.
Setiap outlet punya alamat server sendiri, dengan slug outlet di belakangnya. Satu koneksi berlaku untuk satu outlet; untuk outlet lain, pakai alamat outlet itu.
https://api.bukujanji.com/mcp/{slug-outlet}Bila muncul pesan bahwa outlet belum punya slug, atur dulu alamat situs outlet di Website CMS. Alamat server tanpa slug (…/mcp) tidak dilayani.
Semua aplikasi AI memakai alur yang sama: tempel alamat server outlet sebagai konektor, masuk dengan akun pemilik, baca dan setujui layar persetujuan. Nama menu di tiap aplikasi dapat berubah dari waktu ke waktu; ikuti petunjuk resmi penyedianya bila berbeda dari yang tertulis di bawah.
Claude (claude.ai): buka pengaturan Konektor, tambahkan konektor kustom, beri nama, lalu tempel alamat server outlet. Selesaikan login dan persetujuan di jendela Bukujanji yang terbuka.
ChatGPT (chatgpt.com): nyalakan Developer mode di pengaturan, lalu tambahkan konektor/plugin kustom, tempel alamat server outlet, dan pilih autentikasi OAuth. Fitur ini bergantung pada paket ChatGPT Anda dan disiapkan lewat situs web, bukan aplikasi HP.
Klien MCP lain (Gemini, Grok, atau aplikasi MCP lainnya): tambahkan server MCP jarak jauh (remote, Streamable HTTP) dengan alamat server outlet dan autentikasi OAuth. Klien mendaftar sendiri secara otomatis (dynamic client registration). Tidak semua paket atau wilayah penyedia mengizinkan konektor kustom.
Saat halaman login Bukujanji muncul, masuk dengan akun pemilik dari outlet yang alamatnya Anda tempel. Bila peramban masih menyimpan sesi akun lain, permintaan ditolak dan aplikasi AI sering hanya menampilkan pesan umum seperti "connection can't be made". Keluar dari sesi lama lalu ulangi.
Di halaman yang sama Anda dapat memilih "Peran" tersimpan, bila outlet memilikinya. Peran menentukan izin koneksi sehingga centang manual diabaikan.
| Izin | Artinya |
|---|---|
| outlet:read | Membaca data outlet: jadwal dan booking, pelanggan, laporan, katalog dan harga, promo, kelas, tindak lanjut, dan dompet (angka saja). Selalu aktif. Cabut koneksi bila ingin menutupnya. |
| catalog:write | Menyiapkan data master: membuat layanan, meja/lapangan, kelas berjadwal mingguan, ruangan, karyawan, dan paket; mengatur jam operasional, kebijakan refund/reschedule, libur dan blokir waktu; mengubah harga, nama, deskripsi, dan kapasitas item yang ada; mengaktifkan atau menonaktifkan item. |
| promos:write | Membuat promo dan kode voucher, dengan batas: diskon maksimal 50% atau Rp 1.000.000, berlaku maksimal 90 hari, voucher wajib berkuota. |
| bookings:write | Memesankan kursi kelas dari paket aktif pelanggan, memindahkan booking kelas ke sesi lain, membatalkan booking dengan alasan (refund mengikuti kebijakan outlet), dan menandai kehadiran. |
| customers:write | Mendaftarkan pelanggan baru (beserta anak/peserta di outlet kelas), menambah anak/peserta ke pelanggan yang ada, dan menambah catatan pelanggan. |
| messages:write | Mengirim pengingat WhatsApp bertemplate (jadwal booking, paket akan habis, kuota tipis) ke satu pelanggan per panggilan, dari nomor WhatsApp outlet. |
| inbox:write | Membaca Inbox WhatsApp (nama, nomor, dan ISI CHAT pelanggan dikirim ke penyedia AI) dan membalas satu chat setelah Anda menyetujui teks persisnya. Mati kecuali Anda mencentangnya. |
Izin tulis dapat diubah kapan saja di Pengaturan → Koneksi AI → "Ubah izin" pada koneksi yang bersangkutan, tanpa menghubungkan ulang. Perubahan berlaku sekitar satu menit kemudian.
Tool baca tidak mengubah apa pun dan boleh dipanggil kapan saja oleh aplikasi AI, sebatas izin koneksi.
| Tool | Fungsi |
|---|---|
| get_outlet_context | Profil outlet: nama, zona waktu, jam buka, dan daftar layanan, lapangan, serta kelas aktif beserta id-nya. |
| explain_capabilities | Menjelaskan apa yang bisa dan tidak bisa dilakukan lewat koneksi ini. |
| get_agenda | Agenda satu tanggal atau rentang maksimal 7 hari: sesi kelas beserta peserta dan kursi tersisa, kunjungan layanan/lapangan, pembelian paket, dan yang dibatalkan. |
| check_availability | Keterisian satu hari: jam buka, libur, blokir waktu, cuti staf, dan kursi kosong. |
| get_booking | Detail satu booking berdasarkan kode transaksi, termasuk rincian uang (subtotal, diskon, total, terbayar, sisa). |
| search_customers | Mencari atau mendaftar pelanggan dengan filter (belum datang N hari, kelas tertentu, punya paket aktif, dan lain-lain), serta menghitung jumlah. Tanpa tanggal lahir dan catatan. |
| get_follow_ups | Daftar siapa yang perlu diurus: tagihan belum bayar, paket akan habis, kuota tipis, pelanggan lama tidak datang, sesi besok. |
| get_report_summary | Laporan per periode dengan angka yang sama seperti menu Laporan/Penjualan di dasbor (omzet, booking, per layanan, per karyawan, metode bayar, dan lain-lain). |
| get_price_list | Daftar harga: layanan beserta varian, tarif meja/lapangan, harga kelas, dan harga khusus. |
| get_promotions | Promo dan kode voucher: besaran, kuota terpakai, masa berlaku, dan status. Tanpa data pelanggan. |
| get_classes | Kelas beserta jadwal berulang, instruktur, kapasitas, dan harga. |
| get_wallet | Dompet outlet, baca saja: saldo, saldo tertahan, mutasi terakhir, dan penarikan terakhir. Tanpa nomor rekening. |
| get_setup_status | Kesiapan outlet baru: apa yang masih kurang dan risiko kebijakan refund/reschedule yang belum diputuskan. |
| get_whatsapp_inbox | Membaca daftar chat dan isi chat Inbox WhatsApp. Butuh izin inbox:write. |
| request_capability | Mencatat permintaan yang tidak bisa dipenuhi sebagai calon fitur untuk ditinjau tim Bukujanji (tanpa data pribadi pelanggan). |
Setiap tool tulis bekerja dalam DUA LANGKAH. Pertama, aplikasi AI memanggil tool tanpa konfirmasi dan menerima pratinjau persis apa yang akan dibuat atau diubah, beserta kode konfirmasi. Pratinjau itu ditunjukkan kepada Anda. Hanya setelah Anda menyetujuinya di percakapan, aplikasi AI memanggil lagi dengan argumen yang sama ditambah konfirmasi dan kode tadi. Kode dihitung dari isi pratinjau, sehingga perubahan yang berbeda dari yang Anda lihat ditolak.
| Tool | Fungsi | Izin |
|---|---|---|
| create_service | Membuat layanan baru dengan varian harga. | catalog:write |
| create_court | Membuat meja/lapangan/ruang sewa baru dengan tarif. | catalog:write |
| create_class | Membuat kelas baru dengan jadwal mingguan; sesi dibuat otomatis. | catalog:write |
| update_catalog_item | Mengubah harga, nama, deskripsi, status bisa-dibooking-online, dan kapasitas kelas pada item yang ada. Tidak mengubah jadwal kelas atau kategori. | catalog:write |
| set_catalog_item_status | Menonaktifkan atau mengaktifkan kembali layanan, meja/lapangan, kelas, promo, atau voucher. Datanya tetap ada. | catalog:write |
| setup_outlet | Mengisi jam operasional, ruangan, karyawan, jam kerja karyawan, tautan karyawan-layanan, paket, kebijakan refund/reschedule, libur, dan blokir waktu. | catalog:write |
| create_promo | Membuat promo diskon otomatis. | promos:write |
| create_voucher | Membuat kode voucher berkuota. | promos:write |
| book_package_seat | Memesankan kursi kelas dari paket aktif pelanggan (memakai kuota, tanpa pembayaran). | bookings:write |
| reschedule_booking | Memindahkan booking sesi kelas ke sesi lain dari kelas yang sama (alasan wajib). | bookings:write |
| cancel_booking | Membatalkan satu booking dengan alasan; dampak refund tampil di pratinjau. | bookings:write |
| mark_attendance | Menandai hadir atau membatalkan tanda hadir. | bookings:write |
| create_customer | Mendaftarkan pelanggan baru, bersama anak/peserta di outlet kelas. | customers:write |
| add_participant | Menambah anak/peserta ke pelanggan yang sudah ada (outlet kelas). | customers:write |
| add_customer_note | Menambah catatan pada pelanggan; catatan lama tidak dibaca maupun dihapus. | customers:write |
| send_whatsapp_reminder | Mengirim satu pengingat WhatsApp bertemplate ke satu pelanggan. | messages:write |
| reply_whatsapp_chat | Membalas satu chat Inbox dengan teks yang Anda setujui kata per kata. | inbox:write |
Bila Anda meminta hal yang tidak ada tool-nya, aplikasi AI diinstruksikan mencatatnya sebagai calon fitur (tanpa data pribadi pelanggan) dan memberi tahu Anda bahwa itu tetap dikerjakan di dasbor.
Bukujanji tidak mendorong data ke penyedia AI. Data keluar hanya ketika aplikasi AI Anda memanggil sebuah tool, dan hanya sebatas izin koneksi. Menurut layar persetujuan, kategori yang dapat dikirim:
Tidak dikirim: tanggal lahir, catatan pelanggan yang sudah tersimpan, dan data outlet lain. Setelah data sampai ke penyedia AI, penyimpanan dan penggunaannya mengikuti kebijakan privasi penyedia tersebut; sebagian paket individu dapat memakai percakapan untuk melatih model kecuali Anda menonaktifkannya di pengaturan penyedia. Sebagai pemilik outlet, Anda yang memutuskan pengiriman data pelanggan ini dan bertanggung jawab atas dasar hukumnya terhadap pelanggan Anda.
Untuk tiap panggilan, Bukujanji menyimpan catatan aktivitas: nama tool, berhasil atau tidak, durasi, dan argumen dalam bentuk tersamar (teks bebas hanya tersisa dua karakter pertama dan panjangnya). Isi yang dikembalikan ke aplikasi AI tidak disimpan di catatan itu. Rinciannya ada di Kebijakan Privasi, Bagian 5.1.
Mencabut koneksi tidak menghapus data yang sudah diterima penyedia AI. Untuk itu, hubungi penyedia aplikasi AI yang Anda pakai.
Mulai dengan pertanyaan, lalu tambahkan tindakan bila izin tulis sudah diberikan.
Bantuan lain dan permintaan terkait data pribadi: email support@bukujanji.com.