Memasang AVARA di situsmu
Ada tiga hal yang bisa dipasang, dan ketiganya bekerja dengan cara yang berbeda. Bacalah bagian yang kamu butuhkan saja.
Chatbot untuk pengunjung
Bisa dipasang di domain mana pun. Tidak butuh login.
<script src="https://avara.aisac.id/embed.js"
data-chatbot="slug-chatbot"></script>Tempel tepat di tempat kamu ingin chatbotnya muncul — skrip itu membuat bingkainya sendiri di posisi itu.
data-chatbot | Wajib. Slug chatbot, terlihat di panel AVARA. |
data-tampilan | penuh (bawaan), teks, atau avatar. |
data-tinggi | auto (bawaan) atau angka piksel, mis. 520px. |
data-lebar | Bawaannya 100%. |
data-judul | Judul bingkai untuk pembaca layar. |
Tanpa itu peramban menolak menampilkannya, dan yang terlihat cuma kotak kosong. Buka Kode Sematan di panel AVARA, isi Domain yang boleh menyematkan dengan alamat situsmu. www dan tanpa www dihitung berbeda — daftarkan keduanya bila situsmu melayani keduanya.
Tiga tampilan yang tersedia: penuh (avatar + percakapan), teks (tanpa 3D, paling ringan), dan avatar (avatar besar dengan takarir). Mode teks tidak memuat mesin 3D sama sekali — pilih itu bila halamanmu sudah berat.
Panel pengaturan di halaman admin situsmu
Hanya bekerja sedomain dengan AVARA. Butuh login AVARA.
<script src="https://avara.aisac.id/embed.js"
data-panel="chatbot" data-id="ID-CHATBOT"></script>Ganti data-panel dengan kb untuk panel knowledge base. Id chatbotnya (bukan slug) ada di panel AVARA — bagian Panel admin di halaman Kode Sematan sudah menyiapkan potongan yang tinggal disalin.
data-panel | chatbot atau kb. |
data-id | Wajib. Id chatbot, bukan slug. |
data-tema | gelap (bawaan) atau terang. |
data-aksen | Warna #rrggbb, agar menyatu dengan warna situsmu. |
Panel ini membaca akun AVARA orang yang membukanya. Peramban tidak mengirim cookie sesi ke bingkai yang berbeda situs, jadi panel yang dipasang di domain lain akan selalu menampilkan layar “belum masuk” — betapapun benar pemasangannya, dan tanpa satu pun pesan galat yang menjelaskan sebabnya.
Periksa dulu di panel AVARA: Kode Sematan → Panel admin, masukkan alamat halaman adminmu. Kalau jawabannya tidak bisa, pasang chatbotnya saja (bagian 1) — itu tidak butuh sesi dan berjalan di domain mana pun.
Kantor 3D di intranet timmu
Hanya bekerja sedomain. Butuh login AVARA, dan bisa dikunci kata sandi ruang.
<iframe src="https://avara.aisac.id/embed/office/SLUG-TIM" allow="fullscreen" style="width:100%;height:640px;border:0" title="Kantor AVARA" ></iframe>
Kantor yang dipasang di kolom sempit hanya bisa dipakai dengan layar penuh. Tanpa izin itu, tombol layar penuh di dalamnya ditolak peramban tanpa gejala apa pun — ditekan, dan tidak terjadi apa-apa. embed.js sudah memasangnya sendiri.
Slug tim ada di panel AVARA, menu Ruang Kantor. Di halaman yang sama kamu bisa memasang kata sandi ruang — lapis kedua di atas login, untuk layar yang terbuka di meja bersama. Kalau dipasang, di dalam kantor muncul tombol Kunci kantor yang meminta kata sandinya lagi di peramban itu.
Menu yang sama juga menentukan domain mana yang boleh membingkai kantormu. Mengisinya mempersempit — ia tidak bisa membuka domain di luar AVARA, karena sesi memang tidak terbaca di sana.
Menghubungkan panel dengan halamanmu
Opsional. Berguna kalau halamanmu perlu bereaksi.
Panel mengabari halaman yang memuatnya setiap kali sesuatu tersimpan atau gagal. embed.js sudah menerjemahkannya jadi event DOM biasa, jadi kamu tidak perlu berurusan dengan postMessage:
document.addEventListener("avara:tersimpan", function (e) {
console.log("tersimpan:", e.detail.apa); // "chatbot" | "kb-topic"
// mis. muat ulang daftar chatbot di halamanmu sendiri
});
document.addEventListener("avara:galat", function (e) {
console.warn("gagal:", e.detail.pesan);
});Tinggi bingkainya juga sudah diurus: panel melaporkan tinggi isinya sendiri dan embed.js menyesuaikannya. Isi data-tinggi hanya bila kamu memang ingin memakunya — begitu diisi, laporan dari dalam diabaikan.
Apa yang tersimpan di peramban pengunjungmu
Yang wajib mencantumkannya adalah kamu, bukan kami — dan ini datanya.
Begitu kamu menempelkan bingkai ini, AVARA menyimpan beberapa hal di peramban orang yang membuka halamanmu. Dari sudut pandang hukum, yang menempatkan bingkainya adalah kamu, jadi yang wajib memberi tahu pengunjung juga kamu. Kami tidak bisa melakukannya untukmu — tapi kami bisa memastikan kamu tahu persis apa isinya.
Tidak ada satu pun yang dipakai untuk iklan, analitik, atau pelacakan lintas situs. Semuanya diperlukan agar fiturnya berfungsi, jadi di kebanyakan yurisdiksi ia masuk kategori strictly necessary — yang berarti cukup diberitahukan, tidak perlu diminta izinnya. Konfirmasikan itu ke penasihat hukummu sendiri bila ragu; kami tidak bisa memberi nasihat hukum untuk yurisdiksimu.
| Nama | Jenis | Untuk apa | Berapa lama |
|---|---|---|---|
| avatar_session | Cookie | Menandai bahwa Anda sudah masuk, supaya tidak diminta kata sandi di tiap halaman. | 30 hari, atau sampai Anda keluar |
| avara_kantor_<tim> | Cookie | Menandai bahwa Anda sudah memasukkan kata sandi ruang kerja 3D. | 8 jam |
| avara_pengunjung | Penyimpanan lokal | Nomor acak tanpa nama, supaya percakapan Anda dengan chatbot bisa dilanjutkan dan tidak tercampur dengan percakapan orang lain di perangkat yang sama. | Sampai Anda menghapus data situs ini |
| avara_izin_<chatbot> | Penyimpanan lokal | Bukti bahwa Anda sudah memasukkan kode akses, dipakai saat chatbot dipasang di dalam halaman situs lain. | 12 jam |
| avara_sfx_bisu | Penyimpanan lokal | Mengingat bahwa Anda mematikan suara. | Sampai Anda menghapus data situs ini |
| avara_pintasan_kantor_<tim> | Penyimpanan lokal | Mengingat gerakan pintasan (tombol 1-0) yang Anda pasang di kantor 3D tim ini. | Sampai Anda menghapus data situs ini |
| avara_setelan_kantor | Penyimpanan lokal | Mengingat pengaturan ruang 3D yang Anda pilih: tombol, kepekaan kamera, tema dan ukuran antarmuka, kualitas gambar, dan volume suara. | Sampai Anda menghapus data situs ini |
| avara_hud_kantor | Penyimpanan lokal | Mengingat bagian antarmuka ruang 3D mana yang Anda sembunyikan, dan letak serta ukuran bagian yang Anda atur sendiri. | Sampai Anda menghapus data situs ini |
| avara_peta_kantor | Penyimpanan lokal | Mengingat setelan peta mini ruang 3D: perbesaran, arah peta, dan apakah diciutkan. | Sampai Anda menghapus data situs ini |
| avara_petunjuk_kantor | Penyimpanan lokal | Mengingat misi panduan ruang 3D yang sudah Anda selesaikan, dan apakah panelnya Anda ciutkan. | Sampai Anda menghapus data situs ini |
Salin tabel ini apa adanya ke kebijakan cookie situsmu. Daftarnya dibaca langsung dari kode yang berjalan — jadi kalau kelak ada yang bertambah, halaman ini yang berubah lebih dulu, bukan setelah ada yang mengeluh.
Yang tidak ada di tabel ini tidak akan pernah sampai ke pengunjungmu. Cookie panel pengelola, misalnya, hanya berlaku di domain AVARA sendiri.
Ada yang tidak berjalan seperti di atas? Kirim alamat halamannya ke info@aisac.id.