QuantumRank AI · Growth & Social Operating System multi-tenant

Panduan Penggunaan QuantumRank AI

Cara kerja seluruh menu QuantumRank AI — dari menghubungkan kanal, siklus konten, publikasi, inbox, CRM, listening, SEO, otomasi, hingga tata kelola akses dan keamanan.

Versi panduan 1.0 · diperbarui 28 Juli 2026

Buka aplikasi Minta pendampingan

Prinsip utama

QuantumRank AI hanya menghubungkan kanal melalui otorisasi resmi pemilik akun. Sistem tidak membuat akun media sosial, tidak meminta kata sandi kanal, dan tidak melewati CAPTCHA, OTP, MFA, pembatasan platform, atau proses review penyedia.

Siapa yang menggunakan panduan ini

•System Owner dan Super Admin yang mengelola struktur SaaS, billing, cakupan akses, serta tata kelola.
•Tenant Owner dan Agency Admin yang mengelola workspace pelanggan, kanal, konten, pengguna, dan otomasi.
•Social Media Manager, Content Approver, Community Manager, Analyst, dan Viewer sesuai izin masing-masing.

Bab 1

Memulai dan navigasi dasar

Akses akun, menerima undangan, memilih workspace, membuka menu pada perangkat seluler, mengganti tema, dan keluar.

A. Masuk ke aplikasi

01Buka halaman Masuk. Akses workspace hanya tersedia bagi pengguna yang telah memiliki akun atau memperoleh undangan admin.
02Masukkan email dan kata sandi minimal 8 karakter, lalu pilih Masuk. Alternatifnya, pilih Lanjutkan dengan Google.
03Apabila terlalu banyak percobaan gagal, sistem menampilkan pembatasan sementara. Tunggu sebelum mencoba kembali.
04Setelah autentikasi berhasil, sistem mengarahkan Anda ke Dashboard atau halaman tujuan dari tautan undangan.

B. Menerima undangan workspace

01Buka tautan undangan yang dibuat admin. Jangan mengubah parameter token pada tautan.
02Masuk menggunakan alamat email yang sama dengan email penerima undangan.
03Sistem memeriksa status undangan, masa berlaku, dan kecocokan email. Undangan yang dicabut, kedaluwarsa, sudah digunakan, atau tidak cocok akan ditolak.
04Setelah diterima, sesi diperbarui dan Anda diarahkan ke Dashboard dengan peran yang telah ditetapkan.

C. Navigasi konsol

Elemen	Cara menggunakan	Hasil / catatan
Sidebar kiri	Pilih grup Ikhtisar, Operasi, Intelijen, Otomasi & AI, Langganan, Hierarki akun, atau Tata kelola.	Menu disaring otomatis berdasarkan permission akun.
Tombol menu (☰)	Pada ponsel, sentuh tombol di kiri atas untuk membuka sidebar; sentuh area gelap untuk menutup.	Tidak mengubah data.
Pemilih Tenant	Jika akun memiliki lebih dari satu workspace, pilih tenant dari daftar di bagian bawah sidebar.	Semua data halaman beralih ke tenant aktif dan tetap terisolasi.
Status AI	Lihat badge AI aktif, AI status, atau Kill switch pada header.	Kill switch aktif menolak eksekusi AI sesuai cakupan.
Tema terang/gelap	Sentuh ikon bulan/matahari pada header.	Mengganti mode gelap dan terang.
Keluar	Sentuh Keluar pada kartu profil di bawah sidebar.	Sesi lokal berakhir dan kembali ke halaman Masuk.

Mengapa menu bisa berbeda?

Menu muncul hanya apabila akun memiliki permission yang sesuai. Contoh: Analyst melihat modul analitik, tetapi tidak dapat mengelola koneksi; Security Admin melihat Security & Audit, tetapi bukan pipeline konten.

Bab 2

Dashboard

Command center untuk membaca kesehatan kanal, percakapan, lead, konten, reputasi, biaya AI, dan keamanan.

