← Усі пости

Встановити віджет за пʼять хвилин

Покрокове встановлення віджета Lavenity: додайте домен, скопіюйте site ID, вставте асинхронний script і перевірте першу розмову.

Щоб поставити Lavenity на сайт, не потрібні SDK, npm-пакет чи збірка. Достатньо одного тега script.

Що потрібно перед установкою

Зареєструйтеся, створіть робочий простір і додайте домен, де має зʼявитися чат. У дашборді буде site ID — він потрібен для сніпета.

Вставте скрипт перед закривним тегом body на будь-якому стеку: WordPress, Shopify, статичний сайт чи власний фреймворк. Скрипт вантажиться асинхронно й важить близько 4 КБ, тож не повинен блокувати рендер.

Куди додати script і site ID

Відкрийте сайт у приватному вікні й надішліть тестове повідомлення. Воно має зʼявитися в командних вхідних за секунду — зі статусами presence і «друкує…», якщо онлайн інший оператор.

Якщо бульбашка не зʼявляється, перевірте, що домен точно збігається з allowlist (включно з www) і що блокувальник контенту не ріже сторонні скрипти у тестовому профілі.

Як перевірити віджет після запуску

Коли будете готові залучити команду, надішліть інвайти з дашборду. Owners керують сайтами й тарифами; agents працюють із розмовами.

Типові причини, чому бульбашка не зʼявляється

Найчастіше проблема в точному збігу домену: example.com і www.example.com потрібно дозволити окремо, а staging-хост не вважається production-доменом. Також перевірте site ID, адресу script, політику Content Security Policy та consent manager, який може відкладати сторонні теги до згоди. Якщо встановлюєте чат через Google Tag Manager, запускайте тег один раз на сторінку: повторне підключення того самого loader не прискорює віджет і ускладнює діагностику.

Тестуйте в приватному вікні без активної операторської сесії. Відкрийте launcher, надішліть повідомлення, перевірте його появу у вхідних, дайте відповідь і перезавантажте сторінку. Історія має повернутися, а домен — залишатися дозволеним без ручного втручання.

Поширене запитання

Чи потрібен npm-пакет або перебудова сайту?

Ні. Для стандартної установки достатньо асинхронного тега script із site ID перед закривним body. Його можна додати без SDK у статичний HTML, WordPress, Shopify, через Google Tag Manager або у власний frontend.