Дашборд
Загальний стан вашого AI-адміністратора в особистих повідомленнях.
Діалоги
Усі особисті переписки. Ви можете підхопити будь-який діалог вручну — бот одразу замовкне.
Ліди
Клієнти, яких бот довів до готовності й передав менеджеру.
| Дата | Клієнт | Канал | Запит | Бюджет | Готовність | Статус |
|---|
Пісочниця
Перевірте, як бот веде діалог, ще до підключення каналів. Реальні повідомлення нікому не надсилаються.
Персона адміна
Ким бот себе представляє. Клієнт має бути впевнений, що пише живій людині — вам.
Сценарій продажу
Що бот продає, за якими цінами і як веде клієнта до закриття.
Передача менеджеру
Коли бот зупиняється і кличе живу людину.
@userinfobot. Туди прилітатиме картка ліда.Поведінка
Затримки, робочі години і памʼять — щоб переписка виглядала людською.
Telegram
Бот відповідає у ваших особистих переписках через Telegram Business — від вашого імені, з вашого акаунта.
Відкрийте налаштування Telegram
Telegram → Налаштування → Telegram Business → Чат-боти.
Додайте нашого бота
Введіть цей username:
Дозвольте читати і надсилати повідомлення
Без дозволу на надсилання бот бачитиме переписку, але не зможе відповідати.
Готово
Статус угорі стане зеленим протягом кількох секунд. Далі напишіть собі з іншого акаунта — має прийти відповідь від вашого імені.
Створіть бота
У Telegram відкрийте @BotFather → /newbot → придумайте імʼя і username. Скопіюйте токен і вставте у поле вище.
Увімкніть Business-режим бота
У @BotFather: /mybots → ваш бот → Bot Settings → Business Mode → Turn on.
Підключіть бота до свого акаунта
Telegram → Налаштування → Telegram Business → Чат-боти → введіть username вашого бота → дозвольте читати і надсилати повідомлення.
Готово
Натисніть «Перевірити зʼєднання». Тепер будь-хто, хто напише вам у ЛС, отримає відповідь від вашого імені.
Бот відповідає в Instagram Direct вашого бізнес-акаунта — повідомлення виглядають як ваші власні.
Бізнес-акаунт
Instagram → Налаштування → Тип акаунта → Професійний / Бізнес. У «Повідомленнях» увімкніть Дозволити доступ до повідомлень.
Створіть застосунок Meta
developers.facebook.com/apps → Create App → тип Business → додайте продукт Instagram → API setup with Instagram login.
Токен
У розділі Instagram → Generate access token, оберіть свій акаунт, дозволи: instagram_business_basic, instagram_business_manage_messages. Токен вставте вище.
Вебхук
Instagram → Configure webhooks. Callback URL і Verify token візьміть з полів вище. Підпишіться на поле messages.
Перевірка
Натисніть «Перевірити зʼєднання» — має показати ваш @нікнейм. Потім напишіть у Direct з іншого акаунта.
AI-модель
Мозок бота. Підійде будь-який провайдер із OpenAI-сумісним API.
База даних
Усі налаштування, діалоги, ліди й події зберігаються в Supabase. На диску сервера дані не лежать взагалі.
Той самий файл лежить у проекті:
db/tginst-schema.sql — перезаписується при кожному старті, тож завжди відповідає версії застосунку.tginst_, тому вони не перетинаються з таблицями попереднього проекту (clients, memory, analytics_events) у тій самій базі.main, наявний адміністратор стане власником сервісу. Повторний запуск безпечний.Той самий файл:
db/migrate-tenants.sql.Візьміть ключ
Supabase → Project Settings → API → розділ Project API keys → service_role (кнопка «Reveal»).
Додайте у змінні оточення хостингу
SUPABASE_URL=https://ksrugoksvcdfueveeqpl.supabase.co SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOi...
Перезапустіть застосунок
Далі натисніть «Перевірити підключення» — має зʼявитися зелений статус.
service_role обходить усі політики безпеки. Тримайте його лише у змінних оточення сервера — ніколи у фронтенді, репозиторії чи публічних файлах.| Таблиця | Що всередині |
|---|---|
tginst_settings | Усі налаштування панелі: персона, сценарій, ціни, пороги передачі, токени каналів, ключ AI. По рядку на розділ. |
tginst_users | Адміністратори панелі та хеші паролів (scrypt). |
tginst_dialogs | Діалоги з клієнтами: канал, етап воронки, оцінка готовності, статус, уся переписка. |
tginst_leads | Клієнти, передані менеджеру: запит, бюджет, контакт, готовність, статус обробки. |
tginst_events | Журнал: підключення каналів, передачі менеджеру, помилки. |
Бізнеси
Кожен профіль — окремий клієнт: свій бот, свій сценарій, свої діалоги й ліди. Дані профілів ніде не перетинаються.
Інструкція
Як налаштувати бота під свій бізнес — від опису послуг до першого ліда.
Імʼя і роль
Ставте реальні — так, ніби відповідає ваш адміністратор. Клієнт має вірити, що спілкується з людиною.
Тон
Як саме розмовляти: «тепло, спокійно, без складних термінів» або «коротко й по ділу». Це помітно змінює відповіді.
Про бізнес
Чим займаєтесь, для кого, що вирізняє. Пишіть фактами, без реклами — це основа знань бота.
Що продаємо
Опис послуги: що входить, як проходить, який результат отримує клієнт.
Ціни та умови
Впишіть реальний прайс.
Часті питання
Те, що питають щодня. Чим більше заповните — тим менше бот імпровізує.
Заборонено
Чого бот не має робити ніколи. Наприклад: не ставити діагноз заочно, не обіцяти точну ціну без огляду.
Попишіть боту як клієнт
Задавайте ті питання, які ставлять справжні клієнти: «скільки коштує», «а це боляче», «коли можна прийти».
Дивіться на готовність
Знизу видно етап розмови й оцінку готовності клієнта. Коли вона дійде до порогу — зʼявиться повідомлення, що тут спрацювала б передача вам, і з якої причини.
Правте й повторюйте
Не сподобалась відповідь — доповніть «Сценарій продажу» або «Заборонено», натисніть «Очистити» і спробуйте знову.
Створіть бота
У Telegram відкрийте @BotFather → /newbot → придумайте імʼя. Отриманий токен вставте в розділі «Telegram».
Увімкніть Business-режим
@BotFather → /mybots → ваш бот → Bot Settings → Business Mode → Turn on.
Підключіть до свого акаунта
Telegram → Налаштування → Telegram Business → Чат-боти → введіть username бота → дозвольте читати і надсилати повідомлення.
Перевірте
Кнопка «Перевірити зʼєднання» в розділі «Telegram». Далі напишіть собі з іншого акаунта — має прийти відповідь.
Бізнес-акаунт
Instagram → Налаштування → Тип акаунта → Професійний. У «Повідомленнях» увімкніть доступ до повідомлень.
Решта — технічна частина
Створення застосунку Meta, токен і вебхук. Якщо застрягли — попросіть допомогти того, хто вам налаштовував сервіс: це разова дія на 10 хвилин.
Куди слати картку клієнта
Напишіть у Telegram боту @userinfobot — він одразу пришле ваш ID. Вставте його в поле «Chat ID менеджера».
Напишіть своєму боту /start
Обовʼязково: без цього Telegram не дозволить боту писати вам першим.
Перевірте
Кнопка «Тестове сповіщення» — має прийти повідомлення в Telegram.
Виставте поріг готовності
70-75 — збалансовано. Нижче 60 бот передаватиме занадто рано, вище 85 — перетримуватиме клієнта.
Дашборд
Скільки діалогів, скільки клієнтів передано, середня готовність, помилки.
Діалоги
Уся переписка. Написали самі — бот одразу замовкає і не заважає. Повернути йому керування: кнопка «Віддати боту».
Ліди
Черга клієнтів, готових до розмови. Ставте статуси «в роботі / закрито / втрачено», вивантажуйте в CSV.
Пісочниця
Повертайтесь сюди щоразу, коли міняєте ціни або сценарій — перевірити, що бот усе зрозумів правильно.
Бот мовчить у Telegram
Перевірте в розділі «Telegram»: канал увімкнено, токен збережено, Business Mode у BotFather увімкнено, бот доданий у налаштуваннях Telegram Business. Потім натисніть «Перевірити зʼєднання».
Бот мовчить в Instagram
Найчастіше — не підтверджений вебхук або токен без дозволу на повідомлення. Натисніть «Перевірити зʼєднання», текст помилки зʼявиться прямо там.
Відповіді надто «ботівські»
У полі «Тон» додайте «дуже коротко, як у месенджері», заповніть «Заборонено» і додайте більше живих формулювань у «Часті питання».
Бот передає занадто рано або пізно
Розділ «Передача менеджеру» — підніміть або опустіть «Поріг готовності» на 5-10 і перевірте в Пісочниці.
Бот називає неправильні ціни
Значить, їх немає в полі «Ціни та умови» або вони там нечіткі. Випишіть прайс рядками — бот користується тільки ним.
На дашборді помилки
Якщо там червоні записи, яких ви не розумієте — надішліть скріншот тому, хто налаштовував сервіс. Це технічна частина, вам її чіпати не треба.
Підключення клієнтів
Один ваш бот обслуговує всіх клієнтів. Клієнт нічого не створює — просто додає цього бота у свій Telegram Business, і його переписки починають вестись автоматично.
@BotFather, увімкніть йому Business Mode — і більше до цього не повертайтесь.Хостинг і запуск
Технічна частина сервісу. Клієнти цього розділу не бачать.
Файли
Закиньте app.js і теку db/ у кореневу папку застосунку.
Точка входу
У панелі хостингу (cPanel «Setup Node.js App», Railway, Render, VPS) вкажіть стартовий файл app.js:
node app.js
Змінні оточення
SUPABASE_URL=https://ksrugoksvcdfueveeqpl.supabase.co SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOi... PORT=3000 PUBLIC_URL=https://qw1-cloud.site SESSION_SECRET=довгий-випадковий-рядок ADMIN_LOGIN=Admin ADMIN_PASSWORD=ваш-надійний-пароль
SESSION_SECRET задавайте обовʼязково. Без нього він генерується заново при кожному старті — і всі, хто був у панелі, вилітають після перезапуску.ADMIN_LOGIN / ADMIN_PASSWORD потрібні лише для найпершого запуску. Далі користувачі живуть у базі, і ці рядки можна прибрати.Перевірка
Відкрийте / — має зʼявитися вікно входу. Технічна перевірка без авторизації: /health.
app.js обслуговує всіх клієнтів одночасно.Профіль = клієнт
Свій бот-токен, персона, сценарій, поріг передачі, діалоги й ліди. Дані профілів не перетинаються ніде.
Telegram
У кожного профілю власний цикл отримання оновлень і власна адреса вебхука: /webhook/telegram/<профіль>. Різні боти не заважають один одному.
Адреса вебхука одна на всіх: /webhook/instagram. Події розкладаються по профілях за ID Instagram-акаунта, який ви підтверджуєте кнопкою «Перевірити зʼєднання». Один акаунт не можна підключити до двох профілів.
AI-ключ
Задається в розділі «AI-модель» і копіюється в кожен новий профіль автоматично. Клієнти цього розділу не бачать і ключ змінити не можуть.
| Роль | Що бачить |
|---|---|
| Власник сервісу | Усі профілі, створення бізнесів, AI-модель, база даних, цей розділ, користувачі |
| Адміністратор профілю | Свої профілі повністю: сценарій, канали, токени каналів, діалоги, ліди. Це роль для клієнта |
| Менеджер | Тільки діалоги, ліди й пісочницю свого профілю. Токенів не бачить узагалі |
Створіть профіль
Розділ «Бізнеси» → назва, ідентифікатор, ніша. Пресет ніші одразу заповнить сценарій, тон і слова-тригери.
Впишіть реальний прайс
У пресетах ціни — заглушки виду 000 грн. Без реальних цифр бот не називатиме вартість.
Перевірте в Пісочниці
Переконайтесь, що діалог доходить до передачі менеджеру.
Видайте доступ
Розділ «Доступ» → створити користувача з роллю «Адміністратор профілю» і позначити цей бізнес. Пароль показується один раз.
Доступ
Ваш пароль і користувачі панелі. Усе зберігається в таблиці tginst_users.
Адміністратор профілю — клієнт-власник бізнесу: повний доступ, але тільки до своїх профілів.
Менеджер — лише діалоги, ліди й пісочниця свого профілю. Не бачить жодного токена.
| Логін | Роль | Профілі | Примітка | Дії |
|---|