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

# ШІ Ростік — доставки: статуси посилок, хто не забирає, повернення

Ростік — ШІ-співробітник Helomi, який супроводжує посилки після відправки, без ШІ-мозку: він не розмовляє від себе, а крутить цикл. Кожні кілька годин бере всі активні ТТН з блоку «Доставка» ваших угод, звіряє їхні статуси на сайтах служб (Нова Пошта, Укрпошта, Meest, Rozetka Delivery), переводить угоди на етапи за вашими налаштуваннями перевізника, рахує дні на відділенні й кому вже час дзвонити, стежить за поверненнями (коли прийшло на ваше відділення, з якого дня йде комісія, коли забрали), а менеджерам показує все це на сторінці «Доставки» і в його пульті. Усі дані — з вашої CRM, налаштування — у пульті, керувати ним можуть люди й інші ШІ (Ломі).

## Можливості
- Усі активні ТТН з угод під наглядом: статус із сайту служби, номер відділення, післяплата, телефон отримувача (Нова Пошта віддає його сама).
- Етап угоди змінюється за статусом посилки — за таблицею «Пов'язані статуси» у налаштуваннях перевізника, від імені «ШІ Ростік» у журналі картки.
- Сторінка «Доставки»: вкладки «В роботі», «Отримано», «Повернення» (забрати / забрано), дні на відділенні, скільки лишилось безплатного зберігання, «щось не так» (ТТН створена, але посилку не віддали; служба давно не оновлює статус).
- Кому подзвонити: лежить на відділенні від N днів і нещодавно не дзвонили; результат дзвінка записується в картку й у нотатку угоди.
- Нагадування клієнтам «заберіть посилку» через ШІ Люду, по службах (день приходу = 1-й): Нова Пошта (5 днів) — лист день 2, Telegram день 3 зранку, дзвінок з дня 4, SMS день 4 о 15:00; Укрпошта, Meest, Rozetka Delivery (7 днів) — лист 2, Telegram 4, дзвінок 6, SMS 6. SMS лише тим, кому менеджер того дня не додзвонився; уночі не пишемо; кожен канал один раз. Дні й години — у налаштуваннях.
- Повернення: день приходу на ваше відділення, пуш менеджерам на 3/4/5 день (день 5 — останній безплатний, з 6-го йде комісія), зворотна ТТН Нової Пошти, «забрали» → угода «Програно», покупець у BlackBox, нотатка в угоду.
- ТТН скасованих угод, які так і не поїхали, скасовуються у службі (своя накладна) і зникають з «Доставок».
- ТТН Ростік не створює — він стежить за вже створеними. Вагу й розмір посилки в ТТН (і в Олеся, і в шторці, і в авто-ТТН) задає галочка «Вага й габарити з товарів» у картці служби ([Доставки і ТТН, 3а](shipping.md#3а-вага-й-габарити-з-товарів-угоди)); у журналі угоди біля ТТН видно, з якими числами пішла посилка.
- Щоденний дайджест у чат («кому подзвонити», «що забрати») — вмикається на чат.
- Усе підписане «ШІ Ростік» у журналі картки угоди і в «Журналі» пульта (кожен крок: скільки звірено, етапів, повернень).

## 1. Налаштування
Ростік з'являється сам в «Інтеграції (головне меню) → ШІ» як плитка «Ростік» і в «Налаштування → Команда → ШІ-співробітники». «Відкрити» на картці веде у вікно ШІ, кружечок «Налаштування» праворуч угорі вікна — його налаштування (вкладка «Налаштування»). Усі значення — тут, у коді нічого міняти не треба:

| Група | Налаштування | Що означає | Типово |
| --- | --- | --- | --- |
| Загальні | Застосовувати зміни до угод | Вимкнено — Ростік лише стежить за статусами, угоди не чіпає (ні етапів, ні «Програно», ні нотаток) | так |
| Цикл | Як часто звіряти статуси на сайтах служб, хв | Період кроку | 120 |
| Цикл | Стежити за ТТН угод не старших за, днів | Старші беруться лише поки їхня посилка ще «в роботі» чи «повернення» | 90 |
| Цикл | Макс. переведень етапу за один крок | Запобіжник від масової зміни етапів | 40 |
| На відділенні | Подзвонити клієнту з якого дня на відділенні | Коли картка стає «треба подзвонити» | 3 |
| На відділенні (по службах) | Безплатне зберігання, днів; лист / Telegram / дзвінок / SMS — на який день | Лічильник «лишилось днів», список «Подзвонити», графік Люди | НП 5: 2 / 3 / 4 / 4; Укрпошта, Meest, Rozetka 7: 2 / 4 / 6 / 6 |
| На відділенні | Лежить понад N днів — ховати як застарілу | Щоб вкладка не засмічувалась | 30 |
| Зависло | ТТН створена, посилку не віддали — попередити з дня / ховати через | Позначка «щось не так» і приховування | 7 / 60 |
| Зависло | Служба не оновлює «в дорозі» — попередити з дня / ховати через | Те саме для посилок у дорозі | 10 / 60 |
| Повернення | З якого дня на вашому відділенні йде комісія | Для підпису й червоної позначки | 7 |
| Повернення | Нагадати менеджерам забрати повернення на дні | Пуш адміністраторам, через кому | 5,6,7 |
| Повернення | Повернення «в дорозі» без руху понад N днів — ховати | Мертві відмови | 14 |
| Повернення | Забрали зі складу → закрити угоду як «Програно» | Етап ролі «Програно» + архів | так |
| Повернення | Забрали → внести покупця у BlackBox | Потрібен ключ «Інтеграції → BlackBox» | так |
| Нагадування через Люду | Передавати Люді нагадування «заберіть посилку» | Шле реальні повідомлення клієнтам | ні |
| Нагадування через Люду | Передавати Люді; також SMS (лише кому не додзвонилися); години: писати з, SMS з, не писати з | Кожен канал один раз; лист і Telegram з ранку, SMS з години SMS, уночі мовчимо | ні; ні; 9 / 15 / 22 |
| Нагадування через Люду | Макс. нагадувань за крок; адреса вебхука Люди; коди джерел | М'який старт; куди слати; назва=код для Люди | 5; адреса; OLX=…, Prom=… |
| ТТН скасованих угод | Скасувати ТТН і сховати; макс. за крок | Угоду скасовано, посилку службі не віддали | так; 15 |

Етапи за статусом Ростік не вгадує: вони задаються в «Інтеграції → Нова Пошта (Укрпошта, Meest, Rozetka) → Пов'язані статуси» — статус служби → етап, окремо для післяплати. Нема рядка для статусу — етап не змінюється. Поки посилку не здали службі («створена, ще не відправлена»), етап Ростік не міняє взагалі (власник 16.10: «лише на відправлено, у відділенні, отримано і повернення») — стани задаються там само, перемикачами «Міняти етап, коли посилка».

Після збереження зміни діють із наступного кроку, без перезапуску.

## 2. Увімкнути або вимкнути Ростіка
«Інтеграції → ШІ» → плитка «Ростік» → перемикач «Увімкнено». Те саме в пульті: «⋯ → Вимкнути». Вимкнений Ростік не робить нічого: цикл пропускається, «Запустити крок» сірий, дайджести в чат не йдуть, інструменти інших ШІ відповідають «ШІ вимкнено». Сторінка «Доставки» показує те, що було на момент вимкнення.

## 3. Як посилка потрапляє під нагляд і що робить крок
Посилка з'являється в «Доставках», коли в угоді є ТТН у блоці «Доставка» (створена з угоди або додана вручну). На кожному кроці Ростік:
1. Бере активні ТТН угод (не старші за «днів» з налаштувань плюс усі, що ще «в роботі» або «повернення») і оновлює картку посилки з угоди: клієнт, телефон, товари, джерело, етап, сума, післяплата.
2. Одним запитом на службу звіряє статуси всіх ТТН на сайтах служб: категорія («в роботі», «отримано», «повернення»), під-стан («створено, не відправлено», «прийнято», «в дорозі», «у відділенні»), відділення, дата останньої події. Для повернень Нової Пошти читає зворотну ТТН — вона каже, чи повернення ще їде, чи вже лежить на вашому відділенні, чи ви його отримали.
3. Переводить угоди на етапи за «Пов'язаними статусами» (розділ 4), розбирає повернення (розділ 6), нагадує (розділ 5), прибирає ТТН скасованих угод (розділ 7), ховає з трекера ТТН, яких в угодах більше нема.
4. Пише підсумок у «Журнал» пульта: скільки доставок, звірено по службах, етапів переведено, повернень забрано, нагадувань.

«Запустити крок» у пульті або «Звірити» на сторінці «Доставки» робить це зараз, не чекаючи періоду.

## 4. Етапи угоди за статусом посилки
Коли статус зі служби збігається з рядком «Пов'язаних статусів» перевізника (точно або за шаблоном з XXXX), угода переходить на вказаний етап своєї воронки — тією самою дією, що й кнопка людини: журнал картки з автором «ШІ Ростік», складські наслідки етапу, тригери, автодії. Той самий етап — нічого; заархівовані угоди не чіпаються; за один крок — не більше, ніж у налаштуванні «Макс. переведень». «Застосовувати зміни» вимкнено — етапи не змінюються, статуси лише показуються.

## 5. На відділенні: дзвінки й нагадування клієнтам
Посилка лежить на відділенні від «дня дзвінка» і клієнту не дзвонили останні 20 годин (після «сказали, що заберуть» — 48) → картка стає «треба подзвонити», а в пульті вона в списку «Подзвонити» з телефоном. Результат дзвінка («не взяли слухавку», «сказали, що заберуть», «відмовилися», «інше» з коментарем) записується в картку і нотаткою в угоду з іменем менеджера. Якщо увімкнено «Передавати Люді нагадування», на день Telegram / пошти / SMS Ростік передає ШІ Люді дані клієнта і замовлення з вашої CRM; Люда шле повідомлення і повертає результат («доставлено», «нема контакту»), Ростік пише нотатку в угоду. Кожен канал — один раз на посилку.

## 6. Повернення
Відмова або повернення за статусом служби → посилка у вкладці «Повернення → Забрати». Коли служба показує, що повернення прибуло на ваше відділення, Ростік фіксує день приходу (день приходу — 1-й) і на дні з налаштування шле адміністраторам пуш «Забери повернення» (з якого дня йде комісія — у підписі). Коли служба показує, що ви його отримали (зворотна ТТН Нової Пошти, «вручено відправнику» в Укрпошти / Meest), або менеджер відмітив «забрали» на сторінці — Ростік закриває угоду як «Програно» (етап ролі «Програно» своєї воронки, архів, нотатка з причиною), вносить покупця у BlackBox (якщо є ключ і увімкнено) і пише нотатку в угоду. Повернені товари далі розбирає Віктор на сторінці «Склад → Повернення».

## 7. ТТН скасованих угод
Угода на етапі ролі «Програно» (або закрита як програна), а свіжий статус служби каже «створено, посилку не віддали» → Ростік скасовує ТТН тією самою дією, що й кнопка «Скасувати» в блоці «Доставка»: свою накладну видаляє у службі, чужу (Kasta, Prom) лише позначає скасованою з підказкою видалити в кабінеті; картка зникає з «Доставок», в журнал угоди іде запис. Посилки, які вже прийняла служба, не чіпаються.

## 8. Пульт Ростіка і сторінка «Доставки»
Вікно — `/crm/ai/rostik` («Відкрити» на картці в «Інтеграції → ШІ» чи в «Структурі»): скільки на відділенні (чорна картка) і кому подзвонити, в дорозі, не відправлені, повернень забрати, післяплата на відділеннях; цикл (як часто, останній крок, «Запустити крок»); списки «Подзвонити» (ім'я, товар, джерело, телефон, ТТН, відділення, днів) і «Забрати повернення» (ТТН, служба, відділення, день — з червоною позначкою, коли комісія вже йде). Налаштування — кружечок «Налаштування» у вікні: вкладки «Налаштування» (з «Доступами й лімітами» внизу), «API», «Огляд», «Журнал». На комп'ютері пульт відкривається на весь екран (меню хоста в рейку ☰, розділи на нижній панелі швидкого доступу), «Згорнути» повертає як було; на телефоні — док знизу, KPI по два в ряд. Сторінка «Доставки» (меню «Доставки») — робочий список менеджера з тими самими даними: пошук за ТТН / телефоном / угодою / клієнтом, картка посилки з посиланням на угоду в CRM, дзвінки, «забрали», ручне виправлення статусу після перевірки на сайті служби, «сховати».

## Можливі помилки
| Як показується | Чому | Що зробити |
| --- | --- | --- |
| Статус посилки не змінюється, у «Журналі» `track_errors 1` | Сайт служби не відповів або нема ключа/токена перевізника | Перевірити акаунт у «Інтеграції → перевізник»; наступний крок спробує знову |
| ТТН довго без статусу служби, «… статус ще недоступний» | Номер записано з пробілами («20 4005 5552 6300» із сайту НП) — до 15.10 трекер такий номер пропускав; тепер питає службу без пробілів | Нічого: наступний крок оновить статус; якщо ні — перевірте номер на сайті служби |
| Угода не переходить на етап, хоч статус змінився | Нема рядка для цього статусу в «Пов'язаних статусах» або «Застосовувати зміни» вимкнено | Додати рядок статус → етап у налаштуваннях перевізника; увімкнути «Застосовувати» |
| У нотатці: «не вдалося закрити угоду як «Програно»: …» | Правила воронки або обов'язкова юрособа при закритті | Закрити угоду вручну після виправлення |
| Нагадування клієнтам не ідуть | «Передавати Люді» вимкнено (типово) або Люда недоступна (`post_failed` у картці) | Увімкнути в пульті; перевірити адресу вебхука Люди |
| Інструмент ai_rostik_* → 403 «ШІ вимкнено» | Ростіка вимкнули | Увімкнути в «Інтеграції → ШІ» |
| Посилка зникла зі списку | ТТН видалили з угоди, угоду скасували й посилку не відправили, або посилка застаріла за порогами | Знайти через пошук (приховані не показуються) або переглянути угоду |

## Для ШІ-співробітників
Ключ розділу в каталозі — `ai-rostik` (`describe_section("ai-rostik")`, `GET /api/ai/sections/ai-rostik`); доступ — галочка «ШІ Ростік (доставки: посилки, повернення)» у «Доступах» співробітника (Ломі має її типово).
- `ai_rostik_status` — стан, налаштування, останній крок.
- `ai_rostik_summary` — зведення: в роботі, на відділенні, кому подзвонити, в дорозі, не відправлені, повернення, післяплата.
- `ai_rostik_list` (tab = in_work | archive | to_pickup | returned), `ai_rostik_search` (q), `ai_rostik_get` (картка), `ai_rostik_digest` (кому подзвонити / що забрати).
- `ai_rostik_run_step` — крок зараз.
- `ai_rostik_call` — записати результат дзвінка (outcome, note); `ai_rostik_fix_status` — виправити стан після перевірки на сайті служби.
- `ai_rostik_return_handled` — відмітити «повернення забрали» (угода → «Програно», BlackBox) — через кошик підтверджень «масові дії».
- `ai_rostik_settings_save` — змінити налаштування (ті самі перевірки, що в пульті); `ai_rostik_enabled` — увімкнути/вимкнути. Обидві — через кошик підтверджень «Керування іншими ШІ».
Не вигадуйте id посилок — беріть їх з `ai_rostik_list` / `ai_rostik_search`; не повторюйте дію, що вже чекає підтвердження; етапи угод не змінюйте в обхід «Пов'язаних статусів».

## Додаткова інформація
Пов'язане: [Угоди](deals.md), [Нова Пошта](int-nova-poshta.md), [Укрпошта](int-ukrposhta.md), [Meest](int-meest.md), [Rozetka Delivery](int-rozetka-delivery.md), [BlackBox](int-blackbox.md), [ШІ Віктор](ai-viktor.md), [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md).