Serie e-maili i kampanie transakcyjne utworzysz teraz i będziesz nimi zarządzać przez API Quandy, tak samo jak prostą kampanią e-mailową. Programista połączy je bezpośrednio z CRM, ERP, DMS albo własnymi aplikacjami. Marketer dalej edytuje je w aplikacji jak dotąd.

W skrócie

  1. Serię e-maili (typ kampanii 30) i kampanię transakcyjną (typ 70) utworzysz jednym wywołaniem, powstanie kampania i pierwszy e-mail.
  2. Przez API zmienisz ustawienia, zarządzasz e-mailami, wyślesz test i kampanię aktywujesz, wstrzymasz i wznowisz.
  3. Serię uruchomisz wywołaniem aktywacji z datą startu o pełnej godzinie i odstępem od 1 do 60 dni.
  4. Test wyślesz na maksymalnie 3 adresy, a HTML musi zawierać znacznik {{ unsubscribe_link }}.
  5. Trwającą kampanię edytujesz dopiero po wstrzymaniu, przed aktywacją przechodzi te same kontrole co w aplikacji.

W skrócie: co jest nowe, od kiedy, kogo dotyczy i gdzie to znajdziesz

  • Co jest nowe: API oprócz prostej kampanii obsługuje teraz dwa kolejne typy kampanii, serię e-maili i kampanię transakcyjną.
  • Od kiedy: od 20 listopada 2026.
  • Kogo dotyczy: programistów i integratorów, którzy łączą Quandę z CRM, ERP, DMS albo własnymi aplikacjami, oraz marketerów, którzy korzystają z serii i e-maili transakcyjnych.
  • Czego nie obejmuje: kampanii urodzinowych, rocznicowych, logicznych i z testami A/B oraz ustawień automatyzacji.
  • Gdzie to znajdziesz: w dokumentacji API w języku angielskim, w częściach Email series i Transactional emails. Link do niej znajdziesz w artykule Dokumentacja API i klucz API.
Schemat serii e-maili sterowanej przez API Quandy: Twój system, na przykład CRM, ERP, DMS albo własne aplikacje, wywołaniami API tworzy serię, dodaje części i ją aktywuje. Seria wysyła potem kontaktom z etykietą Nowi klienci część 1 na starcie, część 2 po 3 dniach i część 3 po 6 dniach.
Twój system tworzy, uzupełnia i uruchamia serię przez API, a części wychodzą potem w ustawionym odstępie.

Co nowego w API dla serii e-maili i e-maili transakcyjnych

API Quandy potrafi teraz utworzyć serię e-maili i kampanię transakcyjną oraz nimi zarządzać. Dotąd przez API można było utworzyć, edytować, przetestować i wysłać tylko prostą kampanię e-mailową. Serie i e-maile transakcyjne tworzyło się wyłącznie w aplikacji.

API to interfejs, przez który dwa systemy przekazują sobie dane bez ręcznego klikania. Seria e-maili, nazywana też sekwencją e-maili albo kampanią drip, to ciąg e-maili, które kontakty z wybranymi etykietami dostają po kolei w odstępie podanej liczby dni. E-mail transakcyjny przygotujesz w Quandzie wcześniej, a wyjdzie w chwili, gdy kontakt spełni warunek, na przykład po zamówieniu.

Co teraz zrobisz przez API:

  • Utworzenie jednym wywołaniem. Wywołanie to jedno żądanie Twojego systemu do API. Powstaje nim kampania i jej pierwszy e-mail, tak samo jak przy prostej kampanii.
  • Zarządzanie oboma typami kampanii. Zmienisz ustawienia kampanii, dodasz, edytujesz i usuniesz e-mail oraz odczytasz listę e-maili. Wyślesz e-mail testowy i kampanię aktywujesz, wstrzymasz i wznowisz.
  • Ustawienia serii. Etykiety kontaktów, do których seria trafia, odstęp między częściami od 1 do 60 dni, data i godzina startu oraz kolejność części. Do tego status części i etykiety, które kontakt dostanie albo straci po wysłaniu części.
  • E-mail testowy serii. Wybierasz wszystkie części, tylko części edytowane dzisiaj albo wybrane części, tak jak w aplikacji. Test wyślesz na maksymalnie 3 adresy.
  • Treść e-maila. Wysyłasz ją jako HTML albo tworzysz ją z szablonu.
  • Dostępność. API jest w Pakiecie na miarę we wszystkich planach, w wariancie Tylko e-maile w planach Professional i Enterprise, zobacz cennik.
  • Praca z asystentem AI. Serie e-maili i kampanie transakcyjne może utworzyć i obsługiwać także asystent AI połączony przez Quanda MCP server.

