E-mailové seriály a transakční kampaně nově založíte a spravujete přes API Quandy, stejně jako jednoduchou e-mailovou kampaň. Vývojář je napojí přímo na CRM, ERP, DMS nebo vlastní aplikace. Marketér je pak dál upravuje v aplikaci jako dosud.

V kostce

  1. E-mailový seriál (typ kampaně 30) i transakční kampaň (typ 70) založíte jedním voláním, vznikne kampaň i první e-mail.
  2. Přes API změníte nastavení, spravujete e-maily, pošlete test a kampaň aktivujete, pozastavíte a obnovíte.
  3. Seriál spustíte voláním aktivace s datem startu v celou hodinu a periodou 1 až 60 dní.
  4. Test jde nejvýše na 3 adresy a HTML musí obsahovat značku {{ unsubscribe_link }}.
  5. Probíhající kampaň upravíte až po pozastavení, před aktivací proběhnou stejné kontroly jako v aplikaci.

Stručně: co je nové, od kdy, koho se to týká a kde to najdete

  • Co je nové: API kromě jednoduché kampaně nově umí dva další typy kampaní, e-mailový seriál a transakční kampaň.
  • Od kdy: od 20. listopadu 2026.
  • Koho se to týká: vývojářů a integrátorů, kteří napojují Quandu na CRM, ERP, DMS nebo vlastní aplikace, a marketérů, kteří seriály a transakční e-maily používají.
  • Co součástí není: narozeninové, výroční, logické a A/B kampaně a nastavení automatizací.
  • Kde to najdete: v API dokumentaci v částech E-mailový seriál a Transakční e-maily.
Schéma e-mailového seriálu řízeného přes API Quanda: váš systém, například CRM, ERP, DMS nebo vlastní aplikace, voláním API založí seriál, přidá díly a aktivuje ho. Seriál pak kontaktům se štítkem Noví zákazníci pošle 1. díl při startu, 2. díl za 3 dny a 3. díl za 6 dní.
Váš systém seriál založí, doplní a spustí přes API, díly pak odcházejí s nastavenou periodou.

Co je nového v API pro seriály a transakční e-maily

API Quandy nově umí založit a spravovat e-mailový seriál i transakční kampaň. Dosud šlo přes API založit, upravit, otestovat a odeslat jen jednoduchou e-mailovou kampaň. Seriály a transakční e-maily se zakládaly pouze v aplikaci.

API je rozhraní, přes které si dva systémy předávají data bez ručního klikání. E-mailový seriál, někdy se mu říká e-mailová sekvence nebo drip kampaň, je řada e-mailů, které kontakty s vybranými štítky dostávají postupně s odstupem zadaného počtu dní. Transakční e-mail si v Quandě připravíte předem a odejde ve chvíli, kdy kontakt splní podmínku, třeba po objednávce.

Co teď přes API zvládnete:

  • Založení jedním voláním. Volání je jeden požadavek vašeho systému na API. Vznikne jím kampaň i její první e-mail, stejně jako u jednoduché kampaně.
  • Správa obou typů kampaní. Změníte nastavení kampaně, přidáte, upravíte a smažete e-mail a přečtete seznam e-mailů. Pošlete testovací e-mail a kampaň aktivujete, pozastavíte a obnovíte.
  • Nastavení seriálu. Štítky kontaktů, kterým seriál chodí, perioda mezi díly 1 až 60 dní, datum a hodina startu a pořadí dílů. K tomu stav dílu a štítky, které se kontaktu po odeslání dílu přidají nebo odeberou.
  • Testovací e-mail seriálu. Volíte všechny díly, pouze dnes upravené nebo vybrané díly, stejně jako v aplikaci. Test jde nejvýše na 3 adresy.
  • Obsah e-mailu. Pošlete ho jako HTML nebo ho necháte vytvořit ze šablony.
  • Dostupnost. API je v Balíčku na míru ve všech tarifech, ve variantě Jen e-maily v tarifech Professional a Enterprise, viz ceník.
  • Práce s AI asistentem. Seriály a transakční kampaně umí založit a spravovat i AI asistent napojený přes Quanda MCP server.

Další možnosti napojení, včetně hotových propojení bez programování, shrnuje návod Propojení Quandy s webem, CRM nebo jiným softwarem.

K čemu využijete seriály a transakční e-maily přes API

API se vyplatí všude, kde kampaně vznikají nebo se mění podle dat z jiného systému. Kampaň pak nemusí nikdo ručně zakládat ani přepisovat v aplikaci. Tři typické situace:

Uvítací seriál zakládaný z CRM. Systém CRM si uvítací seriál pro nové zákazníky založí sám. Jedním voláním vznikne kampaň s prvním dílem, dalšími voláními přidá další díly. Nastaví štítek nových zákazníků, periodu a start. Marketér pak seriál zkontroluje v aplikaci a aktivuje. Co dalšího seriály v Quandě umí, ukazuje stránka E-mail marketing.

Transakční e-mail spravovaný z vlastního systému. Když se změní text transakčního e-mailu, třeba potvrzení objednávky, váš systém ho upraví přes API a pošle si test. Jak transakční e-mail připravit v aplikaci, popisuje návod Transakční e-maily pro automatizace.

Hromadná úprava dílů seriálu. Ve všech dílech potřebujete změnit patičku nebo odkaz. Skript přečte seznam e-mailů, každý díl upraví a nastaví mu stav ke kontrole. Kolega je pak v aplikaci projde a označí jako zkontrolované.

