HelomiWIKI

Telegram

Your company's Telegram bot: a client writes to your bot — the conversation appears in “Conversations”, and replies from there go out through the same bot. Each bot (brand, store) is its own account on the card, with a token from @BotFather; the administrator connects it on their own, with no developer and no server setup. Telegram orders placed by AI Eduard become Helomi deals directly.

11 minUpdated 01.11.2026
Markdown for AI

This article is in Ukrainian for now. Ask Lomi in your language — she will read the article and answer. Talk to Lomi

On this page

Можливості

  • Бот за токеном від @BotFather; у кожного бренду може бути свій бот — окремий акаунт картки («+»).
  • Повідомлення клієнтів у «Переписках» з підписом акаунта; відповідь із «Переписок» іде тим самим ботом.
  • Текст, фото (до 5 МБ) і документи (до 20 МБ) — у стрічці чату, відкриваються натиском; голосові, стікери, контакт і локація — позначкою в тексті; змінене клієнтом повідомлення — окремим рядком «Змінено: …».
  • Два режими отримання: «Опитування» (типово, працює одразу) і «Вебхук» (повідомлення приходять миттєво).
  • Привітання, коли клієнт натискає «Почати», — один раз на чат.
  • «Перевірити» показує, який бот підключено; «Отримати повідомлення зараз» — не чекати наступного кола.
  • Угоди з Telegram-замовлень (ШІ Едуард) напряму в CRM: клієнт за телефоном, позиції за артикулом, доставка й післяплата, дод. поля «Адреса доставки», «Спосіб доставки», «Спосіб Оплати», «Тип оплати checkbox», реквізити клієнта («Код ЄДРПОУ», «Юридична адреса») з витягів, нотатки й файли, зміна й видалення угоди командами Едуарда («зміни N», «видали N» — у «Видалену інформацію» на 30 днів).
  • Кнопка «Відкрити в CRM» під угодою в Telegram веде в картку угоди Helomi.

1Підключити бота

Бот — окремий акаунт Telegram, який створює службовий бот @BotFather; Helomi читає повідомлення бота за його токеном. Підключає адміністратор, на все — кілька хвилин.

  1. Відкрийте в Telegram @BotFather і надішліть команду /newbot.
  2. Введіть назву бота (її бачать клієнти) і ім'я для посилання — воно має закінчуватися на bot.
  3. Скопіюйте токен, який надішле @BotFather. Це ключ до бота: нікому його не пересилайте.
  4. Відкрийте НалаштуванняІнтеграції й автоматизаціяПовідомленняTelegram«Налаштування → Інтеграції й автоматизація → Повідомлення → Telegram», вкладку «Підключення».
  5. У рядку ключа «TELEGRAM_BOT_TOKEN» натисніть «Ввести», вставте токен і натисніть «Зберегти ключ».
  6. Натисніть «Перевірити» — відповідь «бот @ім'я (Назва)» означає, що все гаразд; у блоці бота з'являться його ім'я й посилання.
  7. Напишіть боту зі свого Telegram — приблизно за пів хвилини розмова з'явиться в «Переписках».
Примітка

Бот бачить лише тих, хто написав йому сам: Telegram не дає ботам писати першими. Групи й канали в «Переписки» не потрапляють.

Порада

Посилання на бота (воно є в блоці бота після «Перевірити») додайте на сайт, у підпис листів і в оголошення — так клієнти знайдуть, куди писати.

2Кілька ботів — для кожного бренду свій

Кожен бот — окремий акаунт картки зі своєю назвою, токеном, перемикачем, налаштуваннями й журналом. Розмови в «Переписках» підписані назвою акаунта, а відповідь іде саме тим ботом, що отримав повідомлення.

  1. Створіть нового бота в @BotFather: команда /newbot, назва, ім'я на bot — і скопіюйте токен.
  2. У картці «Telegram» натисніть «+» унизу праворуч.
  3. Вкажіть назву (наприклад, «Магазин сумок») і токен нового бота, натисніть «Додати акаунт».
  4. Увімкніть перемикач у шапці картки нового акаунта — акаунт створюється вимкненим і, доки вимкнений, повідомлень не отримує.
  5. Натисніть «Перевірити».
Примітка

Основна картка «Telegram» отримує повідомлення, щойно введено токен: її перемикач відповідає за приймання замовлень ШІ Едуарда, а не за бота.

3Обрати, як отримувати повідомлення

«Опитування» — Helomi сам питає Telegram про нові повідомлення приблизно раз на пів хвилини; працює одразу, нічого налаштовувати не треба. «Вебхук» — Telegram надсилає кожне повідомлення миттєво на захищену адресу Helomi.

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

Один токен — одна програма. Якщо цим самим ботом уже користується інша програма (конструктор ботів, інша CRM), Telegram віддасть повідомлення лише одній з них, і Helomi покаже «бота вже опитує інша програма» або «у бота ввімкнено вебхук». Вимкніть іншу програму або створіть для Helomi окремого бота.

4Привітати клієнта й налаштувати бота

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

  1. Відкрийте вкладку «Підключення» картки бота → «Налаштування бота».
  2. У полі «Привітання» напишіть текст, який бот надішле, коли клієнт натисне «Почати». Порожньо — бот не вітається.
  3. У полях «Джерело угод», «Відповідальний» і «Оператори» оберіть значення зі списків.
  4. Натисніть «Зберегти».

Привітання бот надсилає один раз на чат; такий чат не стає «непрочитаним», доки клієнт не напише щось сам. Поле «Ім'я відправника» діє лише у Viber.

5Відповісти клієнту

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

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

Клієнт, який заблокував бота, відповіді не отримає — «Переписки» покажуть «клієнт заблокував бота». Написати йому можна лише в самому Telegram.

6Замовлення з Telegram в угоди (ШІ Едуард)

Едуард оформлює замовлення з Telegram, і вони стають угодами Helomi напряму — з клієнтом, товарами, доставкою й оплатою.

  1. Вкладка «Налаштування продажів»: «Основне» («Увімкнути інтеграцію», «Джерело угод», «Відповідальний»), «Нові замовлення» («Автоприйняття», «Зв'язувати товари по»), «Чати», «Автоматична відправка ТТН». «Пов'язаних статусів» нема. «Зберегти».
  2. Перемикач «Увімкнути інтеграцію» = приймання угод від Едуарда. Увімкнений — угоди, які створює Едуард, стають угодами Helomi; вимкнений — вхід відповідає Едуарду помилкою «канал Telegram вимкнено», і Едуард показує її в чаті (замовлення не губиться мовчки, менеджер бачить текст). Вибір із картки переживає перезапуск сервера.
  3. «Джерело угод» порожнє — джерело береться з того, що визначив Едуард (Telegram / ОЛХ / ДРОПЕРИ…); обране — ставиться всім угодам Едуарда. Дроп-замовлення (ДРОПЕРИ) потрапляють на етап «Необроблені» воронки «Дропшипери продаж».
  4. Зміни Едуарда видно в журналі угоди й клієнта з підписом «Едуард»; нотатки й файли — у блоках «Нотатки» і «Файли».

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 AI employees read this same article: help("int-telegram")