Elemen	Cara menggunakan	Hasil / catatan
Buat konten baru	Pilih tombol di kanan judul halaman.	Membuka menu Content.
Kanal terhubung	Bandingkan jumlah kanal CONNECTED dengan seluruh kanal yang tersedia.	Kanal harus dihubungkan melalui Connections.
Skor kesehatan kanal	Periksa rata-rata health token dan permission.	Skor rendah memerlukan refresh token atau otorisasi ulang.
Percakapan terbuka	Lihat jumlah thread unread, open, atau pending.	Buka Inbox untuk menindaklanjuti.
Lead terkualifikasi	Lihat lead berstatus QUALIFIED atau PROPOSAL.	Buka Growth CRM untuk mengubah tahap.
Konten menunggu review	Lihat konten dengan status IN_REVIEW.	Approver perlu membuka Content dan memilih Setujui atau Minta revisi.
Mention risiko tinggi	Lihat mention dengan risk score ≥ 70.	Tinjau melalui Listening.
Estimasi biaya AI	Baca biaya rata-rata per eksekusi, total periode, proyeksi, token, kapabilitas, dan model.	Angka indikatif untuk transparansi kuota, bukan tagihan.
Security event terbaru	Pilih Lihat semua untuk membuka Security & Audit.	Menampilkan event append-only dari backend.

Cara membaca Dashboard

Gunakan Dashboard sebagai halaman pemeriksaan awal setiap hari. Prioritaskan kanal dengan health rendah, konten yang menunggu approval, percakapan terbuka, mention risiko tinggi, dan peringatan keamanan.

Bab 3

Connections

Menghubungkan, menyegarkan, mengotorisasi ulang, dan mencabut akses kanal melalui OAuth resmi.

Langkah menghubungkan kanal

01Pastikan Anda memiliki izin connections.manage dan kredensial aplikasi platform sudah dikonfigurasi pada server.
02Cari kartu platform yang ingin dihubungkan, lalu pilih Hubungkan lewat platform.
03Selesaikan layar consent resmi menggunakan akun pemilik kanal dan berikan scope yang dibutuhkan.
04Setelah callback berhasil, periksa badge CONNECTED, nama akun, account ID, masa berlaku token, scope, dan health score.
05Gunakan Segarkan token bila token mendekati kedaluwarsa atau health menurun.
06Gunakan Cabut akses untuk menghapus otorisasi kanal dari workspace. Hubungkan ulang apabila diperlukan.

Elemen	Cara menggunakan	Hasil / catatan
Scope badge	Bandingkan scope wajib dengan scope yang telah diberikan.	Hijau berarti diberikan; netral berarti belum lengkap.
Otorisasi ulang	Muncul ketika status NEEDS_REAUTHORIZATION.	Pemilik akun harus menyelesaikan consent baru.
Configured	Tombol koneksi dinonaktifkan bila kredensial server belum ada.	Minta operator teknis mengisi client ID/secret provider.
Pesan OAuth	Baca banner invalid state, expired state, denied, missing scope, atau token exchange failed.	Mulai ulang dari halaman Connections dan jangan memakai callback lama.

Dukungan kanal

Sistem mendefinisikan Facebook Pages, Instagram Professional, TikTok, X, LinkedIn Organization, YouTube, Google Business Profile, dan WhatsApp Business. Kapabilitas tetap bergantung pada permission, account type, wilayah, paket API, serta review platform.

Bab 4

Content

Membuat konten dan menjalankan state machine dari draf sampai arsip.

Membuat draf baru

01Isi Judul dan Isi konten.
02Pilih tingkat risiko LOW, MEDIUM, atau HIGH sesuai sensitivitas pesan dan dampak publik.
03Pilih satu atau beberapa Kanal tujuan. Publikasi hanya berhasil pada kanal yang sudah terhubung dan memiliki kapabilitas yang diperlukan.
04Pilih Simpan sebagai draf. Tombol aktif setelah judul, isi, dan minimal satu kanal terisi serta akun memiliki content.manage.

DRAFT→AI GENERATED→IN REVIEW→APPROVED→SCHEDULED→PUBLISHED

Elemen	Cara menggunakan	Hasil / catatan
Edit ke draf	Mengembalikan IDEA, AI_GENERATED, atau CHANGES_REQUESTED ke DRAFT.	Gunakan untuk penyuntingan manual.
Generate AI	Dari DRAFT, jalankan pembuatan versi AI.	Status menjadi AI_GENERATED.
Kirim review	Kirim DRAFT atau AI_GENERATED ke pemeriksa.	Status menjadi IN_REVIEW.
Minta revisi	Approver menolak sementara dan memberi jalur revisi.	Status menjadi CHANGES_REQUESTED.
Setujui	Approver menyetujui konten.	Status menjadi APPROVED.
Jadwalkan / Publikasikan	Meneruskan konten ke proses publishing.	Tindakan publik tetap melalui job dan permission publish.
Ulangi	Digunakan pada FAILED atau PARTIALLY_PUBLISHED.	Kembali ke SCHEDULED.
Batalkan / Arsipkan	Menghentikan jadwal atau menutup siklus konten.	Status terminal CANCELLED atau ARCHIVED.

