🔥 TEplogradbot Теплоград CRM Бот

v1.1.0
📊 Статистика системы
Загрузка...
💬 Диалоги с клиентами
Загрузка...
💬

Выберите диалог слева

📋 Отчёты
Загрузка...
⚠️ Журнал ошибок
Загрузка...
Загрузка...
Загрузка...
📖 Инструкция по использованию TEplogradbot

🤖 Что делает бот

Telegram-бот для компании Теплоград (монтаж и обслуживание систем отопления). Бот автоматически:

  • Отвечает клиентам в Telegram с помощью AI (OpenRouter)
  • Обновляет сделки и контакты в Bitrix24
  • Отправляет follow-up если клиент не отвечает 5 мин, затем 60 мин
  • Генерирует и отправляет отчёты по расписанию
  • Уведомляет администраторов об ошибках

⚙️ Первоначальная настройка

  1. Скопируйте .env.example.env и заполните токены
  2. Создайте БД: createdb teplograd_bot
  3. Инициализируйте схему: npm run setup-db
  4. Запустите: npm start
  5. Откройте бот в Telegram и напишите любое сообщение

💬 Раздел Диалоги

  • Список всех диалогов с клиентами (обновляется каждые 30 сек)
  • Клик по диалогу — просмотр истории сообщений
  • Можно отправить сообщение вручную через поле ввода
  • Кнопка "Закрыть диалог" — переводит в статус "closed"

📋 Раздел Отчёты

  • Утренний — 09:00 ежедневно — краткая сводка по активным диалогам
  • Ежедневный — 23:59 — итоги дня
  • Еженедельный — понедельник 08:00 — итоги недели
  • Кнопка "Генерировать" — отправить отчёт прямо сейчас
  • Получатели настраиваются в разделе Настройки → "Получатели отчётов"

⚙️ Раздел Настройки

  • Системный промпт — инструкции для AI-агента (как отвечать клиентам)
  • Follow-up промпты — тексты/инструкции для автоматических напоминаний
  • Получатели отчётов — Telegram chat_id через запятую
  • Параметры ожидания — через сколько минут отправлять follow-up

🔗 Bitrix24 интеграция

  • API: https://teplograd.bitrix24.ru/rest/7594/nmaz7f20u628e0uv
  • После каждого сообщения AI определяет действие в CRM (обновить сделку / контакт)
  • Поддерживаемые операции: update_deal, update_contact, create_contact
  • Стадии сделки: C1:NEW, C1:PREPARATION, C1:EXECUTING, C1:WON, C1:LOSE

🖥️ Развёртывание на сервере

# На сервере (212.8.229.64)
cd /var/www/teplogradbot
npm install
cp .env.example .env
nano .env          # заполнить токены
npm run setup-db   # создать таблицы
pm2 start src/app.js --name teplogradbot
pm2 save
        
🔍 Диагностика подключения
Загрузка...
📨 Входящие вебхуки (последние 20)
Загрузка логов...
🧪 Тестирование