Przejdź do treści

Integracja Brevo z aplikacją i CRM: maile transakcyjne, SMS i listy kontaktów

Reset hasła, potwierdzenie zamówienia, link do faktury, kod odbioru. Takie wiadomości aplikacja wysyła sama i powinna wiedzieć, czy dotarły. Podłączam Brevo jako pocztę wychodzącą aplikacji, sklepu albo SaaS, a jego kontakty spinam z CRM.

Autor: Szymon Łakomy. Aktualizacja:

Mail transakcyjny czy marketingowy: po co je rozdzielać?

Newsletter i kampanie opisuję na stronach integracja GetResponse i integracja MailerLite. Tutaj Brevo ma inną rolę: jest pocztą wychodzącą aplikacji. Obie role mogą działać na jednym koncie, ale w integracji rozdzielam je od pierwszego dnia.

CechaMail transakcyjnyKampania marketingowa
Kto uruchamia wysyłkękod aplikacji w chwili zdarzeniaosoba z marketingu w panelu Brevo
Przykładyreset hasła, potwierdzenie zamówienia, zaproszenie do konta, fakturanewsletter, promocja, zaproszenie na webinar
Odbiorcajedna osoba, której dotyczy zdarzenielista albo segment kontaktów
Wypis z newsletteraw mojej integracji nie blokuje wiadomości potrzebnych do korzystania z usługiwyklucza osobę z kolejnych kampanii
Co mierzęczy wiadomość doszła i po jakim czasieotwarcia, kliknięcia, wypisy

Podział dotyczy list, szablonów i nadawców w integracji. Jakie zgody zbierać, ustala osoba odpowiedzialna w firmie za dane osobowe.

Co robić z kontaktami w kampaniach, rozpisuję w tekście o automatyzacji marketingu w małej firmie.

Jak aplikacja wysyła wiadomość przez API Brevo

  1. Zdarzenie. Klient prosi o reset hasła, opłaca zamówienie albo dostaje zaproszenie do konta firmy.
  2. Wywołanie API. Serwer przekazuje do Brevo numer szablonu i dane do wstawienia, na przykład imię i link. Mail transakcyjny idzie zapytaniem POST na adres /v3/smtp/email, a klucz w nagłówku api-key.
  3. Identyfikator. Brevo odsyła identyfikator wiadomości. Zapisuję go przy zamówieniu albo koncie, bo po nim łączę później zdarzenia z konkretną wysyłką.
  4. Status. Webhook z Brevo zmienia status wiadomości w aplikacji: wysłana, doręczona, odbita.

SMS idzie podobną drogą, przez adres /v3/transactionalSMS/send. Dokumentacja Brevo podaje szczegóły, które wpływają na treść: nazwa nadawcy z liter i cyfr ma najwyżej 11 znaków, tekst dłuższy niż 160 znaków wychodzi jako kilka wiadomości, a kod rezygnacji dopisany do treści sprawia, że Brevo traktuje SMS jako marketingowy. Kiedy SMS ma sens, opisuję przy automatycznych powiadomieniach SMS.

Backend piszę głównie w Pythonie i Django, więc korzystam z oficjalnego SDK Brevo dla Pythona albo ze zwykłego zapytania HTTP. W sklepie na WooCommerce maile o zamówieniach wysyła sam sklep, więc ustalamy, czy tam zostają, czy przechodzą przez Brevo razem z resztą.

Które zdarzenia z Brevo warto odbierać webhookiem?

Brevo pozwala ustawić osobne webhooki dla wiadomości transakcyjnych i marketingowych. Dla maili transakcyjnych dokumentacja wymienia między innymi wysłanie, doręczenie, otwarcie, kliknięcie, miękkie i twarde odbicie, błędny adres, opóźnienie, zgłoszenie spamu, wypis, blokadę i błąd. Zwykle odbieram te:

ZdarzenieCo znaczyCo robi integracja
Doręczona (Delivered)serwer odbiorcy przyjął wiadomośćzmienia status przy zamówieniu lub koncie
Twarde odbicie, błędny adres (Hard Bounce, Invalid Email)adres nie istnieje albo ma literówkęoznacza adres jako błędny, prosi o poprawkę przy logowaniu, dopisuje notatkę w CRM
Miękkie odbicie, opóźnienie (Soft Bounce, Deferred)chwilowy kłopot po stronie odbiorcy, na przykład pełna skrzynkanie blokuje adresu, alarmuje dopiero przy powtórkach
Spamodbiorca zgłosił wiadomość jako niechcianąwstrzymuje wysyłki marketingowe do tej osoby
Zablokowana (Blocked)Brevo wstrzymało wysyłkę na ten adreszakłada zadanie dla obsługi, bo klient czeka na mail, który nie wyjdzie

Zakładam, że zdarzenie może przyjść dwa razy albo w innej kolejności, niż zaszło, więc zapis statusu znosi powtórki i nie cofa doręczonej wiadomości do stanu wysłanej. Gdy klient twierdzi, że nie dostał maila, obsługa widzi przy jego koncie, czy wiadomość doszła do serwera, czy odbiła się od błędnego adresu. Jeśli doszła, zostaje folder spam po stronie klienta.

