HelomiWIKI

Telegram

Інтеграція з Telegram підключає акаунти брендів, через які ШІ Люда веде переписки з клієнтами, надсилає вітальні повідомлення й нагадування; розмови видно в «Переписках». Замовлення з Telegram, які оформлює ШІ Едуард, з 15.10.2026 стають угодами в Helomi напряму — через сумісний із KeepinCRM вхід, тож код Едуарда не змінювався.

6 хвОновлено 25.10.2026
Markdown для ШІ
На цій сторінці

Можливості

  • Кілька акаунтів Telegram (по одному на бренд) — переписки з клієнтами в «Переписках».
  • Перевірка, що для кожного акаунта є сесія на сервері.
  • Стан полера «Переписок» у картці.
  • Угоди з Telegram-замовлень (ШІ Едуард) напряму в CRM: клієнт за телефоном, позиції за артикулом, доставка й післяплата, дод. поля «Адреса доставки», «Спосіб доставки», «Спосіб Оплати», «Тип оплати checkbox», реквізити клієнта («Код ЄДРПОУ», «Юридична адреса») з витягів, нотатки й файли (накладні OLX, PDF витягів), зміна й видалення угоди командами Едуарда («зміни N», «видали N» — у «Видалену інформацію» на 30 днів).
  • Джерело угоди — те, що визначив Едуард (Telegram, ОЛХ, Prom, ДРОПЕРИ…: id джерел KeepinCRM збережено при імпорті); якщо в картці обрано «Джерело угод» — воно головніше. Дроп-замовлення (ДРОПЕРИ) потрапляють на етап «Необроблені» воронки «Дропшипери продаж», як і раніше.
  • Кнопка «Відкрити в CRM» під угодою в Telegram веде в картку угоди Helomi.

1Налаштування

Підключає адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Повідомлення» → картка «Telegram» → «Підключення».

  1. Рядок «Акаунти (назва:api_id:api_hash, через кому)» → «Ввести» → список акаунтів у форматі назва:api_id:api_hash, кілька — через кому → «Зберегти ключ». api_id і api_hash видає Telegram для застосунку на my.telegram.org.
  2. Для кожного акаунта на сервері має бути файл сесії (вхід у Telegram цим акаунтом).
  3. «Перевірити» дивиться, чи є сесії на диску: «сесій на диску: N» або «нема сесій: <назви>». У мережу перевірка не ходить, щоб не заважати Люді.
  4. «Стан роботи»: «Акаунти», «Сесій на диску», «Полер «Переписок»» (час останнього циклу або помилка).

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

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

3Переключити Едуарда або повернути на KeepinCRM

Що требаЗаявка / командаЩо робить

Після переключення в KeepinCRM для Едуарда вимикати нічого не треба (він писав туди лише через API і більше туди не ходить), але старий ключ API KeepinCRM, зашитий у коді Едуарда, варто відкликати в кабінеті KeepinCRM.

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

Що ви бачитеЧомуЩо зробити
«INBOX_TG_ACCOUNTS порожній»Акаунти не введеноВведіть рядок «Акаунти»
«нема сесій: …»Для акаунта нема файлу сесії на серверіСтворіть сесію (через розробника)
В Telegram від Едуарда: «канал Telegram вимкнено (CRM_INTAKE_TELEGRAM=false) — угоди Едуарда ще йдуть у KeepinCRM»Перемикач «Увімкнути інтеграцію» вимкнено, а Едуард уже шле сюдиУвімкніть інтеграцію в картці
У відповіді входу ignored_fieldsЕдуард надіслав поле з назвою, якого в Helomi немаСтворіть поле з такою назвою в «Налаштуваннях полів» угоди/клієнта або лишіть як є (KeepinCRM теж ігнорувала)
«Полер «Переписок»: помилка …»Збій отримання переписокПодивіться текст помилки, перевірте сесію

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

5). Угоди з Telegram ШІ бачить у «Угодах» (deals_list, deals_get) за джерелом і за дод. полем telegram_order_id. Інші ШІ-агенти (Роман, Денис, Олександр), які шлють замовлення Едуарду на його вебхук, автоматично пишуть у Helomi разом із ним. Статтю ШІ читає інструментом help("int-telegram")`.

Додаткова інформація

Цю саму статтю читають ШІ-співробітники Helomi: help("int-telegram")