Inne możliwości połączenia, w tym gotowe integracje bez programowania, opisuje instrukcja Połącz Quandę ze swoją stroną, systemem CRM albo innym oprogramowaniem.

Do czego wykorzystasz serie e-maili i e-maile transakcyjne przez API

API opłaca się wszędzie tam, gdzie kampanie powstają albo zmieniają się na podstawie danych z innego systemu. Nikt wtedy nie musi ręcznie tworzyć ani przepisywać kampanii w aplikacji. Trzy typowe sytuacje:

Seria powitalna tworzona z CRM. System CRM sam tworzy serię powitalną dla nowych klientów. Jednym wywołaniem powstaje kampania z pierwszą częścią, kolejnymi wywołaniami system dodaje kolejne części. Ustawia etykietę nowych klientów, odstęp i start. Marketer potem sprawdza serię w aplikacji i ją aktywuje. Co jeszcze potrafią serie w Quandzie, pokazuje strona E-mail marketing.

E-mail transakcyjny zarządzany z własnego systemu. Gdy zmieni się tekst e-maila transakcyjnego, na przykład potwierdzenia zamówienia, Twój system edytuje go przez API i wysyła sobie test. Jak przygotować e-mail transakcyjny w aplikacji, opisuje instrukcja E-maile transakcyjne dla automatyzacji.

Masowa edycja części serii. We wszystkich częściach musisz zmienić stopkę albo link. Skrypt odczyta listę e-maili, edytuje każdą część i ustawi jej status do sprawdzenia. Współpracownik potem przejrzy je w aplikacji i oznaczy jako sprawdzone.

Jak utworzyć serię e-maili przez API

Serię przez API utworzysz i uruchomisz w sześciu krokach. Każdy krok to jedno albo kilka wywołań, a każde wywołanie wysyłasz z kluczem API w nagłówku. Seria pozostaje w stanie W budowie i nic nie wysyła, dopóki jej nie aktywujesz.

  1. Utwórz serię. Wywołaniem POST /api/newsletter/campaigns/30/ wysyłasz nazwę kampanii, kierownika projektu, nadawcę, język, temat i treść pierwszej części jako HTML albo z szablonu. Powstanie kampania i pierwsza część.
  2. Dodaj kolejne części. Każdą część dodasz osobnym wywołaniem i w razie potrzeby zmienisz ich kolejność.
  3. Ustaw odbiorców. Podaj etykiety kontaktów, do których seria trafia. Opcjonalnie dodaj etykiety, które kontakt dostanie albo straci po wysłaniu części.
  4. Oznacz status części. Każda część ma status w przygotowaniu, do sprawdzenia, sprawdzona albo gotowa.
  5. Wyślij e-mail testowy. Wybierz wszystkie części, tylko części edytowane dzisiaj albo wybrane części. Test wyślesz na maksymalnie 3 adresy.
  6. Aktywuj serię. Wywołaniem POST /api/newsletter/campaigns/{campaign_id}/activate/ wysyłasz datę i godzinę startu oraz odstęp od 1 do 60 dni. Start musi być dzisiaj albo później i o pełnej godzinie. Przed aktywacją kampania przechodzi te same kontrole co w aplikacji: zweryfikowany e-mail i domena nadawcy, poprawność treści i kontrola spamu.

Tak wygląda wywołanie aktywacji, które uruchomi serię 1 grudnia 2026 o 9:00 z odstępem 3 dni:

POST https://api.onquanda.com/api/newsletter/campaigns/{campaign_id}/activate/
content-type: application/json
authorization: Token TWOJ_KLUCZ_API

