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

# ШІ Едуард — замовлення з Telegram: свій бот, оператори й угоди

Едуард — ШІ-агент Helomi, який приймає замовлення в Telegram від вашої команди. Менеджер або дропшипер надсилає вашому боту замовлення як зручно — текстом, скріншотом, кількома повідомленнями, — а Едуард знаходить товари на складі, розкладає клієнта, доставку й оплату і створює угоду. Бота ви створюєте самі й підключаєте за хвилину, без розробника.

## Можливості
- Свій бот компанії: токен від @BotFather вставляєте у вікні Едуарда, Helomi перевіряє його в Telegram і показує ім'я й посилання бота.
- Оператори за запрошенням: кожна людина отримує своє одноразове посилання на бота; від інших бот замовлень не приймає.
- Замовлення як зручно: текст, фото, скріншот, PDF — хоч кількома повідомленнями; Едуард збирає їх в одне замовлення.
- Товари зі «Складу»: підбір за артикулом, словами назви, їхніми коренями й числами («100 мл», «50 ват»); не знайшов у короткому списку — шукає по всьому складу.
- Пошук товару з чату: «знайди циліндр 100» — артикул, ціна й наявність, без створення замовлення.
- Миттєва відповідь «Збираю замовлення — 2 повідомл.» з кнопками «Обробити зараз» і «Скинути»; кнопка «Меню» з усіма командами.
- Яскрава картка угоди: клієнт, доставка, оплата, джерело, товари з артикулами й наявністю, сума, етап, відповідальний, файли.
- Джерело, оплата й доставка зі слів оператора: «з олх», «наложка», «нп київ 12» — за вашим словником і вашими довідниками.
- Розбір перед угодою з кнопками «Так» і «Ні» — або угода одразу, як вирішите в налаштуваннях.
- Угода туди, куди скажете: воронка, етап (свій для кожного джерела), номер, відповідальний, поля угоди, файли.
- Зміни з чату: «зміни 50001234 ціну на 300», «прибери сітку», «до цього ще скоби» — Едуард править угоду й пише, що змінив.
- Вибір товару кнопками: коли Едуард не певен, який товар мали на увазі, він показує до чотирьох схожих зі «Складу» — оператор натискає потрібний.
- ТТН з чату: кнопка «Створити ТТН» під угодою — накладна через підключену службу доставки після «Так».
- Навчання на виправленнях: Едуард пропонує рядки у «Словник» і «Синоніми товарів», а додаєте їх ви — на вкладці «Навчання».
- Нотатка, стан і ТТН, видалення угоди (після «так») — командою або кнопкою під угодою.
- Документи клієнта: витяг з ЄДР чи довідка про рахунок — назва фірми, код і юридична адреса лягають у картку клієнта.
- «OLX Доставка»: в угоду йде повна вартість товару, комісія — окремо у «Фінанси».
- Головні оператори отримують копії угод інших операторів; інші ШІ передають Едуарду замовлення текстом.
- Один бот на дві справи: оператори диктують замовлення, а клієнти пишуть тому самому боту — і їхні повідомлення йдуть у «Переписки».

## 1. Створити бота в Telegram
Бот — це окремий обліковий запис у Telegram, якому писатимуть ваші оператори. Створити його може будь-хто з телефона.

1. Відкрийте в Telegram чат з **@BotFather** (офіційний бот Telegram із синьою галочкою).
2. Надішліть команду `/newbot`.
3. Введіть назву бота — її бачитимуть оператори, наприклад «Замовлення Моя Компанія».
4. Введіть ім'я користувача бота латиницею; воно має закінчуватися на `bot`, наприклад `mycompany_orders_bot`.
5. Скопіюйте токен із повідомлення BotFather — довгий рядок із цифр і літер з двокрапкою посередині.

> [!WARNING]
> Токен — це ключ до бота: хто його має, той керує ботом. Не надсилайте токен у чати й не вставляйте будь-куди, крім вікна Едуарда чи картки бота в «Інтеграціях».

