> Усі статті WIKI Helomi: /wiki/llms.txt

# ШІ Вадим — менеджер у Viber: чернетки відповідей, угоди й задачі з чату

Вадим — ШІ-агент Helomi, який відповідає покупцям у Viber. Сюди пишуть після дзвінка або замовлення: дані для відправки, квитанція, «коли відправите». На розмову, де клієнт чекає відповіді, Вадим готує коротку чернетку, розбір і пропозицію угоди чи задачі; сам назовні нічого не надсилає, поки ви не дозволите.

## Можливості
- Чернетка відповіді на кожен чат Viber, що чекає відповіді: «Надіслати» як є або виправлену, «Оновити чернетку», «Не підходить».
- Розбір розмови «Що почув ШІ»: що хоче клієнт, стан розмови, товар з наявністю й ціною, телефон, доставка, оплата, впевненість.
- Свій менеджер на кожен акаунт Viber: окремий ШІ зі своїм ім'ям, магазином, інструкцією й вікном; назва магазину — з поля «Назва магазину» або з акаунта, куди написав клієнт.
- Угода й задача з чату за один натиск; повторно з того самого чату угода не дублюється.
- ТТН і стан посилки клієнту, коли чат прив'язаний до угоди з ТТН.
- Сам визначає, коли угоду вже можна створювати (дані зібрано, з оплатою ясно), і сам надсилає клієнту ТТН угоди, створеної з чату.
- «База» (хто він, звідки товари, чого бракує) і «Розбір відповідей» (де людина відповіла інакше) — у вікні агента.
- Типово лише пропонує: автоматичні відповіді, угоди й задачі — лише коли ви дозволите в налаштуваннях.
- Навчання: «Навчити» в смузі чернетки, і учитель сам пропонує уроки з ваших виправлень.
- Інші ШІ (Ломі, Остап) працюють з цими чатами тими самими діями через «Вхід для ШІ».

## 1. Увімкнути агента
Вадим працює, щойно його увімкнено: окремо прив'язувати його до каналу не треба. Потрібні лише ключ моделі й чати цього каналу в «Переписках».

1. Перевірте ключ моделі: «Інтеграції → ШІ → Anthropic (Claude)» → вставте ключ → «Перевірити».
2. Переконайтеся, що чати каналу приходять у «Переписки» (стаття [Viber](int-viber.md)).
3. Відкрийте «Інтеграції → ШІ», знайдіть картку «Вадим» і ввімкніть перемикач «Увімкнено».
4. Натисніть «Відкрити» — перші чернетки з'являться за наступний крок агента (типово за 2 хвилини).

> [!NOTE]
> Новий агент вимкнений, а в налаштуваннях стоїть «лише чернетка»: поки ви не дозволили інше, він нічого не надсилає клієнтам і
> сам не створює угод і задач.

## 2. Вибрати, де агент відповідає
Група «Канал» у налаштуваннях каже, від чийого імені й у яких чатах Вадим готує чернетки. Типові значення — усі акаунти, назва магазину з акаунта.

1. Відкрийте вікно агента і натисніть кружечок «Налаштування».
2. Знайдіть групу «Канал».
3. Заповніть потрібні поля і натисніть «Зберегти» — діє з наступної чернетки.

- **«Назва магазину»**: від чийого імені пише Вадим. Порожньо — назва акаунта чи сайту, куди написав клієнт (наприклад, Viber), у кожному чаті своя.
- **«Відповідати лише в цих акаунтах»**: назви акаунтів чи сайтів через кому, як у «Переписках». Порожньо — в усіх.
- **«Службові розсилки (фрази через ;)»**: є така фраза в останньому повідомленні — це розсилка служби доставки, а не клієнт; агент не відповідає й не витрачає модель.

### Додати окремого менеджера на кожен акаунт Viber
Кожен акаунт Viber може мати свого менеджера — зі своїм ім'ям, назвою магазину й інструкцією про саме цей магазин. Менеджер відповідає лише в закріплених за ним чатах, тож два ШІ ніколи не готують чернетку на одну розмову.

1. Відкрийте «Інтеграції → ШІ», знайдіть шаблон «Вадим» і натисніть «Додати»; дайте новому менеджеру своє ім'я.
2. Натисніть «Відкрити» на його картці й кружечок «Налаштування».
3. У групі «Канал» впишіть у «Відповідати лише в цих акаунтах» назву, як вона стоїть у «Переписках», і за потреби «Назва магазину».
4. У групі «Характер» допишіть в «Інструкція для ШІ», що продає цей магазин і що тут питають клієнти.
5. Натисніть «Зберегти» і ввімкніть менеджера перемикачем «Увімкнено».

