База знаний Rabotyaga CRM

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

От ключа до заказов из магазина в воронке и чата на сайте.

1. Установите CRM Ключ RCRM_… → install.php → MySQL → панель на хостинге.
2. Воронка Этапы под ваш процесс: новая → в работе → выиграна / проиграна.
3. Импорт из CMS OpenCart — модуль экспорта; другие CMS — бесплатный файл обмена. Формат — CSV заказов.
4. Задание по URL / cron CRM забирает CSV, создаёт сделки с позициями и клиентами.
5. Виджет на сайт Чат + ИИ + операторы — код вставки из канала.
6. По желанию: каталог, товары CSV, провайдер ИИ.

Установка

Отдельная папка на PHP-хостинге. Сайт магазина не трогается. Основная база CRM — MySQL / MariaDB. Рядом создаётся каталог данных rabotyaga_crm_data (конфиг БД, аналитика SQLite, логи).

Требования

• PHP 7.4+ / 8.x, расширения: PDO + MySQL (pdo_mysql), PDO + SQLite (для аналитики), cURL, JSON.
• Пустая база MySQL (или MariaDB) и пользователь с правами на неё — хост, имя БД, логин, пароль. Обычно создаётся в панели хостинга (phpMyAdmin / «Базы MySQL»).
• Для раздела Почта — расширение PHP imap (см. ниже).
• Права на запись в родительскую директорию (для rabotyaga_crm_data).
• Лицензионный ключ (после входа).
• Домен CRM, привязанный к ключу в кабинете (тот же хост, что в браузере при установке, без www и без https://).
• Для больших CSV на shared-хостинге: max_execution_time 300–600 сек.

Скачать install.php

1. Папка, например /rabotyagacrm/ на том же или отдельном домене.
2. Залейте install.php, откройте в браузере.
3. Зелёные проверки → ключ, логин/пароль администратора CRM и параметры MySQL (хост, порт, база, пользователь, пароль) → «Установить».
4. Установщик создаст таблицы в MySQL, сохранит rabotyaga_crm_data/db.config.json и откроет admin.php. Повторный запуск установщика блокируется.
5. Обновления — раздел Система в панели.

MySQL при установке

• Создайте пустую базу заранее — таблицы создаст установщик.
• Хост чаще всего 127.0.0.1 или localhost; на части хостингов — отдельный hostname из панели (смотрите подсказку у MySQL).
• Порт по умолчанию 3306, если провайдер не указал иначе.
• Пользователь БД должен иметь права CREATE, ALTER, INSERT, UPDATE, DELETE, SELECT, INDEX на эту базу.
• Аналитика сайта хранится отдельно в SQLite-файле analytics.db внутри rabotyaga_crm_data — для неё нужен pdo_sqlite.
• Если установка уже прошла, править доступ к MySQL можно только через файл db.config.json (раздел «База данных» в панели убран).

Воронка сделок

Канбан по этапам воронки. Одна сделка — один заказ из магазина (или созданная вручную).

Настройка этапов

1. Раздел Воронка → вкладка настроек этапов (или «Воронки»).
2. Задайте порядок, названия, финальные флаги выиграна / проиграна.
3. При импорте колонка stage в CSV сопоставляется с этапом (маппинг в профиле импорта).

Работа со сделками

• Перетаскивание между колонками, фильтры по сумме, дате изменения и дате заказа (order_created_at).
• Карточка: позиции, сумма, закуп, прибыль, клиент, компания, доставка, оплата, задачи.
• Печать / выгрузка бланка сделки.
• Список и превью сделок в колонках канбана.

CMS и импорт заказов

Обмен заказами бесплатный. CRM принимает CSV по спецификации Rabotyaga (см. CSV заказов).

OpenCart

• Модуль экспорта заказов в CSV: позиции, subtotal, доставка, скидка, способы оплаты и доставки, order_created_at.
• Feed товаров/клиентов/заказов: index.php?route=feed/rabotyaga_crm (см. CSV товаров).
• URL выгрузки указывается в задании импорта CRM.

Другие CMS

1С-Битрикс, WooCommerce, MODX, самопис — напишите в поддержку домен и CMS: сделаем бесплатный файл обмена под ваш магазин в том же формате CSV.

Профиль импорта в CRM

1. Раздел Импорт → профиль «Заказы / сделки CSV».
2. Превью — проверка заголовков и первых строк, привязка колонок к полям.
3. Маппинг этапов — значения статуса заказа из CMS → этапы воронки.
4. Маппинг доставки и оплаты — текст из shipping_method / payment_method → справочники CRM.
5. Типы цен — колонки item_price, order_shipping, order_discount и др. → правила ценообразования.
6. system_code — код вашей системы (например shop_ocext), если не задан в CSV.

Режимы синхронизации

• all — полная синхронизация: новые создаются, существующие по order_external_id обновляются.
• new_only — только заказы, которых ещё нет в CRM.
• by_stages — обновлять только сделки на выбранных этапах воронки.

Спецификация CSV: заказы и сделки

Формат совпадает с кнопкой «Спецификация» в импорте сделок в панели CRM. Шаблон можно скачать там же.

Пример строк

title;amount;currency;stage;client_email;client_phone;client_name;customer_external_id;company;notes;source;order_external_id;system_code;source_label;order_created_at;order_subtotal;order_shipping;order_discount;shipping_method;payment_method;item_name;item_sku;item_qty;item_price;item_cost;item_total;product_external_id
Заказ #101;15500;RUB;Новая;ivan@example.com;+79001112233;Иван Иванов;42;ООО Ромашка;;сайт;101;shop_ocext;Магазин;2026-01-01 12:30:00;15000;800;-300;Курьер;Карта;Ноутбук;NB-1;1;12000;9000;12000;55
Заказ #101;15500;RUB;Новая;ivan@example.com;+79001112233;Иван Иванов;42;ООО Ромашка;;сайт;101;shop_ocext;Магазин;2026-01-01 12:30:00;15000;800;-300;Курьер;Карта;Мышь;MS-2;1;3000;1800;3000;56

Правила файла

• Кодировка UTF-8 (BOM допускается). Разделитель по умолчанию ;; в превью можно указать , или tab.
• Обязательно поле title (или синоним из списка). Остальные — по необходимости.
• Поля заказа (amount, order_subtotal, order_shipping …) дублируются в каждой строке позиции с тем же order_external_id.
• order_created_at — для фильтра «по дате заказа» в воронке, не путать с датой импорта.
• Отрицательная скидка в order_discount или положительная — как отдаёт ваша CMS; в CRM попадает в правило «Скидка» на заказ.

Спецификация CSV: клиенты

Импорт и обновление клиентов по customer_external_id + system_code.

Адреса (до 3 в строке)

Для каждого блока address1 … address3 — колонки:

• addressN_postal_code, addressN_country, addressN_region, addressN_city, addressN_metro, addressN_street, addressN_full

Достаточно заполнить addressN_full одной строкой или разбить на части.

Upsert

• Если указан customer_external_id — обновление существующего клиента с тем же system_code.
• Иначе поиск по email / телефону; при отсутствии — создание.
• Нужно хотя бы одно из: ФИО (name или части), email, phone.

Спецификация CSV: товары

Каталог CRM. Совместимо с экспортом OpenCart feed/rabotyaga_crm.

OpenCart feed

• Товары: index.php?route=feed/rabotyaga_crm
• Клиенты: …&type=customers
• Заказы: …&type=orders (тот же формат, что CSV сделок)

Характеристики

Колонка attributes: Группа, Имя---значение|Группа2, Имя2---значение2. Производитель — отдельная колонка manufacturer.

Цены

• price — базовая; price_special — скидочная (в превью привяжите к правилу «Скидочная»).
• cost — закуп для расчёта прибыли в сделках.

Клиенты, компании и сделки

Клиенты

• Контакты: ФИО, email, до двух телефонов с комментариями, несколько адресов.
• Теги, день рождения, согласия на рассылки, заметки.
• Связь с диалогами виджета (client_id в сессиях чата).
• Импорт — CSV клиентов или из заказов при импорте сделок.

Компании

• Юрлица и ИП: ИНН, КПП, ОГРН, адреса, банковские реквизиты.
• Привязка контактов-клиентов к компании.
• Подсказки DaData при заполнении (если настроена интеграция).

Сделки

• Позиции из каталога или «свободные» строки из CSV.
• Сумма, закуп, прибыль по сделке и по строкам.
• Доставка, оплата, типы цен на заказ и позиции.
• Лента активности, задачи, печать бланка.

Каталог товаров

• SKU, базовая / скидочная / закупочная цена, валюта, остаток.
• Категории (дерево), производитель, характеристики, описание, фото, ссылка на сайт.
• Импорт: CSV или YML (задание cron import_yml).
• В сделке позиция связывается с товаром по product_external_id или SKU — подтягивается закуп и название.
• Типы цен (OpenCart, скидка, доставка…) настраиваются в разделе каталога и используются при импорте заказов.

Доставка и оплата

Справочники способов доставки и оплаты. Строки в карточке сделки.

1. Раздел Доставка / Оплата — создайте способы (название, код, активность).
2. В профиле импорта заказов — маппинг: текст из CMS → ID способа в CRM.
3. При импорте CSV поля shipping_method и payment_method проходят через маппинг; при auto_create_* новые значения добавляются в справочник автоматически.
4. Стоимость доставки в сделке — из order_shipping (правило цены на заказ).

Задачи

• Задачи по сделкам, клиентам, товарам — группы, статусы, сроки.
• Комментарии и история изменений.
• Напоминания и уведомления (Telegram/email через интеграции).
• Отображение в карточке сделки и в общем разделе задач.

Аналитика сайта (JS-трекер)

Раздел Аналитика собирает сессии посетителей с вашего сайта: просмотры страниц, Yandex Client ID (_ym_uid), gclid, yclid, UTM и поведение. Без серверной защиты Talosion — только то, что даёт JS-трекер.

Установка трекера

1. В CRM: Настройки → Аналитика сайта — включите сбор и сохраните.
2. Скопируйте код вида:
   <script src="…/assets/tracker.js" data-endpoint="…/api/analytics/track.php" defer></script>
3. Вставьте перед </body> на всех страницах сайта.
4. На сайте должна быть установлена Яндекс.Метрика (cookie _ym_uid) — иначе Client ID не определится.

Раздел «Аналитика сессий»

Список визитов, фильтры по дате и поиск по IP / Client ID. В карточке сессии — история страниц и кнопка Создать клиента (подставляются ID и привязка визитов).

Защита от скликивания

Правила срабатывают в JS-трекере (частые визиты, мгновенные отказники и др.). Подозрительные Yandex Client ID попадают в очередь — для ручной проверки или выгрузки в Метрику.

Карточка клиента

В блоке «Аналитика сайта» можно вручную указать Yandex Client ID, gclid, yclid и смотреть историю посещений.

Почта (IMAP)

Раздел Почта в панели CRM забирает входящие с корпоративного ящика (Яндекс, Mail.ru и др.), привязывает письма к клиентам и по правилам может создавать задачи. Синхронизация идёт вручную и по cron вместе с автоматизацией.

Требование: PHP IMAP

На сервере должна быть функция imap_open(). Без неё в панели будет предупреждение, синк не заработает.

Проверка по SSH:

php -m | grep imap
php -r "echo function_exists('imap_open') ? 'OK' : 'NO';"

Debian / Ubuntu (PHP 8.1 native, ISPmanager)

apt update
apt install -y php8.1-imap
systemctl restart php8.1-fpm
systemctl restart nginx

Если сайт на Apache: systemctl restart apache2. Нужен тот же PHP, что обрабатывает сайт (проверьте через phpinfo() в браузере).

CentOS / AlmaLinux

dnf install php-imap
systemctl restart php-fpm

Подключение ящика

1. Почта → Ящики → Добавить. Пресет «Яндекс» подставит IMAP/SMTP.
2. Для Яндекса — пароль приложения (не основной пароль аккаунта).
3. Укажите дату старта — чтобы не тянуть весь архив при первом подключении.
4. Нажмите Проверить IMAP, затем Синхронизировать.

Правила обработки

У каждого ящика — список правил (кнопка «Правила»). Проверка сверху вниз: срабатывает первое подходящее. В конце можно добавить правило «Остальное» (без условий).

• Условия (все заполненные должны совпасть): отправитель, тема, фрагмент текста.
• Действия: привязать/создать клиента по email, создать задачу (группа, исполнитель, срок, напоминания).
• В списке входящих видны созданные задачи и фильтр «Кому поставлено».

Ответы из CRM

Открыть входящее → «Написать ответ». Письмо уходит через SMTP того же ящика (Яндекс: smtp.yandex.ru, 465, SSL, пароль приложения). Ответ попадает в «Исходящие» и в тред переписки.

• В настройках ящика — «Проверить SMTP» рядом с IMAP.
• Можно включить цитирование исходного текста.
• На сервере Яндекса письмо тоже остаётся (в «Отправленных»), CRM хранит свою копию.

Рассылки

Раздел Рассылки — исходящие email-кампании по клиентам или сотрудникам через SMTP ящика из раздела Почта. Одна рассылка = аудитория + канал + цепочка писем (шаги).

Цепочка писем

• У каждого шага свои тема, текст (plain), HTML, интервал между получателями.
• Точная дата — отправка шага в указанное время.
• Относительно — задержка от старта рассылки или от предыдущего письма тому же получателю.
• HTML можно вставить вручную или загрузить файл .html; в редакторе есть live-превью с демо-подстановками {name}, {email}, {company}, {unsubscribe_url}.

Как запустить

1. Выберите аудиторию (клиенты / сотрудники / смешанно) и фильтры, при необходимости — «Предпросмотр получателей».
2. Укажите SMTP-ящик, соберите шаги цепочки.
3. Сохраните черновик → «Запланировать» (очередь получателей × шаги) → отправка идёт батчами по cron/лимитам дня.
4. «Тест активного шага» шлёт письмо на указанный email без постановки всей очереди.

Отписка

• На план рассылки — в карточке плана галка «Добавлять ссылку „Отписаться“». Для клиентов обычно вкл., для сотрудников — выкл.
• Глобально (вкладка «Лимиты»): режим ссылки — встроенная страница CRM (/api/mailing/unsubscribe.php) или свой URL с плейсхолдерами; опция автоматически дописать футер с отпиской, если в шаблоне нет {unsubscribe_url}.
• По ссылке открывается страница подтверждения; после отписки у клиента снимается согласие на email-маркетинг (marketing_email), в поле отписки пишется дата и рассылка.
• Служебные письма (ответы менеджера, сделки) отписка не затрагивает.

Генерация контента

Раздел Генерация контента (Инструменты) — SEO-поля для товаров через ваш ИИ-провайдер. В каталог CRM результаты не пишутся.

Источники

• Ручной ввод — поля как в CSV: название, external_id, sku, категория, бренд, URL, описание (одна строка очереди).
• CSV — вставка текста или URL файла; разделитель ;, UTF-8.

Как работать

1. Создайте задание: тип «Товары», провайдер ИИ, источник → «Создать и запустить».
2. Очередь обрабатывается кнопкой «Продолжить очередь» и cron api/cron/automation.php.
3. Вкладки «Задания» и «Результаты» (фильтры по заданию, типу, провайдеру, статусу).
4. Готовый набор — постоянная ссылка CSV по token задания (без логина).

Яндекс Директ

Раздел Яндекс Директ (Инструменты) — оптимизация через Direct API v5 и цели Яндекс Метрики. Подключение: токен Директа (+ Client-Login) и токен Метрики + ID счётчика.

Моя стратегия

Задайте цену цели (CPA), недельный бюджет и цели Метрики. От них считаются пустые фразы, CPA и защита бюджета. Выберите срезы аудитории для мониторинга или нажмите «Найти параметры» — система найдёт убыточные и выгодные значения (устройство, пол, возраст, регион, ОС и др.).

Что умеет

• Пустые фразы / минус-слова — по конверсиям целей Директа (не по CRM yclid).
• Срезы аудитории — корректировки BidModifiers / сегменты Метрики после «Применить».
• Защита слива — алерт и письмо выбранному сотруднику при перерасходе / расходе без целей.
• Ключевые слова и Журнал действий; автотаргетинг можно выключить из Настроек.
• Антифрод → Директ — кнопка «В Директ» в очереди скликивания.

Как начать

1. Настройки → токен Директа → токен Метрики и счётчик → сохранить.
2. «Моя стратегия» → CPA, бюджет, загрузить и выбрать цели → сохранить.
3. «Найти параметры» и/или «Синхронизировать» → рекомендации → «Применить».

Cron и задания импорта

Раздел Задания (cron): очередь импортов по минутам суток.

Типы заданий

• import_deals_csv — заказы / сделки по URL CSV.
• import_clients_csv — клиенты.
• import_csv — товары CSV.
• import_yml — товары YML.

Настройка

1. Создайте задание, укажите URL выгрузки с магазина (или CRM uploads).
2. Привяжите сохранённый профиль импорта (маппинг, system_code, режим sync).
3. Выберите минуту запуска (0–1439). На одну минуту — одно задание в очереди.
4. На сервере добавьте cron: * * * * * curl -s "https://ваш-crm/api/cron/imports_exports.php?token=…" — точный URL и token в разделе Система.

ИИ-виджет на сайт

В лицензию Rabotyaga CRM входит полноценный ИИ-виджет: чат на сайте, диалоги в CRM, операторы, навыки, мобильные приложения. Без квот на сообщения в рамках лицензии.

С ИИ и без ИИ

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

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

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

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

1. Раздел Провайдеры → API-ключ модели.
2. Канал: ИИ → Включён, выберите провайдер.
3. На чате — навыки (FAQ, каталог…) или прямые ответы ИИ.
4. Вне рабочих часов — ИИ или форма обратной связи (расписание канала).

Виджет и ваш бренд

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

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

1. Чаты → «Добавить чат» → тип Виджет.
2. Вкладки: Основное → Дизайн → Тексты → Контакты → Навыки.

Дизайн

• Основной / вторичный / цвет текста, ширина и высота окна, сторона и отступ снизу.
• Стиль кнопок, шрифт, лого в шапке (header_image_url).
• Иконка плавающей кнопки (button_icon_url) — своя картинка вместо дефолтной.
• Стиль кнопки: классика / пульс / «сигнал TV», «живой бордер».
• Звуки отправки и получения, быстрые вопросы, карусель контактов.
• Доп. CSS — классы .rabotyaga-….

Тексты

• Приветствие, заголовок (chat_header_text), подвал (chat_footer_text) — замените на свой бренд.
• Placeholder, кнопка отправки, «Печатает…», ошибки, пустая история.

Операторы

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

1. Операторы → имя, фамилия, аватар.
2. Привязка и ключи приложений — во вкладке Админ канала.
3. В Сообщения — ответ от имени оператора, вкл/выкл ИИ в диалоге.

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

Канал связывает чаты, переписку и операторов. Без канала нет кода с channel_id и ключей rg_op_….

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

1. Каналы → «Новый канал».
2. Основное: название, промпт, greeting, ИИ вкл/выкл, провайдер.
3. Email при старте диалога, авторизация, температура, оркестратор — по желанию.

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

1. Вкладка Чаты канала → выберите виджет.
2. Скопируйте код: плавающий (перед </body>) или встроенный.

Операторы и ключи

1. Вкладка Админ → отметьте операторов → «Сохранить».
2. Ключ rg_op_… для приложений, ссылка Telegram для привязки.
3. URL панели оператора: …/operator_app/

Приложения оператора

Android, Windows, iPhone/Mac — одна панель. Скачивания в Система → «Приложения оператора». Ключ — в канале после привязки оператора.

Android

1. Скачайте APK из раздела Система.
2. Укажите URL панели и ключ rg_op_….

Windows

1. Файл .vbs — отдельное окно панели.
2. ⚙ → ключ оператора. Альтернатива: PWA из Edge/Chrome.

iPhone / Mac

1. Ссылка «iPhone / Mac» с ?sound=1 → Safari → «На экран Домой» / Dock.

Провайдер ИИ (виджет и CRM)

Для режима с ИИ. Ключи моделей — ваши, оплата напрямую провайдеру.

1. Провайдеры → «Добавить» (DeepSeek, YandexGPT, GigaChat, OpenAI…).
2. API-ключ, модель, base URL при необходимости.
3. На канале — провайдер по умолчанию и ИИ → Включён.

Telegram

Два бота — разные токены:

• Клиентский — чат типа Telegram для посетителей.
• Админ-бот канала — уведомления операторам и привязка Telegram.

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

1. @BotFather → token → Чаты → тип Telegram → сохранить (webhook).
2. Привязать чат к каналу.

Админ-бот

1. Канал → Админ → token админ-бота.
2. У операторов — «Ссылка Telegram».

Навыки

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

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

• FAQ — CSV с вопросами/ответами для виджета.
• YML/каталог — поиск товаров в чате.
• Уведомление — email при старте диалога.

Лицензия и обновления

• Бессрочная лицензия — CRM, виджет, мобильное приложение, импорт CMS без абонентки за пользователей и объём данных.
• Первый год обновлений включён. Дальше — помесячно, только если нужны новые версии.
• Без оплаты обновлений CRM продолжает работать на установленной версии.
• Раздел Система — ключ, проверка обновлений, ссылки на приложения оператора.
• Токены ИИ — напрямую у провайдера, отдельно от лицензии CRM.
• Установка и настройка интеграции (товары, заказы, клиенты) — входят в стоимость лицензии при покупке на rabotyagacrm.a25a.com.

Поддержка и кабинет

• Тестовый период — 7 дней (запрос в кабинете).
• Email: support@a25a.com, раздел «Поддержка» в личном кабинете.
• Интеграция под вашу CMS — бесплатно: укажите домен, CMS и желаемый URL выгрузки.
• Спецификации CSV в панели CRM совпадают с разделами заказы, клиенты, товары этой базы знаний.