logo

RedmineKanban

Login
Последнее обновление: 18.11.2026

Документация: ClientDesk

ClientDesk — CRM-плагин для Redmine. Он ведёт клиентов, сделки и продукты внутри проекта, связывает обращения с контактами и принимает почту без отдельной CRM.

Интерфейс CRM открывается внутри страницы Redmine. Открытый клиент, сделка или продукт сохраняются в адресе страницы: ссылку можно обновить и передать коллеге.


Ключевые возможности

Что добавляется в Redmine

  • Модуль проекта «ClientDesk» и пункт меню проекта ClientDesk.
  • Верхнее меню и меню приложений. Пункт ClientDesk можно включить отдельно. Он открывает CRM по всем доступным проектам.
  • Меню администрирования. Пункт ClientDesk ведёт в настройки плагина.
  • Задача. Поле контакта, карточка клиента в боковой панели, ответ клиенту, шаблоны, оценка и подсказка ИИ.
  • Список задач. Дополнительные столбцы и фильтры по контакту, компании, каналу, времени реакции, времени ответа, времени решения и оценке.
  • Поиск Redmine. Галочка Clientdesk ищет клиентов, сделки и продукты.
  • Настраиваемые поля для клиентов, сделок и продуктов.

Клиенты, сделки и продукты

  • Клиенты — контакты и компании. У контакта есть компания, почта, телефон, адрес, страна, язык, ответственный и заметки.
  • Сделки — статус, сумма, валюта, срок, заметка и позиции из каталога.
  • Продукты — товар, услуга или подписка, цены в разных валютах.
  • Подписки — позиции сделки с периодом 1 месяц или 1 год. На карточке видны активные и истекшие.
  • Панель управления — сводка по клиентам, сделкам и продуктам. Состав блоков зависит от прав пользователя.
  • Журнал изменений у клиента, сделки и продукта.

Почта, ответы и оценка

  • IMAP — входящие ящики проекта. Из письма создаётся задача или комментарий к уже открытой задаче.
  • SMTP — исходящие профили. В проекте выбирается профиль для ответов клиенту.
  • Шаблоны ответов с подстановкой имени клиента, номера задачи и других полей.
  • Оценка обращения. При закрытии задачи автору можно отправить письмо со ссылкой. Ссылка открывается без входа в Redmine.
  • Автозакрытие обращений через заданное число часов и письмо клиенту.
  • ИИ. На странице задачи можно сгенерировать текст ответа по краткому запросу.
  • Импорт из RedmineUp — контакты, компании, сделки и продукты. Связь задач с новыми контактами выполняется отдельной кнопкой.

Для кого

  • Поддержка — обращения из почты, ответ клиенту и оценка качества.
  • Продажи — клиенты, сделки, каталог и подписки.
  • Администратор Redmine — статусы сделок, почта, шаблоны и импорт.

Совместимость

Redmine: 6.0 - 7.0

Базы данных: MySQL, PostgreSQL, SQLite

В настройках Redmine должен быть включён REST web service. Иначе на странице настроек плагина показывается предупреждение «Включите REST web service».


Установка и обновление

  1. Удалите старую версию плагина, если она установлена.

    cd redmine/plugins
    rm -r clientdesk
    
  2. Скопируйте папку clientdesk в redmine/plugins/.

  3. Выполните миграции в корне Redmine.

    bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=clientdesk
    
  4. Остановите и запустите Redmine. В части установок, например в Docker, нужна именно остановка и запуск, а не перезапуск.


Удаление

  1. В корне Redmine выполните:

    bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=clientdesk VERSION=0
    
  2. Удалите папку плагина.

    cd redmine/plugins
    rm -r clientdesk
    
  3. Остановите и запустите Redmine.


Настройка

  1. Включите REST web service в настройках Redmine.
  2. Выдайте права в Администрирование → Роли и права доступа, раздел ClientDesk.
  3. Включите модуль ClientDesk в Проект → Настройки → Модули.
  4. Откройте настройки плагина и создайте статусы сделок.
  5. Если нужны ответы клиентам, создайте SMTP-профиль и выберите его в настройках проекта.
  6. Если нужна входящая почта, добавьте IMAP-ящик и привяжите его к проекту.

Администрирование

