🤖

CRM AI Consultant

Версія 3.8 • Документація

Універсальна система AI-чату з підтримкою кількох каналів і повним індивідуальним налаштуванням для кожного сайту.

Зміст

1. Вступ ★ Що нового в v3.8 2. Структура проєкту 3. Встановлення 4. Як використовувати 5. Управління сайтами 6. Канали зв'язку 7. Дизайн чату 8. API ключі 9. Вирішення проблем

1. Вступ

CRM AI Consultant — це універсальна система двостороннього AI-чату, яка дозволяє підключати розумний віджет на будь-який сайт (WordPress, Tilda, чисті HTML, Laravel тощо).

Кожен сайт має повністю індивідуальні налаштування: дизайн чату, канал зв'язку, модель штучного інтелекту, API ключі та власну історію спілкування.

Підтримувані канали: Telegram, OpenAI (GPT), Grok (xAI), WhatsApp, Viber

НОВЕ Що нового в версії 4.1

⚡ Промпт зберігається у файл — відповіді AI стали значно швидшими
Кешування налаштувань сайту — менше запитів до бази даних
Додаткова відправка в Telegram — навіть при роботі через Grok або OpenAI
Оптимізовані канали Grok та OpenAI — зменшений час відповіді
Покращена структура зберігання промптів — основний промпт у полі system_prompt
Новий чекбокс «Надсилати також у Telegram» у налаштуваннях сайту
Стабільність і безпека — покращена обробка помилок і кешування
Загальна оптимізація швидкості роботи чату

Тепер бот відповідає помітно швидше, особливо при використанні Grok та OpenAI.

НОВЕ Що нового в версії 3.8

Єдиний потужний системний промпт для кожного сайту (замість кількох полів)
Покращена підтримка Grok — сильніший контроль над поведінкою AI
Новий сучасний дизайн адмін-панелі (світліша шапка, футер і карточки)
Вибір іконок бота через зручне модальне вікно
Міні-іконки каналу та моделі в карточках сайтів
Кольорові кнопки в карточках (Редагувати — голуба, Історія — сіра, Видалити — червона)
Покращена адаптивність на всіх пристроях
Відновлена і стабільна перевірка коду на сайті
Загальна оптимізація швидкості та зручності інтерфейсу

Переглянути Changelog (Що нового)

2. Структура проєкту

crm-ai-consultant/
├── index.php                 ← Головний файл віджету (віддає JS-конфіг + обробляє всі AJAX-запити)
├── config.php                ← Основні налаштування системи (паролі, шляхи, константи)
├── version.php               ← Версія проєкту (використовується в шапці)
├── documentation.html        ← Ця документація
├── crm-ai-error.log          ← Лог помилок (створюється автоматично)
│
├── admin/
│   ├── index.php             ← Головна сторінка адмін-панелі (список всіх сайтів)
│   ├── sites.php             ← Повні налаштування одного сайту (основний файл)
│   ├── conversations.php     ← Перегляд історії чатів усіх сайтів
│   ├── navigation.php        ← Шапка адмін-панелі
│   ├── footer.php            ← Футер адмін-панелі
│   ├── login.php             ← Сторінка входу в адмінку
│   ├── icon.php              ← Модальне вікно вибору іконок бота
│   ├── settings_general.php  ← Загальні налаштування сайту (промпт, назва, статус)
│   ├── settings_telegram.php ← Налаштування каналу Telegram
│   ├── settings_grok.php     ← Налаштування каналу Grok (xAI)
│   ├── settings_openai.php   ← Налаштування каналу OpenAI
│   ├── settings_whatsapp.php ← Налаштування каналу WhatsApp
│   ├── settings_viber.php    ← Налаштування каналу Viber
│   ├── admin.js              ← JavaScript для адмін-панелі
│   └── admin.css             ← Додаткові стилі для адмін-панелі
│
├── sites/                    ← Папка з індивідуальними налаштуваннями кожного сайту (site_id.json)
├── conversations/            ← Папка з історією всіх розмов (JSON-файли)
│
├── channels/
│   ├── telegram.php          ← Обробник повідомлень через Telegram
│   ├── openai.php            ← Обробник через OpenAI (GPT)
│   ├── grok.php              ← Обробник через Grok (xAI)
│   ├── whatsapp.php          ← Обробник через WhatsApp
│   └── viber.php             ← Обробник через Viber
│
├── assets/
│   ├── chat.js               ← Головний скрипт чату (віджет, який показується на сайті)
│   └── style.css             ← Стилі віджету чату
│
└── includes/
    ├── functions.php         ← Основні функції (збереження повідомлень, обробка каналів)
    ├── get-messages.php      ← AJAX: отримання повідомлень
    └── get-conversation.php  ← AJAX: отримання повної історії розмови

3. Встановлення

Завантажте всі файли в папку /ai/crm/ на сервері
Створіть папки sites/ та conversations/
Налаштуйте права на запис: 755 для папок, 644 для файлів
Зайдіть в адмін-панель: https://bilohash.com/ai/crm/admin/
Увійдіть за паролем 12345 (обов'язково змініть його!)

4. Як використовувати

1. Додайте новий сайт у адмін-панелі

2. Заповніть налаштування (особливо системний промпт!)

3. Скопіюйте згенерований код

4. Вставте його на свій сайт перед тегом </body>

5. Натисніть кнопку «Перевірити» в адмінці

5. Управління сайтами

Кожен сайт має свій унікальний site_id, який генерується автоматично з домену.
Приклад: mapsme_no, bilohash_com

6. Канали зв'язку

Найшвидший і найстабільніший канал. Повідомлення приходять у ваш Telegram.

OpenAI / Grok

Автоматичні відповіді через штучний інтелект.

Підтримка бізнес-API (в розробці).

Viber

Підтримка бізнес-API (в розробці).

7. Дизайн чату

Кожен сайт може мати повністю індивідуальний дизайн: кольори, іконка бота, заголовок, підзаголовок, позиція віджету (ліворуч/праворуч), текст привітання та авто-відкриття.

8. API ключі

Telegram — Bot Token + Chat ID
OpenAI — API Key (отримати)
Grok (xAI) — API Key (отримати)

9. Вирішення проблем

Білий екран

Перевірте файл crm-ai-error.log у папці /ai/

Чат не з’являється

Переконайтеся, що скрипт вставлений перед </body> і site_id правильний.

Помилка "Помилка зв'язку"

Перевірте, чи правильно налаштований канал і API ключі.