Панель email-рассылок и почтовый кабинет Joobby на Laravel
Кейс · Email-маркетинг · Laravel · GigaChat
Панель email-рассылок и почтовый кабинет Joobby
Веб-приложение объединяет базу контактов, подготовку писем, массовые рассылки и обработку ответов. Менеджер загружает Excel, выбирает шаблон, запускает отправку в фоне и отслеживает события по получателям. Для личной переписки предусмотрен почтовый кабинет с входящими, исходящими и AI-редактором текста.
Задача
Объединить работу с контактными базами и email-коммуникациями в одной панели. Сотруднику нужен последовательный сценарий: подготовить аудиторию, написать письмо, запустить рассылку, посмотреть ход отправки и продолжить общение с теми, кто ответил.
Техническая задача — вынести отправку из HTTP-запроса в фоновые процессы, сохранить состояние каждого письма и связать рассылки с почтовым кабинетом и аналитикой.
Что реализовано
Импорт контактных баз
Загрузка контактов из Excel с именем базы. Импорт пропускает строку заголовков и пустые строки, определяет email в одной из первых двух колонок и отделяет его от имени. При обработке учитывается реестр исключённых адресов.
Шаблоны и персонализация
В панели можно создавать и редактировать шаблоны. При отправке подставляются имя получателя, изображение шаблона и отслеживаемые ссылки. Для контактов без имени предусмотрено нейтральное обращение.
Массовая отправка
Кампания хранит тему, содержание, выбранную базу и шаблон. Для каждого получателя создаётся отдельная запись со статусом. Очередь обрабатывает письма последовательно, с отложенным запуском следующей задачи.
Почтовый кабинет
Входящие и исходящие письма доступны в веб-интерфейсе. Сотрудник может написать новое письмо, ответить на входящее и скачать вложение. Отдельный IMAP-процесс собирает почту в фоновом режиме.
События по получателям
Статистика показывает количество отправленных писем, зафиксированных открытий и переходов. В детализации кампании доступны фильтры по получателям с открытием, без открытия и с переходом по ссылке.
Управление исключениями
Публичная форма отписки добавляет адрес в реестр исключений и удаляет его из импортированных контактов. В панели есть управление этим реестром; сервис отправки отдельных писем проверяет его перед постановкой в очередь.
Как работает рассылка
Подготовка аудитории
Пользователь загружает Excel и выбирает нужную контактную базу в форме рассылки.
Сборка письма
Указывает тему и содержание, выбирает шаблон оформления. Персональные значения подставляются при обработке конкретного получателя.
Создание кампании
Приложение сохраняет кампанию и список получателей. Записи получателей добавляются в базу порциями по 500 строк, после чего запускается первая фоновая задача.
Фоновая обработка
Задача выбирает ожидающее письмо, создаёт токен отслеживания и выполняет отправку. Успех или ошибка фиксируются в записи получателя. Пока остаются ожидающие письма, следующая задача планируется с паузой от 10 до 120 секунд.
Контроль результата
Менеджер смотрит статус кампании и события по контактам, а входящие ответы обрабатывает в почтовом кабинете.
AI-редактор деловой переписки
В редакторе письма подключён GigaChat. Пользователь передаёт черновик на переработку, чтобы сделать формулировки грамотнее, короче и убедительнее. Дополнительно можно запросить новую тему письма.
Интеграция запрашивает структурированный JSON с текстом и, при необходимости, темой. Инструкция модели предусматривает сохранение HTML-разметки письма. Результат возвращается в интерфейс редактирования; отправка выполняется отдельным действием пользователя.
Почтовая синхронизация и аналитика
Команда mail:listen проверяет IMAP-ящик с паузой 30 секунд между циклами. Уже сохранённые сообщения распознаются по UID; для существующих писем предусмотрена догрузка вложений. Ошибка очередной проверки обрабатывается внутри цикла, чтобы процесс мог продолжить работу.
Открытия регистрируются через пиксель, переходы — через промежуточную ссылку с токеном получателя. Такие события помогают ориентироваться в реакции аудитории, но не являются точным измерением прочтения человеком: загрузка изображений и автоматическая проверка ссылок почтовыми сервисами влияют на статистику.
Статус «отправлено» отражает успешное выполнение отправки приложением. Он сам по себе не подтверждает попадание письма во входящие получателя.
Технологии
Результат
Собрана единая панель для работы с email-коммуникациями: от импорта контактов и подготовки шаблона до фоновой отправки, просмотра событий и обработки входящих ответов. Состояние кампании и отдельных писем хранится в базе и доступно через интерфейс.
Проект показывает полный прикладной сценарий на Laravel: импорт табличных данных, очереди, почтовые протоколы, персонализацию, событийную аналитику и подключение языковой модели к рабочему редактору.
Частые вопросы о панели рассылок
Какие контакты можно загрузить в панель?
Панель импортирует Excel-файлы. В первых двух колонках ожидаются email и имя; расположение email определяется по формату адреса. Строка заголовков и пустые строки пропускаются, а база получает отдельное имя для выбора в рассылке.
Нужно ли держать страницу открытой во время рассылки?
Нет. После запуска письма обрабатываются фоновыми задачами Laravel. Для продолжения отправки на сервере должен работать обработчик очереди. Статус кампании и состояние получателей можно посмотреть в панели.
Что показывает статистика открытий и переходов?
Панель фиксирует загрузку пикселя и обращения к отслеживаемым ссылкам. Эти события помогают оценить реакцию аудитории, но не доказывают прочтение письма человеком: почтовые сервисы могут блокировать изображения или автоматически проверять ссылки. Статус отправки также не гарантирует попадание во входящие.
Можно ли обрабатывать ответы на рассылку в этой же системе?
Да. Почтовый кабинет показывает входящие и исходящие письма, позволяет отвечать, создавать новые письма и скачивать вложения. Входящая почта загружается отдельным IMAP-процессом.
Что делает GigaChat и отправляет ли он письма самостоятельно?
GigaChat помогает переработать черновик делового письма и при необходимости предложить новую тему. Результат возвращается в редактор. Пользователь проверяет текст и отдельно выполняет отправку.
Как получатель может отказаться от рассылки?
В проекте предусмотрена публичная форма отписки: адрес добавляется в реестр исключений и удаляется из импортированных контактов. Реестром можно управлять из панели. Сервис отправки отдельных писем проверяет исключения перед отправкой.
Чем панель Joobby отличается от MiniSMTP?
Joobby отвечает за контактные базы, шаблоны, кампании, переписку и события по получателям. MiniSMTP предоставляет HTTP API для отправки транзакционных писем через собственный SMTP-relay. Он не заменяет панель маркетинговых кампаний. Подключение двух решений потребует отдельной интеграции транспорта.
Разработка панели рассылок под ваши процессы
Подобное решение подходит для команд, которым нужен собственный интерфейс для контактных баз, шаблонов и переписки. Состав интеграций, правила отправки и отчётность можно адаптировать под существующую CRM и почтовую инфраструктуру.
Email Marketing · Laravel · SMTP · IMAP · Excel · GigaChat · Automation