Настройки плагина доступны администратору Redmine двумя способами.

  1. Администрирование → Модули → ClientDesk CRM plugin → Настроить.
  2. Администрирование → ClientDesk.

Вкладка «Общее»

  • Показывать в верхнем меню — пункт ClientDesk в верхнем меню Redmine.
  • Показывать в меню приложений — пункт ClientDesk в меню приложений.
  • Формат имени контакта — «Имя Фамилия», «Имя Отчество Фамилия», «Фамилия Имя» или «Фамилия Имя Отчество».
  • Страна по умолчанию для новых контактов.
  • Язык по умолчанию для новых контактов.
  • Доступные валюты — список, из которого выбирают валюту сделки и цены продукта.
  • Автоматически закрывать обращения после — число часов. Закрытие выполняет фоновое задание, см. ниже.
  • Отправить автоматически письмо клиенту — тема и текст письма о закрытии. Оба поля обязательны, если галочка включена.

В тему и текст письма о закрытии можно вставить: %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.author.name}, %{ticket.author.email}, %{client.name}, %{ticket.status}.

Вкладка «Почта»

Список IMAP-ящиков. Ящик привязывается к проекту.

У ящика задаются хост, порт, имя пользователя, пароль, метод аутентификации, защита соединения и проверка SSL. Далее указывают папку IMAP, папку переноса успешно обработанных писем и папку переноса писем с ошибкой.

Правила создания задачи:

  • трекер и статус новой задачи;
  • Создавать контакты — новый контакт для неизвестного отправителя;
  • Использовать номер задачи из темы — если в теме есть номер открытой задачи, письмо станет комментарием, а не новой задачей;
  • Чёрный список отправителей — один шаблон на строку, можно регулярные выражения.

Кнопка «Проверить соединение» показывает папку, число сообщений и число новых сообщений.

Вкладка «SMTP»

Исходящие профили: хост, порт, учётная запись, пароль, защита соединения и адрес отправителя. Один профиль можно отметить как профиль по умолчанию. В проекте выбирается этот профиль, другой профиль или общие настройки почты Redmine.

Вкладка «Статусы сделок»

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

Вкладка «Шаблоны ответов»

Шаблон — это название и текст. В текст подставляются поля клиента, задачи и автора ответа:

%{client.name}, %{client.first_name}, %{client.last_name}, %{client.email}, %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.tracker}, %{ticket.status}, %{response.author}, %{response.author.first_name}, %{response.author.last_name}.

На странице задачи шаблон выбирается в списке «Вставить шаблон». Для этого нужны права редактирования задач и просмотра клиентов.

Вкладка «Коммуникации»

Журнал входящих и исходящих сообщений. По нему видно, какие письма уже создали задачу или комментарий, чтобы одно письмо не обрабатывалось дважды. На этой вкладке нет кнопки сохранения настроек.

Вкладка «ИИ»

Адрес сервиса, к которому плагин отправляет запрос на генерацию ответа. Поведение на странице задачи включается в настройках проекта.

Вкладка «Запросить оценку»

Общий шаблон письма с просьбой оценить обращение. Галочка «При закрытии задачи запросить у автора оценку» включает шаблон. Тема и текст обязательны.

Ниже — таблица проектов с модулем ClientDesk. Для каждого проекта выбирается режим: Выключено, По шаблону из админки или Шаблон проекта. Режим шаблона из админки доступен, когда общий шаблон заполнен и включён.

В шаблон на этой вкладке вставляются переменные в фигурных скобках: {%ticket.id%}, {%ticket.subject%}, {%ticket.project%}, {%ticket.author.name%}, {%ticket.author.email%}, {%client.name%}, {%vote.url%}.

Вкладка «Импорт»

Три действия, только для администратора.

  • Импортировать из RedmineUp — создаёт контакты, сделки и продукты. Задачи на этом шаге не привязываются.
  • Связать задачи с новыми контактами — берёт связи из helpdesk для уже импортированных клиентов. Задача, у которой контакт ClientDesk уже указан, пропускается.
  • Удалить всё — безвозвратно удаляет контакты, компании, сделки, продукты, заметки и привязки задач. Статусы сделок, почтовые ящики и шаблоны остаются.

Если таблиц RedmineUp в базе нет, импорт сообщает об этом и ничего не создаёт.

Роли и права доступа