У кожного менеджера своє вікно, свої чати, показники, уроки й журнал (наприклад, другий менеджер для другого номера Viber). Менеджер із порожнім полем «Відповідати лише в цих акаунтах» бере чати тих акаунтів Viber, яких не закріпив жоден інший; якщо такого менеджера нема, чати без свого менеджера лишаються людям. У «Переписках» смуга чернетки сама показує менеджера того чату, який ви відкрили.

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

> [!TIP]
> Ломі може навчити будь-якого менеджера: попросіть її «навчи Вадима відповідати так-то» — вона додасть урок, і він діятиме з наступної чернетки. Самі налаштування ШІ (інструкцію, акаунти, доступи) змінює людина у вікні ШІ.

## 3. Працювати у вікні агента
Вікно — робоче місце менеджера: ліворуч список розмов, праворуч розмова з чернеткою й розбором.

1. Відкрийте вікно — угорі показники «Чекають відповіді», «Чернетки готові», «Надіслано сьогодні» і «Взято як є».
2. Виберіть ліворуч вкладку «Чекають», «З чернеткою» або «Усі».
3. Натисніть рядок чату — праворуч відкриються повідомлення, «Що почув ШІ» і «Чернетка відповіді».
4. Виправте текст за потреби й натисніть «Надіслати», або «Не підходить», якщо чернетка не годиться.

Відповідь іде у Viber тим самим шляхом, що й з «Переписок»; у частини підключень вона стає в чергу й доходить за хвилину. Клієнт написав ще раз — стара чернетка застаріла, на наступному кроці агент підготує нову. Та сама чернетка є й у «Переписках» — смугою «Чернетка · Вадим» над полем відповіді з кнопкою «Вставити у відповідь».

Що Вадим вміє в типових розмовах:
- Клієнт надіслав дані для відправки: Вадим підтверджує замовлення, називає день відправки й пропонує угоду.
- Клієнт надіслав квитанцію чи пише «оплатив»: чернетки нема, позначка «потрібна людина: перевірити оплату».
- «Коли відправка?», «де посилка?»: день відправки з налаштувань або ТТН з угоди чату.
- Розсилки Нової Пошти, Meest та інших служб: Вадим їх пропускає й модель на них не витрачає.

> [!WARNING]
> Оплату, повернення коштів, скарги й брак Вадим не вирішує: він лишає чернетку порожньою або нейтральною і пише «потрібна
> людина» з причиною. Надходження грошей перевіряєте ви.

## 4. Створити угоду чи задачу з чату
Коли клієнт домовився про покупку або треба щось зробити, агент пропонує угоду чи задачу, а ви приймаєте або відхиляєте.

1. Відкрийте чат — якщо агент пропонує угоду, праворуч є картка «Створити угоду».
2. Перевірте клієнта й телефон, товар, кількість, ціну, доставку й оплату.
3. Натисніть «Прийняти» — угода створиться, у чаті з'явиться пігулка «угода №…».
4. Для задачі натисніть «Поставити» в картці «Поставити задачу» або «Не треба».

Воронку, етап і джерело нових угод, відповідального й термін задач задають групи «Угоди» і «Задачі» в налаштуваннях агента.

### Коли агент пропонує угоду, а коли вона «чекає»
Вадим сам читає розмову й вирішує, чи час створювати угоду. Угода пропонується, коли клієнт дав усе потрібне і з оплатою ясно; інакше картка називається «Угода чекає» і пояснює, чого бракує.

1. Подивіться в «Що почув ШІ» на рядок «Оплата»: «при отриманні», «чекаємо передоплату», «клієнт каже, що оплатив, — не перевірено» або «оплату підтверджено».
2. Картка «Створити угоду» — дані зібрано, домовились про оплату при отриманні або оплату вже підтверджено: натисніть «Прийняти».
3. Картка «Угода чекає» — у рядку «Ще не час» написано причину: «бракує: телефон, відділення», «чекаємо передоплату 280 грн» або «клієнт каже, що оплатив, — перевірте надходження».
4. Клієнт надіслав квитанцію — перевірте надходження грошей і надішліть йому підтвердження («Так все є, оплата пройшла»). Після цього угода сама стає пропозицією, а з «створювати самому» — створюється одразу.
5. Потрібна угода вже зараз — натисніть у картці «Створити все одно».

Дані для відправки агент просить завжди одним реченням з налаштування «Доставка → Як просити дані для відправки» (типово «Напишіть ваш ПІБ, номер телефона, місто і відділення НП чи укр пошти (індекс 5 цифр)»). Для Укрпошти потрібен індекс рівно з 5 цифр: без нього угода «чекає».

> [!NOTE]
> Сам агент оплату не підтверджує: надходження грошей бачить лише людина. Чернетка з підтвердженням оплати ніколи не йде клієнту автоматично.