Kontrol versi

Setiap tindakan mengirim expected version. Jika konten sudah berubah di sesi lain, server dapat menolak untuk mencegah overwrite atau approval terhadap versi lama.

Bab 5

Publishing

Mengantrikan publikasi segera atau terjadwal dan mengelola hasil per kanal.

Mengantrikan publikasi

01Pastikan konten telah berstatus APPROVED atau SCHEDULED.
02Kosongkan kolom Jadwal untuk publikasi segera, atau pilih tanggal dan waktu untuk publikasi terjadwal.
03Pilih Antrikan publikasi atau Jadwalkan publikasi.
04Pantau Riwayat job. Setiap job mempunyai idempotency key, jadwal, jumlah percobaan, max attempts, dan hasil per kanal.
05Gunakan Batalkan pada job SCHEDULED atau QUEUED.
06Gunakan Coba lagi pada job FAILED atau PARTIALLY_PUBLISHED. Kanal yang gagal dapat diproses ulang tanpa menggandakan hasil yang sudah berhasil.

Status	Arti	Hasil / catatan
PUBLISHED	Publikasi kanal berhasil.	External ID ditampilkan bila provider mengembalikannya.
PROVIDER_NOT_CONFIGURED	Adapter/kredensial provider belum siap.	Konfigurasikan provider sebelum retry.
RETRY_SCHEDULED	Sistem menjadwalkan retry dengan backoff.	Tunggu next attempt atau gunakan kontrol yang tersedia.
PARTIALLY_PUBLISHED	Sebagian kanal berhasil dan sebagian gagal.	Gunakan Coba lagi; job per kanal mencegah kegagalan menyeluruh.

Idempotensi

Jangan membuat ulang konten hanya karena satu kanal gagal. Gunakan retry pada job yang sama agar sistem menjaga idempotency dan jejak audit.

Bab 6

Inbox

Menangani komentar, pesan, dan ulasan lintas kanal dalam satu tampilan.

Elemen	Cara menggunakan	Hasil / catatan
Filter status	Pilih Semua, unread, open, pending, resolved, atau archived.	Daftar thread langsung disaring.
Ubah status	Pilih status pada kartu percakapan.	Memerlukan inbox.manage.
Kirim balasan	Tulis balasan lalu pilih Kirim balasan.	Hanya tersedia bila provider dan capability mendukung reply.
Reply unsupported	Balas melalui aplikasi resmi platform.	QuantumRank AI tetap dapat mengubah status dan menyimpan audit.
Konversi ke lead	Pilih Konversi ke lead pada percakapan yang belum terhubung ke CRM.	Satu thread hanya menghasilkan satu lead secara idempoten.
Lihat riwayat	Buka daftar pesan masuk/keluar, delivery status, waktu, dan failure reason.	Pilih Tutup riwayat untuk menyembunyikan.

SOP respons

Mulai dari unread/open, baca sentimen dan konteks, balas bila API mendukung, ubah status menjadi pending bila menunggu pelanggan, lalu resolved setelah selesai. Konversi ke lead apabila ada kebutuhan komersial yang jelas.

Bab 7

Growth CRM

Mengelola lead, nilai pipeline, status penjualan, aktivitas, dan retensi data.

Elemen	Cara menggunakan	Hasil / catatan
Statistik	Baca total lead, nilai pipeline dalam Rupiah, dan skor rata-rata.	Nilai dihitung dari seluruh lead tenant aktif.
Daftar lead	Periksa nama, sumber, status, nilai, catatan, dan skor.	Lead dari Inbox ditandai “dari inbox”.
Tahap lead	Pilih NEW, QUALIFIED, PROPOSAL, WON, atau LOST.	Memerlukan izin pengelolaan inbox/CRM.
Lead manual	Isi Nama lead dan Estimasi nilai (Rp), lalu pilih Tambah lead.	Sumber disimpan sebagai manual.
Retensi data	Ubah action antara redact dan purge untuk domain yang tersedia.	Redact menyamarkan; purge menghapus sesuai kebijakan.
Jalankan retensi sekarang	Menjalankan kebijakan retensi secara manual.	Gunakan setelah verifikasi kebijakan dan legal hold.
Aktivitas terakhir	Baca tipe aktivitas, ringkasan, dan waktu.	Membantu audit perubahan pipeline.

Nilai pipeline

