MAX Chat Widget для Битрикс / Битрикс24
=========================================
Версия: 1.1.0
Сайт:   https://maxchatpro.ru
Email:  support@maxchatpro.ru


КАК ЭТО РАБОТАЕТ
────────────────
На сайте появляется плавающая кнопка (справа внизу) с пульсацией и
индикатором онлайн. Через 3 секунды — tooltip с приветствием. Клик
открывает чат с вашим MAX-ботом в приложении MAX или в браузере.

Клиенты пишут вашему боту → вы отвечаете в MAX — никакой отдельной
административной панели не требуется.


УСТАНОВКА (2 минуты)
─────────────────────
1. Создайте MAX-бота
   → зайдите на https://dev.max.ru
   → зарегистрируйтесь (нужен аккаунт ИП/юрлица, резидент РФ)
   → создайте бота, дождитесь модерации
   → скопируйте ник бота (например: id7804551064_bot)

2. Отредактируйте widget.html
   → откройте widget.html в текстовом редакторе
   → найдите строку:
        bot_username: 'YOUR_BOT_USERNAME',
     замените YOUR_BOT_USERNAME на ник вашего бота
   → при желании поменяйте цвет (color), текст и т.д.

3. Вставьте виджет на сайт — выберите способ:

   ВАРИАНТ A. В шаблон сайта (рекомендуется — работает на всех страницах)
   ─────────────────────────────────────────────────────────────────────
   → Битрикс Админка → Настройки → Сайт → Шаблоны сайтов
   → выберите ваш активный шаблон → footer.php (или соответствующий)
   → перед закрывающим </body> вставьте содержимое widget.html
   → сохраните

   ВАРИАНТ B. На отдельной странице через HTML-блок
   ────────────────────────────────────────────────
   → откройте страницу в редакторе Битрикс
   → перейдите в режим редактирования кода (вкладка «Код» или
     компонент «Включаемая область» / html-блок)
   → вставьте содержимое widget.html
   → сохраните

   ВАРИАНТ C. Через включаемую область footer.include.php
   ──────────────────────────────────────────────────────
   → откройте файл /bitrix/templates/{ваш_шаблон}/include_areas/footer.php
     (или создайте новый)
   → вставьте содержимое widget.html


НАСТРОЙКИ (в начале widget.html)
────────────────────────────────
  bot_username   — ник MAX-бота (без @), обязательно
  color          — цвет кнопки (HEX: #0077FF, #E1232D, и т.д.)
  position       — bottom-right | bottom-left | top-right | top-left
  welcome_text   — текст в tooltip
  button_text    — надпись на CTA-кнопке
  bot_name       — подпись над текстом tooltip
  show_on_mobile — показывать ли на мобильных (true/false)
  tooltip_delay  — автопоказ tooltip через мс (0 = не показывать)


СОВМЕСТИМОСТЬ
─────────────
Виджет работает со всеми редакциями «1С-Битрикс: Управление сайтом»
(Старт, Стандарт, Малый бизнес, Бизнес), с Битрикс24 облачным и
коробочным. Поддерживает любой шаблон сайта.

Конфликтов с JS-библиотеками Битрикс нет — все идентификаторы
и классы виджета начинаются с префикса mcw- и изолированы от
других элементов страницы.


АЛЬТЕРНАТИВА: ОТКРЫТЫЕ ЛИНИИ БИТРИКС24
──────────────────────────────────────
Если хотите получать сообщения MAX прямо в чат «Открытых линий»
Битрикс24 — смотрите файл openline-guide.md с инструкцией.


ПОДДЕРЖКА
─────────
support@maxchatpro.ru
https://maxchatpro.ru/support/