## 5. Дозволити автоматичні відповіді
Типово Вадим лише готує чернетки. Автоматичну відправку вмикаєте ви, і діє вона тільки для впевнених відповідей.

1. Відкрийте налаштування агента, група «Відповіді».
2. У полі «Як відповідати» виберіть «впевнене — у «Чекають підтвердження»» або «впевнене надсилає сам».
3. Задайте «Поріг впевненості для автовідповіді, %» і «Що ніколи не йде само».
4. Натисніть «Зберегти».

> [!CAUTION]
> «Надсилає сам» означає, що відповідь піде клієнту без людини. Почніть з режиму «у підтвердження» і подивіться тиждень на «Взято як є».

## 6. Налаштувати агента під себе
Усе, що визначає поведінку агента, змінюється в його налаштуваннях без розробника; зміна діє з наступної чернетки.

1. Відкрийте вікно агента і натисніть кружечок «Налаштування».
2. Виберіть групу й змініть поля.
3. Натисніть «Зберегти».

- **«Характер»**: інструкція для ШІ (типова написана з ваших реальних переписок цього каналу), тон, звертання, мова.
- **«Знання»**: що агент знає про компанію — доставка, оплата, повернення, графік, адреса сайту магазину.
- **«Відповіді»**: довжина, підпис, стоп-слова, робочі години.
- **«Ціна»** і **«Доставка»**: звідки брати ціну, дні відправки й година, до якої замовлення їде того ж дня, ТТН і стан посилки.
- **«Навчання»**, **«Угоди»**, **«Задачі»**, **«Повідомлення»**, **«Що показувати»**.

## 7. Надіслати клієнту ТТН
Клієнт, який замовив у чаті, чекає номер посилки саме тут. Вадим називає ТТН і стан посилки, коли клієнт питає, і сам надсилає номер, щойно він з'явиться в угоді.

Якщо угоду створено з чату, клієнт чекає номер саме тут. Щойно в угоді з'являється ТТН, Вадим пише її клієнту сам і ставить позначку «клієнту надіслано» — у вікні агента під угодою та в «Переписках» у панелі «Про клієнта».

1. Створіть угоду з чату (картка «Створити угоду» або «+ Угода» в «Переписках») і ТТН в угоді — як завжди.
2. Протягом кількох хвилин агент надішле клієнту повідомлення «ТТН: …». Текст — у налаштуванні «Доставка → Текст повідомлення з ТТН».
3. Перевірте позначку у вікні агента: рядок «ТТН … · клієнту надіслано» з часом. Якщо там «клієнту ще не надіслано» — натисніть «Надіслати ТТН».

Чого агент не робить:
- не шле ТТН за замовленнями маркетплейсу чи сайту (чат «по замовленню», покупка кнопкою на майданчику) — там номер показує сам майданчик;
- не шле номер удруге, якщо ви вже написали його клієнту самі, — ставить позначку «номер уже писали в чаті»;
- не шле старі ТТН, які були до ввімкнення цієї можливості, і ТТН посилок, які вже отримано;
- не шле поза «Робочими годинами» агента.

> [!TIP]
> Хочете підтверджувати кожну відправку — виберіть «Доставка → Надсилати клієнту ТТН, коли вона з'явиться → у «Чекають підтвердження»». «Не надсилати» вимикає це зовсім.

## 8. Подивитися «Базу» агента
«База» показує одним екраном, хто такий Вадим і з чим він працює: від чийого імені пише, звідки бере товари й ціни, чи бачить оголошення, що знає про компанію і що робить сам. Угорі — «Чого бракує»: незаповнені знання, порожній прайс-лист, відсутній шаблон з реквізитами.

1. Відкрийте вікно агента — під «Навчанням» є рядок «База» з пігулкою «бракує N» або «усе є».
2. Натисніть стрілку, щоб розгорнути: «Хто він», «Звідки товари й ціни», «Що знає», «Що робить сам».
3. Прочитайте «Чого бракує» і натисніть «Змінити в налаштуваннях», щоб дозаповнити.

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

## 9. Розібрати, де відповіли інакше
«Розбір відповідей» збирає за 14 днів усі випадки, коли людина виправила чернетку або відповіла сама, — щоб бачити, де агент відповідає не так, і одразу його навчити.

1. Відкрийте вікно агента і розгорніть рядок «Розбір відповідей».
2. Прочитайте підсумок: скільки чернеток пішло як є, скільки з правками, скільки разів відповіла людина, і в яких темах чернетки беруть найрідше.
3. У списку «Де відповіли інакше» порівняйте «Клієнт», «Було» (чернетка агента) і «Треба» (що написала людина).
4. Натисніть «Навчити» біля розбіжності — відкриється форма уроку з уже підставленою відповіддю людини; «Зберегти урок».

