NetSendo
Platform Updates

NetSendo v2.12.2: koniec z kampaniami z niewłaściwej skrzynki

NetSendo Team5 min czytania

Adres nadawcy to część Twojej marki. Gdy subskrybenci widzą maila z firmowego newslettera, ufają mu. Jeśli ta sama wiadomość przychodzi z adresu zamówień sklepu albo z adresu, którego nie znają, są zdezorientowani, wypisują się, a część zgłasza ją jako spam. Może też ucierpieć reputacja nadawcy.

NetSendo v2.12.2 naprawia błąd, który do tego prowadził. Jeśli skrzynka kampanii nie może wysyłać broadcastów, NetSendo nie wysyła jej już po cichu z innego adresu. Zatrzymuje kampanię i mówi, dlaczego.

TL;DR: W NetSendo v2.12.2 (wydanie z 2026-11-22) kampania, której skrzynka nie może wysyłać broadcastów (skrzynka Gmail albo skrzynka z wyłączonym typem One-time (Broadcast)), jest odrzucana przed kolejkowaniem. Wcześniej wychodziła z innej skrzynki. API zwraca 422 Mailbox Not Allowed, panel pokazuje błąd przy polu skrzynki, a jeśli skrzynka straci uprawnienie po zakolejkowaniu, te wpisy kończą się błędem z podaną przyczyną. Nie są wysyłane z innego adresu.

🚀 Co nowego w v2.12.2

Problem: wysyłka z niewłaściwego adresu bez ostrzeżenia

Wersja 2.12.1 zablokowała już takie przekierowanie dla wysyłek transakcyjnych przez POST /api/v1/email/send i /email/batch. Kampanii (wiadomości typu broadcast) błąd jednak nadal dotyczył. Jeśli kampania korzystała ze skrzynki Gmail albo ze skrzynki z wyłączonym typem One-time (Broadcast), wychodziła z pierwszej skrzynki, która mogła wysyłać broadcasty.

Działo się tak niezależnie od tego, czy kampanię wysłano przez send_campaign, zaplanowano przez schedule_campaign, czy uruchomiono z panelu. Na jednym koncie trzy kampanie do listy z jedną osobą wyszły z adresu sklepu.

To tak, jakbyś nadał list z własnym adresem zwrotnym, a urzędnik podmienił go na cudzy, bo Twojego „nie ma na liście”. List dociera, ale odbiorca widzi niewłaściwego nadawcę.

Poprawka: zatrzymanie kampanii przed kolejkowaniem

🛑

Sprawdzenie przed kolejkowaniem

Kampania ze skrzynką, która nie może wysyłać broadcastów, jest zatrzymywana, zanim jakakolwiek wiadomość trafi do kolejki.

🔌

Czytelny błąd API

422 Mailbox Not Allowed podaje skrzynkę i wskazuje właściwe narzędzie.

🖥️

Błąd w panelu

Komunikat pojawia się przy polu skrzynki, gdy wysyłasz lub planujesz kampanię.

🧾

Błąd z przyczyną

Jeśli skrzynka straci uprawnienie po zakolejkowaniu, wpis kończy się błędem z przyczyną. Nie jest wysyłany z innego adresu.

Jak odpowiada API

Gdy wywołasz send_campaign lub schedule_campaign dla kampanii, której skrzynka nie może wysyłać broadcastów, dostaniesz kod HTTP 422 z komunikatem Mailbox Not Allowed. Odpowiedź podaje skrzynkę i podpowiada, czego użyć zamiast tego:

  • send_email, jeśli chcesz napisać do jednej osoby
  • send_campaign_test, jeśli chcesz zobaczyć podgląd

Tak Twoja integracja może obsłużyć ten błąd (uproszczona pseudologika, nie dokładna treść odpowiedzi):

if (response.status === 422) {
  // Mailbox Not Allowed: nie ponawiaj tego samego żądania.
  // Wybierz skrzynkę, która może wysyłać broadcasty,
  // albo użyj send_email (jedna osoba) / send_campaign_test (podgląd).
  notifyOperator(response.body);
}
ℹ️ Uwaga: W panelu szkic może nadal używać skrzynki, która nie wysyła broadcastów. Sprawdzenie działa dopiero przy wysyłce lub planowaniu kampanii.

Co się nie zmieniło

W tych przypadkach nadal działa przejście na inną skrzynkę, tak jak wcześniej:

  • ✅ Kampania bez własnej skrzynki, która bierze ją z listy lub z domyślnych ustawień konta
  • ✅ Pełna skrzynka
  • ✅ Autorespondery

