Lompat ke konten utama
StableTerakhir diperbarui: 27 Okt 2026, 16.14

Admin & Self-Service Portal Pengaturan Toko

Panel Administrasi (Admin & Self-Service) adalah pusat kendali operasional bagi pemilik bisnis untuk mengonfigurasi identitas toko, mengarahkan gaya bahasa kecerdasan buatan, mengelola staf karyawan, mengatur template WhatsApp, menetapkan ambang batas peringatan, serta menentukan aturan notifikasi operasional tanpa memerlukan bantuan staf pemrogram. Seluruh perubahan pada antarmuka ini akan segera merambat pada infrastruktur layanan pelanggan di balik layar.

Stable

1. Ikhtisar & Nilai Bisnis

Setiap merek memiliki karakter komunikasi dan standar operasional yang unik. Panel Admin memungkinkan personalisasi mendalam dan pengelolaan teknis secara instan (self-service) di bawah satu portal terpusat (tersedia pada path /app/settings).

Dalam arsitektur multi-tenant DagangBot, setiap toko pedagang (merchant) menikmati alokasi konfigurasi terisolasi tingkat tinggi. Pengaturan persona bot, preferensi penagihan, serta parameter batas saldo sepenuhnya eksklusif bagi tenant bersangkutan, dan tidak akan membocorkan data referensi sistem kepada entitas luar.

  • Manajemen Multi-Tab Terpadu & Terpusat: Anda memiliki akses tak terbatas ke layar Profil Bisnis, Konfigurasi AI Bot, Pengaturan Instans WhatsApp, Manajemen Struktur Tim Staf, Parameter Katalog Produk Utama, hingga Konfigurasi Parameter Operasional Cabang Ritel.
  • Kustomisasi Persona Kognitif AI Penuh: Atur parameter panduan komunikasi (tone of voice), muatan pesan sapaan pertama statis (greeting message), pesan jaminan cadangan (fallback message) saat sistem tak mampu mencerna kueri, hingga panduan instruksi kustomisasi spesifik prompt spesifik tingkat lanjut.
  • Pusat Notifikasi & Konfigurasi Ambang Batas Otomatis: Lacak pemantauan kapasitas sisa kuota dan tentukan batas kritis pelaporan berkala (low balance warning limit) seperti ambang batas rasio peringatan 20% pada identitas profil toko pusat, atau rentang toleransi pemakaian saldo dompet cabang lokal mandiri senilai angka nominal koin minimum (branch_low_balance_amount). Sistem terintegrasi akan menjadwalkan notifikasi peringatan.
  • Desain Arsitektur Pertahanan Akses Bertingkat (RBAC): Menjamin pelindungan tingkat instans (tenant) menggunakan peranti keamanan isolasi otorisasi lintas pengguna (Role-Based Access Control / RBAC), serta pelindungan privasi komunikasi terenkripsi dari end-user sesuai standar ketat regulasi perlindungan data pribadi hukum lokal (PDP).
Efek Perubahan Seketika (Real-Time Sinkronisasi)

Seluruh konfigurasi arsitektur persona kognitif mesin, pergeseran batasan parameter rasio pelaporan pemakaian token pemotongan biaya saldo, serta penyuntingan status mutlak izin peran staf (RBAC) pada panel sistem disebar seketika memanfaatkan arsitektur asinkron simpul pemrosesan antrean worker event-bus di jaringan pusat, menghindari pemadaman mesin peladen berkala manual.

2. Alur Visual & Antarmuka Dasbor Manajemen Konfigurasi

Berikut adalah tampilan visualisasi cuplikan layar antarmuka menu pengelompokan panel pengaturan peranti administrasi persona konfigurasi tingkat manajemen pusat layanan toko terpadu:

Panel administrasi toko dan pengaturan persona bot AI
Dasbor pusat pengaturan identitas toko dan persona AI
Daftar periksa checklist onboarding merchant baru
Wizard mandiri aktivasi fitur toko 4 langkah

3. Panduan Langkah-demi-Langkah Konfigurasi Fungsional Operasional

