Arsitektur Plugin yang Dapat Diperluas — Membangun Kemampuan Kustom (Masa Depan)

Setiap bisnis memiliki kebutuhan unik yang tidak dapat dipenuhi sepenuhnya oleh solusi generik. Sistem plugin yang direncanakan akan memungkinkan pengembang untuk memperluas fungsionalitas widget dengan kemampuan kustom — tanpa memisahkan kode atau kehilangan jalur pembaruan.

Mengapa plugin penting untuk kasus penggunaan lanjutan

Widget standar tidak dapat memprediksi setiap persyaratan bisnis. Anda mungkin memerlukan:

• Analisis sentimen untuk mengarahkan pelanggan yang marah ke agen manusia
• Integrasi CRM untuk memperkaya percakapan dengan riwayat pembelian pelanggan
• Moderasi kustom untuk menegakkan kebijakan konten spesifik merek
• Renderer khusus untuk data spesifik industri (grafik medis, grafik keuangan, kutipan hukum)
• Pemicu otomatisasi alur kerja (buat tiket dukungan saat kata kunci tertentu muncul)

Hook siklus hidup untuk integrasi yang bersih

Plugin mendaftar selama inisialisasi widget dan menerima callback pada momen siklus hidup kunci:

• onBeforeMessageSend — memproses pesan pengguna sebelum mengirim ke backend
• onAfterMessageReceive — memproses respons AI sebelum merender
• onConversationStart — menginisialisasi status plugin saat percakapan dimulai
• onConversationEnd — membersihkan sumber daya, mencatat analitik
• onWidgetOpen / onWidgetClose — melacak keterlibatan, memicu efek samping
• onError — penanganan atau pelaporan kesalahan kustom

Preprocessor dan postprocessor pesan

Preprocessor memodifikasi pesan pengguna sebelum mengirim:
- Pemeriksaan ejaan dan koreksi otomatis
- Filter kata kasar atau moderasi konten
- Ekstraksi data (mendeteksi email, nomor telepon, ID pesanan)
- Deteksi sentimen

Postprocessor memodifikasi respons AI sebelum merender:
- Peningkatan markdown (mengonversi tabel menjadi komponen interaktif)
- Enrichment tautan (prabaca URL, mengungkap metadata)
- Penyaringan kepatuhan (menyunting PII, data keuangan sensitif)

Keamanan melalui sandboxing

Plugin tidak dapat mengkompromikan keamanan atau stabilitas widget:

• Plugin berjalan dalam ruang lingkup JavaScript yang terisolasi (tidak dapat mengakses variabel global atau mencemari namespace)
• Akses API dibatasi (plugin hanya dapat memanggil domain yang terdaftar)
• Akses DOM dibatasi (plugin tidak dapat memodifikasi UI widget di luar area render yang ditentukan)
• Waktu eksekusi dibatasi (plugin yang berjalan lama dihentikan untuk mencegah pembekuan UI)

Contoh konfigurasi

WidgetSDK.registerPlugin({
  name: 'sentiment-analyzer',
  version: '1.0.0',
  hooks: {
    onBeforeMessageSend: async (message, context) => {
      const sentiment = await analyzeSentiment(message.text);
      return { ...message, metadata: { sentiment } };
    },
    onAfterMessageReceive: (message, context) => {
      if (message.metadata?.sentiment < -0.5) {
        context.escalateToHuman(message);
      }
      return message;
    }
  }
});