Документація

Надсилання розсилок

Через що йдуть листи розсилок, від чийого імені та з якою швидкістю: власний SMTP або сервіс, плавний старт, перевірка SPF, DKIM і DMARC, стоп-лист і часті проблеми.

На цій сторінці

Тут налаштовується, як ідуть листи розсилок: через який сервіс, від чийого імені та з якою швидкістю. Тут же магазин перевіряє, чи готовий ваш домен до масових листів, і веде стоп-лист адрес, на які писати більше не можна. Усе це лежить у «Налаштування платформи» → «Сповіщення» → «Надсилання розсилок». Самі розсилки описано на сторінці Розсилки покупцям.

Розсилки й листи про замовлення розведено навмисно. Якщо на розсилку поскаржаться і поштові служби почнуть відправляти ваші листи в спам, листи про замовлення не мають постраждати разом із нею.

Ліворуч на сторінці п’ять блоків: «Сервіс надсилання», «Відправник», «Швидкість надсилання», «Готовність домену» і «Стоп-лист». Співробітник без права змінювати налаштування магазину, але з правом вести розсилки бачить лише стоп-лист.

Сервіс надсилання

У блоці «Сервіс надсилання» виберіть у полі «Через що надсилати»:

«Як сповіщення про замовлення». Розсилки йдуть тим самим поштовим сервером, що й листи про замовлення, із «Налаштування платформи» → «Сповіщення» → «Канали зв’язку». Це найпростіше і стоїть за замовчуванням. Але якщо на розсилку поскаржаться, постраждають і листи про замовлення. Якщо пошту сповіщень не налаштовано або вимкнено в «Каналах зв’язку», розсилки через неї не йдуть.

«Власний поштовий сервер (SMTP)». Окремий сервер лише для розсилок. Так само підключаються сервіси розсилок, які приймають листи через SMTP: SendPulse, eSputnik, Unisender Go, Brevo, Amazon SES. Поля:

Поле Що вписати
Адреса сервера наприклад, smtp.example.com
Порт зазвичай 587 або 465
Шифрування «TLS (порт 587)», «SSL (порт 465)» або «Без шифрування»
Логін зазвичай адреса пошти або логін із кабінету сервісу
Пароль пароль або ключ для SMTP з кабінету сервісу
Не перевіряти сертифікат сервера вмикайте, лише якщо ваш сервер працює із сертифікатом власного випуску

Пароль після збереження не показується. Якщо залишити поле порожнім під час наступного збереження, магазин збереже попередній пароль. Налаштування кожного сервісу зберігаються окремо: перемкнулися на інший сервіс і назад — пароль не зник.

Сервіс із доповнення. Доповнення додають до цього списку сервіси розсилок, які працюють через свій API. Поля підключення в кожного свої, їх називає доповнення. Якщо вибраний сервіс зник (доповнення вимкнули), магазин попереджає: «Вибраний сервіс надсилання зараз недоступний». Доки ви не виберете інший, листи розсилок не йдуть.

Натисніть «Зберегти».

Перевірочний лист

Нижче є блок «Перевірочний лист». Впишіть свою адресу й натисніть «Надіслати». Лист іде за збереженими налаштуваннями, тому спершу збережіть, потім перевіряйте. Якщо лист не пішов, магазин покаже відповідь сервера. Якщо пішов, перевірте, у яку папку він потрапив: якщо в «Спам», загляньте в блок «Готовність домену».

Посилання для звітів про доставку

Деякі сервіси розсилок повідомляють магазину про долю листів: скриньки немає, отримувач поскаржився на спам, відписався кнопкою в поштовій програмі. Для таких сервісів у блоці з’являється поле «Посилання для звітів про доставку» і кнопка «Копіювати». Вставте посилання в кабінеті сервісу, у налаштуваннях сповіщень про повернення та скарги.

Посилання має вигляд https://ваш-магазин/mailings/feedback/код-сервісу/ключ. Ключ магазин створює один раз, і потім він не змінюється. Магазин має відкриватися з інтернету, інакше сервіс до нього не достукається.

Що магазин робить зі звітом:

  • скриньки немає — лист у звіті розсилки стає «Не дійшло», адреса потрапляє до стоп-листа з причиною «Скриньки немає»;
  • скарга на спам — адреса потрапляє до стоп-листа, у картці покупця з’являється відмова від розсилок, скаргу видно у звіті розсилки;
  • відписка — позначка у звіті розсилки, адреса в стоп-листі, відмова в картці.

У варіантів «Як сповіщення про замовлення» і «Власний поштовий сервер» звітів немає: звичайний поштовий сервер їх не надсилає. Тоді магазин знає про відписки за посиланням у листі й кнопкою поштової служби, а про недоставку — лише якщо сервер відмовив одразу під час надсилання. Такі листи у звіті будуть «Не дійшло», але до стоп-листа вони не потрапляють.

Відправник

Поле Що робить
Адреса відправника з якої адреси йдуть розсилки, наприклад news@shop.com
Ім’я відправника його покупець бачить у списку листів, наприклад назву магазину
Адреса для відповідей сюди прийде відповідь покупця на розсилку