Klucz API, adresy IP i domena nadawcy

Klucz API tylko na serwerze

Trzymam go w zmiennych środowiskowych albo w menedżerze sekretów, nigdy w kodzie strony ani w aplikacji mobilnej. Kto go przechwyci, wyśle wiadomości w imieniu Twojej firmy. Test i produkcja mają osobne klucze.

Zatwierdzone adresy IP

Brevo pozwala zatwierdzać adresy IP, z których wolno wywoływać API, i blokować pozostałe. Gdy ta ochrona jest włączona, przed przenosinami aplikacji na inny serwer dopisuję nowy adres, inaczej wysyłka stanie w dniu migracji.

Zapora przed webhookami

Brevo publikuje w centrum pomocy zakresy adresów swoich usług, w tym te, z których przychodzą webhooki. W listopadzie 2026 lista podawała dla webhooków dwa zakresy: 1.179.112.0/20 i 172.246.240.0/20. Zanim zamknę zaporę, sprawdzam aktualną wersję listy i dokumentację dla programistów, a aplikacja i tak sprawdza, czy identyfikator z webhooka należy do jej wiadomości.

Uwierzytelniona domena

Wiadomości wychodzą z adresu w Twojej domenie, więc w DNS powinny być poprawne wpisy SPF, DKIM i DMARC. Bez nich mail z aplikacji częściej ląduje w spamie. Kolejność wdrożenia opisuję na stronie konfiguracja SPF, DKIM i DMARC.

Kontakty i zgody: co synchronizuję między Brevo a CRM?

Źródłem prawdy o kliencie zostaje CRM albo baza aplikacji. Do Brevo trafia tylko to, czego potrzeba do wysyłki i podziału odbiorców: adres, telefon, imię i kilka atrybutów, na przykład plan abonamentu.

  • atrybuty zakładam w Brevo przed pierwszą synchronizacją, bo dokumentacja wymaga, żeby atrybuty zapisywane przez API istniały już w koncie,
  • klienci aplikacji i subskrybenci newslettera to osobne listy, a zgoda marketingowa jest osobnym polem z datą i źródłem,
  • wypisy, zgłoszenia spamu i twarde odbicia wracają do CRM, żeby handlowiec nie pisał na martwy adres,
  • usunięcie konta w aplikacji usuwa albo anonimizuje kontakt także w Brevo.
Opisuję stronę techniczną. Treść zgód, czas przechowywania danych i umowę powierzenia z dostawcą wysyłki ustala osoba, która odpowiada w firmie za RODO. Co aplikacja musi umieć po swojej stronie, piszę na stronie aplikacja zgodna z RODO.

Ile kosztuje integracja Brevo?

Jeden rodzaj wiadomości ze statusami z webhooka, na przykład potwierdzenia zamówień, wyceniam od około 500 zł netto. Aplikacja, sklep i CRM z dwukierunkową synchronizacją kontaktów i SMS-ami to zwykle od około 2000 zł netto. Opłaty za samą wysyłkę ustala Brevo w cenniku zależnym od planu. W aplikacji abonamentowej to stały koszt miesięczny obok serwera, o czym piszę przy aplikacji SaaS na zamówienie, a pilnowanie połączeń po starcie wchodzi w utrzymanie aplikacji webowej.

Źródła

Opis opieram na poniższych źródłach. Przepisy, dokumentacja producentów i warunki usług się zmieniają, więc szczegóły warto sprawdzić u źródła:

Najczęstsze pytania

Czy Brevo nadaje się do maili transakcyjnych, czy tylko do newslettera?

Do obu. Brevo ma osobne API do maili transakcyjnych i SMS-ów oraz osobne webhooki dla zdarzeń transakcyjnych, więc aplikacja wysyła przez nie reset hasła, a marketing w tym samym koncie prowadzi kampanie. W integracji trzymam te obszary na osobnych listach i szablonach.

Czy formularz na stronie może wysyłać maile przez Brevo prosto z przeglądarki?

Nie powinien. Klucz API w kodzie strony zobaczy każdy, kto otworzy narzędzia przeglądarki. Formularz wysyła dane do serwera, serwer je sprawdza i dopiero on wywołuje API Brevo. Tak samo działa to w aplikacji mobilnej.

Czy połączę Brevo z CRM, który już mam?

Zwykle tak, jeśli CRM ma API albo webhooki. Kontakty, atrybuty i zgody przechodzą z CRM do Brevo, a wypisy, odbicia i zgłoszenia spamu wracają do CRM. Przykłady dla konkretnych systemów opisuję przy integracji HubSpot i integracji Pipedrive.

Ile trwa podłączenie aplikacji do Brevo?

Jeden rodzaj wiadomości z szablonem i webhookiem statusów to zwykle kilka dni razem z testami na adresach testowych. Dłużej trwa uwierzytelnienie domeny, gdy DNS prowadzi zewnętrzna firma, i przeniesienie istniejących szablonów.

Powiązane strony

Aplikacja ma wysyłać maile przez Brevo i wiedzieć, czy doszły?

Napisz, jakie wiadomości wysyła Twoja aplikacja lub sklep, gdzie trzymasz dane klientów i czy masz już konto w Brevo.