Vidceti quraşdırın

RolChat vidceti aktivləşdirdiyiniz modullara uyğunlaşan bir üzən düymədir: çat, geri zəng sorğusu forması, görüş bronlanması, lead forması və bilik bazasında axtarış onun içindədir. Onu bir dəfə quraşdırırsınız; nəyi göstərəcəyi paneldə müəyyən edilir.

1. Kodu kopyalayın

Parametrlər → Vidcet bölməsində saytı seçin və quraşdırma kodunu kopyalayın. O, belə görünür:

<!-- RolChat widget -->
<script>
  window.rolchatConfig = {
    "site_id": "ste_…",
    "account_id": "…",
    "widget_key": "wk1.<site>.<signature>",
    "modules": ["chat"]
  };
</script>
<script async src="https://widget.rolchat.com/stub.js"></script>

Vidcet açarı açıqdır və səhifədə yerləşdirmək təhlükəsizdir. O, saytınızı göstərir və imzalanıb, ona görə heç kim vidcetin surətini sizin hesabınıza yönləndirə bilməz. Vidcet parametrlərini dəyişdikcə panel obyektə əlavə açarlar yazır (salamlama, başlıq, mövzu, iş saatları, ekran ölçüsünə görə düzülüş); dəyişikliklərdən sonra kodu yenidən kopyalayın və ya obyekti minimal saxlayıb qalanını vidcetin özünün yükləməsinə imkan verin.

stub.js bir neçə kilobaytdır və qalanını yalnız ziyarətçiyə lazım olanda yükləyir: çat interfeysini ilk açılışda, izləməni razılıqdan sonra, razılıq bannerini isə tələb olunan yerlərdə.

2. Onu </body> teqindən əvvəl yapışdırın

Kodu vidcetin görünməli olduğu hər səhifəyə əlavə edin, ən yaxşısı saytın şablonu və ya teq meneceri vasitəsilə, belə ki, o, hər yerdə eyni anda görünsün. Skript asinxron yüklənir və səhifənin göstərilməsini bloklamır; ilk yükləmə paketi Core Web Vitals göstəricilərinizə təsir etməməsi üçün qəsdən kiçik saxlanılır.

3. İşlədiyini yoxlayın

Saytınızı gizli pəncərədə açın. Düymə seçdiyiniz küncdə görünür. Paneldə Ziyarətçilər yeni anonim sessiyanı real vaxtda göstərir, vidcetdən göndərilən mesaj isə Gələnlər qutusunda yeni söhbət kimi görünür.

Daxil olmuş istifadəçiləri tanıdın

Ziyarətçiləriniz məhsulunuza daxil olursa, söhbətlərin düzgün kontakta bağlanması üçün RolChat-ə onların kim olduğunu bildirin:

window.rolchat.identify({
  email: "alice@example.com",
  first_name: "Alice",
  last_name: "Martin",
  phone: "+15551234567",
  external_id: "user_12345",
  custom_fields: { plan: "pro" },
});

Qəbul edilən atributlar email, phone, first_name, last_name, external_id və düz custom_fields obyektidir; qalan hər şey nəzərə alınmır. RolChat e-poçtu CRM-də axtarır. Kontakt varsa, sessiya ona bağlanır və operator profili görür; yoxdursa, məlumatlar saxlanılır və ziyarətçi ilk dəfə yazanda lead yaradılır.

Daha yüksək etibarlılıq üçün backend-iniz kimliyi imzalaya bilər: RolChat-in istifadəçi üçün verdiyi imzanı atributlarla birlikdə ötürün və sessiya yalnız imza yoxlamadan keçdikdə yüksəldilir. İstifadəçi hesabdan çıxanda window.rolchat.reset() çağırın, əks halda həmin brauzerdəki növbəti şəxs əvvəlki söhbəti görəcək.

JavaScript API

window.rolchat stub işə düşən kimi əlçatan olur; paket yüklənənə qədər edilən çağırışlar növbəyə qoyulur və ardıcıl icra olunur.

Metod	Nə edir
show() / hide()	Başlatma düyməsini göstərir və ya gizlədir
open() / close()	Çat panelini açır və ya bağlayır
identify(traits)	Sessiyanı bir şəxsə bağlayır (yuxarıya baxın)
reset()	Kimliyi unudur və yeni anonim sessiya başladır
pushEvent(name, props)	Trigger mesajları və avtomatlaşdırma üçün xüsusi hadisə göndərir
trackPageView(path?)	Tək səhifəli tətbiqlərdə səhifə baxışını bildirir
setLocale(code)	Vidcetin dilini dəyişir
showConsentPreferences()	Razılıq seçimləri mərkəzini açır
on(event, handler) / off(event, handler)	chat:opened, chat:closed, message:sent, message:received, session:started hadisələrinə abunə olur

window.rolchat.pushEvent("cart_abandoned", { value: 129.9, currency: "EUR" });
window.rolchat.on("message:received", () => audio.play());

Dil və istiqamət

Vidcet window.rolchatConfig daxilində lang ilə təyin etdiyiniz dildə danışır (məsələn, "lang": "de"); o olmadıqda RolChat-in dəstəklədiyi 40 dil arasından ziyarətçinin brauzer dilində, brauzerin üstünlük sırasına uyğun; heç biri uyğun gəlmirsə, ingilis dilində. Saytın öz dil ayarı istifadə olunmur: vidcetin saytınızın dilində danışması üçün lang təyin edin. Ərəb və ivrit dilləri sağdan sola göstərilir. Operator mesajları vidcet tərəfindən tərcümə edilmir; əvəzində operator tərəfi AI ilə canlı tərcümədən istifadə edə bilər.

Kukilər və razılıq

Razılıq banneri tələb olunan yerlərdə vidcet razılıqdan əvvəl ziyarətçiləri izləmir. RolChat Məxfilik modulundan istifadə edirsinizsə, banner və vidcet vahid razılıq vəziyyətini paylaşır. Başqa razılıq alətindən istifadə edirsinizsə, vidcetin analitika hadisələri Parametrlər → Məxfilik → Yerləşdirmə bölməsində qurduğunuz siqnalı gözləyir.

Vidcet harada qurulur

Nə	Harada
Rənglər, mövqe, salamlama, giriş nöqtələri, quraşdırma kodu	Parametrlər → Vidcet
Vidcetin daxilində hansı modulların görünəcəyi	Parametrlər → Modullar (hər sayt üçün)
İş saatları və oflayn mesaj	Parametrlər → Saytlar → İş saatları
Müəyyən səhifələrdə göstərilən trigger mesajları	Marketinq → Triggerlər