Виджетті орнату

RolChat виджеті - сіз қосқан модульдерге бейімделетін бір қалқымалы батырма: чат, кері қоңырау сұрау формасы, кездесу брондау, лид формасы және білім базасы бойынша іздеу - бәрі оның ішінде. Оны бір рет орнатыңыз; оның не көрсететіні басқару тақтасында шешіледі.

1. Кодты көшіріңіз

Баптаулар → Виджет бөлімінде сайтты таңдап, орнату кодын көшіріңіз. Ол мынадай болады:

<!-- 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>

Виджет кілті жария және оны бетке қоса беру қауіпсіз. Ол сайтыңызды атайды және қол қойылған, сондықтан ешкім виджеттің көшірмесін сіздің аккаунтыңызға бағыттай алмайды. Виджет баптауларын өзгерткен сайын басқару тақтасы объектіге қосымша кілттерді (сәлемдесу, тақырып атауы, тақырып безендіруі, жұмыс уақыты, экран өлшеміне қарай орналасу) қосады; оларды өзгерткеннен кейін кодты қайта көшіріңіз немесе объектіні ең аз күйде қалдырып, қалғанын виджеттің өзі алсын.

stub.js бірнеше килобайт қана және қалғанын келушіге қажет болғанда ғана жүктейді: чат беті алғаш ашылғанда, бақылау келісімнен кейін, келісім баннері талап етілетін жерде.

2. Оны </body> алдына қойыңыз

Кодты виджет керек әр бетке қосыңыз, ең дұрысы - сайт үлгісі немесе тег менеджері арқылы, сонда ол бірден барлық жерде пайда болады. Скрипт асинхронды жүктеледі және бейнелеуді бөгемейді; бірінші жүктелетін бума Core Web Vitals көрсеткіштеріңізге әсер етпеуі үшін әдейі кішкентай етіп жасалған.

3. Жұмысын тексеріңіз

Сайтыңызды жеке (инкогнито) терезеде ашыңыз. Батырма сіз таңдаған бұрышта пайда болады. Басқару тақтасында Келушілер жаңа анонимді сессияны нақты уақытта көрсетеді, ал виджеттен жіберілген хабарлама кіріс жәшігінде жаңа сұхбат ретінде пайда болады.

Жүйеге кірген пайдаланушыларды сәйкестендіру

Егер келушілеріңіз өніміңізге кірсе, сұхбаттар дұрыс контактіге тіркелуі үшін RolChat-қа олардың кім екенін айтыңыз:

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

Қабылданатын белгілер: email, phone, first_name, last_name, external_id және жалпақ custom_fields объектісі; қалғаны елемейді. RolChat электрондық поштаны CRM-нен іздейді. Контакт бар болса, сессия соған байланады және оператор профильді көреді; болмаса, деректер сақталып, келуші алғаш жазғанда лид жасалады.

Сенімді арттыру үшін бэкендіңіз сәйкестендіруге қол қоя алады: RolChat пайдаланушы үшін беретін қолтаңбаны белгілермен бірге жіберіңіз, сонда сессия қолтаңба расталғанда ғана жоғарылатылады. Пайдаланушы шыққанда window.rolchat.reset() шақырыңыз, әйтпесе сол браузердегі келесі адам алдыңғы сұхбатты көреді.

JavaScript API

window.rolchat stub іске қосылған бойда қолжетімді; бума жүктелгенге дейінгі шақырулар кезекке қойылып, ретімен орындалады.

Әдіс	Не істейді
show() / hide()	Іске қосу батырмасын көрсету немесе жасыру
open() / close()	Чат тақтасын ашу немесе жабу
identify(traits)	Сессияны адамға байлау (жоғарыда)
reset()	Сәйкестендіруді ұмытып, жаңа анонимді сессия бастау
pushEvent(name, props)	Триггерлі хабарламалар мен автоматтандыру үшін өз оқиғаңызды жіберу
trackPageView(path?)	Бір беттік қолданбаларда бет қаралымын жіберу
setLocale(code)	Виджет тілін ауыстыру
showConsentPreferences()	Келісім баптаулары орталығын ашу
on(event, handler) / off(event, handler)	chat:opened, chat:closed, message:sent, message:received, session:started оқиғаларына жазылу

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

Тіл және бағыт

Виджет window.rolchatConfig ішіндегі lang параметрімен бекіткен тілде сөйлейді (мысалы, "lang": "de"); ол болмаса - RolChat қолдайтын 40 тілдің ішінен келушінің браузер тілінде, браузердің қалаулары ретімен; ешқайсысы сәйкес келмесе - ағылшынша. Сайттың өз тіл баптауы қолданылмайды: виджет сайтыңыздың тілінде сөйлеуі үшін lang белгілеңіз. Араб және иврит тілдері оңнан солға қарай көрсетіледі. Оператор хабарламаларын виджет аудармайды; оператор жағы оның орнына AI арқылы тікелей аударманы қолдана алады.

Cookie және келісім

Келісім баннері талап етілетін жерде виджет келісімге дейін келушілерді бақыламайды. RolChat Құпиялылық модулін пайдалансаңыз, баннер мен виджеттің келісім күйі ортақ болады. Басқа келісім құралын пайдалансаңыз, виджеттің аналитика оқиғалары Баптаулар → Құпиялылық → Енгізу бөлімінде бапталған сигналды күтеді.

Виджет қай жерде бапталады

Не	Қайда
Түстер, орналасу, сәлемдесу, кіру нүктелері, орнату коды	Баптаулар → Виджет
Виджет ішінде қай модульдер көрінеді	Баптаулар → Модульдер (сайт бойынша)
Жұмыс уақыты және офлайн хабарлама	Баптаулар → Сайттар → Жұмыс уақыты
Белгілі беттерде көрсетілетін триггерлі хабарламалар	Маркетинг → Триггерлер