Masukkan estimasi realistis dalam Rupiah. Jangan menggunakan nominal pemasukan pasti sebelum lead berstatus WON.

Bab 8

Listening

Memantau percakapan publik dari API resmi, menilai sentimen, risiko, confidence, dan tinjauan manusia.

Membuat query listening

01Isi Nama query, misalnya “NagaLox - reputasi nasional”.
02Isi Ekspresi kata kunci yang relevan. Gunakan nama merek, produk, figur, isu, atau frasa spesifik.
03Pilih Sumber resmi yang ingin dipantau.
04Pilih Simpan query. Sistem membuat query dan source dengan mode polling.
05Pilih query pada panel Query aktif untuk memfilter hasil, atau gunakan Semua hasil.

Elemen	Cara menggunakan	Hasil / catatan
Hanya perlu ditinjau	Centang filter agar hanya event requires_review yang tampil.	Memudahkan human review.
Sentiment	Baca positive, neutral, atau negative.	Selalu pertimbangkan confidence dan konteks teks.
Risk score	Prioritaskan nilai ≥ 70 sebagai risiko tinggi.	Dapat digunakan sebagai trigger Automation.
Confidence	Nilai persentase keyakinan model.	Confidence rendah perlu tinjauan manusia.
Valid	Konfirmasi hasil deteksi.	Menyimpan decision confirmed.
Salah deteksi	Tandai false positive.	Berguna untuk evaluasi model.
Eskalasi	Naikkan ke penanganan risiko/reputasi.	Menyimpan decision escalated.
Abaikan	Tutup event yang tidak relevan.	Menyimpan decision dismissed.
Ingestion terakhir	Baca sumber, trigger, status, received, inserted, duplicate, dan failed.	Gunakan untuk memeriksa kesehatan pengambilan data.

Batas legal dan platform

Listening hanya mengambil data publik dari API resmi yang telah diizinkan. Ketersediaan data bergantung pada kebijakan, permission, produk API, dan persetujuan platform.

Bab 9

SEO Rank

Membuat proyek SEO, memverifikasi domain, menghubungkan Search Console, memantau kata kunci, rekomendasi, dan alert.

Membuat dan menyiapkan proyek

01Pilih Tambah proyek, isi Nama proyek dan Domain, lalu pilih Simpan.
02Pilih proyek dari daftar domain di bagian atas.
03Pilih metode verifikasi: meta tag, berkas HTML, DNS TXT, atau Google Search Console.
04Pilih Terbitkan token, pasang token pada domain, lalu pilih Cek verifikasi.
05Untuk Search Console, isi URL properti persis seperti di Search Console dan ID koneksi Google dari modul Connections, kemudian pilih Simpan properti.
06Tambahkan kata kunci satu per baris, maksimal 100 per proses dan 500 per proyek.
07Pilih Jalankan pengecekan setelah domain terverifikasi dan sumber resmi tersedia.

Elemen	Cara menggunakan	Hasil / catatan
Skor SEO	Baca skor, kelengkapan data, dan apakah hasil berupa estimasi.	Rincian komponen menjelaskan kontribusi tiap faktor.
Kata kunci	Baca posisi terbaru, previous, pergerakan, best position, perangkat, negara, bahasa, dan tanggal cek.	Angka lebih kecil berarti posisi lebih baik.
Rekomendasi	Pilih Tandai selesai atau Abaikan.	Tersedia bagi role yang boleh mengedit.
Peringatan	Pilih Akui atau Selesaikan.	Critical perlu prioritas.
Riwayat pengecekan	Periksa sumber data, processed, skipped, status, dan error code.	Idempotent replay berarti pengecekan hari itu sudah dijalankan.
Kebijakan data SEO	Baca retensi snapshot/performa, threshold penurunan, kuota harian, dan legal hold.	Pilih Simpan kebijakan setelah perubahan yang sah.

Sumber data resmi

Peringkat tidak diukur sebelum domain terverifikasi dan properti Search Console/koneksi resmi tersedia. Status provider_not_configured bukan hasil peringkat, melainkan konfigurasi yang belum lengkap.

Bab 10

Automation

Membuat workflow ter-versi dengan trigger, kondisi, action, approval, retry, dan dead letter.

Membuat workflow

01Isi Nama minimal 3 karakter dan Deskripsi.
02Isi Trigger, misalnya listening.negative_spike.
03Isi Field kondisi, pilih Operator eq, neq, contains, gt, lt, atau exists, lalu isi Nilai.
04Pilih Action dari registry. Perhatikan label risk dan indikator approval.
05Isi Catatan versi agar alasan perubahan dapat diaudit.
06Aktifkan Wajib approval untuk action non-low dan pilih apakah workflow langsung aktif.
07Pilih Simpan versi. Setiap perubahan workflow aktif membuat versi baru.

