Cara Menambahkan Chatbot AI Asyntai ke Umbraco
Panduan langkah demi langkah untuk situs web Umbraco CMS
Langkah 1: Dapatkan Kode Embed Anda
Pertama, buka Dasbor Asyntai dan gulir ke bawah ke bagian "Kode Embed". Salin kode embed unik Anda yang akan terlihat seperti ini:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Catatan: Kode di atas hanya contoh. Anda harus menyalin kode embed unik Anda sendiri dari Dasbor karena berisi ID widget personal Anda.
Langkah 2: Edit Template Master (Direkomendasikan)
Cara termudah untuk menambahkan chatbot ke semua halaman adalah dengan mengedit template Master Anda:
- Masuk ke Umbraco Backoffice Anda
- Buka Settings di sidebar kiri
- Perluas Templates
- Klik pada template Master Anda (atau template layout utama yang digunakan situs Anda)
- Temukan tag penutup
</body> - Tempel kode embed Asyntai Anda tepat sebelum tag
</body> - Klik "Save"
Tips: Menambahkan skrip sebelum tag penutup </body> memastikan skrip dimuat setelah konten halaman, yang disarankan untuk widget obrolan dan tidak akan memperlambat pemuatan halaman Anda.
Alternatif: Menggunakan Tipe Dokumen Pengaturan Situs
Untuk fleksibilitas lebih, Anda dapat menambahkan kolom kustom untuk mengelola skrip footer:
- Buka Settings → Document Types
- Edit tipe dokumen Site Settings Anda (atau buat jika belum ada)
- Tambahkan properti baru bernama "Footer Scripts" dengan tipe data Textarea
- Simpan Tipe Dokumen
- Buka Content dan edit node Pengaturan Situs Anda
- Tempel kode embed Asyntai Anda di kolom Footer Scripts
- Di template Master Anda, tambahkan kode ini sebelum
</body>:@Html.Raw(Model.Value("footerScripts")) - Simpan konten dan template
Catatan: Menggunakan @Html.Raw() penting untuk merender tag skrip dengan benar tanpa encoding HTML.
Alternatif: Menggunakan Folder Scripts
Anda juga dapat membuat file JavaScript di Umbraco Backoffice:
- Buka Settings → Scripts
- Klik kanan pada Scripts dan pilih "Create"
- Buat file baru bernama asyntai-chatbot.js
- Tambahkan kode berikut:
(function() {
var script = document.createElement('script');
script.async = true;
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);
})(); - Ganti
YOUR_WIDGET_IDdengan ID widget Anda yang sebenarnya - Simpan file
- Sertakan skrip ini di template Master Anda sebelum
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
Alternatif: Khusus Halaman dengan RenderSection
Jika Anda hanya ingin chatbot di halaman tertentu:
- Di template Master Anda, tambahkan sebelum
</body>:@RenderSection("footerScripts", required: false) - Di template halaman tertentu tempat Anda ingin chatbot, tambahkan:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
Langkah 3: Verifikasi Instalasi
Setelah menyimpan perubahan Anda, kunjungi situs web Anda di tab browser baru atau jendela penyamaran. Anda akan melihat tombol widget obrolan di pojok kanan bawah. Klik untuk memastikan widget terbuka dan berfungsi dengan benar.
Tidak melihat widget? Pastikan Anda menyimpan template setelah membuat perubahan. Coba bersihkan cache browser atau lihat di jendela penyamaran. Jika Anda menggunakan Umbraco Cloud, perubahan seharusnya di-deploy secara otomatis. Untuk Umbraco yang di-hosting sendiri, Anda mungkin perlu memulai ulang aplikasi atau membersihkan cache.
Weebly