Инсталирайте уиджета

Уиджетът на 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());

Език и посока

Уиджетът говори на езика, който зададете с lang в window.rolchatConfig (например "lang": "de"); без него - на езика на браузъра на посетителя, по реда на предпочитанията на браузъра, от 40-те езика, които RolChat поддържа; ако никой не съвпада, - на английски. Езиковата настройка на самия сайт не се използва: за да говори уиджетът на езика на сайта ви, задайте lang. Арабският и ивритът се изобразяват отдясно наляво. Съобщенията на агентите не се превеждат от уиджета; вместо това от страната на агента може да се използва превод на живо с AI.

Бисквитки и съгласие

Уиджетът не проследява посетителите преди съгласие там, където е задължителен банер за съгласие. Ако използвате модула Поверителност на RolChat, банерът и уиджетът споделят едно състояние на съгласието. Ако използвате друг инструмент за съгласие, аналитичните събития на уиджета изчакват сигнала, който настроите в Настройки → Поверителност → Вграждане.

Къде се настройва уиджетът

Какво	Къде
Цветове, позиция, поздрав, входни точки, код за инсталиране	Настройки → Уиджет
Кои модули се появяват в уиджета	Настройки → Модули (по сайт)
Работно време и съобщение за офлайн режим	Настройки → Сайтове → Работно време
Тригерни съобщения, показвани на определени страници	Маркетинг → Тригери