Public Documentation

Halaman ini merangkum panduan utama penggunaan sistem Papua Hub Automation: alur operasional, cara upload/update data AI Assistant, troubleshooting, integrasi, dan checklist keamanan dasar.

System Overview

Komponen Inti Sistem

Peta singkat modul utama agar tim non-teknis maupun teknis punya konteks sebelum melakukan perubahan.

Area Fungsi Catatan Operasional
Admin Panel Kelola tenant, knowledge base, campaign, dan monitoring. Pastikan hanya role berwenang yang bisa publish update.
AI Assistant Engine Memproses prompt, retrieval knowledge, dan menyusun jawaban. Perubahan data akan berdampak pada kualitas respons secara langsung.
Messaging Integrations Konektor WhatsApp (Wablas/Fonnte), webhook inbound/outbound. Cek status token, webhook URL, dan limit provider.
Billing & Subscription Mengelola paket, masa aktif, renewal, dan status tenant. Jika tenant nonaktif, automasi dan balasan AI bisa dihentikan.
Knowledge Base

Cara Upload Data untuk AI Assistant

  1. Masuk ke area Admin → Knowledge Base.
  2. Pilih tenant/bisnis yang akan diupdate.
  3. Upload sumber data (dokumen teks, FAQ, SOP, policy produk).
  4. Tentukan label/topik agar mudah ditelusuri.
  5. Simpan lalu jalankan proses sinkronisasi/indexing.
  6. Lakukan uji tanya-jawab minimal 5 skenario pelanggan.
Versioning

Cara Update Data Existing

  1. Duplikasi dokumen lama sebagai backup versi.
  2. Perbarui konten dengan tanggal revisi yang jelas.
  3. Hapus informasi kadaluarsa (harga, promo, nomor kontak lama).
  4. Re-index knowledge agar versi terbaru diprioritaskan.
  5. Uji prompt kritikal: harga, stok, kebijakan refund, jam operasional.
  6. Monitor 24 jam pertama untuk anomali jawaban AI.
Troubleshooting

Masalah Umum dan Solusi Cepat

AI jawab tidak relevan

  • Cek apakah data terbaru sudah di-index.
  • Pastikan topik dokumen tidak terlalu umum/tumpang tindih.
  • Persempit prompt policy untuk instruksi jawaban.

Aksi: Re-upload dokumen prioritas + jalankan validasi 5 pertanyaan wajib.

Pesan WA tidak terkirim

  • Periksa token/API key provider WA.
  • Verifikasi webhook callback aktif.
  • Cek format nomor tujuan (gunakan format internasional).

Aksi: Rotasi API key bila perlu dan lakukan kirim pesan uji ke nomor internal.

Tenant tiba-tiba tidak aktif

  • Audit status subscription & renewal.
  • Cek job automation untuk sinkronisasi paket.
  • Pastikan tidak ada suspend manual dari admin.

Aksi: Re-activate tenant bila pembayaran valid, lalu tes end-to-end.

Dashboard menampilkan data lama

  • Pastikan job metrics/sync tidak gagal.
  • Periksa antrean retry & dead-letter queue.
  • Refresh cache browser dan session.

Aksi: Jalankan sinkronisasi ulang dan pantau timestamp update terakhir.

Integrasi

Checklist Integrasi Baru

  • Webhook endpoint sudah HTTPS dan dapat diakses publik.
  • Gunakan secret/token unik per tenant bila memungkinkan.
  • Implementasikan retry + idempotency untuk event penting.
  • Catat request/response minimal untuk audit.
  • Siapkan fallback jika provider down.
Keamanan

Praktik Operasional Aman

  • Jangan simpan secret/API key di front-end atau dokumen publik.
  • Rotasi key secara periodik dan saat ada indikasi kebocoran.
  • Terapkan role-based access untuk halaman admin.
  • Gunakan sanitasi input untuk mencegah injeksi data.
  • Review log akses admin secara rutin.
FAQ

Pertanyaan yang Sering Muncul