E-mailové seriály a transakčné kampane novo založíte a spravujete cez API Quandy, rovnako ako jednoduchú e-mailovú kampaň. Vývojár ich napojí priamo na CRM, ERP, DMS alebo vlastné aplikácie. Marketér ich potom ďalej upravuje v aplikácii ako doteraz.

V kocke

  1. E-mailový seriál (typ kampane 30) aj transakčnú kampaň (typ 70) založíte jedným volaním, vznikne kampaň aj prvý e-mail.
  2. Cez API zmeníte nastavenie, spravujete e-maily, pošlete test a kampaň aktivujete, pozastavíte a obnovíte.
  3. Seriál spustíte volaním aktivácie s dátumom začiatku v celú hodinu a rozostupom 1 až 60 dní.
  4. Test ide najviac na 3 adresy a HTML musí obsahovať značku {{ unsubscribe_link }}.
  5. Prebiehajúcu kampaň upravíte až po pozastavení, pred aktiváciou prebehnú rovnaké kontroly ako v aplikácii.

Stručne: čo je nové, odkedy, koho sa to týka a kde to nájdete

  • Čo je nové: API okrem jednoduchej kampane novo zvláda dva ďalšie typy kampaní, e-mailový seriál a transakčnú kampaň.
  • Odkedy: od 20. novembra 2026.
  • Koho sa to týka: vývojárov a integrátorov, ktorí napájajú Quandu na CRM, ERP, DMS alebo vlastné aplikácie, a marketérov, ktorí seriály a transakčné e-maily používajú.
  • Čo nie je súčasťou: narodeninové, výročné, logické a A/B kampane a nastavenie automatizácií.
  • Kde to nájdete: v API dokumentácii v angličtine v častiach Email series a Transactional emails, odkaz na ňu je v návode Dokumentácia k API a API kľúč.
Schéma e-mailového seriálu riadeného cez API Quanda: váš systém, napríklad CRM, ERP, DMS alebo vlastné aplikácie, volaním API založí seriál, pridá diely a aktivuje ho. Seriál potom kontaktom so štítkom Noví zákazníci pošle 1. diel pri štarte, 2. diel o 3 dni a 3. diel o 6 dní.
Váš systém seriál založí, doplní a spustí cez API, diely potom odchádzajú s nastaveným rozostupom.

Čo je nové v API pre seriály a transakčné e-maily

API Quandy novo dokáže založiť a spravovať e-mailový seriál aj transakčnú kampaň. Doteraz sa dala cez API založiť, upraviť, otestovať a odoslať len jednoduchá e-mailová kampaň. Seriály a transakčné e-maily sa zakladali iba v aplikácii.

API je rozhranie, cez ktoré si dva systémy odovzdávajú dáta bez ručného klikania. E-mailový seriál, niekedy sa mu hovorí e-mailová sekvencia alebo drip kampaň, je rad e-mailov, ktoré kontakty s vybranými štítkami dostávajú postupne s odstupom zadaného počtu dní. Transakčný e-mail si v Quande pripravíte vopred a odíde vo chvíli, keď kontakt splní podmienku, napríklad po objednávke.

Čo teraz cez API zvládnete:

  • Založenie jedným volaním. Volanie je jedna požiadavka vášho systému na API. Vznikne ním kampaň aj jej prvý e-mail, rovnako ako pri jednoduchej kampani.
  • Správa oboch typov kampaní. Zmeníte nastavenie kampane, pridáte, upravíte a zmažete e-mail a prečítate zoznam e-mailov. Pošlete testovací e-mail a kampaň aktivujete, pozastavíte a obnovíte.
  • Nastavenie seriálu. Štítky kontaktov, ktorým seriál chodí, rozostup medzi dielmi 1 až 60 dní, dátum a hodina začiatku a poradie dielov. K tomu stav dielu a štítky, ktoré sa kontaktu po odoslaní dielu pridajú alebo odoberú.
  • Testovací e-mail seriálu. Volíte všetky diely, len dnes upravené alebo vybrané diely, rovnako ako v aplikácii. Test ide najviac na 3 adresy.
  • Obsah e-mailu. Pošlete ho ako HTML alebo ho necháte vytvoriť zo šablóny.
  • Dostupnosť. API je v Balíčku na mieru vo všetkých tarifoch, vo variante Len e-maily v tarifoch Professional a Enterprise, pozrite cenník.
  • Práca s AI asistentom. Seriály a transakčné kampane dokáže založiť a spravovať aj AI asistent pripojený cez Quanda MCP server.