Ikuti urutan prosedural pelacakan panduan penyesuaian fungsional kontrol tata kelola tingkat pusat sistem toko perusahaan platform ritel pada /app/settings:

  1. 1

    Langkah 1: Lengkapi Rincian Parameter Spesifikasi Profil Bisnis (Tab Profil Utama)

    Bukalah panel tab rute navigasi kontrol administrasi Profil (ProfileTab). Daftarkan pendaftaran nama legal entitas publik toko platform, konfigurasi penyetelan arsitektur perbedaan zona waktu lokal domisili peranti operasional perusahaan, alamat email kotak masuk korespondensi dukungan resmi perlengkapan rute manajemen dukungan utama perusahaan, alamat identitas tautan referensi properti halaman jaringan promosi distribusi, serta pendaftaran titik penempatan nomor telepon resmi dukungan layanan pengesahan pelanggan pusat. Tentukan spesifikasi pilihan klaster pengelompokan klasifikasi klasemen tipe entitas kategori perdagangan pada bagian Business Sector.

  2. 2

    Langkah 2: Parameter Instruksi Direktif Mesin Bahasa Kognitif (Tab Panel AI Bot)

    Pindahkan pendaftaran navigasi fokus perhatian manajemen pengaturan konfigurasi ke pangkalan tabulator pengawasan identitas modifikasi antarmuka instans peranti rute antarmuka cerdas AI Bot (BotConfigTab). Tentukan kustomisasi panduan spesifik pilihan Persona Preset gaya bahasa penanganan. Isikan parameter identitas sebutan subjek Bot Name, rentetan barisan untaian muatan pendaftaran pesan sapaan peluncuran interaksi awal Greeting Message, dan rute pendaftaran rincian pemberitahuan parameter cadangan keselamatan prosedur penyampaian peringatan transisi penundaan layanan dukungan (Fallback Message). Tambahkan panduan instruksi unik limitasi Persona Custom Prompt.

  3. 3

    Langkah 3: Spesifikasi Manajemen Instans Jaringan Jembatan WhatsApp (Tab WhatsApp)

    Akses perlengkapan pangkalan peranti penarikan tab rute navigasi pengelolaan jembatan pendaftaran WhatsApp. Tambahkan perangkat dengan memindai pelacakan gambar barisan kode pendaftaran aktivasi matriks QR Code peranti integrasi instans smartphone. Tetapkan pembatasan klasifikasi fungsi operasional Service Role pangkalan koneksi jaringan jalur gawai tersebut—menentukan apakah rute instalasi nomor komunikasi ponsel diinstruksikan murni khusus melayani fasilitas rutinitas dialog interaksi langsung pelanggan (chat_cs), terisolasi menyebarkan transmisi paket pembaruan notifikasi penyebaran status pengesahan transaksi logistik pelaporan order fungsional satu arah sistematis (notification), atau bauran campuran kapabilitas parameter jaringan layanan pengiriman broadcast massal berjadwal.

  4. 4

    Langkah 4: Rute Pembatasan Kendali Akses & Pembagian Wewenang Staf Internal (Tab Tim Manajerial & Modul Komponen Sistem)

    Navigasikan kursor rute penjelajahan panel kontrol utama administrasi penambahan pengguna menuju tab manajemen identitas relasi kepegawaian Tim. Ciptakan profil spesifikasi pendaftaran kredensial penyusupan penambahan agen staf baru disertai perlekatan wewenang izin kontrol batasan pelacakan sistem rute pemisahan kekuasaan klasifikasi isolasi kontrol terstruktur komando fungsi (Role-Based Access Control), dengan pengelompokan label fungsional khusus Administrator Pusat (Admin), Pelaksana Layanan Dukungan Interaktif Staf (CS), atau tingkatan Otorisator Pengawas Supervisi Pemantau Kinerja Kelompok Pengelola Wilayah Lokasi Cabang Daerah (Branch Manager). Penambahan isian pelaporan wajib memasukkan pengidentifikasi spesifik konfigurasi kontak saku smartphone pribadi (WhatsApp Number) staf terpilih (bukan instans nomor perusahaan gateway) demi memastikan ketersediaan pengiriman notifikasi internal, termasuk penyebaran eskalasi keluhan tingkat tinggi pelaporan ringkasan log periodik harian, serta gema peringatan cadangan persediaan minimum penagihan bulanan sistem toko (low balance alert limit).

4. Parameter & Spesifikasi Teknis

Setiap tab pada antarmuka /app/settings memetakan parameter payload JSON langsung menuju ke API Endpoint di peladen (backend). Berikut ini rincian komprehensif berdasarkan struktur komponen (components/settings/):

4.1. Tab Profil Bisnis (ProfileTab)

Komponen BusinessProfileCard menyimpan identitas jenama (brand).

  • Nama & Sektor: Tersimpan di tenant_settings. Business Sector memengaruhi bagaimana AI menerjemahkan terminologi spesifik industri (misalnya F&B menggunakan kata "Porsi", sementara Fashion menggunakan "Ukuran").
  • Kunci API (API Key Management): Fitur untuk membuat atau meregenerasi secret key (ApiKeyManagementCard via RegenerateApiKeyModal) bagi kebutuhan integrasi webhook khusus.
  • Endpoint Internal: /api/dashboard/merchant/profile.

4.2. Tab Konfigurasi AI Bot (BotConfigTab)

Komponen ini mengatur perilaku inti kecerdasan buatan, terdiri dari:

  • SystemPromptCard: Anda dapat mendiktekan aturan mutlak (system prompt). Misalnya: "Selalu tolak permintaan negosiasi harga."
  • SectorTerminologyCard: Mengelola kamus padanan kata khusus industri, mencegah bot kebingungan jika pelanggan memakai singkatan lokal.
  • PersonaSelectorCard: Mengatur karakter balasan (Sopan, Ramah, Profesional, atau Kasual) yang memengaruhi gaya generasi teks LLM.
  • AutoMessagesCard: Konfigurasi statis untuk Greeting Message dan Fallback Message.
  • API Endpoint: Akses payload ke /api/dashboard/merchant/bot-config.

