Email-розсилка з Brevo: інтеграція та налаштування під ключ

Після запуску інтернет-магазину зіткнулися з проблемою: листи про замовлення не доходили до клієнтів, доставка впала до 60%. Причина — відсутність SPF-запису та перевищення лімітів shared-хостингу. Рішення — інтеграція з Brevo (колишній Sendinblue). Ця платформа забезпечує доставку 99.5%+, включає безкоштовний план на 300 листів/день та надає API з квотою 1000 запитів/год. Ми інтегрували Brevo на 50+ проєктах — від магазинів на Laravel до корпоративних порталів.

Як інтегрувати Brevo з сайтом?

Підключення можливе трьома способами. Перший — REST API (рекомендуємо для кастомних сценаріїв). Другий — SMTP (швидкий старт для WordPress або Laravel). Третій — вебхуки для прийому подій (відкриття, кліки). Розглянемо API-інтеграцію на PHP (Laravel).

// composer require brevo/php-api-v3-sdk

$config = Brevo\Client\Configuration::getDefaultConfiguration()
          ->setApiKey('api-key', env('BREVO_API_KEY'));

$apiInstance = new Brevo\Client\Api\TransactionalEmailsApi(
    new GuzzleHttp\Client(), $config
);

$sendSmtpEmail = new \Brevo\Client\Model\SendSmtpEmail([
    'subject'    => "Замовлення #{$orderId} підтверджено",
    'sender'     => ['name' => 'Магазин', 'email' => '[email protected]'],
    'to'         => [['name' => $name, 'email' => $to]],
    'htmlContent' => $htmlBody,
    'params'     => ['ORDER_ID' => $orderId, 'TOTAL' => $total]
]);

$apiInstance->sendTransacEmail($sendSmtpEmail);

Транзакційний шаблон

$email = new \Brevo\Client\Model\SendSmtpEmail([
    'templateId' => 42,  // ID шаблону в Brevo
    'to'         => [['email' => $to]],
    'params'     => ['ORDER_ID' => $orderId, 'NAME' => $name]
]);

Управління контактами

$contactsApi = new Brevo\Client\Api\ContactsApi(new GuzzleHttp\Client(), $config);

$createContact = new \Brevo\Client\Model\CreateContact([
    'email'      => $email,
    'attributes' => ['FNAME' => $firstName, 'LNAME' => $lastName],
    'listIds'    => [intval(env('BREVO_LIST_ID'))],
    'updateEnabled' => true  // upsert
]);

$contactsApi->createContact($createContact);

Що дає інтеграція Brevo?

Brevo в 2-3 рази дешевший за Mailchimp при схожому функціоналі. Безкоштовний план економить бюджет порівняно з іншими сервісами. API відповідає за 200ms, доставка — 99.5%+. Вбудована CRM, SMS та WhatsApp з одного вікна. Для українських проєктів Brevo — один з небагатьох зарубіжних сервісів, стабільно працюючих з доменами .ua.

Порівняння методів інтеграції:

Чому варто використовувати Brevo для email-розсилки?

Brevo — одне з найкращих рішень для транзакційних листів в ніші e-commerce. Завдяки сегментації аудиторії за атрибутами та поведінкою відкриваємість досягає 45% (проти середніх 20% без сегментації). Документація Brevo рекомендує налаштовувати SPF та DKIM в першу чергу — це основа доставки.

Які налаштування домену обов'язкові?

Для високої доставки необхідно налаштувати SPF, DKIM та DMARC. SPF-запис вказує, які сервери мають право відправляти пошту від вашого домену. DKIM додає цифровий підпис, що підтверджує справжність листа. DMARC визначає політику обробки листів, що не пройшли перевірку. Без цих записів листи йдуть у спам. На практиці додаємо три TXT-записи в DNS:

• SPF: v=spf1 include:spf.brevo.mx ~all
• DKIM: ключ з панелі Brevo публікується як brevo._domainkey.example.ua
• DMARC: _dmarc.example.ua з політикою p=quarantine

Документація Brevo радить налаштовувати SPF та DKIM в першу чергу. Після налаштування перевіряємо через онлайн-інструменти — доставка одразу зростає до 99%+.