Ďalšie možnosti prepojenia, vrátane hotových prepojení bez programovania, zhŕňa návod Prepojenie Quandy s webom, CRM alebo iným softvérom.

Na čo využijete seriály a transakčné e-maily cez API

API sa oplatí všade, kde kampane vznikajú alebo sa menia podľa dát z iného systému. Kampaň potom nemusí nikto ručne zakladať ani prepisovať v aplikácii. Tri typické situácie:

Uvítací seriál zakladaný z CRM. Systém CRM si uvítací seriál pre nových zákazníkov založí sám. Jedným volaním vznikne kampaň s prvým dielom, ďalšími volaniami pridá ďalšie diely. Nastaví štítok nových zákazníkov, rozostup a začiatok. Marketér potom seriál skontroluje v aplikácii a aktivuje. Čo ďalšie seriály v Quande dokážu, ukazuje stránka E-mail marketing.

Transakčný e-mail spravovaný z vlastného systému. Keď sa zmení text transakčného e-mailu, napríklad potvrdenia objednávky, váš systém ho upraví cez API a pošle si test. Ako transakčný e-mail pripraviť v aplikácii, opisuje návod Transakčné e-maily pre automatizácie.

Hromadná úprava dielov seriálu. Vo všetkých dieloch potrebujete zmeniť pätičku alebo odkaz. Skript prečíta zoznam e-mailov, každý diel upraví a nastaví mu stav na kontrolu. Kolega ich potom v aplikácii prejde a označí ako skontrolované.

Ako založiť e-mailový seriál cez API

Seriál cez API založíte a spustíte v šiestich krokoch. Každý krok je jedno alebo niekoľko volaní a každé volanie posielate s API kľúčom v hlavičke. Seriál zostáva v stave Vo výstavbe a nič neodosiela, kým ho neaktivujete.

  1. Založte seriál. Volaním POST /api/newsletter/campaigns/30/ pošlete názov kampane, manažéra, odosielateľa, jazyk, predmet a obsah prvého dielu ako HTML alebo zo šablóny. Vznikne kampaň aj prvý diel.
  2. Pridajte ďalšie diely. Každý diel pridáte samostatným volaním a podľa potreby zmeníte ich poradie.
  3. Nastavte príjemcov. Zadajte štítky kontaktov, ktorým seriál chodí. Voliteľne pridajte štítky, ktoré sa kontaktu po odoslaní dielu pridajú alebo odoberú.
  4. Označte stav dielov. Každý diel má stav rozpracovaný, na kontrolu, skontrolovaný alebo hotový.
  5. Pošlite testovací e-mail. Zvoľte všetky diely, len dnes upravené alebo vybrané diely. Test ide najviac na 3 adresy.
  6. Aktivujte seriál. Volaním POST /api/newsletter/campaigns/{campaign_id}/activate/ pošlete dátum a hodinu začiatku a rozostup 1 až 60 dní. Začiatok musí byť dnes alebo neskôr a v celú hodinu. Pred aktiváciou prebehnú rovnaké kontroly ako v aplikácii: overený e-mail a doména odosielateľa, platnosť obsahu a kontrola spamu.

Takto vyzerá volanie aktivácie, ktoré seriál spustí 1. 12. 2026 o 9:00 s rozostupom 3 dni:

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

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

