Плагин: НейроОтправитель
О плагине
- @package neuroEmailSender
- @author Vladislav Andreev v@salesman.pro
- @version v.0.5 от 16.10.2026
Плагин позволяет импортировать базу клиентов в фиксированном формате, подготавливать приветственные письма с помощью нейросети и отправлять их клиентам

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