В разделе ClientDesk:

  • Просмотр клиентов — список и карточка клиентов, заметки, поиск, поле контакта на задаче.
  • Управление клиентами — создание, изменение и удаление клиентов и заметок, создание контакта из карточки задачи.
  • Просмотр сделок — сделки и подписки.
  • Управление сделками — создание, изменение и удаление сделок.
  • Просмотр продуктов — каталог.
  • Управление продуктами — создание, изменение и удаление продуктов.

Право управления не включает право просмотра. Их нужно выдавать отдельно.

Пункт меню ClientDesk виден, если модуль включён и есть хотя бы одно право просмотра: клиентов, сделок или продуктов. Вкладки внутри CRM показываются по своим правам.

Настройки почты проекта меняет пользователь с правом редактирования проекта. Права CRM для этого не нужны.

Фоновые задания

Получение почты можно запустить вручную из настроек проекта. Для расписания в корне Redmine:

bundle exec rake clientdesk:fetch_mail

Автозакрытие обращений срабатывает только этой командой:

bundle exec rake clientdesk:auto_close_issues

Настройка проекта

Проект → Настройки → ClientDesk.

IMAP

Список входящих ящиков этого проекта. У проекта может быть несколько ящиков. Отсюда же запускаются «Проверить соединение» и «Получить почту».

После получения показывается, сколько писем обработано, сколько задач создано и сколько комментариев добавлено.

SMTP

Выбор исходящего профиля для ответов клиентам. Если профиль не выбран, при ответе показывается предупреждение: укажите SMTP в Настройки → ClientDesk → Почта.

Feedback

При закрытии задачи запросить у автора оценку:

  • Выключено;
  • По шаблону из админки;
  • Шаблон проекта — свои тема и текст. Оба поля обязательны.

В шаблон проекта вставляются %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.author.name}, %{ticket.author.email}, %{client.name}, %{vote.url}.

Настройки ИИ

  • Включить ИИ-подсказки для ответов клиентам и системный промт.
  • Включить предзаполненный промт для клиентов и текст этого промта.

Использование

Открытие CRM

Проект → ClientDesk.

Вкладки:

  • Панель управления — счётчики клиентов, сделок и продуктов. При праве на сделки также видны суммы по валютам и подписки.
  • Клиенты.
  • Сделки.
  • Продукты.

В шапке CRM — поиск по клиентам, сделкам и продуктам текущего контекста. Списки можно фильтровать и сохранять как запрос.

Пункт верхнего меню или меню приложений открывает ту же CRM без привязки к одному проекту. В списки попадают записи из проектов, где модуль включён и есть право просмотра.

Клиенты

Фильтр списка: Все, Контакты, Компании.

Карточка клиента показывает контактные данные, связанные сделки, задачи, заметки и настраиваемые поля. У контакта можно создать компанию прямо в поле компании. У компании в карточке видны её контакты.

Основные поля контакта: имя, отчество, фамилия, email, телефон, должность, компания, день рождения, адрес, город, регион, страна, язык, сайт, ИНН, источник, ответственный, признак «Не контактировать». У компании — название, отрасль и размер компании.

К клиенту можно прикрепить файлы через настраиваемые поля типа «файл». В журнале видно, кто и когда изменил запись.

Клиент принадлежит основному проекту. Дополнительно его можно открыть в других проектах: в родительских и дочерних проектах основного, во всех проектах или в списке «Дополнительно доступен в проектах». Сама привязка задачи или письма к проекту клиента в этот проект не добавляет.

Если при создании контакта email уже есть, плагин не создаёт вторую карточку. Он предлагает открыть существующий контакт, добавить проект в видимость или сменить основной проект. Доступные действия зависят от прав.

«Убрать из проекта» скрывает клиента в текущем проекте и оставляет его в основном. Удаление карточки выполняется в основном проекте. Клиента, который указан в задачах или сделках, удалить нельзя.

Сделки и подписки

Сделка привязана к клиенту и проекту. У неё есть название, статус, сумма, валюта, срок, заметка и позиции. Позиция — это продукт, количество, цена и номер заказа. Продукт берётся из каталога выбранного проекта. Цена берётся в валюте сделки.

Из карточки клиента сделку можно создать с уже выбранным клиентом. Сделку можно перенести в другой проект, если в обоих проектах есть право управления сделками и клиент там виден.

