Rabotyaga
Демо

База знаний

От установки до живого чата с вашим брендом: виджет, операторы, приложения и режим с ИИ или без. Схемы ниже повторяют экраны админки.

Быстрый старт

Минимальный путь до работающего чата на сайте. Детали — в разделах ниже.

  1. Установите Ключ → install.php → админка на вашем хостинге.
  2. Создайте виджет Раздел «Чаты» → тип Виджет → оформите бренд (лого, цвета, тексты).
  3. Создайте хотя бы одного оператора Имя и аватар — так клиент видит, кто отвечает.
  4. Создайте канал и свяжите всё Привяжите виджет и операторов → получите код вставки и ключи приложений.
  5. Подключите приложения Android / Windows / iPhone / Mac — URL панели + ключ rg_op_… из канала.
  6. По желанию: провайдер ИИ и навыки — если нужен автоответчик.

Без ИИ

Живой чат: клиент пишет в виджет, операторы отвечают из админки, Telegram или приложений. На канале поставьте ИИ → Выключен.

С ИИ

Добавьте провайдера, на канале включите ИИ и выберите провайдер. Оператор в любой момент может перехватить диалог и выключить ИИ в сессии.

1. Установка

Rabotyaga ставится в отдельную папку на вашем хостинге. Файлы сайта не затрагиваются. Данные — локально (SQLite, папка rabotyaga_data рядом с установкой).

Что нужно заранее

  • Хостинг или VPS: PHP 7.4+ / 8.x, PDO + SQLite, cURL, JSON.
  • Права на запись в родительскую директорию.
  • Лицензионный ключ из кабинета (после ).
  • Домен, привязанный к ключу в кабинете.

Скачать install.php

Без активного ключа файл не отдаётся.

Ключ проверяется на сервере. Неверный или просроченный — скачивание блокируется.

  1. Создайте папку на сайте, например /rabotyaga/ (или пустой корень поддомена).
  2. Залейте install.php через FTP / файловый менеджер.
  3. Откройте https://ваш-сайт.ru/rabotyaga/install.php.
  4. Дождитесь зелёных проверок, введите ключ, логин, email и пароль админа → «Установить».
После установки откроется admin.php. Повторный запуск установщика блокируется. Обновления — раздел Система в админке.

2. Запуск без ИИ и с ИИ

Один и тот же виджет и канал работают в двух режимах. Переключать можно в любой момент.

Без ИИ — только люди

  1. Установите продукт, создайте виджет и оператора, соберите канал (см. быстрый старт).
  2. В канале → Основное → поле ИИ → Выключен.
  3. Клиент пишет в виджет; сообщение уходит операторам (админка «Сообщения», Telegram-админ-бот, приложения).
  4. Ответ оператора видит клиент в виджете с подписью из профиля оператора.

Провайдер ИИ и навыки не обязательны. Удобно для поддержки, где отвечают только менеджеры.

С ИИ — автоответ + эскалация

  1. Добавьте провайдера (свой API-ключ).
  2. В канале: ИИ → Включён, выберите провайдер по умолчанию.
  3. На чате добавьте навыки (FAQ, каталог…) или оставьте прямые ответы ИИ.
  4. Оператор может в диалоге нажать «выключить ИИ» — дальше отвечает человек.
  5. Вне рабочих часов: либо ИИ продолжает, либо форма обратной связи (настройки расписания канала).
Код виджета и ключи приложений одни и те же в обоих режимах. Разница только в настройке канала (ИИ вкл/выкл) и наличии провайдера.

3. Создание виджета и ваш бренд

Виджет — это чат типа «Виджет» в разделе Чаты. Бренд настраивается на чате; код вставки появляется после привязки чата к каналу.

Создать чат-виджет

  1. Админка → Чаты → «Добавить чат».
  2. Тип: Виджет, название (внутреннее), сохраните.
  3. Откройте чат и пройдите вкладки: Основное → Дизайн → Тексты → Контакты → Навыки.

