Инсталирајте го виџетот

Виџетот на 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, банерот и виџетот делат една состојба на согласност. Ако користите друга алатка за согласност, аналитичките настани на виџетот го чекаат сигналот што ќе го поставите во Поставки → Приватност → Вградување.

Каде се конфигурира виџетот

Што	Каде
Бои, позиција, поздрав, влезни точки, код за инсталирање	Поставки → Виџет
Кои модули се појавуваат во виџетот	Поставки → Модули (по сајт)
Работно време и порака за отсуство	Поставки → Сајтови → Работно време
Тригер-пораки прикажани на одредени страници	Маркетинг → Тригери