Якщо поля залишити порожніми:

  • адреса відправника у варіанта «Як сповіщення про замовлення» береться з пошти сповіщень, а якщо там її немає, з пошти магазину в «Налаштування платформи» → «Налаштування магазину» → «Основні налаштування». В інших сервісів одразу береться пошта магазину з основних налаштувань. Що саме підставиться, видно сірим у порожньому полі;
  • ім’я відправника береться так само: у варіанта «Як сповіщення про замовлення» — з пошти сповіщень, а якщо там його немає, підставляється назва магазину; в інших сервісів одразу підставляється назва магазину. Його теж видно сірим у порожньому полі;
  • відповіді приходять на адресу відправника.

Адреса відправника має бути на вашому домені. З адрес gmail.com, ukr.net, i.ua та інших безкоштовних служб масові листи поштові служби відправляють у спам: налаштувати підпис для чужого домену не можна.

Швидкість надсилання

«Листів на годину, не більше» і «Листів на добу, не більше» задають обмеження. Їх називає ваш поштовий сервер або тариф сервісу розсилок. Порожнє поле — без обмеження.

  • Година рахується ковзна: останні 60 хвилин. Щойно з цього вікна вийде найраніший лист, можна надіслати наступний.
  • Доба рахується календарна, за часовим поясом магазину.
  • Рахуються лише листи розсилок. Листи про замовлення й перевірочні листи в обмеження не входять.

Дійшовши до обмеження, розсилка стає на паузу й продовжує сама, коли надсилати знову можна. У звіті розсилки в цей час написано «Чекає ліміту надсилання» і коли вона продовжиться. Велика розсилка зі скромним обмеженням може йти кілька днів, і це нормально.

Плавний старт

Поштові служби насторожено зустрічають новий домен або сервер: тисяча листів першого ж дня з нього йде в спам. Перемикач «Плавний старт» починає з малого й щодня збільшує добове обмеження в півтора раза.

У полі «Листів першого дня» вкажіть, із чого почати: не менше 10. Якщо залишити порожнім, першого дня — 200 листів. Тоді обмеження такі:

День Листів на добу
1 200
2 300
3 450
4 675
5 1 012
6 1 518
7 2 278
10 7 688
14 38 923

Перший день — той, у який ви ввімкнули плавний старт, дні рахуються за годинником магазину. Через місяць плавний старт закінчується сам, і залишається лише ваше обмеження на добу. Якщо задано і обмеження на добу, і плавний старт, діє менше з них. Якщо вимкнути плавний старт і ввімкнути знову, відлік почнеться заново з першого дня.

Блок «Надіслано розсилками» показує, скільки листів пішло «За останню годину» і «Сьогодні», та «Обмеження на сьогодні» з урахуванням плавного старту.

Готовність домену

Gmail, Yahoo та інші поштові служби приймають розсилки лише від доменів, у яких налаштовано записи SPF, DKIM і DMARC. Блок «Готовність домену» перевіряє домен адреси відправника й показує за кожним записом, що не так. Самі записи додаються в реєстратора домену чи в панелі хостингу, а які саме, підкаже ваш сервіс надсилання. Після правки натисніть «Перевірити знову». Записи в реєстратора іноді розходяться інтернетом кілька годин.

Перевірка Що означає результат
SPF — кому дозволено надсилати від імені домену «Запис є» — усе гаразд. Якщо запис дозволяє надсилати будь-кому (+all), магазин попереджає: поштові служби такому запису не довіряють. Якщо запису немає, додайте TXT-запис від вашого сервісу надсилання
DKIM — підпис листів Щоб перевірити підпис, потрібен його селектор. Якщо його немає, магазин просить його вказати. Якщо селектор вказано, а запису немає, звірте селектор із кабінетом сервісу
DMARC — що робити з підробленими листами Якщо запису немає, додайте TXT-запис для _dmarc.ваш-домен. Для початку підійде v=DMARC1; p=none
Поштова скринька домену Якщо в домену немає поштового сервера, відповіді покупців і сповіщення про недоставку підуть у нікуди

Селектор DKIM — коротке слово з кабінету сервісу надсилання, наприклад default, mail чи s1. Впишіть його в блоці «Селектор підпису DKIM» і натисніть «Зберегти». Він потрібен лише для перевірки.

Якщо адреса відправника на безкоштовній поштовій службі (gmail.com, ukr.net та подібних), перевірок не буде: магазин одразу скаже, що з такої адреси розсилки йдуть у спам, і запропонує завести адресу на домені магазину. Якщо адреси відправника немає зовсім, перевіряти нічого, і магазин попросить її вказати.

Стоп-лист

На адреси зі стоп-листа розсилки більше не йдуть. Листів про замовлення стоп-лист не зупиняє. Адреси зі стоп-листа не вважаються отримувачами: число в «Порахувати отримувачів» їх уже не включає.

Хто потрапляє до стоп-листа:

Причина Коли
Відписався людина натиснула «Відписатися» в листі чи кнопку відписки в поштовій програмі, або відписку надіслав сервіс розсилок
Скриньки немає сервіс розсилок повідомив, що лист повернувся
Поскаржився на спам сервіс розсилок повідомив про скаргу
Внесено вручну адресу додав співробітник