Elemen	Cara menggunakan	Hasil / catatan
Aktifkan/Nonaktifkan	Mengubah apakah workflow dapat dijalankan.	Memerlukan automation.manage.
Jalankan	Menambahkan run manual untuk workflow aktif.	Tidak tersedia bila workflow nonaktif.
Menunggu persetujuan	Pilih Setujui atau Tolak untuk action berisiko.	Action tidak dieksekusi sebelum keputusan manusia.
Run terakhir	Baca correlation ID, action count, depth, attempt, error detail, dan status.	failed/timeout dapat berakhir pada dead letter.
Batas eksekusi	Perhatikan max actions, max depth, cycle detection, retry, dan dead letter.	Mencegah loop dan over-automation.

Praktik aman

Mulai dengan workflow nonaktif dan approval wajib. Jalankan secara manual, periksa run dan audit, lalu aktifkan setelah kondisi dan action teruji.

Bab 11

AI Studio

Menjalankan agen AI melalui policy engine, mengelola agent, kill switch, policy matrix, dan riwayat eksekusi.

Menjalankan agen

01Jika tenant belum memiliki agen, role dengan security.manage memilih Provision agen bawaan.
02Pilih Agen dan Capability yang tersedia.
03Isi Tujuan yang jelas dan Konteks yang relevan. PII diredaksi di server sebelum diproses dan dicatat.
04Pilih Eksekusi agen. Server mengevaluasi policy, kill switch, risk tier, human-only, dan approval.
05Periksa pesan hasil, riwayat eksekusi, keputusan policy, model, prompt version, latency, token, confidence, dan correlation ID.

Elemen	Cara menggunakan	Hasil / catatan
Mode simulasi	Muncul bila penyedia model belum dikonfigurasi.	Output deterministik/template dan run ditandai simulated.
Kill switch global	Menghentikan eksekusi AI seluruh sistem.	Hanya role berwenang; evaluasi paling awal.
Kill switch tenant	Menghentikan AI pada tenant aktif.	Tidak memengaruhi tenant lain.
Agen tenant	Aktifkan atau nonaktifkan agen satu per satu.	Agen nonaktif tidak dapat dieksekusi.
Policy matrix	Baca capability, risk, default decision, human-only, dan cakupan kill switch.	Keputusan dapat allow, require_approval, atau deny.
Riwayat eksekusi	Periksa live model/simulated, approval, error, token, dan latency.	Gunakan correlation ID untuk investigasi.

Urutan kill switch

Evaluasi dilakukan global → tenant → agent → capability. Bila salah satu scope aktif, eksekusi terkait ditolak sebelum model dijalankan.

Bab 12

Langganan Saya

Halaman baca-saja untuk melihat paket aktif, biaya, periode, entitlement, pemakaian, dan riwayat.

Elemen	Cara menggunakan	Hasil / catatan
Paket aktif	Baca nama dan tagline paket tenant.	Perubahan paket dilakukan role pengelola billing.
Biaya langganan	Baca biaya bulanan/tahunan dalam Rupiah atau status harga kustom.	Belum termasuk PPN bila disebutkan.
Periode berjalan	Baca tanggal mulai dan berakhir.	Badge menunjukkan active, trialing, past due, cancelled, dan lainnya.
Entitlement	Bandingkan used value dengan limit per fitur.	Backend menegakkan batas; “Tidak termasuk paket” berarti disabled.
Riwayat langganan	Baca event type, paket sebelum/sesudah, dan tanggal.	Menjadi jejak perubahan paket.
Lihat semua paket	Membuka halaman Pricing.	Bandingkan biaya bulanan dan tahunan.

Kuota penuh

Apabila penggunaan mencapai batas, tindakan fitur dapat ditolak backend. Hubungi Owner, Super Admin, atau Admin Agency yang ditugaskan untuk perubahan paket.

Bab 13

Paket & Billing

Katalog paket dan portofolio pelanggan untuk role pengelola billing.

