Відповідає за вашою базою знань — клієнт пише у віджет на сайті або боту в Telegram, агент знаходить статті довідки й відповідає з посиланням на статтю.
Передає людині — попросить клієнт людину, розмова зʼявляється в «Комунікаціях» зі звуком і сповіщенням.
Підключити базу знань
- Відкрийте «Налаштування» → «Агент підтримки».
- У блоці «База знань» впишіть адресу
index.jsonабоllms.txtвашої довідки й натисніть «Додати». - Перевірте пошук: напишіть типове питання клієнта в «Перевірити пошук» — побачите ті самі фрагменти, які отримає агент.
ПорадаБаза оновлюється раз на добу сама. Після великої зміни довідки натисніть «Оновити зараз».
ВажливоБез бази знань агент не вигадує відповідей — він каже, що в довідці цього немає, і пропонує людину.
Налаштувати, як агент відповідає
- Впишіть імʼя для клієнтів. Порожнє поле — «Помічник <назва компанії>». Привітання за замовчуванням своє для клієнта, що увійшов на сайт, і для відвідувача, якого віджет ще не знає.
- За потреби змініть привітання й допишіть інструкції компанії: тон, теми, що обіцяти не можна, коли кликати людину.
- Оберіть, хто кличе людину: лише клієнт кнопкою чи ще й агент, коли дві відповіді поспіль у довідці немає.
- Натисніть «Зберегти».
Поставити віджет на сайт
- У блоці «Як відповідає» впишіть у поле «Домени сайтів» домени, по одному в рядку:
example.comабо*.example.comразом із піддоменами. Натисніть «Зберегти». - У блоці «Віджет на сайті» натисніть «Створити ключ».
- Увімкніть «Агент підтримки» й «Віджет на сайті» в блоці «Де відповідає».
- Натисніть «Інструкція для розробника» — Krokul скопіює готову інструкцію з ключем і доменами вашої компанії. Передайте її тому, хто веде сайт: розробнику чи AI-агенту. Зі сповіщення її можна завантажити файлом
.md. - Розробник вставляє один рядок коду з поля «Код вставки» у спільний шаблон сайту або в банер згоди на cookie.
ВажливоНа сайті поза переліком доменів віджет не відкривається. Новий сайт чи піддомен — допишіть у «Домени сайтів».
ПорадаВіконце говорить мовою сторінки — українською, англійською, норвезькою, польською, французькою, німецькою, іспанською чи португальською (Бразилія): мову бере з lang сторінки або атрибута data-lang у коді вставки. Своє привітання й ім'я агента показуються як є, типові — мовою сторінки. Атрибут data-opener задає першу репліку віконця, data-from — звідки прийшла людина (мітка в угоді й у посиланні «Спробувати»).
Підготувати сайт до віджета
Інструкція для розробника описує ці кроки докладно; тут — коротко, що перевірити.
- Згода на cookie. Якщо сайт питає згоду, чат вантажиться після згоди на «Функціональні» — так само, як інші чати. В інструкції є готова функція завантаження з вашим ключем.
- Політика безпеки вмісту (CSP). Якщо сайт її має, у
script-srcіframe-srcдодаєтьсяhttps://app.krokul.com, уstyle-src—'unsafe-inline'для кнопки чату. - Наявний чат. Кнопка Krokul стоїть у правому нижньому куті. Якщо там уже є інший чат чи віджет дзвінка, вирішіть, що з ним: прибрати, лишити обидва на перехідний час зі зсувом однієї кнопки або ставити Krokul лише на окремих сторінках.
- Перевірка. Відкрийте сайт на дозволеному домені: праворуч унизу кругла кнопка чату. Напишіть тестове повідомлення — розмова зʼявиться в «Комунікаціях» з адресою сайту.
Важливо«Новий ключ» вимикає старий код на всіх сайтах одразу — після нього скопіюйте інструкцію чи код знову й замініть ключ на сайті.
ПорадаКод завжди посилається на app.krokul.com/w/widget.js — так оновлення віджета приходять на сайт самі. Копія файла на вашому сервері їх не отримує.
Відповідати в Telegram
- Підключіть бота компанії в «Комунікаціях».
- Увімкніть «Бот компанії в Telegram».
ВажливоОдин бот має одну роль. Якщо бот уже відповідає як сейлз, спершу вимкніть сейлза.
Взяти розмову людині
- Розмова, що чекає людину, зʼявляється в «Комунікаціях» із позначкою «просить людину».
- Натисніть «Долучитися» й відповідайте — клієнт побачить відповідь у тому самому віконці.
- Щоб агент знову відповідав сам, натисніть «Повернути агента».
ПорадаЯкщо клієнт закрив віконце й лишив пошту, ваша відповідь прийде йому ще й листом із вашої скриньки Gmail.
Задати графік роботи
У неробочий час агент не обіцяє людину зараз: пише, коли відповість команда, наприклад «завтра після 09:00», і пропонує лишити контакти. Без графіка агент поводиться як і раніше.
- У розділі «Заявки з чату» увімкніть «Графік роботи».
- Позначте робочі дні й години — від і до. Час — за поясом вашої компанії.
- Натисніть «Зберегти».
Збирати заявки з чату
Форма зʼявляється під відповіддю агента, коли в довідці немає відповіді, коли відвідувач просить людину і в неробочий час. Після форми Krokul сам створює контакт, угоду з джерелом «Чат на сайті» й задачу «Звʼязатися» відповідальному; у нотатці угоди — короткий підсумок розмови. Якщо в людини вже є відкрита угода з чату, заявка лягає в неї нотаткою.
- У розділі «Заявки з чату» увімкніть «Збирати заявки».
- Оберіть воронку й етап, куди лягатимуть угоди. Без них збір не вмикається.
- За потреби оберіть відповідального, джерело й поля форми, потім «Зберегти».
ВажливоПошту й телефон із форми ніхто не підтверджує — у нотатці й задачі так і написано. Відвідувач, що вказав чужу пошту, не бачить у віконці нічого з даних того контакта, а відповідь людини йде на пошту з форми.
Увага: Клієнтам, які увійшли на ваш сайт, і на скарги форма не пропонується. Той самий відвідувач не дістає форму вдруге.
Подивитись, скільки заявок дає чат
Унизу екрана — розділ «Заявки з чату за місяць»: розмови у віджеті, які вів агент, скільки разів запропоновано форму, скільки людей лишили контакти й скільки з цього вийшло нових угод. Біля кожного числа — скільки з них припало на неробочий час.
ПорадаЗаявка від людини, в якої вже є відкрита угода з чату, рахується як форма, але не як нова угода — вона лягає нотаткою в наявну.
ПорадаРозмови без контакту знайдете в «Комунікаціях» відбором «Лише потенційні клієнти без контакту».
Консультувати відвідувачів сайту
На цих сторінках агент консультує: відповідає за базою знань, наприкінці ставить щонайбільше одне уточнення — яка команда, чим користуються, яку задачу треба закрити. Під відповіддю бувають кнопки «Залишити контакти» й «Спробувати» та до трьох швидких питань. Знання агент шукає за питанням людини, а сторінку, з якої вона пише, бере як підказку теми. На інших сторінках агент визначає за питанням, чи людина обирає продукт, чи вже ним користується.
- У розділі «Консультант» впишіть сторінки сайту, по одній у рядку:
example.com— увесь сайт,example.com/pricing— сторінка й усе під нею. - За потреби впишіть адресу «Спробувати» — куди веде кнопка під відповіддю, — і привітання консультанта.
- Натисніть «Зберегти».
ПорадаІз консультацією внизу віконця є тиха кнопка «Залишити контакти»: людина відкриває форму сама, коли хоче. Форму агент пропонує ще й тоді, коли людина питає ціну, тариф, демо чи як почати, і після третього повідомлення — один раз на розмову.
ВажливоКлієнт, який увійшов на ваш сайт, завжди дістає підтримку, навіть на сторінках консультанта: без кнопок консультанта й без форми.
Розпізнати клієнта у вашому кабінеті
Коли віджет стоїть усередині вашого продукту, ваш сервер може підписати, хто пише, — тоді розмова привʼязується до контакту, а розмови з різних пристроїв склеюються.
- Натисніть «Створити секрет» і збережіть його на своєму сервері. Krokul покаже секрет один раз.
- На сервері порахуйте підпис: HMAC-SHA256 від рядка
email|externalId|tsсекретом, у шістнадцятковому вигляді;ts— секунди Unix. - На сторінці викличте
window.KrokulWidget.identify({ email, name, externalId, company, ts, sig }). Назва компанії (company) показується підтримці в розділі «Від сайту».
ВажливоПідпис діє 24 години. Без підпису пошта клієнта — лише адреса для відповіді, контакт не привʼязується.
Передати дані про клієнта
Підтримка бачить у «Комунікаціях» розділ «Від сайту»: сторінку, з якої клієнт пише, і дані, які передає ваш сайт, — наприклад тариф і роль.
- Сторінку віджет передає сам: шлях і заголовок, без параметрів адреси.
- Решту даних передайте полем
propsуidentify— рядком JSON:'{"Тариф":"Маржа","Роль":"Власник"}'. До 20 значень, назва до 40 знаків, значення до 200. - Рядок
propsвходить у підпис: HMAC-SHA256 відemail|externalId|ts|propsтим самим секретом. Підписуйте рівно той рядок, який передаєте.
ВажливоДані без підпису віджет не приймає — інакше клієнт міг би підмінити собі тариф у браузері.
Як це влаштовано
Від чийого імені
Агент пише від імені вашої компанії під імʼям з налаштувань. Унизу віконця — дрібний рядок «Працює на Krokul.com»; він вимикається з тарифом, що дозволяє прибрати мітку Krokul.
Що він знає
Лише статті вашої бази знань: каталогу, цін, угод і контрагентів агент не бачить. Посилання у відповіді ставить система — лише на прочитані статті.
Перевірка відповіді
Перед відправкою кожну відповідь перевіряє окрема модель: обіцянку строку, ціну чи вигаданий крок вона відбиває, і розмова переходить до людини.
Нове звернення й оцінка
Закрита розмова лишається закритою: віконце показує її з оцінкою від 1 до 5 і полем коментаря, а кнопка «Нове звернення» починає наступну розмову — агент відповідає в ній з чистого аркуша. У меню ⋯ віконця — «Мої звернення»: клієнт бачить свої попередні розмови з датою, першим питанням, станом і оцінкою й може відкрити будь-яку для читання; писати можна лише в поточну. Оцінку вмикає рядок «Оцінка після закриття розмови» в розділі «Канали», типово ввімкнено; відповідь лягає рядком у розмову й у звіт «Задоволеність клієнтів».
Облік
Розмови агента рахуються пакетом тарифу на місяць; понад пакет нові розмови одразу йдуть людям. Є стеля відповідей на одну розмову за добу.
Хто що може
Екран бачить і змінює лише адміністратор. Пробний пошук у базі знань доступний ще й менеджеру.
Питання й відповіді
Що робить агент, коли відповіді в довідці немає?
Каже про це клієнту й пропонує покликати людину. У режимі «Кличе клієнт або агент» після другої такої відповіді поспіль він передає розмову сам.
Чи бачить підтримка розмову з агентом?
Так, у «Комунікаціях», наживо. Людина може долучитися будь-коли.
Чи може агент пообіцяти виправлення чи знижку?
Ні. Такі відповіді відбиває перевірка, і розмову бере людина.
Чи можна поставити віджет на кілька сайтів?
Так: впишіть усі домени в перелік. Ключ один на компанію; «Новий ключ» вимикає старий код на всіх сайтах.
Чи допомогла стаття?
Дякуємо — так ми знаємо, яку статтю доробити.
Спробуйте в Krokul
Агент підтримки відкривається в застосунку за один клік після входу.