Mulai Cepat & Instalasi Widget

Halaman ini menjelaskan langkah-langkah dasar untuk mengintegrasikan Chat Widget Helvast ke dalam situs web Anda.

---

1. Pemasangan Script Widget

Untuk memasang Chat Widget Helvast pada situs web (WordPress, HTML biasa, React, Laravel, dsb), cukup sisipkan potongan kode JavaScript berikut sebelum penutup tag </body>:

<!-- Helvast Unified Chat Widget -->
<script 
  src="https://app.helvast.com/js/widget-embed.js" 
  data-workspace-id="YOUR_WORKSPACE_ID" 
  async>
</script>

Ganti Workspace ID

Pastikan mengganti YOUR_WORKSPACE_ID dengan ID unik workspace yang dapat Anda temukan di menu Pengaturan Workspace pada Dashboard Helvast.

---

2. Fitur Smart Switcher (Dev vs Live)

Helvast dilengkapi dengan Smart Backend Switcher. Loader widget secara otomatis mendeteksi lingkungan tempat script dijalankan:

• Jika widget dipasang di lingkungan staging/pengujian (dev.helvast.com), trafik API akan diarahkan ke Backend Dev (port 3007).
• Jika dipasang di lingkungan produksi (app.helvast.com), trafik API akan mengarah ke Backend Production (port 3006).

---

3. Verifikasi Pemasangan

Setelah menyisipkan kode embed:

1. Muat ulang (refresh) halaman web Anda.
2. Pelampung (icon chat) Helvast akan muncul di sudut kanan bawah layar.
3. Klik icon untuk membuka Dual Column Chat Window dan uji coba mengirim pesan pertama Anda.

Catatan CORS & Domain

Pastikan domain situs web Anda sudah terdaftar di daftar Allowed Domains di pengaturan workspace agar tidak terkena blokir CORS.