Elemen	Cara menggunakan	Hasil / catatan
Nilai langganan berjalan	Baca estimasi setara bulanan dari subscription active/trialing.	Langganan tahunan dibagi 12 untuk MRR ekuivalen.
Katalog paket	Baca harga bulanan/tahunan, status, tagline, dan entitlement.	Paket custom dapat tidak memiliki harga publik.
Langganan pelanggan	Baca tenant, paket, biaya, periode, status, dan cancel at period end.	Hanya pelanggan dalam scope yang ditampilkan.
Ubah paket	Pilih Paket, Periode, Status, lalu Simpan perubahan.	Perubahan dicatat pada audit.
Tandai menunggak	Mengubah active menjadi past_due.	Gunakan hanya berdasarkan status penagihan nyata.
Aktifkan	Mengubah status nonaktif/menunggak menjadi active.	Pastikan pembayaran atau persetujuan telah valid.

Scope billing

Super Admin dan Admin Agency hanya dapat mengubah pelanggan yang secara eksplisit berada dalam scope atau penugasan mereka. Server menolak perubahan di luar jangkauan.

Bab 14

Super Admin

Panel khusus System Owner untuk menetapkan Super Admin dan cakupan kerjanya.

Menetapkan Super Admin

01Cari pengguna berdasarkan nama atau email. Pengguna harus sudah memiliki akun.
02Pilih pengguna, lalu pilih scope pertama: Agency, Tenant, atau Portofolio penagihan.
03Jika memilih Tenant, pilih tenant tujuan.
04Pilih Jadikan Super Admin + scope. Peran global dan scope pertama diberikan dalam satu transaksi.
05Pada Daftar Super Admin, pantau status, MFA, jumlah agency, pelanggan, scope, dan aktivitas terakhir.
06Gunakan Suspend untuk menangguhkan akses atau Aktifkan untuk memulihkan.
07Gunakan Reset scope untuk menghapus cakupan yang ada, lalu tetapkan scope baru bila diperlukan.

Elemen	Cara menggunakan	Hasil / catatan
Tetapkan scope	Pilih Super Admin, tipe scope, dan scope ID bila diperlukan, lalu Tetapkan.	Tanpa scope aktif, Super Admin tidak menjangkau pelanggan.
Cabut scope	Pilih Cabut pada baris scope.	Akses terkait berhenti.
MFA	Pastikan badge MFA aktif.	Peran istimewa wajib menggunakan MFA.

Tidak ada akses semua tenant otomatis

Super Admin tanpa scope tidak memperoleh fallback “semua tenant”. Cakupan harus diberikan secara eksplisit.

Bab 15

Admin Agency

Panel Owner/Super Admin berscope untuk menugaskan Admin Agency dan pelanggan secara eksplisit.

Menugaskan Admin Agency

01Masukkan User ID Admin Agency dan Agency ID bila ada, lalu pilih Tugaskan.
02Pantau daftar Admin Agency beserta status dan jumlah pelanggan.
03Gunakan Tangguhkan atau Aktifkan untuk mengubah status penugasan.
04Pada penetapan pelanggan, pilih Admin Agency dan tenant pelanggan.
05Pilih tanggal berakhir bila akses harus berbatas waktu.
06Centang permission agency yang dibutuhkan, lalu pilih Berikan akses.
07Gunakan Cabut pada assignment pelanggan untuk menghentikan akses.

Least privilege

Berikan hanya permission yang diperlukan dan gunakan tanggal berakhir untuk pekerjaan sementara. Akses pelanggan hilang otomatis setelah masa berlaku berakhir atau assignment dicabut.

Bab 16

Users & Roles

Mengelola anggota workspace, undangan CSV, role, tautan undangan, dan matriks permission.

Onboarding massal melalui CSV

01Siapkan CSV dengan kolom nama, email, role. Unggah file atau tempel baris CSV pada textarea.
02Pilih Jalankan dry run. Sistem memvalidasi ukuran, jumlah baris, email, duplikat, existing user, dan role yang diizinkan.
03Baca Ringkasan batch dan tabel Hasil pemrosesan. Perbaiki baris invalid atau unauthorized role.
04Centang pernyataan bahwa setiap penerima telah memberi persetujuan untuk diundang.
05Pilih Buat undangan. Sistem tidak membuat password dan tidak membuat akun media sosial.
06Salin tautan undangan yang tampil satu kali atau gunakan menu Undangan tertunda untuk membuat tautan baru.
07Jika sebagian gagal, pilih Ulangi baris gagal. Gunakan Export hasil (CSV) untuk arsip.