Подписка — продукт с типом «Подписка» и периодом 1 месяц или 1 год. Дата начала указывается в сделке, дата окончания считается по периоду. Если срок сделки не совпадает с датами окончания подписок, плагин предлагает заменить срок.

На странице задачи при наведении на имя контакта открывается карточка: имя, почта, сделки и подписки. Активные и истекшие подписки показаны отдельно. Если у контакта есть компания, в карточке есть и её сделки. Сделки других контактов этой компании собраны в блоке «Другие сделки».

Продукты

Каталог проекта. Тип продукта: Товар, Услуга или Подписка. У подписки обязателен период. У продукта есть название, описание, артикул и цены. Валюта цены выбирается из списка «Доступные валюты».

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

Задачи

Если модуль включён и есть право «Просмотр клиентов»:

  1. В форме задачи найдите поле контакта и начните вводить имя. Поиск начинается с двух символов.
  2. Выберите контакт и сохраните задачу.
  3. На странице задачи контакт показан в блоке и в боковой карточке. Карточку можно сменить или очистить без перехода в CRM.
  4. При праве «Управление клиентами» контакт можно создать из этой карточки.

У задачи один текущий контакт. Смена контакта сохраняется в истории обращений.

В список задач можно добавить столбцы и фильтры: контакт, компания контакта, канал обращения, время первой реакции, время первого ответа, время решения, оценка клиента, последнее сообщение и его дата. Каналы: email, телефон, чат, API. Выбранные столбцы попадают в экспорт списка задач.

Ответ клиенту

В комментарии к задаче с контактом есть «Ответить клиенту». Можно указать кому, копию и скрытую копию. Письмо уходит через SMTP проекта. В журнале задачи отмечается, что ответ отправлен. Ответ клиента из почты приходит как комментарий и помечается как ответ клиента.

Над полем комментария есть «написать ответ с помощью ИИ», если подсказки включены в проекте. Краткий запрос и данные задачи уходят на сервис ИИ, готовый текст попадает в поле комментария.

Оценка обращения

Если в проекте включён запрос оценки, при закрытии задачи автор получает письмо со ссылкой. Страница оценки открывается без входа. Оценки: Отлично, Нормально, Плохо. Комментарий необязателен. Сохраняется последняя оценка. Она видна в задаче и в столбце списка задач.

Поиск Redmine

На странице поиска и в быстром поиске шапки есть галочка Clientdesk. Она ищет клиентов, сделки и продукты одной группой. Счётчик Clientdesk (N) оставляет в выдаче только эти результаты.

В одном проекте галочка есть, если модуль включён и есть право просмотра. При поиске по нескольким проектам галочка есть всегда, но чужие записи в результаты не попадают.

Ищется имя, название, email, телефон, должность, сайт, ИНН, название и заметка сделки, описание продукта и настраиваемые поля с признаком «Доступно для поиска». Заметки и вложения в поиск не входят. Режим «Искать только в названиях» оставляет имена и названия.

Ссылка открывает карточку в CRM.


Часто задаваемые вопросы

Почему не видно меню ClientDesk?

Проверьте три условия.

  1. В проекте включён модуль ClientDesk.
  2. У роли есть хотя бы «Просмотр клиентов», «Просмотр сделок» или «Просмотр продуктов».
  3. Для пункта вне проекта включены «Показывать в верхнем меню» или «Показывать в меню приложений», и то же право просмотра есть хотя бы в одном проекте.

Почему на странице настроек написано «Включите REST web service»?

CRM работает через REST API Redmine. Включите службу в Администрирование → Настройки → API.

Можно ли импортировать CRM и сразу привязать задачи?

Нет. Сначала «Импортировать из RedmineUp», проверьте карточки, затем «Связать задачи с новыми контактами». Если импорт не удался, «Удалить всё» очищает импортированные данные и не трогает статусы, почту и шаблоны.

Почему письмо не стало новой задачей?

Если в теме есть номер уже открытой задачи и включена настройка «Использовать номер задачи из темы», письмо добавляется комментарием. Письмо из чёрного списка не создаёт задачу. Повторное письмо видно во вкладке «Коммуникации».

Кто видит оценку клиента?

Оценку ставит автор обращения по письму. В Redmine она видна на задаче и в столбце списка задач тем, у кого есть доступ к задаче.