---
title: "Integracja Brevo: maile transakcyjne i kontakty z aplikacji"
url: "https://szymonlakomy.pl/integracja-brevo"
description: "Integracja Brevo z aplikacją, sklepem i CRM: maile transakcyjne i SMS przez API, webhooki zdarzeń, odbicia i kontakty. Cena od około 500 zł netto."
updated: "2026-11-12"
author: "Szymon Łakomy"
language: "pl"
---

[Strona główna](https://szymonlakomy.pl/) [Integracje z popularnymi systemami](https://szymonlakomy.pl/integracje-z-systemami) Integracja Brevo

# 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](https://szymonlakomy.pl/o-mnie). Aktualizacja: 12 listopada 2026

Integracja Brevo polega na tym, że aplikacja wysyła maile systemowe (reset hasła, potwierdzenie zamówienia, powiadomienie) i SMS-y przez **API Brevo**, a zdarzenia, takie jak doręczenie, odbicie czy kliknięcie, wracają **webhookiem** do aplikacji albo CRM. Kontakty i zgody synchronizuję z CRM. Prostą integrację wyceniam **od około 500 zł netto**, połączenie kilku systemów **od około 2000 zł netto**.

## Mail transakcyjny czy marketingowy: po co je rozdzielać?

Newsletter i kampanie opisuję na stronach [integracja GetResponse](https://szymonlakomy.pl/integracja-getresponse) i [integracja MailerLite](https://szymonlakomy.pl/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.

| Cecha | Mail transakcyjny | Kampania marketingowa |
| --- | --- | --- |
| Kto uruchamia wysyłkę | kod aplikacji w chwili zdarzenia | osoba z marketingu w panelu Brevo |
| Przykłady | reset hasła, potwierdzenie zamówienia, zaproszenie do konta, faktura | newsletter, promocja, zaproszenie na webinar |
| Odbiorca | jedna osoba, której dotyczy zdarzenie | lista albo segment kontaktów |
| Wypis z newslettera | w mojej integracji nie blokuje wiadomości potrzebnych do korzystania z usługi | wyklucza osobę z kolejnych kampanii |
| Co mierzę | czy wiadomość doszła i po jakim czasie | otwarcia, 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](https://szymonlakomy.pl/automatyzacja-marketingu-w-malej-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](https://szymonlakomy.pl/automatyczne-powiadomienia-sms-dla-klientow).

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](https://szymonlakomy.pl/integracja-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:

| Zdarzenie | Co znaczy | Co 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 skrzynka | nie blokuje adresu, alarmuje dopiero przy powtórkach |
| Spam | odbiorca zgłosił wiadomość jako niechcianą | wstrzymuje wysyłki marketingowe do tej osoby |
| Zablokowana (Blocked) | Brevo wstrzymało wysyłkę na ten adres | zakł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](https://szymonlakomy.pl/spf-dkim-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](https://szymonlakomy.pl/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](https://szymonlakomy.pl/aplikacja-saas-na-zamowienie), a pilnowanie połączeń po starcie wchodzi w [utrzymanie aplikacji webowej](https://szymonlakomy.pl/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:

- [Send a transactional email](https://developers.brevo.com/docs/send-a-transactional-email) (Brevo)
- [Send transactional SMS](https://developers.brevo.com/docs/transactional-sms-endpoints) (Brevo)
- [Webhooks: Getting started](https://developers.brevo.com/docs/how-to-use-webhooks) (Brevo)
- [Manage your contacts in Brevo](https://developers.brevo.com/docs/synchronise-contact-lists) (Brevo)
- [Brevo IP ranges: List of publicly exposed services](https://help.brevo.com/hc/en-us/articles/15127404548498-Brevo-IP-ranges-List-of-publicly-exposed-services) (Brevo)

## 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](https://szymonlakomy.pl/integracja-hubspot) i [integracji Pipedrive](https://szymonlakomy.pl/integracja-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

- [Integracje z popularnymi systemami](https://szymonlakomy.pl/integracje-z-systemami)
- [Konfiguracja SPF, DKIM i DMARC](https://szymonlakomy.pl/spf-dkim-dmarc)
- [Integracja GetResponse](https://szymonlakomy.pl/integracja-getresponse)
- [Integracja MailerLite](https://szymonlakomy.pl/integracja-mailerlite)
- [Automatyczne powiadomienia SMS dla klientów](https://szymonlakomy.pl/automatyczne-powiadomienia-sms-dla-klientow)
- [Aplikacja SaaS na zamówienie](https://szymonlakomy.pl/aplikacja-saas-na-zamowienie)
- [Integracja WooCommerce z systemami firmy](https://szymonlakomy.pl/integracja-woocommerce)
- [Automatyzacja marketingu w małej firmie](https://szymonlakomy.pl/automatyzacja-marketingu-w-malej-firmie)

## 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.

[Bezpłatna wycena](https://szymonlakomy.pl/kontakt?temat=automation) [697 322 226](tel:697322226) [LinkedIn](https://www.linkedin.com/in/szymon-%C5%82akomy-7a1192361/)