## 2. Підключити бота до Едуарда
Підключає адміністратор. Helomi одразу перевіряє токен у Telegram: зламаний токен нічого не змінює.

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

Токен зберігається зашифрованим і більше ніде не показується. Бот з'являється ще й окремим акаунтом у «Інтеграції → Повідомлення → Telegram» — там його журнал і режим отримання повідомлень. Під назвою бота у вікні Едуарда видно рядок «як він працює»: скільки збирає повідомлення, чи чекає «так», чи читає фото.

> [!TIP]
> Уже маєте бота в «Інтеграціях»? У формі підключення виберіть його в полі «Або бот, який уже є в «Інтеграціях»» — токен вставляти не потрібно.

## 3. Запросити операторів
Оператор — людина, якій бот дозволяє надсилати замовлення: менеджер, дропшипер, партнер. Без запрошення бот замовлень не приймає.

1. У вікні Едуарда відкрийте вкладку «Оператори».
2. Введіть «Ім'я оператора» — так бот звертатиметься до людини й так будуть підписані її угоди.
3. Виберіть «Людина в Helomi», якщо оператор працює в CRM: він стане відповідальним за свої угоди. Дропшиперу без входу в CRM це поле лишіть порожнім.
4. Натисніть «Запросити».
5. Натисніть «Скопіювати» й надішліть посилання людині.
6. Людина відкриває посилання, натискає «Старт» у Telegram — бот вітається, і вона стає оператором.

Посилання показується один раз і діє обмежений час (типово 48 годин). Минуло або загубилось — «Нове посилання» в рядку оператора. Людина більше не працює з вами — «Відкликати»: бот перестане приймати від неї замовлення, а створені угоди лишаться.

> [!TIP]
> Керівникові натисніть «Зробити головним»: він отримуватиме в бот копію кожної угоди, яку оформили інші оператори чи інші ШІ.

## 4. Надіслати замовлення боту
Оператор пише як зручно — порядок слів не важливий, можна частинами.

1. Надішліть боту замовлення: текст, скріншот чи PDF, хоч кількома повідомленнями. Наприклад: «Іван Петренко 067 123 45 67», потім фото товару, потім «нп київ 12, наложка».
2. Бот одразу відповість «Збираю замовлення — 1 повідомл.»; з кожним новим повідомленням він прибирає цю відповідь і надсилає нову з лічильником.
3. Надіславши все, натисніть «Обробити зараз» (або напишіть «готово») — Едуард розбере всі зібрані повідомлення разом. Сам він не починає: таймера нема.
4. Прочитайте розбір, який надішле бот: клієнт, товари з цінами, сума, доставка, оплата, джерело.
5. Натисніть «Так» під розбором (або напишіть «так») — Едуард створить угоду й надішле картку з її номером, етапом і відповідальним.
6. Щось не так — напишіть уточнення звичайним текстом («телефон 0501112233», «не 2, а 3 штуки») — бот покаже розбір знову.
7. Передумали — «Ні».

Коли Едуард не певен, який товар мали на увазі, він питає «Який товар мали на увазі?» і показує до чотирьох схожих товарів кнопками — з ціною й позначкою «нема», якщо товару немає в наявності. Натисніть потрібний або «Залишити без товару складу». Вибір Едуард запам'ятовує як пропозицію синоніма на вкладці «Навчання».

Якщо чогось бракує (наприклад телефону), бот назве, чого саме, і чекатиме дописаного. Якщо в налаштуваннях вибрано «створювати одразу», бот не питає «так», а одразу створює угоду й дає кнопки для правок.

> [!NOTE]
> Голосові, відео й стікери бот поки не читає — він попросить написати текстом. Фото й PDF — до розміру з налаштувань (типово 5 МБ).

## 5. Знайти товар на складі з чату
Оператор може спитати бота про товар, не оформлюючи замовлення.

1. Напишіть «знайди» й назву або артикул: «знайди паяльник 100 ват», «знайди А000044». Або «Меню» → «Знайти товар на складі».
2. Бот покаже до десяти товарів: назву, артикул, ціну й скільки є в наявності.
3. Натисніть на артикул — він скопіюється; вставте його в замовлення.