Якщо на одну адресу приходить кілька причин, залишається найвагоміша: скарга важливіша за повернення, повернення важливіше за відписку. Під час відписки й скарги магазин ставить ще й відмову від розсилок в усі картки покупців із цією адресою. Повернення листа й ручне додавання картку не змінюють.

У списку видно адресу, причину, розсилку, через яку адреса потрапила сюди, подробиці від сервісу й дату. Поле «Пошук адреси» шукає за адресою, а список «Усі причини» залишає одну причину.

Додати вручну. Якщо людина телефоном попросила більше їй не писати, впишіть адресу в поле «Адреса, на яку більше не писати» і натисніть «Додати».

Прибрати зі стоп-листа. Натисніть значок кошика в рядку адреси, наприклад якщо скриньку полагодили або людина знову підписалася. Якщо людина відмовилася від розсилок у своїй картці, відмова залишиться, і розсилки їй однаково не прийдуть, доки вона знову не дасть згоду. Нова згода покупця, навпаки, адресу зі стоп-листа не прибирає: це робите ви.

Стоп-лист бачить і змінює співробітник із правом «Змінювати налаштування магазину» або «Вести знижки та розсилки».

Часті проблеми

Перевірочний лист прийшов, а розсилка не йде. Перевірочний лист надсилається одразу, а розсилка — через чергу завдань, яку розбирає планувальник. Перевірте рядок планувальника, див. Обслуговування.

«Пошту сповіщень не налаштовано» або «Пошту сповіщень вимкнено в «Каналах зв’язку»». Вибрано варіант «Як сповіщення про замовлення», а пошту сповіщень не налаштовано або вимкнено в «Налаштування платформи» → «Сповіщення» → «Канали зв’язку». Налаштуйте її там або виберіть для розсилок власний сервер.

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

Листи йдуть у спам. Пройдіть блок «Готовність домену»: усі перевірки мають бути «Запис є». Не надсилайте з безкоштовної пошти. Для нового домену чи сервера ввімкніть плавний старт. Подивіться вкладку «Доставка» у звіті розсилки: якщо погано лише в одній поштовій службі, річ у ній.

Розсилка довго стоїть «Чекає ліміту надсилання». Так задумано: дійшовши до обмеження, розсилка чекає й продовжує сама. Якщо обмеження нижчі, ніж дозволяє ваш тариф, підніміть їх у блоці «Швидкість надсилання».

Усі листи розсилки «Не дійшло». Сервер відмовляв під час надсилання, наприклад через неправильний пароль. Причину видно на вкладці «Доставка» звіту, у блоці «Чому не дійшло». Виправте налаштування й надішліть собі перевірочний лист. Кнопка «Дослати» досилає лише тим, хто ще чекає надсилання, тому тим, кому лист не дійшов, надішліть повтор: кнопка «Повторити» у звіті, варіант «Тим, кому лист не дійшов» (докладніше).

Розсилка «зірвалася» з порадою перевірити канал розсилки. Частину листів не вдалося надіслати після кількох спроб. Перевірте сервіс надсилання перевірочним листом і натисніть «Дослати» у звіті.

У звіті немає скарг на спам. Скарги магазин дізнається лише зі звітів сервісу розсилок. У власного поштового сервера їх немає, а для сервісу з доповнення треба вставити посилання для звітів у його кабінет.

Для розробників доповнень

Сервіс надсилання розсилок підключається драйвером. Доповнення реалізує App\Core\Contracts\MailingServiceDriver і реєструє його у своєму PluginServiceProvider:

$this->registerDriver(MailingServiceDriver::class, 'acme', AcmeMailingDriver::class);
Метод Що повертає
code() код сервісу в налаштуваннях, наприклад acme
title(), description() назву й одну фразу для власника магазину: ключ перекладу або готовий рядок
settingsSchema() поля підключення у форматі SchemaFields. Таємні поля позначаються secret: true: панель їх не показує, а порожнє значення під час збереження залишає попереднє
send(MailingMessage $message, array $config) ['ok' => bool, 'message' => string], за бажання id (номер листа в сервісі) і retry_after (сервіс просить зачекати стільки секунд)

MailingMessage уже містить відправника, адресу для відповідей, заголовки відписки в один клік і мітки campaign та recipient у tags. Передайте їх сервісу, щоб він повернув їх у звітах. Стоп-лист, обмеження швидкості й відправника за замовчуванням магазин застосовує сам, до виклику send().

Якщо сервіс надсилає звіти про повернення та скарги, драйвер реалізує ще й App\Core\Contracts\ReceivesMailingFeedback. Його метод feedback(Request $request, array $config) розбирає надісланий звіт і повертає список подій ['address' => …, 'type' => …, 'details' => …, 'campaign_id' => …], де type — bounced, complained, unsubscribed або delivered. Справжність звіту (підпис сервісу) перевіряє сам драйвер: несправжній звіт — порожній список. Лише в таких сервісів у налаштуваннях з’являється «Посилання для звітів про доставку».

Оновлено 16 жовтня 2026