Где менять внешний вид (вкладка «Дизайн»)

  • Основной / вторичный / цвет текста — кнопки, панели, текст в окне.
  • Ширина, высота, сторона, отступ снизу — размер окна и позиция плавающей кнопки.
  • Стиль кнопок — скруглённые / квадратные / пилюли.
  • Шрифт — Arial, Segoe UI, Helvetica, Open Sans.
  • Лого / картинка шапки (header_image_url) — логотип бренда в шапке открытого чата. Загрузите файл или укажите URL.
  • Иконка кнопки чата (button_icon_url) — своя картинка на плавающей кнопке. Если пусто — показывается логотип Rabotyaga; поставьте свой файл, чтобы убрать «чужой» бренд с кнопки.
  • Стиль главной кнопки — классика / пульс / «сигнал TV»; опция «живой бордер».
  • Звуки — отправка и получение сообщения (пресеты или свои файлы).
  • Быстрые вопросы / команды — подсказки у кнопки чата.
  • Карусель контактов — Telegram, WhatsApp и т.д. из вкладки «Контакты».
  • Доп. CSS — тонкая подстройка классов .rabotyaga-….

Где менять слова (вкладка «Тексты»)

  • Приветствие — первое сообщение бота (если у канала нет своего greeting).
  • Заголовок (chat_header_text) — текст в шапке окна, например «Поддержка Молоточки».
  • Подвал (chat_footer_text) — строка внизу. По умолчанию может стоять «Rabotyaga» или дисклеймер про ИИ — замените на свой бренд, юр. текст или «Работаем 9:00–18:00».
  • Placeholder, кнопка отправки, «Печатает…», ошибки, «ничего не найдено», пустая история — все подписи интерфейса.
Чтобы виджет выглядел как ваш продукт: загрузите лого в шапку, свою иконку на кнопку, поменяйте заголовок и подвал, цвета под сайт. Код вставки копируйте уже из канала (после привязки) — см. раздел 5.

4. Операторы

Оператор — человек, который отвечает клиенту. Подпись и аватар в виджете берутся из профиля.

  1. Раздел Операторы → создайте профиль: имя, фамилия, аватар.
  2. Пока оператор не привязан к каналу — ключей приложений ещё нет.
  3. Привязку и выдачу ключей сделаете в канале (вкладка Админ) — см. следующий раздел.

В разделе Сообщения можно отвечать из админки от имени выбранного оператора, включать/выключать ИИ в конкретном диалоге.

5. Канал: связать виджет и операторов

Канал — «релей» между клиентскими чатами, перепиской и входами операторов. Без канала виджет есть, но нет кода вставки с channel_id и нет ключей приложений.

Создать канал

  1. Каналы → «Новый канал».
  2. Вкладка Основное: название, описание, системный промпт, приветствие (greeting).
  3. ИИ: выключен (режим только люди) или включён + провайдер.
  4. По желанию: уведомление на email при старте диалога, «требует авторизацию», температура, правила оркестратора.
  5. Сохраните.

Привязать виджет

  1. Вкладка Чаты → выберите созданный виджет из списка или «Создать новый чат».
  2. В карточке чата появятся chat_key и блоки кода:
    • Плавающий виджет — скрипт перед </body>.
    • Встроенный — контейнер + скрипт внутри страницы.
  3. Скопируйте нужный вариант на сайт.

Привязать операторов → ключи приложений

  1. Вкладка Админ → отметьте операторов канала → «Сохранить».
  2. У каждого появится блок «Доступы операторов»:
    • Ключ для мобильного вида rg_op_… — его вводят в приложениях.
    • Ссылка Telegram — привязка личного Telegram к оператору (нужен админ-бот канала).
  3. Поле URL мобильного приложения оператора — обычно уже заполнено (…/operator_app/). Его же копируют в Android-приложение.
Порядок из быстрого старта: сначала чат и оператор «сами по себе», потом канал как клей — так проще не потерять код виджета и ключи приложений (они живут в карточке канала).

6. Приложения оператора: Android, Windows, iPhone, Mac