💼 Korzyści i przypadki użycia

🛒

E-commerce: newslettery osobno, zamówienia osobno

Wiele sklepów używa jednego adresu do potwierdzeń zamówień, a innego do promocji. Dzięki v2.12.2:

  • kampanie promocyjne nie mogą wyjść z adresu zamówień,
  • klienci dostają newslettery i maile o zamówieniach z adresów, których się spodziewają,
  • wysyłki masowe nie wpływają na reputację nadawcy transakcyjnego.
🤖

SaaS i agenci AI: błędy, z którymi można coś zrobić

Jeśli używasz skryptów lub asystentów AI do uruchamiania send_campaign i schedule_campaign, czytelny błąd 422 jest lepszy niż wysyłka, która wygląda na udaną, ale wyszła z niewłaściwego adresu. Błąd wskazuje send_email dla wiadomości do jednej osoby, np. maili onboardingowych, oraz send_campaign_test dla podglądów. Twoje narzędzia mogą same wybrać właściwy następny krok.

🏢

Agencje: bez pomylonych nadawców klientów

Gdy jedna instancja NetSendo obsługuje skrzynki kilku marek, wysyłka z niewłaściwego adresu to poważny błąd. Dzięki tej poprawce kampania jednego klienta nie wyjdzie ze skrzynki innego klienta z powodu ustawienia broadcastu.

🛠️ Krok po kroku: sprawdź konfigurację po aktualizacji

  1. Zaktualizuj NetSendo

    Pobierz najnowszy obraz i uruchom ponownie stos:

    docker compose pull
    docker compose up -d
  2. Przejrzyj skrzynki

    Otwórz ustawienia skrzynek i sprawdź, które mają włączony typ One-time (Broadcast). Skrzynki Gmail nie mogą wysyłać kampanii, więc zaplanuj wysyłkę kampanii z innej skrzynki.

  3. Sprawdź zaplanowane kampanie

    Przejrzyj kampanie, które są już zaplanowane lub w kolejce. Jeśli skrzynka kampanii nie może wysyłać broadcastów, jej wpisy zakończą się teraz błędem z przyczyną. Nie zostaną wysłane z innego adresu. Przypisz takim kampaniom skrzynkę, która może wysyłać broadcasty.

  4. Zaktualizuj integracje

    Upewnij się, że Twoje klienty API i automatyzacje obsługują 422 Mailbox Not Allowed. Powinny powiadomić kogoś i nie ponawiać tego samego żądania.

  5. Przetestuj podgląd

    Użyj send_campaign_test, aby sprawdzić kampanię przed wysyłką lub zaplanowaniem.

⚠️ Częsty błąd: Kampanie, które wcześniej „działały”, mogą teraz zostać odrzucone. Nigdy nie wychodziły z wybranej skrzynki, tylko z innej. Popraw wybór skrzynki. Nie próbuj obchodzić błędu.

🎯 Wskazówki ekspertów

1
Osobne skrzynki do różnych zadań

Oddziel skrzynki transakcyjne od skrzynek do broadcastów. Włączaj One-time (Broadcast) tylko tam, gdzie chcesz wysyłać masowo.

2
Używaj właściwego narzędzia

Do jednej osoby pisz przez send_email. Nie twórz broadcastu do listy z jedną osobą.

3
Obserwuj wpisy z błędem

Wpisy zakończone błędem z przyczyną pokazują, że coś wymaga uwagi. Sprawdzaj je regularnie, zwłaszcza po zmianie ustawień skrzynek.

4
Ostrożnie ze zmianą ustawień skrzynek

Wyłączenie broadcastu w skrzynce z kampaniami w kolejce sprawi, że te wpisy zakończą się błędem. Najpierw przypisz kampanie do innej skrzynki.

✅ Podsumowanie

v2.12.2 to małe, ale ważne wydanie. Twoje kampanie wychodzą ze skrzynki, którą wybrałeś, albo nie wychodzą wcale. Dostajesz czytelny błąd w API, komunikat przy polu skrzynki w panelu i wpisy z błędem z podaną przyczyną, więc problemy nie przechodzą już niezauważone. Ponieważ NetSendo działa na Twoim serwerze, dane, skrzynki i konfiguracja wysyłki pozostają pod Twoją kontrolą.

Zaktualizuj do v2.12.2

Przeczytaj dokumentację, sprawdź integracje albo zainstaluj NetSendo przez Dockera. Jeśli ta poprawka oszczędzi Ci kłopotów, daj nam gwiazdkę na GitHubie.

#release#bug-fix#campaigns#mailboxes#api#deliverability
Udostępnij