Jak založit e-mailový seriál přes API

Seriál přes API založíte a spustíte v šesti krocích. Každý krok je jedno nebo několik volání a každé volání posíláte s API klíčem v hlavičce. Seriál zůstává ve stavu Ve výstavbě a nic neodesílá, dokud ho neaktivujete.

  1. Založte seriál. Voláním POST /api/newsletter/campaigns/30/ pošlete název kampaně, manažera, odesílatele, jazyk, předmět a obsah prvního dílu jako HTML nebo ze šablony. Vznikne kampaň i první díl.
  2. Přidejte další díly. Každý díl přidáte samostatným voláním a podle potřeby změníte jejich pořadí.
  3. Nastavte příjemce. Zadejte štítky kontaktů, kterým seriál chodí. Volitelně přidejte štítky, které se kontaktu po odeslání dílu přidají nebo odeberou.
  4. Označte stav dílů. Každý díl má stav rozpracováno, ke kontrole, zkontrolováno nebo hotovo.
  5. Pošlete testovací e-mail. Zvolte všechny díly, pouze dnes upravené nebo vybrané díly. Test jde nejvýše na 3 adresy.
  6. Aktivujte seriál. Voláním POST /api/newsletter/campaigns/{campaign_id}/activate/ pošlete datum a hodinu startu a periodu 1 až 60 dní. Start musí být dnes nebo později a v celou hodinu. Před aktivací proběhnou stejné kontroly jako v aplikaci: ověřený e-mail a doména odesílatele, platnost obsahu a kontrola spamu.

Takto vypadá volání aktivace, které seriál spustí 1. 12. 2026 v 9:00 s periodou 3 dny:

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

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

Transakční kampaň založíte voláním POST /api/newsletter/campaigns/70/ a dál ji spravujete podobnými voláními jako seriál. Seriál založený přes API je běžná kampaň, dál ho upravíte i v aplikaci. Platí to i obráceně.

Seznam dílů e-mailového seriálu v aplikaci Quanda: tabulka Díl č.1 až Díl č.3 se šipkami pro změnu pořadí a sloupci Název e-mailu, Předmět e-mailu, Vytvořeno, Upraveno, Odesláno a Akce.
Díly seriálu v E-mail editoru. Stejně se zobrazí i seriál založený přes API.

Na co si dát pozor při úpravách přes API

Pro seriály a transakční kampaně přes API platí stejná bezpečnostní pravidla jako v aplikaci. Hlídejte hlavně těchto pět.

  • Před úpravou kampaň pozastavte. Probíhající kampaň nejde upravovat. Nejdřív ji pozastavte, upravte a pak obnovte, stejně jako v aplikaci.
  • Odkaz pro odhlášení. HTML e-mailu musí obsahovat značku {{ unsubscribe_link }}. Značka je zástupný text, za který Quanda při odeslání doplní odkaz pro odhlášení.
  • Nové datum po zmeškaném termínu. Když u pozastaveného seriálu mezitím uplyne termín dalšího odeslání, zadáte při obnovení nové datum startu a periodu, a to voláním aktivace. V aplikaci totéž popisuje návod Nastavení odeslání e-mailového seriálu.
  • Požadavky posílejte postupně. Na jeden API klíč posílejte požadavky jeden po druhém, ne souběžně. Mezi koncem jednoho a začátkem dalšího je prodleva 30 ms a při příliš častém přístupu vrátí API kód 429, požadavek pak zopakujte. Hlídejte to hlavně ve skriptu, který upravuje všechny díly seriálu najednou.
  • Nová verze e-mailu. Když u spuštěné kampaně změníte odkazy v e-mailu, který už odešel, vznikne nová verze e-mailu. Statistiky odeslané verze zůstanou zachované.
Nastavení data startu a periody seriálu v Quandě: stránka Odeslání s poli pro testovací příjemce, volbou Všechny díly nebo Vybrané díly a sekcí Odeslání kampaně s poli Datum, Čas a Další e-mail za.
Datum, čas a rozestup dílů v aplikaci. Přes API je pošlete voláním aktivace.

Co se v API nemění

Novinka jen přidává nová volání, stávající integrace fungují dál beze změny. Konkrétně:

  • API pro jednoduché kampaně funguje beze změny.
  • Endpointy, tedy adresy, na které váš systém volání posílá, zůstávají stejné.
  • Odesílání transakčních e-mailů jednotlivým příjemcům přes API funguje jako dřív.
  • Aplikace se chová stejně jako dosud.

Součástí tohoto vydání nejsou narozeninové, výroční, logické a A/B kampaně. Přes API také nenastavíte automatizace.

Seriály a transakční e-maily přes API: shrnutí

Seriály a transakční kampaně teď založíte a spravujete přes API stejně jako jednoduchou kampaň a se stejnými pravidly jako v aplikaci. Všechna volání, pole a chybové odpovědi popisuje API dokumentace v částech E-mailový seriál a Transakční e-maily. Jak získat API klíč, najdete v nápovědě Dokumentace k API a API klíč. Nastavení seriálu v aplikaci popisuje návod Jak vytvořit a nastavit e-mailový seriál.

S napojením vám poradí naše podpora na support@onquanda.com nebo na telefonu +420 605 163 892.

Tým Quanda