Що входить в роботу з інтеграції?

1. Налаштування домену: SPF/DKIM/DMARC для високої доставки.
2. Підключення API/SMTP згідно з вашою CMS (Laravel, WordPress, 1С-Бітрікс).
3. Розробка транзакційних шаблонів: адаптивний дизайн, змінні.
4. Імпорт контактів з атрибутами, сегментація.
5. Тестування: перевірка спаму, відкриваємості, часу завантаження.
6. Навчання: покажемо, як створювати кампанії та дивитися статистику.
7. Підтримка: гарантія 2 тижні після запуску.

Процес роботи

1. Аналітика: вивчаємо вашу аудиторію, поточні розсилки.
2. Проектування: вибираємо спосіб інтеграції, проектуємо шаблони.
3. Реалізація: пишемо код, налаштовуємо маршрути.
4. Тест: перевіряємо всі сценарії (реєстрація, замовлення, скидання пароля).
5. Деплой: вмикаємо в продакшен, моніторимо перші 24 години.

Строки орієнтовно

• Базова інтеграція (SMTP + API для однієї події) — від 1 дня.
• Розширена (шаблони, сегментація, вебхуки) — від 3 днів.
• Комплексна автоматизація (ланцюжки листів) — від 5 днів.

Вартість розраховується індивідуально в залежності від складності. Замовте оцінку — це безкоштовно.

Типові помилки при інтеграції

• Ігнорування SPF/DKIM: листи йдуть у спам.
• Занадто часті запити: API повертає 429 Too Many Requests. В Brevo — 1000 запитів на годину, плануйте batch-процеси.
• Відсутність unsubscribe-посилання: порушення закону.
• Дупи контактів: використовуйте updateEnabled: true для upsert.

Чому довіряють нам?

5+ років досвіду в інтеграції поштових сервісів, 50+ успішних проєктів, сертифіковані спеціалісти Brevo. Гарантуємо доставку 99%+ та повну документацію. Зв'яжіться з нами — оцінимо ваш проєкт за 1 годину. Замовте інтеграцію та отримайте стабільну доставку.

Додаткова таблиця: чек-лист налаштування домену

Інтеграція email розсилок: чому вона часто ламається?

Ми стикалися з тим, що тригерний лист через 10 хвилин після реєстрації конвертує в 4–5 разів краще, ніж той самий лист через 24 години. Це не маркетинговий міф — це механіка: поки користувач теплий, поки пам'ятає контекст. Але більшість інтеграцій з розсильниками зроблені так: форма сабмітиться → синхронний HTTP-запит до API → якщо API гальмує, користувач чекає 3 секунди → лист йде або не йде, ніхто не знає.

Якщо ви зіткнулися з втраченими листами або потраплянням у спам, замовте аудит існуючої інтеграції — ми знайдемо вузькі місця за 2 дні.

Провайдери та їх API

Unisender — російський провайдер, популярний у сегменті SMB. REST API, простий. Додавання контакту: importContacts, відправка транзакційного листа: sendEmail. Важливо: для транзакційних листів (підтвердження замовлення, скидання пароля) Unisender Go — окремий сервіс з іншим API та окремою ціною. Змішувати масові розсилки та транзакційні в одному потоці — погана ідея для репутації домену.

SendPulse — надає email, SMS, web push, Viber, Telegram-боти через єдиний API. Для проєктів, де потрібен омніканал, це зручно. Automation 360 — візуальний конструктор ланцюжків, можна запустити автоматизацію через API event. SDK для PHP (sendpulse/rest-api-php-sdk) підтримується, але оновлюється нерегулярно — краще використовувати напряму через Guzzle.

Mailchimp — вибір для міжнародної аудиторії та маркетингових команд, звиклих до екосистеми Mailchimp. Transactional email — через Mandrill (дочірній сервіс). Marketing API v3 для управління списками, тегами, кампаніями. Webhook для подій: відкриття, клік, відписка, bounce.

