Jak AI może pilnować doręczalności maili transakcyjnych przez SendGrid i Mailgun?
Podłącz AI do SendGrid albo Mailgun przez REST API i webhooki. Zbierasz bounce_classification, spam_report i statystyki doręczeń, a AI diagnozuje problemy i wskazuje, co naprawić.
SendGrid i Mailgun mają otwarte REST API oraz mechanizm webhooków zdarzeń. Dzięki nim AI może na bieżąco odbierać dane o każdym wysłanym mailu: czy doszedł, czy odbił się jako hard bounce, czy trafił do folderu spam. Firma dostaje automatyczny monitoring doręczalności, posortowaną listę adresów do wyczyszczenia i diagnozę, dlaczego konkretny szablon albo cały strumień maili nagle przestał docierać do odbiorców.
Dlaczego maile transakcyjne to nie newsletter i dlaczego każdy niedostarczony mail boli
Newsletter można raz na jakiś czas pominąć. Potwierdzenie zamówienia, faktura, link do śledzenia paczki albo jednorazowy kod do resetowania hasła to zupełnie co innego. Klient ich czeka. Gdy mail nie przyjdzie w ciągu kilku minut, dzwoni do biura obsługi. Jeśli to faktura, może nie zapłacić na czas, bo "nie dostał". Jeśli to link aktywacyjny do konta, po prostu nie może zacząć używać usługi.
SendGrid i Mailgun obsługują właśnie ten rodzaj wysyłki: maile wyzwalane zdarzeniem w systemie, nie harmonogramem kampanii. Potwierdzenie zamówienia w sklepie, mail z dokumentem PDF po podpisaniu umowy, powiadomienie o statusie reklamacji, zaproszenie do panelu klienta. Każdy z tych maili to punkt styku z klientem, gdzie niedostarczenie od razu widać.
Problem pojawia się, gdy system wysyła normalnie, ale reputacja domeny nadawcy spada po cichu. Rośnie liczba hard bounce'ów, zaczynają pojawiać się wpisy w polu spam_report w logu zdarzeń, a nikt w firmie o tym nie wie. Przez kilka tygodni wszystko wygląda dobrze w dashboardzie. Potem pewnego dnia maile zaczynają masowo trafiać do spamu albo w ogóle nie dochodzić do klientów na określonych domenach. W tym momencie odbudowa reputacji IP nadawcy trwa tygodniami i jest procesem żmudnym.
Jak fizycznie wygląda podłączenie: API, webhooki i co trzeba mieć
Oba serwisy mają otwarte REST API i mechanizm webhooków. Oznacza to, że nasz system (portal, sklep, aplikacja) może zarówno aktywnie pobierać dane, jak i odbierać je w czasie rzeczywistym za każdym razem, gdy coś się dzieje z mailem.
SendGrid: API opisane jest w dokumentacji pod adresem docs.sendgrid.com (REST, format JSON). Klucz API zakładamy w panelu: Settings > API Keys. Do monitoringu wystarczą uprawnienia Stats: Read i Suppressions: Read, bez dostępu do wysyłki. Event Webhook konfigurujemy pod Settings > Mail Settings > Event Webhook: wpisujemy adres naszego endpointu i zaznaczamy zdarzenia, które chcemy odbierać. Dane lecą do nas jako JSON na każde zdarzenie: delivered, bounce, spam_report, deferred, dropped, unsubscribe. Statystyki agregowane (dzienne liczniki) dostępne przez GET /v3/stats z parametrami start_date, end_date, aggregated_by.
Mailgun: Panel pod app.mailgun.com, dokumentacja pod documentation.mailgun.com (REST, JSON). Klucz znajdziemy w Account > API Security > Private API key. Webhooki ustawiamy w sekcji Sending > Webhooks, osobno dla każdego typu zdarzenia: permanent_fail (hard bounce), temporary_fail (soft bounce), complained (zgłoszenie spamu), delivered, opened, clicked. Każde zdarzenie to osobna konfiguracja URL endpointu. Poza webhookami mamy też GET /v3/{domain}/events: paginowane logi wszystkich zdarzeń, przydatne do uzupełniania danych za okresy wcześniejsze.
Żeby w ogóle podłączyć webhooki, potrzebujecie:
- aktywnego konta (SendGrid Essentials lub wyżej, Mailgun Foundation lub wyżej),
- zweryfikowanej domeny nadawcy z rekordami SPF, DKIM i DMARC w DNS,
- endpointu na serwerze, który odbierze zdarzenia i zapisze je do bazy,
- klucza API z odpowiednimi uprawnieniami do odczytu.
Czego te serwisy nie udostępniają: treści wysłanego maila po fakcie (dostajecie tylko metadane zdarzenia), historii starszej niż 30 dni bez wyższego planu oraz szczegółowych informacji o tym, dlaczego konkretny dostawca pocztowy (np. Gmail, Onet) uznał mail za spam, bo to informacja po stronie odbiorcy, do której nadawca nie ma dostępu.
Jakie dane faktycznie zbieramy i co z nich widać
Z Event Webhook SendGrid dostajemy obiekt JSON z kluczowymi polami: event (typ zdarzenia), email (adres odbiorcy), reason (komunikat SMTP, np. "550 5.1.1 The email account that you tried to reach does not exist"), bounce_classification i timestamp. Pole bounce_classification to coś, z czym AI potrafi naprawdę pracować. SendGrid klasyfikuje odbicia jako: Generic, Mail Block, Bad Destination Mailbox Address, Spam Content, Reputation, Technical Failure. Ta ostateczna klasyfikacja po stronie SendGrid to już interpretacja kodu SMTP, nie surowy błąd.
"Bad Destination Mailbox Address" to martwy adres. "Reputation" oznacza, że serwer odbiorcy odrzucił mail ze względu na reputację IP nadawcy. "Spam Content" to sygnał, że treść maila trafiła na filtr po stronie odbiorcy. Każda z tych klas wymaga innej reakcji. AI potrafi to rozróżnić i napisać komunikat dla osoby odpowiedzialnej w firmie, zrozumiały bez znajomości protokołu SMTP.
Z Mailgun podobnie: pole event (failed, delivered, complained), recipient, reason, code (kod SMTP, np. 550, 421), severity (temporary albo permanent) oraz message.headers.subject, jeśli chcemy wiedzieć, który szablon sprawiał problemy. Połączenie kodu SMTP z polem severity od razu dzieli zdarzenia na te, które wymagają usunięcia adresu z listy, i te, gdzie wystarczy poczekać.
Statystyki agregowane uzupełniają obraz. Wahania dzień do dnia, które na wykresie w dashboardzie wyglądają jak normalny szum, AI potrafi zebrać w trend: czy wskaźnik doręczeń systematycznie spada od poniedziałku, czy to był jednorazowy skok po wysyłce do starej listy.
U jednego z klientów sklep B2B wysyłał kilkaset potwierdzeń zamówień dziennie. Przez kilkanaście dni liczba twardych odbić rosła bardzo powoli: kilka adresów z jednej domeny firmy kontrahenta. AI zauważyło wzorzec: ta sama domena odbiorcy, ten sam kod 550, ale różne osoby. Okazało się, że kontrahent zmienił serwer pocztowy i nie zaktualizował rekordów MX. Bez monitoringu webhooków nikt by tego nie wyłapał: system "wysyłał", licznik w dashboardzie sklepu wyglądał normalnie, a maile trafiały w pustkę od ponad tygodnia.
Co konkretnie robi AI z tymi danymi
Monitoring i diagnoza spadu doręczalności
AI porównuje dzienne statystyki doręczeń w oknie kilku lub kilkunastu dni i wykrywa odchylenie od normy. Patrzy na rozkład bounce_classification w tym samym oknie czasowym. Wzrost klasy "Reputation" oznacza inny problem niż wzrost "Bad Destination Mailbox Address". Pierwsze wymaga działań po stronie konfiguracji nadawcy (IP warming, uwierzytelnienie domeny, sprawdzenie list RBL). Drugie to czyszczenie listy adresatów. AI potrafi to rozróżnić i przesłać gotowy komunikat do osoby odpowiedzialnej za komunikację z klientami bez konieczności tłumaczenia, czym jest rekord SPF.
Porządkowanie listy odbitych adresów
Hard bounce'y powinny natychmiast lądować na liście supresji, bo wysyłanie powtórnie na te adresy niszczy reputację domeny. SendGrid prowadzi własną listę supresji (Suppressions > Bounces, endpoint GET /v3/suppression/bounces), Mailgun podobnie (GET /v3/{domain}/bounces). Problem w tym, że ta lista rośnie i nikt jej regularnie nie analizuje.
AI grupuje odbicia według domeny odbiorcy, sprawdza, czy adres pojawia się też w spam_reports, i patrzy, kiedy ostatni raz mail do tego adresu dotarł. Wynik to posortowana tabela: które adresy usunąć od razu, które sprawdzić ręcznie przez inny kanał (np. zadzwonić do klienta), a które mogły odrzucić mail tymczasowo i warto spróbować za kilka dni. Taki plik CSV można łatwo zaimportować do CRM-u albo systemu mailingowego i zaktualizować listę jednym ruchem.
Analiza i poprawa szablonów
Klasyfikacja "Spam Content" w polu bounce_classification SendGrid albo duża liczba zdarzeń complained w Mailgun to sygnał, że treść konkretnego szablonu trafia na filtry. AI skanuje HTML szablonu pod kątem zwrotów wysokiego ryzyka, sprawdza stosunek tekstu do grafiki oraz weryfikuje, czy pola subject i preheader nie zawierają znaków specjalnych używanych przez spamerów.
Jeden wzorzec, który się powtarza u firm korzystających z systemu ERP do generowania maili: faktury wysyłane jako obrazek JPG w treści maila, minimum tekstu HTML, link do pobrania pliku. Filtry antyspamowe oceniają taki układ nisko. AI wskazuje ten wzorzec i proponuje przebudowę szablonu przed kolejną wysyłką. To nie zastąpi testu w narzędziu do sprawdzania reputacji IP, ale pozwala złapać oczywiste problemy, zanim trafią do filtrów skrzynki odbiorczej.
Raport dla osoby bez technicznego tła
Surowe dane z webhooków to stosy JSON-ów z kodami SMTP. Mało który właściciel firmy chce to czytać. AI przetwarza te dane na tygodniowy raport: trend doręczalności względem poprzedniego tygodnia, lista domen z największą liczbą odbić, konkretne szablony z rosnącą liczbą spam_report, adresy do usunięcia z listy. Raport idzie mailem do właściciela albo pojawia się w panelu narzędzia. Jeśli coś się zmienia dramatycznie między raportami, AI może wypchnąć powiadomienie od razu.
Od czego zaczynamy: kroki do pierwszej roboczej integracji
Zanim AI zacznie analizować dane, trzeba je zbierać. Kolejność jest prosta:
- Sprawdzacie, przez który serwis idą Wasze maile transakcyjne. Może to być SendGrid, Mailgun, własny serwer SMTP lub inny dostawca. Jeśli to SendGrid albo Mailgun: możecie zacząć od razu.
- Zakładacie klucz API w panelu serwisu z uprawnieniami tylko do odczytu statystyk i supresji. Nie potrzebujecie uprawnień do wysyłki.
- Budujecie endpoint po stronie portalu: prosty URL, który odbiera zdarzenia z webhooka i zapisuje je do tabeli w bazie. Pola: event_type, email, reason, bounce_classification lub severity, timestamp, subject (żeby wiedzieć, który szablon).
- Rejestrujecie webhook w panelu serwisu. Zarówno SendGrid, jak i Mailgun mają opcję wysłania zdarzenia testowego bezpośrednio z panelu, żeby sprawdzić, czy endpoint odpowiada poprawnie.
- Dajecie AI dostęp do tej tabeli z instrukcją, żeby generował tygodniowy raport: trend doręczalności, lista adresów do supresji, bounce_classification z największym wzrostem względem poprzedniego okresu.
- Opcjonalnie: AI analizuje szablony HTML przed wysyłką i sprawdza subject każdego nowego szablonu pod kątem pól wysokiego ryzyka.
Konfiguracja klucza API i webhooka w panelu SendGrid albo Mailgun to coś, co można zrobić samemu w ciągu godziny. Endpoint odbierający zdarzenia i zapis do bazy to praca techniczna: kilka godzin pracy programisty albo gotowe narzędzie portalu skonfigurowane pod ten cel. Potem AI robi resztę: czyta bazę, porównuje, komentuje i informuje.
Warto zacząć od małego kroku: samo zebranie danych przez webhooki i wykres doręczalności dziennej to już ogromna zmiana w stosunku do patrzenia na licznik "sent" w systemie wysyłki. Firmy, które to wdrożyły, przestają dowiadywać się o problemach z maili od klientów, a zaczynają je widzieć same, zanim klient zdąży zadzwonić.
Chcecie zobaczyć, jak taka integracja wygląda na rzeczywistym przykładzie? Zajrzyjcie do realnych wdrożeń albo umówcie się na 15 minut rozmowy, żebyśmy mogli ocenić, jak to wygląda w Waszym systemie.
Chcecie to u siebie?
Na osobnej stronie rozpisaliśmy, co dokładnie podłączamy w SendGrid, o co możecie wtedy pytać asystenta i ile kosztuje wdrożenie.
Co podłączamy i ile to kosztuje →Najczęstsze pytania
Czy maile transakcyjne wysyłane przez SendGrid mogą trafić do spamu?
Tak. Nawet maile transakcyjne takie jak faktury czy potwierdzenia zamówień trafiają do spamu, jeśli domena nadawcy ma złą reputację, brakuje rekordów DKIM lub DMARC albo lista adresatów zawiera dużo nieaktywnych adresów. SendGrid zapisuje te zdarzenia jako spam_report w Event Webhook.
Czym różni się hard bounce od soft bounce w SendGrid i Mailgun?
Hard bounce (w Mailgun: severity "permanent") to trwały błąd: adres nie istnieje albo domena nie działa. Soft bounce (severity "temporary") to tymczasowy problem: skrzynka jest pełna lub serwer tymczasowo niedostępny. Hard bounce'y powinny natychmiast lądować na liście supresji, bo ponowne wysyłanie na takie adresy niszczy reputację Waszej domeny.
Czy SendGrid i Mailgun przechowują historię zdarzeń?
SendGrid na podstawowych planach przechowuje Activity Feed przez 3 dni, Mailgun zdarzenia przez 30 dni na płatnych planach. Dlatego warto od razu budować własną bazę zdarzeń po stronie portalu i zbierać dane przez webhooki, zamiast polegać na retencji u dostawcy.
Czy można podłączyć AI do SendGrid bez własnego programisty?
Do samego podłączenia API i webhooków potrzeba kogoś, kto postawi endpoint odbierający zdarzenia i połączy go z bazą danych. Nie jest to projekt na tygodnie, ale wymaga pracy technicznej. Konfigurację klucza API i webhooka w panelu SendGrid albo Mailgun można wykonać samemu, nawet bez programowania.
Czy AI zastąpi narzędzia do sprawdzania reputacji IP i domeny?
Nie w całości. AI dobrze radzi sobie z analizą trendów i danych z webhooków, ale do pełnej diagnozy reputacji IP przydają się zewnętrzne narzędzia jak Google Postmaster Tools czy MXToolbox. Można to połączyć: AI interpretuje dane z webhooków i wskazuje, gdzie szukać przyczyny, a narzędzia reputacyjne dają kontekst o stanie IP nadawcy.
Pokażemy to na Waszych danych z SendGrid
Jedno zdanie wystarczy: czego szukacie w SendGrid albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.
Opracowanie: zespół redAi z wykorzystaniem narzędzi AI.
Podłączymy SendGrid do AI u Was
15 minut rozmowy: mówicie, czego szukacie w danych, my mówimy, co wyciągniemy z SendGrid, ile to potrwa i czego potrzebujemy po Waszej stronie.
- Bezpłatna prezentacjaAI na Waszych zadaniach, nie na slajdach.
- Dostęp tego samego dniaZespół od razu pracuje we własnym portalu.
- Do 2 tygodni testówPłacicie dopiero po decyzji.
Może Was też zainteresować

Jak AI może sprawdzić status paczki, porównać koszty kurierów i przygotować reklamację w GlobKurier za Wasz sklep?

Jak AI może czytać procedury i tabele z Coda i Craft, żeby nikt w firmie nie szukał ręcznie?