Пошук той самий, яким Едуард підбирає товари в замовленні: точний артикул важить найбільше, далі слова назви, їхні корені («паяльники» → «паяльник») і числа-характеристики. Модель для пошуку не викликається.

## 6. Змінити угоду, додати нотатку чи видалити
Під створеною угодою бот показує кнопки «Змінити», «Нотатка», «ТТН», «Створити ТТН», «Відкрити в CRM», «Видалити угоду». Те саме можна написати текстом.

1. Щоб змінити — натисніть «Змінити» й напишіть, що саме: «ціну на 300», «2 штуки», «прибери сітку», «оплата на рахунок», «телефон 0501112233».
2. Щоб додати нотатку — «Нотатка» й текст.
3. Щоб побачити етап і номер накладної — «ТТН».
4. Щоб створити накладну — «Створити ТТН» (або напишіть «створи ттн»). Бот покаже службу доставки, одержувача, адресу й післяплату; перевірте й натисніть «Так» — номер ТТН з'явиться в чаті й в угоді.
5. Щоб видалити — «Видалити угоду», потім «Так». Угода піде у «Видалену інформацію» на 30 днів.

| Що написати боту | Що станеться |
| --- | --- |
| зміни 50001234 ціну на 300 | ціна позиції в угоді №50001234 стане 300 |
| #50001234 оплата на рахунок, 2 шт | зміняться поле оплати й кількість |
| видали 50001234 сітку | з угоди зникне лише товар «сітка» |
| нотатка 50001234 передзвонити | нотатка в угоді |
| стан 50001234 | етап, сума й ТТН |
| створи ттн 50001234 | запитання з даними накладної, після «так» — ТТН через вашу службу доставки |
| видали 50001234 | запитання «Видалити?», після «так» — у «Видалену інформацію» |
| до цього ще скоби · постав оплату на рахунок | без номера: зміна щойно створеної угоди (типово протягом 20 хвилин) |
| нове замовлення … | навіть одразу після угоди це буде нова угода |

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

> [!NOTE]
> Типово оператор змінює лише угоди, які сам оформив через бота. Своїм менеджерам можна дозволити будь-яку угоду за номером: «Замовлення → Які угоди оператор може змінювати».

## 7. Стежити за замовленнями у вікні
Вікно Едуарда показує, що оператори написали боту і що з цього вийшло.

1. Відкрийте «Інтеграції → ШІ» → «Едуард» → «Відкрити».
2. Угорі — показники за 30 днів: скільки угод створено, скільки чекають «так», скільки операторів і помилок.
3. На вкладці «Замовлення» виберіть стан: «Усі», «Чекають «так»», «Угоди», «Помилки».
4. У рядку замовлення натисніть «Угода №…», щоб відкрити створену угоду. Тут же видно зміни й видалення угод з чату та попередження розбору.
5. Замовлення з помилкою — «Розібрати ще раз»; зайве — «Скасувати».

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

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

| Група | Що тут налаштовують |
| --- | --- |
| Характер | інструкція для ШІ, тон, звертання й мова відповідей бота |
| Бот у Telegram | який бот слухає Едуард, привітання, кнопки під повідомленнями, що робити з чужими, скільки діє запрошення |
| Замовлення | створювати після «так» чи одразу; коли обробляти надіслане (за кнопкою, за таймером чи одразу); фото й PDF; уточнення без номера; зміна й видалення угод з чату; ТТН з чату; вибір товару кнопками; чи обов'язкові телефон, товари й доставка; звідки ціна; попередження про повтор |
| Угода | воронка й етап, етап за джерелом, джерело зі слів оператора, які поля угоди заповнювати, файли, номер (початок + випадкові цифри чи порядковий), відповідальний, коментар |
| Товари | чи підказувати моделі товари зі «Складу», скільки, другий запит по всьому складу, синоніми товарів |
| Словник | як розуміти скорочення й сленг вашої команди |
| Навчання | чи пропонувати правила з виправлень операторів і скільки виправлень зібрати перед пропозицією |
| Документи клієнта | чи читати витяги й довідки і в які поля клієнта класти код і юридичну адресу |
| Повідомлення | оформлення (зі значками чи простий текст), миттєве «прийняв», розбір, посилання на угоду, копії головним операторам, зусилля моделі |
| Що показувати | перша вкладка вікна, період списку, вартість розбору — особисто для вас |

