Агент підтримки

Адміністратор вмикає агента, який відповідає клієнтам компанії у віджеті на сайті й у Telegram-боті за базою знань компанії, а на прохання клієнта передає розмову людині в «Комунікаціях».

Де знайти: Адміністрування → Налаштування → Агент підтримки

Відповідає за вашою базою знань — клієнт пише у віджет на сайті або боту в Telegram, агент знаходить статті довідки й відповідає з посиланням на статтю.

Передає людині — попросить клієнт людину, розмова зʼявляється в «Комунікаціях» зі звуком і сповіщенням.

Підключити базу знань

  1. Відкрийте «Налаштування» → «Агент підтримки».
  2. У блоці «База знань» впишіть адресу index.json або llms.txt вашої довідки й натисніть «Додати».
  3. Перевірте пошук: напишіть типове питання клієнта в «Перевірити пошук» — побачите ті самі фрагменти, які отримає агент.

ПорадаБаза оновлюється раз на добу сама. Після великої зміни довідки натисніть «Оновити зараз».

ВажливоБез бази знань агент не вигадує відповідей — він каже, що в довідці цього немає, і пропонує людину.

Налаштувати, як агент відповідає

  1. Впишіть імʼя для клієнтів. Порожнє поле — «Помічник <назва компанії>». Привітання за замовчуванням своє для клієнта, що увійшов на сайт, і для відвідувача, якого віджет ще не знає.
  2. За потреби змініть привітання й допишіть інструкції компанії: тон, теми, що обіцяти не можна, коли кликати людину.
  3. Оберіть, хто кличе людину: лише клієнт кнопкою чи ще й агент, коли дві відповіді поспіль у довідці немає.
  4. Натисніть «Зберегти».

Поставити віджет на сайт

  1. У блоці «Як відповідає» впишіть у поле «Домени сайтів» домени, по одному в рядку: example.com або *.example.com разом із піддоменами. Натисніть «Зберегти».
  2. У блоці «Віджет на сайті» натисніть «Створити ключ».
  3. Увімкніть «Агент підтримки» й «Віджет на сайті» в блоці «Де відповідає».
  4. Натисніть «Інструкція для розробника» — Krokul скопіює готову інструкцію з ключем і доменами вашої компанії. Передайте її тому, хто веде сайт: розробнику чи AI-агенту. Зі сповіщення її можна завантажити файлом .md.
  5. Розробник вставляє один рядок коду з поля «Код вставки» у спільний шаблон сайту або в банер згоди на 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

  1. Підключіть бота компанії в «Комунікаціях».
  2. Увімкніть «Бот компанії в Telegram».

ВажливоОдин бот має одну роль. Якщо бот уже відповідає як сейлз, спершу вимкніть сейлза.

Взяти розмову людині

  1. Розмова, що чекає людину, зʼявляється в «Комунікаціях» із позначкою «просить людину».
  2. Натисніть «Долучитися» й відповідайте — клієнт побачить відповідь у тому самому віконці.
  3. Щоб агент знову відповідав сам, натисніть «Повернути агента».

ПорадаЯкщо клієнт закрив віконце й лишив пошту, ваша відповідь прийде йому ще й листом із вашої скриньки Gmail.

Задати графік роботи

У неробочий час агент не обіцяє людину зараз: пише, коли відповість команда, наприклад «завтра після 09:00», і пропонує лишити контакти. Без графіка агент поводиться як і раніше.

  1. У розділі «Заявки з чату» увімкніть «Графік роботи».
  2. Позначте робочі дні й години — від і до. Час — за поясом вашої компанії.
  3. Натисніть «Зберегти».

Збирати заявки з чату

Форма зʼявляється під відповіддю агента, коли в довідці немає відповіді, коли відвідувач просить людину і в неробочий час. Після форми Krokul сам створює контакт, угоду з джерелом «Чат на сайті» й задачу «Звʼязатися» відповідальному; у нотатці угоди — короткий підсумок розмови. Якщо в людини вже є відкрита угода з чату, заявка лягає в неї нотаткою.

  1. У розділі «Заявки з чату» увімкніть «Збирати заявки».
  2. Оберіть воронку й етап, куди лягатимуть угоди. Без них збір не вмикається.
  3. За потреби оберіть відповідального, джерело й поля форми, потім «Зберегти».

ВажливоПошту й телефон із форми ніхто не підтверджує — у нотатці й задачі так і написано. Відвідувач, що вказав чужу пошту, не бачить у віконці нічого з даних того контакта, а відповідь людини йде на пошту з форми.

Увага: Клієнтам, які увійшли на ваш сайт, і на скарги форма не пропонується. Той самий відвідувач не дістає форму вдруге.

Подивитись, скільки заявок дає чат

Унизу екрана — розділ «Заявки з чату за місяць»: розмови у віджеті, які вів агент, скільки разів запропоновано форму, скільки людей лишили контакти й скільки з цього вийшло нових угод. Біля кожного числа — скільки з них припало на неробочий час.

ПорадаЗаявка від людини, в якої вже є відкрита угода з чату, рахується як форма, але не як нова угода — вона лягає нотаткою в наявну.

ПорадаРозмови без контакту знайдете в «Комунікаціях» відбором «Лише потенційні клієнти без контакту».