> [!TIP]
> Розбіжність з пігулкою «урок є» вже стала уроком. Однакові розбіжності учитель сам збирає в пропозиції раз на добу.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| Смуга «Немає ключа моделі» | Ключа моделі нема | «Інтеграції → ШІ → Anthropic (Claude)» → вставити ключ → «Перевірити» |
| «ШІ-співробітника «Вадим» вимкнено», кнопки сірі | Перемикач «Увімкнено» вимкнено | Увімкнути на картці в «Інтеграції → ШІ» |
| Чату нема в списку «Чекають» | Чат з іншого акаунта, це група або розсилка служби, чи розмова старша за «Брати чати не старші за, днів» | Перевірити групу «Канал» і «Цикл» у налаштуваннях |
| Замість чернетки — «потрібна людина» | Оплата, скарга, фото без тексту або даних бракує | Відповісти самому: написати текст у полі й «Надіслати» |
| «Не вдалося відправити: …» | Канал відмовив, причина — після двокрапки | Виправити причину; текст лишився в полі — «Надіслати» ще раз |
| Картка «Угода чекає» замість «Створити угоду» | Бракує даних клієнта, не домовились про оплату або передоплата не перевірена — причина в рядку «Ще не час» | Дочекатися даних чи підтвердити клієнту оплату; потрібна угода зараз — «Створити все одно» |
| Біля ТТН «клієнту ще не надіслано» | Агент вимкнений, зараз поза його робочими годинами, ТТН була до ввімкнення авто-надсилання або відправка не вдалась | «Надіслати ТТН» у вікні агента |
| Чернетка з позначкою «помилка» | Модель не відповіла | «Оновити чернетку»; повторюється — перевірити ключ і ліміти |
| «Вичерпано місячний ліміт токенів моделі» | Бюджет у «Доступах і лімітах» вичерпано | Збільшити бюджет або дочекатися нового місяця |

## Для ШІ-співробітників
Ключ розділу в каталозі — `ai-vadym` (`describe_section("ai-vadym")`); доступ — галочка «ШІ Вадим» у «Доступах і лімітах» співробітника (Ломі має типово). Вимкнений агент на всі інструменти відповідає «ШІ вимкнено».
- `ai_vadym_status` — стан, режим відповідей, показники, останній крок, чи є ключ моделі.
- `ai_vadym_conversations` (tab = waiting | drafted | all, q, days) — чати каналу з останньою чернеткою.
- `ai_vadym_conversation` (conv_id) — повідомлення, активна чернетка з розбором, угода й задача розмови.
- `ai_vadym_draft` (conv_id) — підготувати або оновити чернетку зараз.
- `ai_vadym_send` (draft_id, text) — надіслати відповідь клієнту; відправка назовні чекає «Підтвердити» людини в кошику підтверджень.
- `ai_vadym_reject` (draft_id, reason), `ai_vadym_deal` (draft_id, overrides), `ai_vadym_task` (draft_id, title, due_at, assignee_id, important).
- `ai_vadym_deal_reject`, `ai_vadym_task_reject` (draft_id) — відхилити пропозицію.
- `ai_vadym_stats` (days), `ai_vadym_run_step`, `ai_vadym_lessons`, `ai_vadym_teach`, `ai_vadym_lesson_decide`.
- `ai_vadym_base` — «База» агента: хто він, звідки товари й ціни, що знає, що робить сам, чого бракує.
- `ai_vadym_review` (days, limit) — «Розбір відповідей»: де людина відповіла інакше, ніж чернетка; `draft_id` звідти — для `ai_vadym_teach`.
- `ai_vadym_ttn_send` (conv_id, ttn) — надіслати клієнту номер ТТН угоди чату; відправка назовні чекає «Підтвердити» людини.

Не вигадуйте id чатів і чернеток — беріть їх з `ai_vadym_conversations`; якщо інструмент повернув `pending_id`, скажіть людині, що відповідь чекає підтвердження. Оплату й повернення коштів не підтверджуйте. Налаштування агента змінює людина.

## Додаткова інформація
- Пов'язані статті: [Viber](int-viber.md), [Переписки](chats.md), [Угоди](deals.md), [Завдання](tasks.md), [ШІ-співробітники](ai-employees.md), [Ключі моделей](int-ai-keys.md); менеджери інших каналів — [ШІ Олександр (OLX)](ai-oleksandr.md), [ШІ Денис (Prom)](ai-denys.md), [ШІ Олег (Rozetka)](ai-ruslan.md), [ШІ Роман (Telegram)](ai-taras.md), [ШІ Степан (чат сайту)](ai-stepan.md).