SMS. Для Росії: СМСЦ, МТС Exolve, Devino Telecom, SMS Aero. API у всіх схожий: метод send, параметри phone, message, sender (ім'я відправника — потрібно реєструвати окремо у оператора). Один нюанс: ім'я відправника має бути зареєстровано через агрегатора з договором — без цього SMS не відправляться на мережі МТС/МегаФон/Білайн.

Як побудувати інтеграцію, щоб не втрачати листи?

Розділяємо транзакційні та маркетингові потоки

Транзакційні листи (підтвердження замовлення, скидання пароля, статус доставки) — через окремий домен-відправник або субдомен tx.example.com. Маркетингові розсилки — через mail.example.com або news.example.com. Якщо маркетингова розсилка отримає багато скарг на спам, це не повинно зачепити репутацію транзакційного потоку. Згідно з документацією SendGrid, транзакційні повідомлення слід відправляти через виділений IP-пул для запобігання перехресному впливу.

Черга та retry

Будь-який виклик до email API — через чергу (Laravel Queue, Bull, Celery). Якщо Unisender повернув 503 — задача йде в retry через 5 хвилин, потім 15, потім 60. Після 5 невдалих спроб — у dead letter queue з алертом. Користувач при цьому вже отримав свій 200 OK і не знає про проблему. Завдяки цьому підходу bounce rate на проєктах знижується до 0.5%.

Приклад job для Laravel:

public function handle(): void
{
    try {
        $response = Http::post(config('services.unisender.email_url'), $this->params);
        if ($response->failed()) {
            $this->release(300); // retry через 5 хв
        }
    } catch (\Throwable $e) {
        $this->release(300);
    }
}

Шаблони

Зберігаємо шаблони в коді (Blade, Twig, React Email), не в інтерфейсі провайдера. Причини: версіонування через Git, preview у браузері без відправки, можливість тестування. Для складних шаблонів з динамічним контентом — react-email з експортом в HTML через @react-email/render.

Валідація та згоди

Перед додаванням контакту до списку — double opt-in (лист з підтвердженням). Зберігати факт підтвердження з timestamp у своїй БД. При відписці — синхронно відписуємо і у провайдера, і в своїй базі. Ігнорувати webhook відписки — прямий шлях до блокування акаунта у провайдера. Всі процеси відповідають ФЗ-152 про персональні дані.

Моніторинг доставності

Підключаємо webhook від провайдера на події bounce (жорсткий і м'який), spam_complaint, unsubscribe. Жорсткий bounce — негайно позначаємо email як невалідний у своїй БД, більше не відправляємо. М'який bounce 3 рази поспіль — те саме. Метрики: open rate, click rate, bounce rate, unsubscribe rate — дивимося не рідше разу на тиждень. Наші сертифіковані інженери налаштовують алерти в Grafana/Prometheus.

Чому важливо розділяти потоки?

Якщо відправити маркетингову розсилку з того ж домену, що й транзакційні листи, отримавши скарги на спам, ви ризикуєте заблокувати домен — і користувачі перестануть отримувати навіть підтвердження замовлень. SPF, DKIM, DMARC (Wikipedia SPF, Wikipedia DKIM) повинні бути налаштовані окремо для кожного потоку. Ми використовуємо субдомени з різними DNS-записами.

Обсяг робіт з інтеграції

• Аудит поточних потоків комунікації та репутації домену (SPF, DKIM, DMARC)
• Вибір провайдера та схеми: транзакційний vs маркетинговий трафік
• Налаштування DNS-записів SPF, DKIM, DMARC (Wikipedia DMARC)
• Розробка шаблонів листів (HTML + динамічний контент)
• Інтеграція з бекендом через черги та API
• Налаштування webhook для доставності та скарг
• Документація з експлуатації та навчання команди
• Гарантія доставності та підтримка після запуску

Терміни та вартість

Вартість розраховується індивідуально після аудиту. Ми працюємо під ключ: від аналізу до моніторингу в продакшені. Отримайте консультацію інженера — оцінимо проєкт безкоштовно та скажемо точні терміни. Досвід більше 7 років в інтеграції поштових сервісів, реалізовано 50+ проєктів. Замовте безкоштовний аудит поточної інтеграції — отримайте звіт з рекомендаціями.