Transakčnú kampaň založíte volaním POST /api/newsletter/campaigns/70/ a ďalej ju spravujete podobnými volaniami ako seriál. Seriál založený cez API je bežná kampaň, ďalej ho upravíte aj v aplikácii. Platí to aj opačne.

Zoznam dielov e-mailového seriálu v aplikácii Quanda: tabuľka troch dielov so šípkami na zmenu poradia, názvom a predmetom e-mailu a dátumami vytvorenia, úpravy a odoslania.
Diely seriálu v E-mail editore. Rovnako sa zobrazí aj seriál založený cez API.

Na čo si dať pozor pri úpravách cez API

Pre seriály a transakčné kampane cez API platia rovnaké bezpečnostné pravidlá ako v aplikácii. Strážte hlavne týchto päť.

  • Pred úpravou kampaň pozastavte. Prebiehajúcu kampaň nie je možné upravovať. Najskôr ju pozastavte, upravte a potom obnovte, rovnako ako v aplikácii.
  • Odkaz na odhlásenie. HTML e-mailu musí obsahovať značku {{ unsubscribe_link }}. Značka je zástupný text, za ktorý Quanda pri odoslaní doplní odkaz na odhlásenie.
  • Nový dátum po zmeškanom termíne. Keď pri pozastavenom seriáli medzitým uplynie termín ďalšieho odoslania, zadáte pri obnovení nový dátum začiatku a rozostup, a to volaním aktivácie. V aplikácii to isté opisuje návod Nastavenie odoslania e-mailového seriálu.
  • Požiadavky posielajte postupne. Na jeden API kľúč posielajte požiadavky jednu po druhej, nie súbežne. Medzi koncom jednej a začiatkom ďalšej požiadavky je prestávka 30 ms a pri príliš častom prístupe vráti API kód 429, požiadavku potom zopakujte. Strážte to hlavne v skripte, ktorý upravuje všetky diely seriálu naraz.
  • Nová verzia e-mailu. Keď pri spustenej kampani zmeníte odkazy v e-maile, ktorý už odišiel, vznikne nová verzia e-mailu. Štatistiky odoslanej verzie zostanú zachované.
Nastavenie dátumu štartu a rozostupu seriálu v Quande: stránka Odoslanie s poľami pre testovacích príjemcov, voľbou Všetky diely alebo Vybrané diely a sekciou Odoslanie kampane s poľami Dátum, Čas a Ďalší e-mail za.
Dátum, čas a rozostup dielov v aplikácii. Cez API ich pošlete volaním aktivácie.

Čo sa v API nemení

Novinka len pridáva nové volania, existujúce integrácie fungujú ďalej bez zmeny. Konkrétne:

  • API pre jednoduché kampane funguje bez zmeny.
  • Endpointy, teda adresy, na ktoré váš systém volania posiela, zostávajú rovnaké.
  • Odosielanie transakčných e-mailov jednotlivým príjemcom cez API funguje ako predtým.
  • Aplikácia sa správa rovnako ako doteraz.

Súčasťou tohto vydania nie sú narodeninové, výročné, logické a A/B kampane. Cez API tiež nenastavíte automatizácie.

E-mailové seriály a transakčné e-maily cez API: zhrnutie

Seriály a transakčné kampane teraz založíte a spravujete cez API rovnako ako jednoduchú kampaň a s rovnakými pravidlami ako v aplikácii. Všetky volania, polia a chybové odpovede opisuje API dokumentácia v angličtine v častiach Email series a Transactional emails. Odkaz na ňu aj postup, ako získať API kľúč, nájdete v návode Dokumentácia k API a API kľúč. Nastavenie seriálu v aplikácii opisuje návod Ako vytvoriť a nastaviť e-mailový seriál.

S napojením vám poradí naša podpora na support@onquanda.com alebo na telefóne +420 605 163 892.

Tím Quanda