embent

Panduan instalasi / Shopify

Pasang Embent di Shopify

Satu tag skrip di kode temamu, tanpa perlu pasang app. Kalau kamu bisa membuka editor tema, selesai dalam beberapa menit.

Sebelum mulai

  • Akses edit ke kode tema tokomu (kamu hanya bisa mengedit kode tema setelah dibeli/ditambahkan ke tokomu).
  • Widget tidak akan muncul di halaman checkout, terima kasih, atau status pesanan Shopify — Shopify memblokir skrip kustom di sana untuk toko yang bukan Shopify Plus.

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

Buka kode temamu

Dari admin Shopify-mu, buka Online Store → Themes. Di tema yang aktif, klik menu ⋯ dan pilih Edit code. Shopify menyarankan menduplikasi temamu dulu, karena perubahan kode yang tidak cocok dengan update tema berikutnya akan otomatis terhapus.

3

Tempel ke theme.liquid sebelum </body>

Di folder Layout, buka theme.liquid, gulir ke tag penutup </body> di bagian bawah file, dan tempel cuplikannya persis di atasnya. Klik Save.

Pastikan berhasil

Muat ulang toko onlinemu (bukan halaman checkout) di tab browser baru: 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 tidak muncul dan saya pakai app speed-optimization (Booster, Hyperspeed, atau sejenisnya)App speed yang "menunda JavaScript sampai ada interaksi" bisa menulis ulang atau menunda skrip Embent. Widget-nya dibuat untuk bertahan dari itu, tapi kalau tetap tidak muncul, tambahkan "embent" ke daftar pengecualian app tersebut — setiap app seperti ini punya daftar itu — lalu muat ulang toko onlinemu.

Pertanyaan umum

Apakah widget-nya muncul saat checkout?Tidak. Shopify membatasi kode kustom di halaman checkout untuk toko yang bukan Shopify Plus, jadi widget-nya muncul di halaman tokomu tapi tidak di checkout, status pesanan, atau halaman terima kasih.
Apakah update tema akan menghapus cuplikannya?Bisa — Shopify menghapus perubahan kode yang tidak cocok dengan update saat temanya diperbarui. Duplikasi temamu dulu sebelum kustomisasi, dan cek ulang cuplikannya setelah update tema apa pun.
Perlu developer atau app untuk memasangnya?Tidak. Cukup tempel satu tag skrip — tanpa pasang app, dan tanpa perlu paham Liquid selain menemukan tag penutup body.
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.