Одинаковая панель оператора на всех платформах. Скачивания и ссылки — в админке раздел Система → блок «Приложения оператора». Ключ канала — во вкладке Админ у канала (после привязки оператора).

Что понадобится везде

  • URL панели — обычно https://ваш-сайт.ru/rabotyaga/operator_app/ (то же поле в канале / в Системе).
  • Ключ оператора rg_op_… — персональный на связку «оператор + канал».

Android

  1. В Система нажмите «Скачать приложение (Android)» (APK).
  2. Установите APK на телефон.
  3. В настройках приложения укажите URL панели и вставьте ключ rg_op_….
  4. Откроется список диалогов именно этого канала.

Windows

  1. «Скачать ПК-приложение (Windows)» — файл .vbs.
  2. Запустите: на рабочем столе появится ярлык, откроется отдельное окно панели.
  3. В окне нажмите ⚙, вставьте ключ оператора (URL часто уже подставлен) → сохранить.

Альтернатива: Edge/Chrome → «Установить приложение» (PWA) с той же страницы operator_app/.

iPhone и Mac

  1. В Системе скопируйте ссылку «iPhone / Mac (браузер)» (с параметром sound=1 для звука новых сообщений).
  2. Откройте в Safari.
  3. iPhone: «Поделиться» → «На экран Домой». Mac: при желании «Добавить в Dock».
  4. Ключ оператора введите в ⚙ внутри панели.
Ключ привязан к каналу. Сменили канал или нажали «Новый ключ» — нужно обновить ключ в приложении. Не путайте лицензионный ключ RG_… (продукт) с ключом оператора rg_op_… (вход в панель).

7. Подключение провайдера ИИ

Нужно только для режима с ИИ. Ключи к моделям — ваши; Rabotyaga вызывает API по вашим настройкам.

  1. Раздел Провайдеры → «Добавить».
  2. Выберите тип (DeepSeek, YandexGPT, GigaChat и др.), укажите API-ключ (и модель / base URL при необходимости).
  3. Сохраните.
  4. В канале выберите этот провайдер как «по умолчанию» и включите ИИ.
  • Несколько провайдеров — разные каналы могут использовать разных.
  • Температуру и лимит истории переопределяют в настройках канала.

8. Канал с Telegram

Два разных бота — не смешивайте токены:

  • Клиентский бот — посетители пишут боту как в чат на сайте (чат типа Telegram).
  • Админ-бот канала — уведомления операторам и ссылки привязки в «Админ-входах».

Клиентский Telegram-чат

  1. В @BotFather создайте бота, скопируйте token.
  2. Чаты → новый чат, тип Telegram → укажите token → сохраните (ставится webhook).
  3. Привяжите чат к каналу (вкладка «Чаты» у канала).

Админ-бот

  1. Канал → Админ → «Telegram bot token (админ)» → сохранить.
  2. У операторов канала — «Ссылка Telegram» для привязки аккаунта.
Один token = один webhook. Не используйте одного бота и как клиентский чат, и как админ-уведомления.

9. Навыки

Навык — действие для ИИ: FAQ, каталог, уведомление, авторизация… Вешаются на чат, не на канал.

  1. Навыки — создайте/настройте интеграцию нужного типа.
  2. Чат → вкладка «Навыки» → добавьте из доступных.
  3. Заполните «Когда вызывать» и при необходимости «Инструкцию при первом вызове».
  4. Для чувствительных действий — «Требует авторизацию» + auth-навык.
  • На канале тоже можно включить «Требует авторизацию» на весь канал; текст «как войти» — из инструкции auth-навыка.
  • «Информирование при начале диалога» — навык типа «Уведомление» (email).

10. Что ещё полезно

  • Система — лицензия, обновления, ссылки и скачивания приложений.
  • Логи оркестратора — почему выбран навык или дан прямой ответ.
  • Клиенты (CRM) — карточки людей и привязка диалогов.
  • Тестовый период — 14 дней (кабинет / поддержка).
Контакты