Консультувати відвідувачів сайту

На цих сторінках агент консультує: відповідає за базою знань, наприкінці ставить щонайбільше одне уточнення — яка команда, чим користуються, яку задачу треба закрити. Під відповіддю бувають кнопки «Залишити контакти» й «Спробувати» та до трьох швидких питань. Знання агент шукає за питанням людини, а сторінку, з якої вона пише, бере як підказку теми. На інших сторінках агент визначає за питанням, чи людина обирає продукт, чи вже ним користується.

  1. У розділі «Консультант» впишіть сторінки сайту, по одній у рядку: example.com — увесь сайт, example.com/pricing — сторінка й усе під нею.
  2. За потреби впишіть адресу «Спробувати» — куди веде кнопка під відповіддю, — і привітання консультанта.
  3. Натисніть «Зберегти».

ПорадаІз консультацією внизу віконця є тиха кнопка «Залишити контакти»: людина відкриває форму сама, коли хоче. Форму агент пропонує ще й тоді, коли людина питає ціну, тариф, демо чи як почати, і після третього повідомлення — один раз на розмову.

ВажливоКлієнт, який увійшов на ваш сайт, завжди дістає підтримку, навіть на сторінках консультанта: без кнопок консультанта й без форми.

Розпізнати клієнта у вашому кабінеті

Коли віджет стоїть усередині вашого продукту, ваш сервер може підписати, хто пише, — тоді розмова привʼязується до контакту, а розмови з різних пристроїв склеюються.

  1. Натисніть «Створити секрет» і збережіть його на своєму сервері. Krokul покаже секрет один раз.
  2. На сервері порахуйте підпис: HMAC-SHA256 від рядка email|externalId|ts секретом, у шістнадцятковому вигляді; ts — секунди Unix.
  3. На сторінці викличте window.KrokulWidget.identify({ email, name, externalId, company, ts, sig }). Назва компанії (company) показується підтримці в розділі «Від сайту».

ВажливоПідпис діє 24 години. Без підпису пошта клієнта — лише адреса для відповіді, контакт не привʼязується.

Передати дані про клієнта

Підтримка бачить у «Комунікаціях» розділ «Від сайту»: сторінку, з якої клієнт пише, і дані, які передає ваш сайт, — наприклад тариф і роль.

  1. Сторінку віджет передає сам: шлях і заголовок, без параметрів адреси.
  2. Решту даних передайте полем props у identify — рядком JSON: '{"Тариф":"Маржа","Роль":"Власник"}'. До 20 значень, назва до 40 знаків, значення до 200.
  3. Рядок props входить у підпис: HMAC-SHA256 від email|externalId|ts|props тим самим секретом. Підписуйте рівно той рядок, який передаєте.

ВажливоДані без підпису віджет не приймає — інакше клієнт міг би підмінити собі тариф у браузері.

Як це влаштовано

  • Від чийого імені

    Агент пише від імені вашої компанії під імʼям з налаштувань. Унизу віконця — дрібний рядок «Працює на Krokul.com»; він вимикається з тарифом, що дозволяє прибрати мітку Krokul.

  • Що він знає

    Лише статті вашої бази знань: каталогу, цін, угод і контрагентів агент не бачить. Посилання у відповіді ставить система — лише на прочитані статті.

  • Перевірка відповіді

    Перед відправкою кожну відповідь перевіряє окрема модель: обіцянку строку, ціну чи вигаданий крок вона відбиває, і розмова переходить до людини.

  • Нове звернення й оцінка

    Закрита розмова лишається закритою: віконце показує її з оцінкою від 1 до 5 і полем коментаря, а кнопка «Нове звернення» починає наступну розмову — агент відповідає в ній з чистого аркуша. У меню ⋯ віконця — «Мої звернення»: клієнт бачить свої попередні розмови з датою, першим питанням, станом і оцінкою й може відкрити будь-яку для читання; писати можна лише в поточну. Оцінку вмикає рядок «Оцінка після закриття розмови» в розділі «Канали», типово ввімкнено; відповідь лягає рядком у розмову й у звіт «Задоволеність клієнтів».

  • Облік

    Розмови агента рахуються пакетом тарифу на місяць; понад пакет нові розмови одразу йдуть людям. Є стеля відповідей на одну розмову за добу.

  • Хто що може

    Екран бачить і змінює лише адміністратор. Пробний пошук у базі знань доступний ще й менеджеру.

Питання й відповіді

Що робить агент, коли відповіді в довідці немає?

Каже про це клієнту й пропонує покликати людину. У режимі «Кличе клієнт або агент» після другої такої відповіді поспіль він передає розмову сам.

Чи бачить підтримка розмову з агентом?

Так, у «Комунікаціях», наживо. Людина може долучитися будь-коли.

Чи може агент пообіцяти виправлення чи знижку?

Ні. Такі відповіді відбиває перевірка, і розмову бере людина.

Чи можна поставити віджет на кілька сайтів?

Так: впишіть усі домени в перелік. Ключ один на компанію; «Новий ключ» вимикає старий код на всіх сайтах.

Чи допомогла стаття?

Спробуйте в Krokul

Агент підтримки відкривається в застосунку за один клік після входу.

Відкрити в Krokul

Markdown для ІІ