# Агент підтримки: відповіді клієнтам за вашою базою знань

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

Теги: агент підтримки, віджет, чат на сайті, база знань, 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.

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

### Збирати заявки з чату
1. У розділі «Заявки з чату» увімкніть «Збирати заявки».
2. Оберіть воронку й етап, куди лягатимуть угоди. Без них збір не вмикається.
3. За потреби оберіть відповідального, джерело й поля форми, потім «Зберегти».
Форма зʼявляється під відповіддю агента, коли в довідці немає відповіді, коли відвідувач просить людину і в неробочий час. Після форми Krokul сам створює контакт, угоду з джерелом «Чат на сайті» й задачу «Звʼязатися» відповідальному; у нотатці угоди — короткий підсумок розмови. Якщо в людини вже є відкрита угода з чату, заявка лягає в неї нотаткою.
> Важливо: Пошту й телефон із форми ніхто не підтверджує — у нотатці й задачі так і написано. Відвідувач, що вказав чужу пошту, не бачить у віконці нічого з даних того контакта, а відповідь людини йде на пошту з форми.
> Увага: Клієнтам, які увійшли на ваш сайт, і на скарги форма не пропонується. Той самий відвідувач не дістає форму вдруге.

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

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

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

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

Повʼязані вікна: «Комунікації», «Сейлз у Telegram», «Оплата».

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

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

### Чи може агент пообіцяти виправлення чи знижку?
Ні. Такі відповіді відбиває перевірка, і розмову бере людина.

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

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs
