Lompat ke konten utama
StableTerakhir diperbarui: 9 Okt 2026, 09.28

Solusi Agensi & Arsitektur White-Label

Platform DagangBot menyediakan infrastruktur korporat bagi penyedia jasa agensi, software house, dan konsultan digital yang ingin menjual kembali (resell) layanan automasi AI dengan identitas merek mereka sendiri. Melalui modul White-Label, agensi beroperasi sebagai pengelola utama (master tenant) yang mengendalikan siklus hidup, kuota, dan akses dari puluhan sub-akun klien secara terpusat tanpa mengekspos infrastruktur dasar DagangBot.

Stable

1. Ikhtisar & Arsitektur Agensi

Model keagenan dalam platform didesain dengan prinsip pemisahan tenant (tenant isolation) yang ketat namun memberikan fleksibilitas distribusi sumber daya. Secara struktural, sebuah entitas agensi berada di atas merchant reguler, di mana akun agensi memegang kendali administratif atas subaccounts (klien).

Arsitektur ini didukung oleh kebijakan Row-Level Security (RLS) pada tingkat basis data PostgreSQL. Setiap kueri yang dieksekusi oleh sub-akun secara otomatis diisolasi berdasarkan tenant_id mereka sendiri. Sementara itu, pemilik agensi diberikan privilese ancestor yang dievaluasi secara dinamis (melalui fungsi internal IsAgencyAncestor), memungkinkan mereka melakukan agregasi bacaan atau mendistribusikan token dari dompet agensi ke dompet klien tanpa membongkar batas RLS antar klien itu sendiri.

Terdapat empat pilar utama dalam modul White-Label:

  1. Manajemen Sub-Akun Klien: Kemampuan untuk melakukan provisioning akun baru, mengelola kunci API (API keys) klien, dan menangguhkan (suspend) akun klien yang bermasalah.
  2. Kustomisasi Identitas Visual & Domain: Pelabelan putih (white-labeling) pada antarmuka pengguna, mencakup logo, warna tema, dan akses melalui custom domain yang diverifikasi melalui DNS.
  3. Distribusi Token & Kuota Pesan: Sistem alokasi sumber daya (Quota Distribution) di mana agensi membeli pool token besar lalu memecahnya secara granular ke masing-masing klien.
  4. Akses Sesi Asistensi Sub-Akun: Fasilitas bagi pemilik agensi untuk masuk (login) ke dalam dasbor klien tanpa memerlukan kata sandi klien, difasilitasi oleh sesi asistensi terotorisasi jangka pendek yang tercatat secara ketat di log audit.

Fitur White-Label dan Portal Agensi hanya tersedia untuk pengguna yang berlangganan Paket Agency. Downgrade dari paket ini akan menangguhkan akses ke portal agensi dan membekukan kustomisasi domain klien.

2. Manajemen Sub-Akun & Hierarki Organisasi

Agensi bertindak sebagai entitas induk (parent) dari banyak merchants (sub-akun). Pembuatan sub-akun dilakukan melalui proses provisioning yang secara otomatis menautkan agency_id klien ke entitas agensi terkait. Sesuai arsitektur, sebuah klien hanya dapat dikaitkan dengan satu agensi (relasi satu-ke-banyak).

Pembuatan dan Penangguhan Klien

Saat agensi memanggil fungsionalitas pembuatan sub-akun, sistem akan membuatkan ruang lingkup tenant baru di dalam kluster basis data. Sub-akun ini lahir dengan paket dasar yang diwariskan atau dikelola oleh agensi. Agensi memegang otoritas penuh untuk menangguhkan (suspend) operasional klien (berdasarkan fungsi spesifikasi layanan SuspendSubaccount). Penangguhan akan membekukan seluruh instans WhatsApp klien dan menghentikan konsumsi token secara instan, sering kali digunakan ketika klien menunggak pembayaran tagihan bulanan kepada agensi.

Akses Sesi Asistensi Sub-Akun (Support Access)

Untuk tujuan dukungan teknis (technical support), staf agensi dengan peran agency_owner dapat mengakses dasbor sub-akun secara aman. Proses ini membangkitkan token otorisasi khusus dengan penanda sesi terotorisasi yang mencatat entitas asli staf pengakses. Segala tindakan yang dilakukan selama masa asistensi akan dicatat dalam log audit klien dengan penanda yang jelas bahwa tindakan tersebut dilakukan oleh akun agensi induk, bukan oleh pengguna klien itu sendiri. Akses bantuan ini bersifat sementara dan dapat dicabut secara langsung kapan saja oleh pihak agensi.

3. Isolasi Branding & Kustomisasi Domain

Inti dari solusi white-label adalah kemampuan untuk menyembunyikan jejak DagangBot dari pandangan pengguna akhir klien. Sistem menyimpan profil ini di dalam entitas konfigurasi branding yang menimpa profil antarmuka pengguna standar.

