Telegram
Telegram-бот компании: клиент пишет вашему боту — переписка появляется в «Переписках», а ответ оттуда уходит тем же ботом. Каждый бот (бренд, магазин) — свой аккаунт карточки с токеном от @BotFather; подключает администратор сам, без разработчика и без настроек сервера. Заказы из Telegram, которые оформляет ИИ Эдуард, становятся сделками Helomi напрямую.
Эта статья пока на украинском. Спросите Lomi на вашем языке — она прочитает статью и ответит. Поговорить с Lomi
На этой странице
Можливості
- Бот за токеном від @BotFather; у кожного бренду може бути свій бот — окремий акаунт картки («+»).
- Повідомлення клієнтів у «Переписках» з підписом акаунта; відповідь із «Переписок» іде тим самим ботом.
- Текст, фото (до 5 МБ) і документи (до 20 МБ) — у стрічці чату, відкриваються натиском; голосові, стікери, контакт і локація — позначкою в тексті; змінене клієнтом повідомлення — окремим рядком «Змінено: …».
- Два режими отримання: «Опитування» (типово, працює одразу) і «Вебхук» (повідомлення приходять миттєво).
- Привітання, коли клієнт натискає «Почати», — один раз на чат.
- «Перевірити» показує, який бот підключено; «Отримати повідомлення зараз» — не чекати наступного кола.
- Угоди з Telegram-замовлень (ШІ Едуард) напряму в CRM: клієнт за телефоном, позиції за артикулом, доставка й післяплата, дод. поля «Адреса доставки», «Спосіб доставки», «Спосіб Оплати», «Тип оплати checkbox», реквізити клієнта («Код ЄДРПОУ», «Юридична адреса») з витягів, нотатки й файли, зміна й видалення угоди командами Едуарда («зміни N», «видали N» — у «Видалену інформацію» на 30 днів).
- Кнопка «Відкрити в CRM» під угодою в Telegram веде в картку угоди Helomi.
1Підключити бота
Бот — окремий акаунт Telegram, який створює службовий бот @BotFather; Helomi читає повідомлення бота за його токеном. Підключає адміністратор, на все — кілька хвилин.
- Відкрийте в Telegram @BotFather і надішліть команду
/newbot. - Введіть назву бота (її бачать клієнти) і ім'я для посилання — воно має закінчуватися на
bot. - Скопіюйте токен, який надішле @BotFather. Це ключ до бота: нікому його не пересилайте.
- Відкрийте Налаштування›Інтеграції й автоматизація›Повідомлення›Telegram«Налаштування → Інтеграції й автоматизація → Повідомлення → Telegram», вкладку «Підключення».
- У рядку ключа «TELEGRAM_BOT_TOKEN» натисніть «Ввести», вставте токен і натисніть «Зберегти ключ».
- Натисніть «Перевірити» — відповідь «бот @ім'я (Назва)» означає, що все гаразд; у блоці бота з'являться його ім'я й посилання.
- Напишіть боту зі свого Telegram — приблизно за пів хвилини розмова з'явиться в «Переписках».
Бот бачить лише тих, хто написав йому сам: Telegram не дає ботам писати першими. Групи й канали в «Переписки» не потрапляють.
Посилання на бота (воно є в блоці бота після «Перевірити») додайте на сайт, у підпис листів і в оголошення — так клієнти знайдуть, куди писати.
2Кілька ботів — для кожного бренду свій
Кожен бот — окремий акаунт картки зі своєю назвою, токеном, перемикачем, налаштуваннями й журналом. Розмови в «Переписках» підписані назвою акаунта, а відповідь іде саме тим ботом, що отримав повідомлення.
- Створіть нового бота в @BotFather: команда
/newbot, назва, ім'я наbot— і скопіюйте токен. - У картці «Telegram» натисніть «+» унизу праворуч.
- Вкажіть назву (наприклад, «Магазин сумок») і токен нового бота, натисніть «Додати акаунт».
- Увімкніть перемикач у шапці картки нового акаунта — акаунт створюється вимкненим і, доки вимкнений, повідомлень не отримує.
- Натисніть «Перевірити».
Основна картка «Telegram» отримує повідомлення, щойно введено токен: її перемикач відповідає за приймання замовлень ШІ Едуарда, а не за бота.
3Обрати, як отримувати повідомлення
«Опитування» — Helomi сам питає Telegram про нові повідомлення приблизно раз на пів хвилини; працює одразу, нічого налаштовувати не треба. «Вебхук» — Telegram надсилає кожне повідомлення миттєво на захищену адресу Helomi.
- Відкрийте вкладку «Підключення» картки бота, блок бота.
- Щоб повідомлення приходили миттєво, натисніть «Увімкнути вебхук» — режим стане «Вебхук».
- Щоб повернутися до опитування, натисніть «Зняти вебхук»: повідомлення, що чекали, не загубляться.
- У режимі «Опитування» кнопка «Отримати повідомлення зараз» забирає нові повідомлення одразу, не чекаючи наступного кола.
Один токен — одна програма. Якщо цим самим ботом уже користується інша програма (конструктор ботів, інша CRM), Telegram віддасть повідомлення лише одній з них, і Helomi покаже «бота вже опитує інша програма» або «у бота ввімкнено вебхук». Вимкніть іншу програму або створіть для Helomi окремого бота.
4Привітати клієнта й налаштувати бота
«Налаштування бота» — що бот робить сам і з якими налаштуваннями працюють його чати: привітання, джерело угод, відповідальний, оператори.
- Відкрийте вкладку «Підключення» картки бота → «Налаштування бота».
- У полі «Привітання» напишіть текст, який бот надішле, коли клієнт натисне «Почати». Порожньо — бот не вітається.
- У полях «Джерело угод», «Відповідальний» і «Оператори» оберіть значення зі списків.
- Натисніть «Зберегти».
Привітання бот надсилає один раз на чат; такий чат не стає «непрочитаним», доки клієнт не напише щось сам. Поле «Ім'я відправника» діє лише у Viber.
5Відповісти клієнту
Відповідь пишуть у «Переписках»: вона йде тим самим ботом, що отримав повідомлення, і з'являється в стрічці чату.
- Відкрийте «Переписки» і чат із підписом акаунта бота.
- Напишіть текст у полі внизу й натисніть «Надіслати».
- Фото й файли з відповіді клієнт отримає посиланнями в тексті.
Клієнт, який заблокував бота, відповіді не отримає — «Переписки» покажуть «клієнт заблокував бота». Написати йому можна лише в самому Telegram.
6Замовлення з Telegram в угоди (ШІ Едуард)
Едуард оформлює замовлення з Telegram, і вони стають угодами Helomi напряму — з клієнтом, товарами, доставкою й оплатою.
- Вкладка «Налаштування продажів»: «Основне» («Увімкнути інтеграцію», «Джерело угод», «Відповідальний»), «Нові замовлення» («Автоприйняття», «Зв'язувати товари по»), «Чати», «Автоматична відправка ТТН». «Пов'язаних статусів» нема. «Зберегти».
- Перемикач «Увімкнути інтеграцію» = приймання угод від Едуарда. Увімкнений — угоди, які створює Едуард, стають угодами Helomi; вимкнений — вхід відповідає Едуарду помилкою «канал Telegram вимкнено», і Едуард показує її в чаті (замовлення не губиться мовчки, менеджер бачить текст). Вибір із картки переживає перезапуск сервера.
- «Джерело угод» порожнє — джерело береться з того, що визначив Едуард (Telegram / ОЛХ / ДРОПЕРИ…); обране — ставиться всім угодам Едуарда. Дроп-замовлення (ДРОПЕРИ) потрапляють на етап «Необроблені» воронки «Дропшипери продаж».
- Зміни Едуарда видно в журналі угоди й клієнта з підписом «Едуард»; нотатки й файли — у блоках «Нотатки» і «Файли».
7Переключити Едуарда або повернути на KeepinCRM
Куди Едуард пише угоди — у Helomi чи в KeepinCRM — перемикає адміністратор сервера заявкою самовикатки; у картці цей вибір видно як перемикач «Увімкнути інтеграцію».
| Що треба | Що робить заявка |
|---|---|
| Подивитися стан | показує, куди дивиться Едуард (KeepinCRM чи Helomi), чи увімкнено канал, відповіді входу й покриття каталогу |
| Переключити на Helomi | дає Едуарду окремий токен і адресу входу Helomi, вмикає кнопку «Відкрити в CRM» і каталог, перезапускає Едуарда, вмикає канал Telegram і перевіряє |
| Каталог Едуарда з нашого складу | підказки артикулів Едуард бере з фіду Helomi «ШІ Едуард (Telegram): каталог для підказок артикулів» у Налаштування›Товари›YML генератор«Налаштування → Товари → YML генератор»: усі товари складу, і ті, яких нема в наявності, і з ціною 0, без неактуальних; Едуард читає артикул, назву і ціну й оновлює каталог кожні 10 хв |
| Повернути на KeepinCRM | повертає налаштування Едуарда як до перемикання, перезапускає його й вимикає канал Telegram |
Після переключення в KeepinCRM для Едуарда вимикати нічого не треба, але старий ключ API KeepinCRM, яким користувався Едуард, варто відкликати в кабінеті KeepinCRM.
8Сесії ШІ Люди (як було до ботів)
Організація, яка вела переписки через ШІ Люду, бачить у «Стані роботи» основної картки «Акаунти» і «Сесій на диску»: ці розмови приходять у «Переписки», як і раніше, а відповідь іде з того самого акаунта Люди. Нові сесії Люди підключає розробник; для нового каналу простіше підключити бота за токеном від @BotFather.
Можливі помилки
| Що ви бачите | Чому | Що зробити |
|---|---|---|
| «токен відхилено (401) — візьміть чинний токен у @BotFather» | Токен відкликали або скопіювали не повністю | У @BotFather → /mybots → бот → «API Token»; вставте токен заново через «Змінити» |
| «токен не підходить (404) — скопіюйте його з @BotFather повністю» | У полі не токен бота або його частина | Скопіюйте токен повністю, разом із частиною до двокрапки |
| «у бота ввімкнено вебхук — зніміть його або оберіть «Вебхук»» | Вебхук бота поставила інша програма або режим змінили не тут | Натисніть «Увімкнути вебхук» у Helomi або вимкніть вебхук в іншій програмі |
| «бота вже опитує інша програма — вимкніть її або увімкніть вебхук» | Тим самим токеном користується ще одна програма | Вимкніть її або створіть для Helomi окремого бота |
| «Telegram просить зачекати … с — спробуйте пізніше» | Забагато запитів за короткий час | Зачекайте; цикл повториться сам |
| «Telegram не відповів — спробуйте ще раз» | Збій мережі чи Telegram | Натисніть «Перевірити» ще раз; опитування повториться саме |
| «Telegram не прийняв адресу вебхука — потрібна адреса https» | Сервер Helomi без захищеної адреси | Лишіть режим «Опитування» |
| «Спершу введіть токен бота — кнопка «Ввести» в рядку ключа» | Токен не задано | «Підключення» → «Ввести» → вставте токен → «Зберегти ключ» |
| «акаунт вимкнено — увімкніть його перемикачем у шапці картки» | Акаунт бота вимкнено | Увімкніть перемикач у шапці картки акаунта |
| «клієнт заблокував бота — написати можна лише в самому Telegram» | Клієнт зупинив бота | Напишіть клієнту в Telegram з особистого акаунта |
| «чат не знайдено — клієнт має спершу написати боту» | Клієнт ще не писав цьому боту | Дочекайтеся повідомлення клієнта |
| Повідомлення не з'являються, помилок нема | Акаунт вимкнено, клієнт пише в групу, або в іншого бота | Перевірте перемикач акаунта й посилання на бота, натисніть «Отримати повідомлення зараз» |
| В Telegram від Едуарда: «канал Telegram вимкнено…» | Перемикач «Увімкнути інтеграцію» вимкнено, а Едуард уже шле сюди | Увімкніть інтеграцію в картці (або заявка адміністратора сервера «Переключити на Helomi» / «Повернути на KeepinCRM») |
| В Telegram від Едуарда: «Невірний X-Auth-Token» | Токен у налаштуваннях Едуарда не збігається з сервером | Заявка адміністратора сервера «Переключити на Helomi» (дає Едуарду актуальний токен) |
У відповіді входу ignored_fields | Едуард надіслав поле з назвою, якого в Helomi нема | Створіть поле з такою назвою в «Налаштуваннях полів» угоди чи клієнта або лишіть як є |
Для ШІ-співробітників
ШІ з доступом до «Інтеграцій» бачить стан бота інструментом messenger_state (kind картки: telegram або telegram-<slug>): чи задано токен, хто бот, режим отримання, стан вебхука, привітання й налаштування, скільки розмов без відповіді; картки всіх ботів — integrations_list, журнал — integrations_log. Токен вводить, вебхук вмикає й бота налаштовує лише людина-адміністратор — ШІ ключів не бачить і не вводить, адресу вебхука бачить без секрету. Розмови ботів ШІ бачить у «Переписках» разом з іншими каналами; відповідати в чатах ботів поки може лише людина (ШІ-продавці працюють у чатах Prom, Rozetka й OLX). Угоди з Telegram ШІ бачить у «Угодах» (deals_list, deals_get) за джерелом і за дод. полем telegram_order_id. Інші ШІ-агенти (Роман, Денис, Олександр), які шлють замовлення Едуарду на його вебхук, автоматично пишуть у Helomi разом із ним. Статтю ШІ читає інструментом help("int-telegram").
Додаткова інформація
Эту же статью читают ИИ-сотрудники Helomi: help("int-telegram")