Przejdź do treści
StayPark Suite · Pomoc
StayPark Suite · Pomoc
Zamknij menu
Szukaj w pomocy Ctrl K
Wprowadzenie Przewodniki Panel - obsługa Portal i aplikacje Wdrożenie i konfiguracja Integracje i API Nowości
Pomoc
Wdrożenie i konfiguracja
Integracje
Poczta i Mailgun

Poczta i Mailgun

Jak podłączyć wysyłkę poczty przez Mailgun - domena, rekordy DNS, klucze, zmienne środowiskowe i webhooki statusów.

Wdrożeniowiec

Zaktualizowano 2 listopada 2026

Na tej stronie
Podświetlone słowa z wyszukiwania: ()

Cała poczta wychodząca idzie przez Mailgun. Wpis w dzienniku poczty powstaje, zanim wiadomość trafi na kolejkę, więc w panelu widać także te, które nie zostały wysłane. Statusy (doręczona, otwarta, odrzucona) przychodzą z Mailguna webhookiem.

Zanim zaczniesz

  • Konto Mailgun z dostępem do ustawień domeny i kluczy.
  • Dostęp do DNS domeny, z której ma wychodzić poczta.
  • Dostęp do zmiennych środowiskowych aplikacji panelu.

Krok po kroku

  1. W Mailgunie przejdź do Sending › Domains › Add New Domain i dodaj subdomenę, np. mg.twojadomena.pl. Wybierz region EU.
  2. Dodaj w DNS wszystkie rekordy, które pokaże Mailgun, i poczekaj, aż każdy będzie zielony.
  3. Skopiuj dwa klucze: Sending API key (Settings › API Keys) i HTTP webhook signing key (Settings › Webhooks).
  4. Wpisz zmienne środowiskowe panelu (poniżej) i wyczyść cache konfiguracji.
  5. W Mailgunie przejdź do Settings › Webhooks › Add webhook i dodaj adres webhooka dla każdego zdarzenia z listy.
  6. Wyślij wiadomość testową z oprawy e-maili marki (Konfiguracja › Marki, zakładka Oprawa emaili) i sprawdź jej status w Komunikacja › Poczta wychodząca.

Użyj subdomeny, nie domeny głównej - reputacja poczty marketingowej nie obniży wtedy reputacji poczty firmowej. Region musi się zgadzać z MAILGUN_ENDPOINT.

Rekordy DNS

Rekord Po co
TXT (SPF) zezwala serwerom Mailguna wysyłać w imieniu domeny
TXT (DKIM) podpisuje wiadomości - bez niego poczta trafia do spamu
MX potrzebny tylko wtedy, gdy odpowiedzi mają wracać przez Mailguna
CNAME śledzenie otwarć i kliknięć na własnej domenie

Dodaj też rekord DMARC na domenie głównej. Zacznij od v=DMARC1; p=none; rua=mailto:..., a po kilku tygodniach obserwacji zaostrz go do p=quarantine.

Zmienne środowiskowe

.env
MAIL_MAILER=mailgun

MAILGUN_DOMAIN=mg.twojadomena.pl
MAILGUN_SECRET=key-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MAILGUN_ENDPOINT=api.eu.mailgun.net
MAILGUN_WEBHOOK_SIGNING_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

MAILGUN_TRACK_OPENS=true
MAILGUN_TRACK_CLICKS=false

MAIL_SYSTEM_FROM_ADDRESS=system@mg.twojadomena.pl
MAIL_SYSTEM_FROM_NAME="StayPark Suite"

Po zmianie wyczyść cache konfiguracji:

php artisan config:clear

Webhooki

Adres webhooka to https://<adres panelu>/webhooks/mailgun - ten sam dla wszystkich zdarzeń. Podepnij go pod zdarzenia: Delivered Messages, Opened, Clicked, Permanent Failure, Temporary Failure, Complained, Unsubscribed.

Efekt

Wiadomości wychodzą z domeny Mailguna, a w Komunikacja › Poczta wychodząca każda ma status i oś zdarzeń uzupełnianą przez webhooki.

Częste problemy

Wiadomości wychodzą, ale nie mają statusów

Webhook nie dociera do panelu. Adres musi być publiczny i po HTTPS - Mailgun nie dosięgnie serwera w sieci lokalnej. Sprawdź też klucz: żądanie bez poprawnego podpisu dostaje odpowiedź 406 i nie zmienia dziennika.

Wiadomość stoi na „W kolejce”

Wiadomość nie doszła do Mailguna. Sprawdź, czy na serwerze działa przetwarzanie kolejki default - z niej wychodzi poczta (zmienna MAIL_QUEUE).

Pomylone klucze

To najczęstsze źródło błędów. Potrzebne są dwa różne klucze: Sending API key w MAILGUN_SECRET (wysyłka) i HTTP webhook signing key w MAILGUN_WEBHOOK_SIGNING_KEY (podpis webhooków).

Brak wyników