embent

Panduan instalasi / HTML & situs kustom

Pasang Embent di situs HTML mana pun

Satu tag skrip, tanpa build step, tanpa framework. Kalau kamu bisa mengedit HTML-mu, selesai dalam kurang dari semenit.

Sebelum mulai

  • Akses untuk mengedit file HTML atau template yang disajikan situsmu.

Langkah-langkah

1

Salin cuplikan embed-mu

Di dashboard Embent-mu, buka Overview bot-mu dan salin cuplikan embed-nya. Bentuknya seperti ini:

<script src="https://api.embent.com/widget.js" data-bot="YOUR_BOT_ID" async></script>
2

Tempel sebelum tag penutup </body>

Buka file atau template yang merender setiap halaman — di kebanyakan situs statis itu adalah layout bersama atau footer include — dan tempel cuplikannya persis sebelum tag penutup </body>.

3

Publish perubahanmu

Unggah atau deploy file yang sudah diedit dengan cara yang biasa kamu pakai untuk mempublikasikan situsmu.

Pastikan berhasil

Muat ulang situsmu: chat bubble muncul di pojok. Ajukan pertanyaan soal halamanmu sendiri dan ia harus menjawab lengkap dengan kutipan sumber.

Kalau tidak berhasil

Sudah dicoba dan widget-nya tidak muncul? Ini biasanya memperbaiki hampir semua kasus.

Saya sudah menambahkan kode embed-nya tapi widget-nya tidak muncul — tidak ada chat bubble, tidak ada launcher, tidak ada apa-apa yang muncul di situs sayaEmpat pemeriksaan ini menyelesaikan hampir semua kasus "widget tidak muncul". Pertama, buka situs live-mu dan lihat page source (klik kanan → View Page Source) lalu cari "embent" — kalau skripnya tidak ada, berarti kodenya belum tersimpan ke halaman yang dipublikasikan. Kedua, pastikan data-bot ID di cuplikanmu cocok dengan yang tertera di dashboard-mu di bagian Settings. Ketiga, bersihkan cache halaman situsmu dan cache CDN mana pun — halaman yang di-cache akan terus menyajikan versi lama tanpa widget-nya. Keempat, pastikan bot-nya tidak sedang dijeda (paused) di dashboard: bot yang dijeda memang sengaja tidak menampilkan apa pun ke pengunjung.
Chat bubble-nya muncul tapi balasan tidak pernah datang, atau widget-nya hilang dan situsku memakai Content-Security-PolicyTambahkan https://api.embent.com ke script-src (memuat skrip widget-nya) dan connect-src (koneksi stream balasan chat terhubung ke origin yang sama). Entri script-src yang hilang menyembunyikan widget-nya sepenuhnya; entri connect-src yang hilang menampilkan bubble-nya tapi jawabannya tidak pernah muncul.
Saya pakai Cloudflare dengan Rocket Loader dan widget-nya kadang muncul kadang tidakRocket Loader menunda skrip lewat loader-nya sendiri. Widget-nya dibuat untuk bertahan dari itu, tapi kalau tetap tidak muncul, tambahkan data-cfasync="false" ke tag skrip Embent — opsi opt-out resmi Rocket Loader — dan skripnya akan dimuat normal.

Pertanyaan umum

Apakah ini berfungsi dengan React, Vue, Next.js atau framework lain?Ya. Tempel cuplikannya sekali ke template HTML root — index.html atau root layout-mu. Widget-nya dirender di dalam Shadow DOM dan tidak mengganggu framework-mu; tidak perlu komponen wrapper.
Apakah ini memperlambat situs saya?Tidak. Skripnya dimuat secara async dan widget-nya di bawah 50KB gzip tanpa framework sendiri, jadi tidak pernah menghalangi render halamanmu.
Perlu menambahkannya ke setiap halaman?Hanya ke template yang dipakai bersama di banyak halaman. Halaman yang melewati layout bersama itu perlu ditambahkan cuplikannya secara terpisah.
Arahkan Embent ke situsmu sekarang.AI agent yang lebih memilih bilang "saya tidak tahu" daripada mengarang jawaban. Paket Free, tanpa kartu — kebanyakan situs sudah bisa menjawab dalam dua menit.

Chat bubble di pojok ini adalah Embent sendiri, berjalan di halaman ini — coba tanya apa saja soal kami.