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

# ШІ Люда — супровід клієнта після замовлення

**Що робить.** Пише клієнту від імені бренду, у якого він купив: «замовлення прийнято + номер ТТН», нагадує забрати посилку з відділення, після отримання надсилає фіскальний чек і просить відгук на маркетплейсі. Пише лише на ім'я, безкоштовними каналами (Telegram, пошта); Viber і SMS — лише для чека та останнього нагадування і лише коли є баланс TurboSMS. Жодних «на сайті дешевше»: маркетплейси за це карають.

**Де живе.** Два сервіси на сервері: `luda-ai` і `viber-fallback`. Пульт — розділ «ШІ Люда» у меню Helomi (`/luda`): ланцюжок, журнал кожної спроби, черга «не дійшло — зробіть руками», бренди й канали, тексти (редагуються адміном).

## Звідки Люда бере дані (з 18.10.2026 — лише наша CRM)

- Угода, клієнт, телефони, пошти, товари, ТТН, бренд — `GET /api/luda/deal/{id}` (за секретом Люди).
- Бренд — за папкою складу артикула (коренева папка «ПайПайПласт», «Міністерство тейпів», «PocoPrint», «Перший Шар»,
  «ФЛЮСЕНКО», «Жовтий квадрат»); товари з папки «Товари для авто» — без вітального.
- Нотатки про кожну спробу — у картку угоди від «ШІ Люда» (`POST /api/luda/note`).
- Результат кожної спроби — у журнал розділу «ШІ Люда» (`POST /api/luda/event`).

KeepinCRM більше не використовується (лише як запасний шлях для угод, імпортованих звідти, якщо Helomi не відповів).

## Як Люду запускають: тригери нашої CRM («Налаштування → Тригери»)

| тригер | коли | що робить Люда |
| --- | --- | --- |
| ШІ Люда: прийнято + ТТН (автоматично) | у доставці угоди з'явилась ТТН | «прийнято + ТТН» новому (повний текст бренду) або постійному (коротко) клієнту; один раз на угоду |
| ШІ Люда: прийнято + ТТН (вручну, галочка) | галочка «Відправити «прийнято + ТТН» (ШІ Люда)» в угоді | те саме ще раз (напр., після зміни ТТН); галочку знімає сама |
| ШІ Люда: нагадати забрати посилку (галочка) | галочка «Нагадати забрати посилку (ШІ Люда)» | ручне нагадування «заберіть»; галочку знімає сама |
| ШІ Люда: підтвердити замовлення (галочка) | галочка «Підтвердити замовлення (ШІ Люда)» | «Ви замовляли … все вірно? Можемо відправляти?» |
| ШІ Люда: повідомлення від менеджера | поле «Коментар для ШІ Люди» заповнене | розгортає коментар у ввічливе повідомлення, або шле свій шаблон за `#код`; поле очищає |
| ШІ Люда: чек і прохання про відгук | угода «Отримано» (через 3 хв, чек уже створено тригером Checkbox) | посилання на фіскальний чек + прохання про відгук там, де купили |

Автоматичні нагадування «заберіть» (Нова Пошта: день 2 лист на пошту, день 3 зранку Telegram, день 4 о 15:00 SMS; Укрпошта / Meest / Rozetka: лист 2, Telegram 4, SMS 6; день приходу на відділення = 1-й; SMS лише тим, кому менеджер того дня не додзвонився; уночі не пишемо; кожен канал лише раз; для Нової Пошти внизу листа й Telegram — «УВАГА: термін зберігання Нової Пошти змінено із 7 днів на 5, не забудьте забрати») шле **Ростік** зі своїх налаштувань («Інтеграції → ШІ → Ростік → Нагадування клієнтам через ШІ Люду»).

## Поля угоди (блок «ШІ Люда»)

| поле | тип | навіщо |
| --- | --- | --- |
| Відправити «прийнято + ТТН» (ШІ Люда) | галочка | надіслати вітальне ще раз |
| Нагадати забрати посилку (ШІ Люда) | галочка | ручне нагадування |
| Підтвердити замовлення (ШІ Люда) | галочка | запитати клієнта, чи все вірно |
| Коментар для ШІ Люди | текст | довільне повідомлення або `#код` свого шаблону |

## Можливі помилки

- «нема ні Telegram, ні пошти» — у картці клієнта немає e-mail, а в бренду немає Telegram (Жовтий квадрат, Перший
  шар, Флюсенко): допишіть пошту клієнту.
- «чека Checkbox по угоді немає» — тригер «Чек Checkbox: замовлення отримано» не створив чек (нема каси/зміни/типу
  оплати): див. журнал того тригера.

## Для ШІ-співробітників

Етап 2: шаблон каталогу `luda`, пульт у `crm-ui`, інструменти `ai_luda_*` — наступний PR. Зараз стан і журнал — через розділ «ШІ Люда» (`/api/luda/overview`, `/api/luda/events`).