Komponen Branding yang Dapat Dikustomisasi

  • Identitas Visual: Agensi dapat mengunggah logo kustom (logo_url) dan favicon berformat PNG transparan. Berkas tersebut disajikan langsung dari jaringan pengiriman konten (CDN).
  • Palet Warna Utama: Menyesuaikan kode heksadesimal (hex color) untuk warna utama (primary_color) dan sekunder (secondary_color) yang akan diterapkan pada tombol, menu navigasi, dan elemen antarmuka aplikasi web.
  • Nama Merek (Brand Name): Seluruh notifikasi antarmuka, tagline faktur (PDF generator), templat surel (email template), dan penyebutan dalam bot WhatsApp pelanggan secara otomatis disanitasi dan diganti menggunakan nama merek agensi tersebut.

Verifikasi dan Pendaftaran Custom Domain

Agensi dapat mengonfigurasi proksi jaringan untuk memuat dasbor melalui alamat web mereka sendiri (contoh: portal.agensihebat.com). Integrasi custom domain dieksekusi dengan protokol keamanan ketat:

  1. Validasi Kepemilikan (DNS TXT): Agensi wajib menambahkan rekaman TXT _dagangbot-verify.<domain> dengan token acak kriptografis txt_token yang diterbitkan sistem. Langkah ini secara efektif mencegah serangan pengambilalihan domain (domain takeover).
  2. Registrasi CNAME: Setelah tahap TXT berlalu, agensi mengarahkan lalu lintas nama domain (FQDN) tersebut menggunakan rekaman CNAME ke proksi platform.
  3. Penerbitan TLS Otomatis (On-Demand TLS): Load balancer infrastruktur memverifikasi status izin domain secara real-time via peladen panggilan internal (CheckTLSAllowed). Setelah terverifikasi sah, mesin sertifikat segera menerbitkan sertifikat Let's Encrypt secara otomatis (on-demand).
Batasan Kustomisasi Label

Meskipun nama merek, domain portal, dan format berkas faktur (Invoice PDF) dapat dikustomisasi, pengirim alamat email sistem (System SMTP Mail From) akan tetap secara mutlak diatur oleh konfigurasi arsitektur platform inti (contoh: [email protected]) guna menjamin reputabilitas integritas email pengirim (SPF/DKIM) di hadapan penyedia layanan email raksasa antispam. Nama pengirim (Display Name) akan diganti ke nama agensi Anda.

4. Distribusi Saldo & Alokasi Token

Ekonomi operasional agensi bergantung pada pengelolaan sumber daya secara terpusat (Centralized Treasury). Agensi mendistribusikan kapabilitas platform kepada hilir sub-akun klien secara terkontrol.

  • Dompet Induk Agensi (Agency Wallet): Sebuah buku besar terpusat (ledger) menampung deposit saldo awal dari agensi. Saldo ini adalah aset operasional di dalam platform.
  • Transfer Modal Token (Token Allocation): Agensi memindahkan saldo koin dari dompet induk ke setiap sub-akun klien dengan fungsi alokasi saldo. Transaksi didistribusikan dan dicatat berlapis dalam buku besar pencatatan token—menciptakan baris debit mutlak di sisi dompet agensi, serta baris top-up kredit di sisi dompet klien. Algoritma basis data melindungi pemanggilan ganda (double-spend) transaksi sekuensial dengan memberlakukan keunikan idempotency_key.
  • Distribusi Kuota Pesan (Quota Distribution): Untuk paket berbasis kapasitas kuota API, agensi menjatah limit sub-akun via antarmuka UpdateDistribution. Secara arsitektural, total volume pesan yang dibagikan kepada seluruh jajaran anak perusahaan klien tidak akan pernah bisa melampaui batasan atas plafon pesan yang dimiliki entitas agensi induk itu sendiri (ErrDistributionExceedsQuota). Integritas dijamin lewat blokade basis data tingkat baris (kunci FOR UPDATE) yang menepis perlombaan eksekusi paralel (concurrency race condition).
Portal manajemen agensi untuk sub-akun klien dan alokasi saldo
Dasbor manajemen sub-akun klien dan konfigurasi white-label portal agensi

5. Prosedur Konfigurasi White-Label & Klien