4.3. Tab Operasional (OperationalTab)

Komponen OperationalTab memastikan sistem sejalan dengan jam kerja dunia nyata Anda.

  • WeeklyHoursCard: Mengatur jadwal operasional spesifik per hari (misal Senin-Jumat 09.00-17.00).
  • OutsideHoursBehaviorCard: Parameter yang menentukan apa yang AI lakukan saat di luar jam operasional. Opsinya: Auto-reply (membalas "Toko tutup"), AI Assist (AI tetap merespons tapi memperingatkan pengiriman besok), atau Ignore (AI berhenti membalas hingga jam buka).
  • HolidaysManagerCard: Kalender khusus hari libur nasional atau tutup toko sementara. Otomatis menimpa Weekly Hours.

4.4. Tab Manajemen Instans WA (WhatsAppTab)

Panel pengaturan konektivitas gerbang WhatsApp.

  • WhatsAppInstanceList: Tabel instans aktif, menunjukkan session_id, status connected/disconnected, dan persentase baterai ponsel host.
  • WhatsAppCapabilityModal: Mengatur bidang service_role. Nilai chat_cs murni melayani pesan masuk AI, notification untuk pengingat transaksi, dan broadcast khusus promosi.
  • WhatsAppTemplatesManager: Menyinkronkan daftar (template) dari Meta Graph API dan memetakannya pada parameter internal.

4.5. Pengaturan Privasi & PDP (privacy)

Laman independen di bawah settings untuk kepatuhan Pelindungan Data Pribadi (PDP).

  • PrivacyRequestsTable: Tabel manajemen permintaan hak penghapusan atau koreksi data dari pelanggan akhir (menggunakan usePrivacyRequestsTable).
  • PrivacyConsentTable: Daftar riwayat rekam jejak pesetujuan (consent) pelacakan kuki dan promosi.
  • AccountDeletionPanel: Bagi merchant untuk mengajukan penghapusan mandiri seluruh instans tenant beserta pangkalan datanya.

5. Kasus Tepi (Edge Cases)

Operasional toko yang kompleks sering berbenturan dengan kondisi anomali. Berikut adalah panduan penanganan aplikasi pada kondisi batas (edge cases):

Skenario Kasus Tepi Tindakan Sistem Penjelasan Teknis & Resolusi
Perubahan API Key saat webhook aktif Semua transaksi webhook lama langsung Unauthorized (401). Regenerasi API melalui RegenerateApiKeyModal segera menghapus kunci cache di Redis peladen. Segera ganti kunci API di aplikasi pihak ketiga Anda.
Cakupan operasional libur di tengah percakapan Bot mendadak berganti mode balasan otomatis. Jika OutsideHoursBehavior diatur ke Auto-reply, pesanan yang setengah jalan (belum Checkout) akan dijeda oleh AI hingga jam operasional kembali aktif keesokan harinya.
Instans WA dihapus saat memproses Broadcast Queue terhenti parsial. Modul queue mendeteksi ketiadaan instance ID dan mengembalikan status pekerjaan (job) ke Failed/Dropped.
Penambahan staf baru melampaui lisensi kuota paket Gagal menambah staf (Limit Exceeded). Batas alokasi users_limit di database ditolak saat insert RLS. Anda harus meningkatkan (upgrade) paket atau menonaktifkan pengguna lama.

6. Pemecahan Masalah (Troubleshooting)

Tabel berikut menjabarkan permasalahan umum dan solusi penyelesaian teknis pada antarmuka dasbor pengaturan:

Gejala Masalah Akar Penyebab Solusi Penanganan
Bot AI gagal menerapkan perintah dari Custom Prompt Konflik gaya bahasa: instruksi kustom bertentangan dengan Persona Preset yang dipilih, atau instruksi terlalu spesifik yang mengesampingkan panduan dasar. Persingkat Custom Prompt maksimal menjadi 3-5 kalimat direktif padat. Pilih Preset yang paling berdekatan karakternya.
Pesan notifikasi pembayaran (order) tidak pernah masuk ke nomor pelanggan Nomor WhatsApp gateway tidak dikonfigurasi dengan kapabilitas (capabilities) notification atau broadcast. Pada tab WhatsApp, ubah Service Role nomor tersebut untuk mencakup peran Notifikasi.
Staf manajer tidak mendapat peringatan limit saldo Kontak internal staf salah format atau nilai low_balance_warning_percent (konfigurasi peringatan) pada sistem terlalu rendah. Ubah format kontak internal manajer di tab Tim ke standar internasional (628xxx). Naikkan ambang persentase minimal.
Gagal menambah pengguna baru (Limit Exceeded) Paket langganan atau lisensi tenant telah mencapai batas penambahan jumlah agen/staf pelanggan. Perbarui paket (upgrade) atau nonaktifkan satu staf lama (suspend/delete) untuk memberikan ruang slot baru.

7. Referensi Terkait

content/docs/features/admin.mdx
Terakhir diperbarui: 27 Okt 2026, 16.14

Dokumentasi teknis DagangBot