Elemen	Cara menggunakan	Hasil / catatan
Anggota workspace	Lihat nama, email, status, dan role.	Anggota aktif/invited/suspended ditandai badge.
Ubah role	Pilih role yang berada di bawah tingkat peran Anda.	Server menolak eskalasi ke role global atau lebih tinggi.
Keluarkan	Menghapus anggota dari tenant aktif.	Tidak dapat mengeluarkan diri sendiri melalui kontrol ini.
Undangan tertunda	Pilih Buat tautan atau Cabut.	Tautan memiliki masa berlaku.
Matriks izin	Baca permission tiap role.	Viewer bersifat read only; System Owner memiliki semua izin.

Batas impor

File dibatasi oleh maksimum baris dan ukuran yang ditampilkan pada halaman. Selalu jalankan dry run sebelum commit; idempotency key mencegah undangan ganda ketika batch yang sama diproses ulang.

Bab 17

Security & Audit

MFA, session control, kill switch AI, security events, compliance controls, dan audit log.

Mengaktifkan MFA

01Pilih Daftarkan authenticator.
02Pindai QR dengan aplikasi authenticator atau masukkan secret secara manual.
03Masukkan kode 6 digit dan pilih Verifikasi.
04Pastikan badge berubah menjadi Aktif. MFA wajib untuk System Owner, Super Admin, Tenant Owner, dan Agency Admin.

Elemen	Cara menggunakan	Hasil / catatan
Keluarkan perangkat lain	Mencabut seluruh sesi selain perangkat saat ini.	Gunakan ketika mencurigai sesi lain.
Cabut semua sesi	Mencabut seluruh sesi global.	Anda perlu masuk kembali.
Aktifkan kill switch AI	Menghentikan eksekusi AI pada scope yang diizinkan.	Gunakan saat insiden, output tidak aman, atau penyedia bermasalah.
Nonaktifkan kill switch	Memulihkan AI setelah penyebab selesai.	Kill switch global hanya dapat dinonaktifkan System Owner.
Security events	Baca event type, severity, subject, dan waktu.	Maksimal 100 event terakhir pada halaman.
Audit log	Baca aktor, event, subjek, severity, correlation ID, dan waktu.	Append-only; tidak dibuat di browser.

Aksi sensitif

Peran istimewa wajib MFA dan aksi sensitif dapat meminta autentikasi ulang dalam jangka waktu maksimum 10 menit terakhir.

Bab 18

Halaman publik dan pemulihan akun

Landing, Pricing, Masuk, undangan, dan reset kata sandi.

Elemen	Cara menggunakan	Hasil / catatan
Landing	Pilih Masuk/Daftar, Buka command center, atau Lihat harga langganan.	Ringkasan fitur dan paket publik.
Pricing	Alihkan Bulanan/Tahunan, bandingkan harga dan entitlement, lalu pilih Mulai dengan paket ini.	Tombol mengarah ke halaman Masuk; aktivasi paket tetap melalui pengelola billing.
Lupa kata sandi	Pada halaman Masuk, pilih Lupa kata sandi, isi email, lalu Kirim tautan pemulihan.	Pesan generik tidak mengungkap apakah email terdaftar.
Reset password	Buka tautan email, masukkan kata sandi baru minimal 8 karakter, lalu Simpan kata sandi.	Tautan tidak valid/kedaluwarsa harus diminta ulang.
Undangan	Masuk dengan email yang diundang lalu biarkan sistem memproses token.	Email mismatch, expired, revoked, atau already used akan ditolak.

Bab 19

Matriks akses dan alur kerja

Ringkasan permission serta urutan penggunaan yang disarankan.

Alur onboarding pelanggan baru

Paket → Tenant & role → Undangan → Connections → MFA → Siap operasi

•Tetapkan paket dan subscription pelanggan melalui Paket & Billing.
•Undang pengguna melalui Users & Roles, lakukan dry run CSV, dan kirim tautan undangan.
•Pengguna menerima undangan dengan email yang tepat dan mengaktifkan MFA bila role istimewa.
•Pemilik kanal menyelesaikan OAuth melalui Connections.
•Periksa Dashboard, kuota, health kanal, dan security event sebelum operasi.

Alur konten sampai publikasi

Content DRAFT → Generate/Edit → Review → Approve → Publishing job → Audit hasil

Alur reputasi dan penjualan

Listening → Human review → Inbox → Respons → Convert lead → Growth CRM

Alur insiden AI

Deteksi risiko → Aktifkan kill switch → Periksa run → Audit correlation → Perbaikan → Nonaktifkan switch