## 9. Навчити Едуарда ваших слів, товарів і правил
Едуард працює з вашими довідниками, а не зі своїми: джерела, етапи й варіанти полів він бере з вашого Helomi.

1. **Словник.** У групі «Словник» допишіть рядки «слова = що це означає»: «наложка = оплата накладеним платежем», «дроп = джерело Дропшипери».
2. **Синоніми товарів.** У «Товари → Синоніми товарів» допишіть рядок «слова = артикули», якщо клієнти називають товар не так, як він зветься на складі: «паяльник, степлер = П001, П002».
3. **Поля угоди.** У «Угода → Які поля угоди заповнювати» перелічіть назви полів через кому. Для поля-списку Едуард вибирає лише з його варіантів у «Налаштування → Типи даних → Угоди».
4. **Етап за джерелом.** У таблиці «Етап за джерелом» виберіть етап для джерела, якому потрібна своя воронка, — наприклад, замовлення дропшиперів одразу на «Необроблені».
5. **Навчання.** Відкрийте вкладку «Навчання» у вікні Едуарда. Тут пропозиції, які він зібрав сам: з уточнень операторів («не 2, а 3», «це з олх») і з товарів, вибраних кнопками. Натисніть «Додати» — рядок піде у «Словник» (вибраний товар — у «Синоніми товарів») і діятиме з наступного замовлення; «Відхилити» — Едуард більше не пропонуватиме це правило. «Знайти правила» переглядає нові виправлення одразу, не чекаючи, поки їх назбирається.
6. Перевірте на прикладі: блок «Перевірити на прикладі» у вікні Едуарда покаже розбір без бота й без угоди.

> [!TIP]
> Правило не вкладається в словник? Допишіть його звичайним реченням у «Характер → Інструкція для ШІ».

## 10. Документи клієнта й «OLX Доставка»
Едуард відрізняє документ клієнта і скріншот оплати від звичайного замовлення.

1. Надішліть боту витяг з ЄДР або довідку про рахунок разом із замовленням (фото чи PDF).
2. Едуард запише назву фірми, код і юридичну адресу в картку клієнта, реквізити — нотаткою в угоду, PDF — у файли клієнта.
3. Надішліть скріншот «OLX Доставки» — ціною товару стане рядок «Вартість товару», а комісія піде окремим рядком у таблицю комісій OLX у «Фінансах».

Поля клієнта для коду й адреси задаються в групі «Документи клієнта»; якщо такого поля у вас нема, реквізити лишаться в нотатці.

## 11. Вирішити, що робити з чужими повідомленнями
Вашому боту може написати будь-хто, хто знає його ім'я. Що тоді робити — вирішуєте ви.

1. Відкрийте налаштування Едуарда → група «Бот у Telegram».
2. У полі «Коли пише не оператор» виберіть варіант.
3. Натисніть «Зберегти».

| Варіант | Що відбувається |
| --- | --- |
| як звичайному боту — у «Переписки» | повідомлення з'являється в «Переписках», менеджер відповідає звідти; зручно, коли бот один і для клієнтів, і для команди |
| відповісти, що бот лише для команди | бот надсилає текст із поля «Відповідь не оператору» |
| мовчати | бот не відповідає й нічого не зберігає |

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

1. Щоб зупинити Едуарда — «Інтеграції → ШІ» → картка «Едуард» → перемикач «Увімкнено».
2. Щоб Едуард перестав слухати саме цього бота — у вікні Едуарда блок «Бот» → «Відключити».
3. Щоб підключити іншого бота — «Змінити бота» й вставити новий токен.

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

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

