Плагин: НейроОтправитель

О плагине

  • @package neuroEmailSender
  • @author Vladislav Andreev v@salesman.pro
  • @version v.0.5 от 16.10.2026

Плагин позволяет импортировать базу клиентов в фиксированном формате, подготавливать приветственные письма с помощью нейросети и отправлять их клиентам

Требования

Для работы плагина требуется:

  1. Настроенный аккаунт в Почтовике - для возможности отправлять и принимать письма
  2. Установленный и настроенный плагин "Планировщик заданий"
  3. Установленный и включённый плагин «Нейроядро» (neuroCore) — в нём живут подключение к нейросети, ключ и промпт генерации писем

Принцип работы

  • Загружается файл с данными клиентов
  • После обработки в фоне менеджеру придет уведомление о готовности и ссылкой для дальнейшей обработки
  • Задается промпт для формирования нейросетью:
    • первого письма
    • второго письма (отправляется через 2 дня)
    • третьего письма (отправляется через 7 дней)
    • четвертого письма (отправляется через 30 дней)
  • Отправляются письма клиентам после подтверждения текста сформированных писем (делает менеджер вручную)
  • Контролируется ответ клиента (появляется какая-нибудь запись в истории активностей - например входящая почта)
  • Если найдена какая-либо запись в истории активностей, то менеджеру ставится задача с необходимостью связаться с клиентом
  • Если через 2 недели после последней отправки не будет зафиксировано ответа от клиента, то менеджеру будет поставлена задача "Связаться с клиентом"

Важно!

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

Как плагин работает с нейросетью

Общение с моделью целиком идёт через «Нейроядро»: плагин не собирает запросы к API и не разбирает ответы вручную.

  • Подключение задаётся в ядре (раздел «Нейроядро» → вкладка «Подключения»): любой сервис с OpenAI-совместимым API или нативный Gemini. Здесь, в настройках плагина, выбирается только то, какое из включённых подключений использовать для генерации. Смена нейросети или модели больше не требует правок кода, а ключ хранится в одном месте (в ядре он шифруется либо берётся из переменной окружения).
  • Промпт генерации приносится плагином при активации и лежит в реестре ядра под кодом neuremailsender.chain: его текст, версии и схему ответа правят в разделе «Нейроядро» → вкладка «Промпты». Правки администратора не перезаписываются при обновлении плагина.
  • Ответ проверяется по схеме: ядро требует четыре письма цепочки (welcome_letter, followup_1..3) и при несоответствии делает один повтор. Раньше неверный ответ приводил к четырём пустым шаблонам в базе — теперь такое письмо не создаётся, а причина попадает в уведомление.
  • Ошибка видна человеком текстом (неверный ключ, квота, недоступная модель, пустой ответ), а не пустым результатом.
  • Цена операции видна до её запуска: как только файл выбран, в форме импорта появляется строка «будет N вызовов модели через подключение «…», ориентировочно X». Одна строка файла — один клиент — один вызов: вся цепочка из четырёх писем приходит одним ответом. Оценка считается по среднему расходу прошлых вызовов этого типа и по ценам подключения; если цен или истории ещё нет, строка прямо говорит об этом, а не показывает ноль.