Permission	Menu/tindakan utama	Role umum yang memiliki akses
users.manage	Users & Roles, Paket & Billing, hierarki akun	System Owner, Super Admin, Tenant Owner; sesuai scope
connections.manage	Hubungkan/refresh/cabut kanal	System Owner, Super Admin, Tenant Owner, Agency Admin, Social Media Manager
content.manage	Membuat dan mengubah konten, AI Studio dasar	System Owner, Super Admin, Tenant Owner, Agency Admin, Social Media Manager
content.approve	Menyetujui/meminta revisi	System Owner, Super Admin, Tenant Owner, Agency Admin, Content Approver
publish	Mengantrikan, membatalkan, retry publikasi	System Owner, Super Admin, Tenant Owner, Agency Admin, Social Media Manager
inbox.manage	Status, balasan, konversi lead	System Owner, Super Admin, Tenant Owner, Agency Admin, Social Media Manager, Community Manager
analytics.view	Dashboard analitik, Growth, Listening, SEO	Hampir semua role operasional; Viewer terbatas
automation.manage	Membuat dan menjalankan workflow	System Owner, Super Admin, Tenant Owner, Agency Admin
security.manage	MFA governance, kill switch, security control	System Owner dan Security Admin; beberapa kontrol role istimewa
billing.manage	Perubahan paket dan status subscription	System Owner, Super Admin, Tenant Owner; sesuai scope/penugasan

Bab 20

Pemecahan masalah dan glosarium

Tindakan awal untuk kondisi umum dan arti status penting.

Kondisi	Tindakan awal	Hasil / catatan
Menu tidak muncul	Periksa role dan permission pada Users & Roles.	Minta admin mengubah role/assignment; jangan berbagi akun.
Koneksi tidak bisa diklik	Periksa kredensial provider configured dan izin connections.manage.	Operator server harus melengkapi konfigurasi.
OAuth gagal	Mulai ulang dari Connections, gunakan akun pemilik kanal, berikan semua scope.	Jangan menggunakan callback lama atau tautan kedaluwarsa.
Publikasi gagal satu kanal	Buka Riwayat job dan gunakan Coba lagi.	Jangan membuat job duplikat manual.
Reply unsupported	Balas melalui aplikasi resmi platform dan update status thread.	Bukan kegagalan sistem; API provider tidak mendukung.
Listening kosong	Pastikan query, source, koneksi, webhook/polling worker aktif.	Periksa Ingestion terakhir.
SEO provider not configured	Verifikasi domain, hubungkan Google, simpan properti Search Console.	Jalankan pengecekan setelah konfigurasi lengkap.
AI simulated	Konfigurasikan penyedia model pada server.	Run simulasi tetap tercatat tetapi bukan output model live.
AI ditolak	Periksa kill switch, policy decision, agent enabled, capability, dan approval.	Buka AI Studio dan Security & Audit.
Kuota penuh	Periksa Langganan Saya dan entitlement.	Upgrade paket atau tunggu periode berikutnya.
Undangan ditolak	Periksa email, token, masa berlaku, dan apakah sudah digunakan/dicabut.	Buat tautan undangan baru.
Aksi sensitif ditolak	Aktifkan MFA dan login ulang bila sesi autentikasi terlalu lama.	Peran istimewa wajib faktor kedua.

Glosarium status

CONNECTED: Kanal telah terotorisasi dan token tersedia pada vault backend.
NEEDS_REAUTHORIZATION: Token/scope memerlukan consent baru dari pemilik akun.
IN_REVIEW: Konten menunggu keputusan pemeriksa.
APPROVED: Konten lulus approval tetapi belum tentu sudah dipublikasikan.
PARTIALLY_PUBLISHED: Sebagian kanal berhasil dan sebagian gagal.
unread / open / pending / resolved / archived: Tahap penanganan thread Inbox.
QUALIFIED / PROPOSAL / WON / LOST: Tahap lead pada Growth CRM.
requires_review: Hasil analisis perlu keputusan manusia.
allow / require_approval / deny: Keputusan policy AI.
dead_letter: Run otomasi berhenti setelah retry gagal atau proteksi eksekusi.
past_due: Langganan ditandai menunggak.
correlation ID: ID penghubung event, run, audit, dan investigasi.
append-only: Log dapat ditambahkan tetapi tidak diedit dari antarmuka biasa.

Catatan perubahan

Panduan ini mengikuti implementasi aplikasi pada 28 Juli 2026. Apabila menu, peran, penyedia, harga, atau workflow berubah setelah tanggal tersebut, dokumentasi akan diperbarui agar tetap sama dengan aplikasi. Pertanyaan teknis dapat dikirim ke halo@nagatama.id.