Ikuti instruksi tahapan teknis di bawah ini untuk memulai portal dan menambahkan klien perdana agensi Anda:

  1. 1

    Langkah 1: Siapkan Subdomain Kustom Agensi

    Akses penyedia registrar panel kontrol DNS domain yang Anda miliki (contoh: Route53 atau Cloudflare). Buat sebuah entri DNS CNAME baru. Jika menggunakan Cloudflare, sangat penting untuk mengatur mode perutean ke DNS Only (awan abu-abu) guna mencegah bentrok sertifikat proksi HTTPS selama masa inisiasi platform.

  2. 2

    Langkah 2: Daftarkan Domain & Masukkan Rekaman TXT

    Buka dasbor Agensi utama Anda dan navigasikan ke panel konfigurasi Agency Portal → Branding & Domain. Masukkan Fully Qualified Domain Name (FQDN) subdomain Anda. Sistem menghasilkan tantangan token TXT aman (_dagangbot-verify). Tanamkan token ini di DNS registrar Anda dan jalankan utilitas verifikasi platform.

  3. 3

    Langkah 3: Konfigurasi Identitas Merek (Visual Branding)

    Setelah diverifikasi, unggah berkas rujukan logo resolusi tinggi dengan properti kanal alpha transparan (logo_transparent.png). Atur pewarnaan grafis tema dasar heksadesimal (Primary Hex Color). Properti identitas ini lalu terikat langsung di konfigurasi profil agensi dan seketika ditayangkan setiap kali klien menavigasi masuk (login) melalui domain tersebut.

  4. 4

    Langkah 4: Pembuatan Sub-Akun Klien (Provisioning)

    Akses direktori klien di dalam portal agensi, lalu tekan Buat Sub-Akun Baru. Lengkapi lembar entitas informasi klien mencakup penetapan batas maksimum instans koneksi API (Max WhatsApp Instances) dan informasi kepemilikan mendasar.

  5. 5

    Langkah 5: Distribusi Modal dan Kunci Akses Klien

    Injeksi saldo sirkulasi token awal ke klien Anda dari tab dompet induk. Klien sekarang memiliki bahan bakar sistem untuk menyalakan instans perpesanan, membangun direktori basis pengetahuan referensi, dan mendesain matriks katalog tanpa mengetahui peran platform asli. Agensi juga bisa memfasilitasi pembuatan secara otomatis SubaccountAPIKey jika klien hendak melakukan integrasi tanpa-kepala (headless API).

6. Integrasi Tingkat Lanjut (Advanced Configuration)

Bagi entitas konsultan berskala lebih tinggi, kapabilitas platform disempurnakan dengan agregasi utilitas terpusat:

  • Manajemen API Key (Delegated API Scope): Portal agensi memberikan kemampuan mencabut dan mengatur otorisasi API keys klien lintas-cabang (Cross-Tenant Scopes). Sangat membantu bilamana pengembangan perangkat lunak klien seperti ERP dikendalikan penuh oleh kontraktor agensi itu sendiri (CreateSubaccountAPIKey).
  • Agregasi Metrik Induk (Rollup Summary): Dasbor portal agensi secara efisien menarik pembacaan agregat (GetRollupSummary) perihal laju pengeluaran token konsolidasi (kalkulasi burn rate) di sepanjang rentang portofolio sub-akun. Ringkasan holistik ini memperlancar pengambilan keputusan strategis agensi atas titik aman pengisian kembali batas volume tagihan infrastruktur.

7. Pemecahan Masalah (Troubleshooting)

Kode/Indikasi Kesalahan Analisis Akar Masalah Dasar Panduan Mitigasi Teknis
Gagal Verifikasi TLS (TLS Hook False / ErrDomainNotVerified) Perutean terhalang proksi sertifikat layanan WAF ganda, atau status propagasi DNS internet terlampau baru Jeda sementara waktu konfigurasi proksi perlindungan sisi registrar DNS agar mesin internal kami dapat mengeluarkan SSL Let's Encrypt berbasis permintaan On-Demand HTTP-01.
Distribusi Ditolak (DISTRIBUTION_EXCEEDS_QUOTA) Upaya penjatahan kuota volume klien akumulatif telah berhasil menggebrak limit atap absolut paket berlangganan Agensi induk Evaluasi ulang rentang sisa kuota sub-akun pasif dan lakukan reposisi limit; alternatifnya, naikkan kelas paket utama (upgrade plan tier) organisasi Anda ke strata level operasional yang lebih tinggi.
Penarikan Saldo Induk Ditolak (ErrInsufficientTokens) Ketersediaan cadangan neraca ledger riil tidak memenuhi minimum agregat transfer koin di lapisan dompet induk Lakukan eksekusi pemenuhan tagihan faktur (Top-Up Master Wallet) pada laman penagihan korporat platform dagang Anda.
Hak Akses Asistensi Klien Ditolak (ErrActorNotAgencyMember) Kredensial User ID staf Anda belum dinaikkan secara memadai untuk mencakup wewenang pemilik agensi Lapor pada Pemilik Agensi (Agency Owner) guna memodifikasi batasan izin keanggotaan staf RBAC di setelan tim.

8. Referensi Terkait

content/docs/advanced/white-label.mdx
Terakhir diperbarui: 9 Okt 2026, 09.28

Dokumentasi teknis DagangBot