NetSendo v2.12.1: bezpieczniejsze importy i właściwi nadawcy w API
Wyobraź sobie taką sytuację: przenosisz 15 000 kontaktów ze starej platformy do NetSendo. Import się kończy, a twoje konto SMTP zaczyna wysyłać do ciebie 15 000 e-maili „Nowy subskrybent na liście”. Limit wysyłki się wyczerpuje. Gmail zaczyna greylistować domenę, którą rozgrzewałeś przez kilka tygodni. Zwykła migracja zaszkodziła twojej dostarczalności.
Przytrafiło się to prawdziwemu użytkownikowi NetSendo, a v2.12.1 to naprawia. Wydanie usuwa też mniej widoczny błąd w transakcyjnym API: e-maile mogły wychodzić z innej skrzynki niż ta, którą wskazałeś. Jeśli wysyłasz przez API albo narzędzie MCP send_email, warto zaktualizować.
POST /api/v1/email/send używa wskazanej skrzynki albo zwraca jasny błąd i nigdy nie podmienia jej po cichu na inną.
🚀 Co nowego w v2.12.1
Ciche operacje masowe
Importy, masowe dodawanie/kopiowanie/przenoszenie i wsadowe wywołania API nie wysyłają już e-maila do administratora przy każdym kontakcie.
Przełącznik dla całego konta
Jedno ustawienie wyłącza powiadomienia o nowych subskrybentach na wszystkich listach konta.
Właściwi nadawcy w API
E-maile z API wychodzą ze wskazanej skrzynki albo wcale. Koniec z cichymi podmianami.
Nowość: „Powiadamiaj mnie o nowych subskrybentach”
W Ustawienia → Domyślne → Subskrypcja znajdziesz nowy przełącznik. Wyłącza on e-mail „Nowy subskrybent na liście” od razu dla wszystkich list na koncie. Ustawienie jest zapisywane jako settings.subscription.notify_admin i można je też zmienić przez API:
curl -X PUT https://your-netsendo.example/api/v1/settings/list-defaults \
-H "Authorization: Bearer $NETSENDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"subscription": {"notify_admin": false}}'
ℹ️ Uwaga: Przełącznik jest domyślnie włączony, więc nic się nie zmienia, dopóki go nie wyłączysz. Aby wyciszyć tylko jedną listę, użyj Ustawienia → E-maile systemowe. Treść żądania powyżej to tylko przykład. Dokładny format znajdziesz w dokumentacji API.
Poprawka: importy nie zasypują już skrzynki
Powiadomienie dla administratora działa jak dzwonek do drzwi. Przydaje się, gdy przychodzi jeden gość, ale nie wtedy, gdy wchodzi cały stadion. Powiadomienia administratora są teraz pomijane przy:
- importach CSV, zarówno w panelu, jak i przez
POST /api/v1/lists/{id}/import - masowym dodawaniu, kopiowaniu i przenoszeniu subskrybentów
- przenoszeniu kontaktów przy usuwaniu listy
- endpointach członków list w API oraz
POST /api/v1/subscribers/batch
Zmiana dotyczy tylko powiadomień administratora. Autorespondery, automatyzacje i webhooki nadal działają zgodnie z opcjami wybranymi przy imporcie.
Poprawka: puste pole „E-mail do powiadomień”
Puste pole E-mail do powiadomień sugerowało, że powiadomienia są wyłączone. W rzeczywistości nadal trafiały na adres e-mail konta. Pole teraz to wyjaśnia i pokazuje, gdzie naprawdę wyłączyć powiadomienia.
Poprawka: e-maile z API wysyłane z niewłaściwej skrzynki
To najpoważniejszy błąd naprawiony w tym wydaniu. Skrzynki Gmail nie mogą wysyłać broadcastów, ale POST /api/v1/email/send (oraz MCP send_email) zapisywał każdy e-mail jako broadcast. W trakcie wysyłki zadanie zastępowało skrzynkę Gmail pierwszą skrzynką, która mogła wysyłać broadcasty. Tymczasem API zdążyło już odpowiedzieć „queued” z nazwą skrzynki Gmail. Na jednym koncie w ciągu dwóch tygodni sześć prywatnych e-maili wyszło z adresu sklepu.
Co dzieje się teraz:
- Takie e-maile są zapisywane jako wiadomości indywidualne (
messages.is_individual, kolumna dodana przez automatyczną migrację). - Może je wysłać każda skrzynka, która obsługuje broadcasty lub autorespondery, także Gmail. E-mail wychodzi z tej skrzynki albo wcale.
- Jeśli wskazana skrzynka nie może wysłać e-maila, dostajesz odpowiedź
422z listą jejallowed_types. - Jeśli przed wysyłką skrzynka zostanie wyłączona, straci te typy albo przekroczy dzienny limit, wpis kończy się błędem z zapisaną przyczyną.
POST /api/v1/email/batchzwraca teraz422dla wskazanej skrzynki, która nie może wysyłać broadcastów. Nie podmienia już skrzynki.- Oba endpointy zwracają teraz faktycznego nadawcę jako
mailbox_idifrom_email.
{
"status": "queued",
"mailbox_id": 4,
"from_email": "anna@yourcompany.com"
}
💼 Korzyści i przypadki użycia
E-commerce: migracja bazy klientów
Przenosisz 50 000 klientów sklepu z innego ESP. Dzięki v2.12.1 możesz:
- zaimportować CSV bez zużywania limitu SMTP na powiadomienia dla administratora
- chronić reputację świeżo rozgrzanej domeny wysyłkowej
- nadal uruchomić sekwencję posprzedażową lub reaktywacyjną, jeśli zechcesz
SaaS: osobiste e-maile onboardingowe przez API
Twoja aplikacja wysyła e-maile onboardingowe „od założyciela” ze skrzynki Gmail przez API albo agenta AI korzystającego z MCP:
- każdy e-mail wychodzi teraz ze wskazanej skrzynki, więc nie przychodzi z ogólnego ani niewłaściwego adresu
- możesz sprawdzić
from_emailw odpowiedzi, zanim zapiszesz wysyłkę w logach - kod
422od razu pokazuje, że skrzynka jest źle skonfigurowana
Agencje: wielu klientów, jedna instancja
Agencje, które synchronizują kontakty masowo przez /subscribers/batch, nie zasypują już skrzynek klientów powiadomieniami. Przy wdrażaniu nowego klienta mogą też wyłączyć powiadomienia dla całego konta jednym wywołaniem API.
🛠️ Krok po kroku: aktualizacja i konfiguracja v2.12.1
- Zrób kopię zapasową i zaktualizuj
Zrób kopię bazy danych, a potem pobierz nowy obraz. Kolumnę
messages.is_individualdoda automatyczna migracja.docker compose pull docker compose up -d - Zdecyduj o powiadomieniach dla całego konta
Otwórz Ustawienia → Domyślne → Subskrypcja. Jeśli nie chcesz powiadomień o każdym nowym subskrybencie, wyłącz „Powiadamiaj mnie o nowych subskrybentach”. Zobaczysz przełącznik z krótkim opisem.
- Sprawdź ustawienia poszczególnych list
Jeśli chcesz wyciszyć tylko jedną listę, użyj zamiast tego Ustawienia → E-maile systemowe.
- Sprawdź pole „E-mail do powiadomień”
Pamiętaj, że puste pole oznacza wysyłkę powiadomień na e-mail konta. Nie oznacza, że powiadomienia są wyłączone.
- Przejrzyj integracje z API
Sprawdź każde wywołanie
email/sendiemail/batch, które wskazuje skrzynkę. Obsłuż odpowiedzi422i zapisuj w logachmailbox_idorazfrom_email.
⚠️ Częsty problem: Integracje, które dotąd „po prostu działały” ze skrzynką Gmail wemail/batch, mogą teraz dostawać422. Te e-maile przez cały czas wychodziły z innej skrzynki. Wskaż skrzynkę, która może wysyłać broadcasty, albo użyjemail/senddo e-maili indywidualnych.
🎯 Wskazówki eksperta
🎯 Wskazówki eksperta
Przy dużych listach wyłącz e-maile do administratora i wysyłaj zdarzenia o nowych subskrybentach przez webhooki NetSendo do Slacka lub CRM-u za pomocą n8n. Dostajesz te same dane bez zużywania limitu SMTP.
Porównuj from_email z oczekiwanym nadawcą i zgłaszaj alert, gdy się różnią. To jedna linijka kodu, a wyłapuje zmiany w konfiguracji.
allowed_types jako wskazówkę do konfiguracjiGdy dostaniesz 422, zapisz allowed_types w logach. Dzięki temu zespół poprawi ustawienia skrzynki, zamiast ponawiać wysyłkę na ślepo.
E-maile wysyłane po imporcie (autorespondery, sekwencje powitalne) nadal liczą się do limitów skrzynki. Przy rozgrzewaniu nowej domeny rozłóż je na etapy.
✅ Podsumowanie
v2.12.1 to małe wydanie, które mocno wpływa na dostarczalność i zaufanie. Operacje masowe nie zasypują już skrzynki ani nie zużywają limitu SMTP. Jeden przełącznik steruje powiadomieniami o nowych subskrybentach dla całego konta. E-maile z API wychodzą teraz ze wskazanej skrzynki albo kończą się jasnym błędem. Ponieważ NetSendo działa na twoim serwerze, możesz od razu wdrożyć te poprawki, a dane i konfiguracja wysyłki pozostają pod twoją kontrolą.
Zaktualizuj do v2.12.1 już dziś
Przeczytaj pełną dokumentację API, połącz swoje narzędzia albo uruchom nową instancję:
NetSendo ci się przydaje? Daj nam gwiazdkę na GitHubie i przeczytaj pełne informacje o wydaniu.