## Можливі помилки
| Що бачите | Чому | Що зробити |
| --- | --- | --- |
| «Це не схоже на токен бота» | вставлено не весь рядок або зайвий текст | скопіюйте токен із повідомлення @BotFather повністю, від цифр до кінця |
| «Telegram не прийняв токен» | токен відкликано або в ньому помилка | у @BotFather надішліть `/token`, виберіть бота й вставте новий токен |
| Бот не відповідає операторові | Едуарда або картку бота вимкнено, чи людина не перейшла за запрошенням | увімкніть Едуарда, натисніть «Перевірити» в блоці «Бот», видайте «Нове посилання» |
| Бот відповідає із затримкою до пів хвилини | бот отримує повідомлення опитуванням, а не одразу | у «Інтеграції → Повідомлення → Telegram» у картці бота увімкніть вебхук |
| Кнопки під повідомленнями не реагують | вебхук бота ввімкнено давно, без подій кнопок | у вікні Едуарда «Змінити бота» → виберіть того самого бота → «Підключити бота» |
| «Це запрошення вже не діє» | посилання використано або минув його час | у рядку оператора натисніть «Нове посилання» |
| «Не обрано модель» у вікні | Едуардові не вибрано модель чи нема ключа | пігулка з моделлю в шапці вікна → компанія й модель → «Зберегти» |
| Бот каже, що файл не читає | модель не вміє читати такі файли або файл завеликий | виберіть модель, що читає зображення й PDF, або надішліть замовлення текстом |
| Замовлення зі станом «Помилка» | модель не відповіла або угода не пройшла перевірку обов'язкових полів | прочитайте причину в рядку, виправте й натисніть «Розібрати ще раз» |
| Бот просить «артикул для: …» | такого товару нема на «Складі» | допишіть артикул, додайте синонім у «Товари» або виберіть «додати позицію без товару складу» |
| «Не вдалося підготувати ТТН» або служба відмовила | в угоді бракує одержувача чи адреси або службу доставки не підключено | допишіть дані («зміни … нп київ 12») чи підключіть службу в «Інтеграції → Доставка» і натисніть «Створити ТТН» ще раз |
| «Створювати ТТН з чату вимкнено» | у налаштуваннях вимкнено дозвіл | «Замовлення → Дозволити створювати ТТН з чату» |
| «Угоди №… серед доступних вам нема» | оператор може змінювати лише свої угоди | дозвольте в «Замовлення → Які угоди оператор може змінювати» або правте угоду в CRM |
| Повідомлення оператора потрапило в «Переписки» | людина ще не оператор або Едуарда вимкнено | запросіть її на вкладці «Оператори» й увімкніть Едуарда |

## Для ШІ-співробітників
ШІ з доступом «ШІ Едуард» працює з агентом інструментами: `ai_eduard_state` (бот, оператори, показники), `ai_eduard_orders` (замовлення за станом), `ai_eduard_order` (передати замовлення текстом — Едуард створить угоду або назве, чого бракує), `ai_eduard_order_retry`, `ai_eduard_order_cancel`, `ai_eduard_try` (розбір прикладу без угоди), `ai_eduard_operators`, `ai_eduard_run_step`, `ai_eduard_lessons` (пропозиції правил), `ai_eduard_teach` (знайти правила у виправленнях). Через підтвердження людини йдуть `ai_eduard_lesson_decide` (додати правило у словник чи відхилити), `ai_eduard_operator_invite`, `ai_eduard_operator_revoke`, `ai_eduard_operator_lead`, `ai_eduard_settings_save` і `ai_eduard_enabled`. Токен бота ШІ не вводить, не бачить і не змінює — бота підключає й відключає лише людина-адміністратор. Угоди з чату ШІ не видаляє: видалення — лише команда оператора в боті з підтвердженням. Посилання-запрошення передавайте лише тій людині, для якої воно створене.

## Додаткова інформація
- Пов'язані статті: [Telegram](int-telegram.md), [ШІ-співробітники](ai-employees.md), [Угоди](deals.md), [Переписки](chats.md).