{"start_at": "2026-12-01T09:00:00", "period": 3}

Kampanię transakcyjną utworzysz wywołaniem POST /api/newsletter/campaigns/70/ i dalej zarządzasz nią podobnymi wywołaniami jak serią. Seria utworzona przez API to zwykła kampania, dalej edytujesz ją także w aplikacji. Działa to również odwrotnie.

Lista części serii e-maili w aplikacji Quanda: tabela Część 1 do Część 3 ze strzałkami do zmiany kolejności oraz kolumnami Nazwa e-maila, Temat e-maila, Utworzono, Zaktualizowano, Wysłano i Ustawienia.
Części serii w Edytorze poczty e-mail. Tak samo wygląda seria utworzona przez API.

Na co uważać przy zmianach przez API

Dla serii i kampanii transakcyjnych przez API obowiązują te same zasady bezpieczeństwa co w aplikacji. Pilnuj przede wszystkim tych pięciu.

  • Przed edycją wstrzymaj kampanię. Trwającej kampanii nie da się edytować. Najpierw ją wstrzymaj, edytuj, a potem wznów, tak samo jak w aplikacji.
  • Link do wypisania się. HTML e-maila musi zawierać znacznik {{ unsubscribe_link }}. Znacznik to tekst zastępczy, w miejsce którego Quanda przy wysyłce wstawi link do wypisania się.
  • Nowa data po przegapionym terminie. Gdy przy wstrzymanej serii w międzyczasie minie termin kolejnej wysyłki, przy wznowieniu podasz nową datę startu i odstęp, i to wywołaniem aktywacji. W aplikacji to samo opisuje instrukcja Ustawienie wysyłki serii e-maili.
  • Wysyłaj żądania po kolei. Z jednym kluczem API wysyłaj żądania jedno po drugim, nie równolegle. Między końcem jednego a początkiem kolejnego żądania jest przerwa 30 ms, a przy zbyt częstym dostępie API zwróci kod 429 i żądanie trzeba powtórzyć. Pilnuj tego zwłaszcza w skrypcie, który zmienia wszystkie części serii naraz.
  • Nowa wersja e-maila. Gdy w uruchomionej kampanii zmienisz linki w e-mailu, który już wyszedł, powstanie nowa wersja e-maila. Statystyki wysłanej wersji zostaną zachowane.
Ustawienie daty startu i odstępu serii w Quandzie: strona Wysyłka z polami dla odbiorców testu, wyborem Wszystkie części albo Wybrane części i sekcją Wysyłanie kampanii z polami Data, Czas i Następny e-mail w.
Data, godzina i odstęp części w aplikacji. Przez API wyślesz je wywołaniem aktywacji.

Co się nie zmienia w API

Nowość tylko dodaje nowe wywołania, dotychczasowe integracje działają dalej bez zmian. Konkretnie:

  • API dla prostych kampanii działa bez zmian.
  • Endpointy, czyli adresy, na które Twój system wysyła wywołania, pozostają takie same.
  • Wysyłka e-maili transakcyjnych do pojedynczych odbiorców przez API działa jak dotąd.
  • Aplikacja działa tak samo jak dotąd.

Częścią tego wydania nie są kampanie urodzinowe, rocznicowe, logiczne i z testami A/B. Przez API nie ustawisz też automatyzacji.

Serie e-maili i e-maile transakcyjne przez API: podsumowanie

Serie i kampanie transakcyjne utworzysz teraz i będziesz nimi zarządzać przez API tak samo jak prostą kampanią i według tych samych zasad co w aplikacji. Wszystkie wywołania, pola i odpowiedzi z błędami opisuje dokumentacja API w języku angielskim w częściach Email series i Transactional emails. Link do niej i instrukcję, jak uzyskać klucz API, znajdziesz w artykule Dokumentacja API i klucz API. Ustawienia serii w aplikacji opisuje instrukcja Jak utworzyć i skonfigurować serię e-maili.

Z połączeniem pomoże Ci nasze wsparcie pod adresem support@onquanda.com lub pod numerem +48 886 080 501.

Zespół Quanda