Přejít na obsah
Dokumentace

Reference

Spouštěče automatizací

Přehled všech spouštěčů automatizací podle kontextu – jejich možnosti a filtry, co je aktivuje a klíče spouštěčů pro práci s API.

Aktualizováno 20. 11. 2026

Spouštěč rozhoduje, kdy automatizace zahájí spuštění. Tato stránka uvádí všechny spouštěče dostupné v jednotlivých kontextech, co je aktivuje, jejich možnosti a klíč, který pro ně používáte v API.

Jak spouštěče fungují

  • Ve webovém rozhraní jeden spouštěč na automatizaci. Vyberte spouštěč na plátně a změňte ho v poli Trigger type. Přes API mohou automatizace v kontextu Contact a Email mít několik spouštěčů, pokud všechny vedou do stejného prvního kroku. Automatizace v kontextu Event mají právě jeden. Každý spouštěč, který se aktivuje, zahájí vlastní spuštění, takže jedna registrace může zahájit dvě: formulář, který kontakt přidá do seznamu kontaktů, aktivuje Form submitted i Added to audience zároveň. Pokud chcete jen jedno spuštění, nastavte na kartě Settings volbu Same contact again while a run is in progress na Don’t start another run (allow_reentry: false).
  • Automatizace musí běžet. Spouštěče v automatizacích, které jsou konceptem, pozastavené nebo zastavené, se ignorují. Události z doby před zapnutím automatizace dodatečně spuštění nezahájí.
  • Spuštění začínají během několika sekund. Emailit nové události přebírá každých několik sekund. Datové spouštěče se kontrolují každých 5 minut.
  • Automatizace v kontextu Contact potřebují kontakt. Událost, kterou nelze přiřadit ke kontaktu ve workspace, například otevření z adresy, která není kontaktem, spuštění nezahájí.
  • Automatizace se mohou spouštět navzájem. Změny provedené krokem, například přidání štítku nebo přidání kontaktu do seznamu kontaktů, aktivují spouštěče jiných automatizací. Automatizace tímto způsobem nikdy nespustí sama sebe a řetězec automatizací, které se spouštějí navzájem, se zastaví po 5 článcích.

Filtry

Spouštěče Contact updated, Custom event, Placed an order, Abandoned a cart, Viewed a product, Product back in stock a všechny spouštěče e-mailů přijímají volitelný filtr. Každé pravidlo porovnává jedno pole události s hodnotou:

  • Operátory: Equals, Not equals, Contains, Not contains, Greater than, Less than, Is set, Is not set, In, Not in, Starts with a Ends with. Greater than a Less than porovnávají čísla. Ostatní porovnávají text a rozlišují velikost písmen.
  • Režim shody: All rules match, nebo Any rule matches.

V API je filtr { "match": "all", "rules": [{ "field": "...", "operator": "equals", "value": "..." }] } v config.filter spouštěče, přičemž match je all, nebo any. Pole jsou cesty do objektu události, například to, link.url nebo u vlastní události properties.total. Pokud chcete kontrolovat samotný kontakt (štítky, seznamy kontaktů, skóre), přidejte za spouštěč krok Condition.

Spouštěče v kontextu Contact

Spouštěč Klíč v API Možnosti Spuštění začne, když
Added to audience contact.added_to_audience Audience. Pro jakýkoli seznam kontaktů nechte prázdné. Kontakt se přidá do seznamu kontaktů, nebo se do něj vrátí po odhlášení.
Removed from audience contact.removed_from_audience Audience. Pro jakýkoli seznam kontaktů nechte prázdné. Členství kontaktu v seznamu se smaže.
Added to segment contact.added_to_segment Tracked segment (povinné) a volba, jestli zahrnout aktuální členy Kontakt začne odpovídat sledovanému segmentu.
Removed from segment contact.removed_from_segment Tracked segment (povinné) Kontakt přestane odpovídat sledovanému segmentu.
Contact created contact.created Žádné Vytvoří se kontakt.
Contact updated contact.updated Field that changed, volitelný filtr Změní se pole, vlastní pole, štítky, skóre nebo marketingový stav kontaktu.
Tag added contact.tag_added Tag. Pro jakýkoli štítek nechte prázdné. Kontakt dostane štítek.
Tag removed contact.tag_removed Tag. Pro jakýkoli štítek nechte prázdné. Štítek se z kontaktu odebere.
Score changed contact.score_changed Crosses a Direction Skóre kontaktu se změní, nebo překročí prahovou hodnotu.
Unsubscribed contact.unsubscribed Audience. Pro jakýkoli seznam nechte prázdné. Kontakt se odhlásí ze seznamu kontaktů, nebo ze všech marketingových e-mailů.
Email opened contact.loaded_email Jen e-maily odeslané touto automatizací Kontakt načte měřený e-mail odeslaný na jeho adresu.
Link clicked contact.clicked_in_email Link contains, jen e-maily odeslané touto automatizací Kontakt klikne na měřený odkaz v e-mailu odeslaném na jeho adresu.
Date in contact field contact.on_date Date field, posun, čas, časové pásmo, Repeat Nastane datum uložené u kontaktu, nebo do něj zbývá nastavený počet dní.
Date anniversary contact.date_anniversary Date field, posun, čas, časové pásmo Každý rok v měsíc a den data uloženého u kontaktu.
Custom event contact.on_event Event name. Pro jakoukoli událost nechte prázdné. Vaše aplikace pošle přes API událostí pro kontakt událost workspace nebo vlastní událost, například nákup. Tarify Business a Custom.
Form submitted form.submitted Form. Pro jakýkoli formulář nechte prázdné. Někdo odešle formulář s e-mailovou adresou.
Placed an order contact.on_purchase Volitelný filtr Kontakt vytvoří novou objednávku.
Abandoned a cart contact.abandoned_cart Volitelný filtr Košík kontaktu se stane opuštěným.
Viewed a product contact.viewed_product Volitelný filtr Kontakt si na vašem webu prohlédne produkt.
Product back in stock contact.back_in_stock Volitelný filtr Produkt, na který se kontakt ptal, je znovu k dispozici.

Added to audience

Aktivuje se, když někoho přidáte do seznamu kontaktů ve webovém rozhraní (Add subscriber, Add to audience, Add contact se seznamy kontaktů), přes API (Přidání odběratele nebo Vytvoření kontaktu s audiences), hromadnou akcí Add to audience nebo krokem Add to audience, Subscribe / unsubscribe či Create contact jiné automatizace. Aktivuje ho i opětovné přidání někoho, kdo se odhlásil.

Neaktivuje se u kontaktů přidaných importem souboru nebo přihlášením přes URL pro přihlášení a nepočítá se ani opětovné zapnutí Subscribed u existujícího odběratele ve webovém rozhraní.

Removed from audience

Aktivuje se, když se odběratel smaže: Delete na stránce seznamu kontaktů, Remove from audience, Smazání odběratele, úprava kontaktu, jejíž seznam audiences daný seznam vynechá, nebo krok Remove from audience jiné automatizace. Smazání kontaktu ho aktivuje jednou pro každý seznam, ve kterém kontakt byl. Odhlášení ho neaktivuje, protože daná osoba v seznamu zůstává; k tomu použijte Unsubscribed.

Pokud chcete zastavit spuštění sekvence, když kontakt opustí její seznam kontaktů, nepotřebujete druhou automatizaci: na kartě Settings zapněte Leave when removed or unsubscribed from the audience that started the run. Viz Podmínky ukončení a cíle.

Spouštěče segmentů

Added to segment a Removed from segment se aktivují, když kontakt vstoupí do sledovaného segmentu, nebo ho opustí. Stejně jako segmenty jsou v alfaverzi a otevřené jen týmu Emailitu. Segment zvolte v poli Tracked segment. Nabízejí se a přijímají jen sledované segmenty, protože ostatní segmenty vstupy a odchody nezaznamenávají.

  • Kdy se aktivují. Když se kontakt změní, jeho segmenty se znovu zkontrolují a spuštění obvykle začnou do minuty. Importy a mazání seznamů kontaktů se zkontrolují po dokončení. Pravidla, která se posouvají s časem, například Created za posledních 30 dní, kontroluje denní synchronizace v 00:30 UTC.
  • Úpravy segmentu spuštění nezahajují. Kontakty, které vstoupí nebo odejdou, protože jste změnili zdroj nebo filtry segmentu, se zaznamenají a odešlou webhookům, ale automatizace nespustí.
  • První zápis členů spuštění nezahajuje. Vytvoření sledovaného segmentu nebo obnovení sledování po přechodu na vyšší tarif zaznamená aktuální členy, aniž by zahájilo spuštění.
  • Zahrnutí aktuálních členů. U Added to segment vyberte Also start for contacts already in the segment when the automation is first started a spuštění se zahájí také pro každého aktuálního člena. Stane se to jednou, při prvním zapnutí automatizace. Nastavení opakovaného vstupu stále platí.

Ve spuštění obsahuje {{payload.object.segment.name}} název segmentu a {{payload.object.reason}} důvod, proč kontakt vstoupil nebo odešel: contact, schedule nebo existing_member u spuštění pro aktuální členy segmentu.

V API nastavte config.segment_id na ID segmentu s předponou seg_ a u contact.added_to_segment volitelně config.include_current_members: true. Segment, který automatizace používají, nelze smazat, dokud tyto automatizace nezměníte.

Contact updated

Aktivuje se pokaždé, když se kontakt upraví ve webovém rozhraní, přes API nebo krokem automatizace, včetně změn štítků a skóre a hromadných akcí Unsubscribe a Resubscribe. Field that changed ho omezí na jedno pole, například na vlastní pole purchased, které nastavuje váš CRM. Filtr může kontrolovat aktuální Email, First name, Last name, Unsubscribed a vlastní pole i jejich předchozí hodnoty, uvedené jako Previous email, Previous first name a tak dále. Předchozí hodnoty jsou k dispozici jen u polí, která se změnila.

Pokud chcete například reagovat, když kontakt přejde na plán pro, přidejte s All rules match dvě pravidla: custom_fields.plan Equals pro a Previous plan (previous.custom_fields.plan) Not equals pro.

Tag added a Tag removed

Aktivují se, když se štítek kontaktu přidá nebo odebere jakoukoli cestou: ve webovém rozhraní, přes API, MCP server nebo krokem automatizace. Štítky se porovnávají malými písmeny, takže VIP a vip jsou stejný štítek.

Score changed

Aktivuje se, když se změní skóre kontaktu. S nastaveným Crosses se aktivuje, jen když skóre danou hodnotu překročí: směr nahoru (Going up, výchozí) znamená, že staré skóre bylo pod ní a nové je na ní nebo nad ní, takže pravidlo „kontakty nad 50 bodů vstupují do prodejního workflow“ se aktivuje jednou, ne při každém bodu. Going down se aktivuje, když skóre klesne pod danou hodnotu.

Unsubscribed

Aktivuje se, když se kontakt odhlásí ze seznamu kontaktů (odkazem pro odhlášení, ve webovém rozhraní, přes API nebo krokem Subscribe / unsubscribe), nebo ze všech marketingových e-mailů. S nastaveným Audience se aktivuje jen pro daný seznam a pro odhlášení ze všeho.

Aktivují se, když kontakt načte měřený e-mail odeslaný na jeho adresu nebo v něm klikne na měřený odkaz: u kampaní, e-mailů z API a SMTP i e-mailů z automatizací. Měření vyžaduje nastavení měření odesílací domény a ověřený CNAME záznam pro měření. Only emails sent by this automation je omezí na e-maily ze samotné automatizace a Link contains na odkazy, jejichž URL obsahuje zadaný text, například /pricing.

Pokud chcete reagovat na otevření nebo proklik e-mailu, který spuštění právě odeslalo, použijte místo toho krok Wait until s volbou Something happens. Viz Wait until.

Date in contact field a Date anniversary

Zvolte Date field, tedy vlastní pole typu Date, například datum obnovení předplatného nebo narozeniny, a pak určete, kdy začít:

  • Days s Unit (days, nebo weeks) a When (before the date, nebo after the date), například 3 dny před obnovením předplatného. 0 znamená přímo v den data.
  • At time (výchozí 00:00) v Timezone (název IANA, například Europe/Prague, výchozí je UTC).
  • Repeat u Date in contact field: Once, on that date, nebo Every year (anniversary). Date anniversary se opakuje vždy každý rok; na roku v poli nezáleží, takže 1990-04-12 zahájí spuštění každý 12. duben. V letech, které nejsou přestupné, začínají výročí 29. února 28. února.

Emailit se dívá 5 minut dopředu a každé spuštění zahájí přesně v minutu, kterou nastavíte. Každý kontakt dostane jedno spuštění na datum (u výročí jedno za rok) a každá kontrola zpracuje až 100 000 kontaktů na automatizaci.

V API nastavte config.date_field na klíč vlastního pole, offset na { "amount": 3, "unit": "days", "direction": "before" } a volitelně time, timezone a repeat: "yearly".

Custom event

Tento spouštěč je součástí tarifů Business a Custom. V tarifech Pay as you go a Pro nelze uložit automatizaci, která ho přidává (403 s "error": "plan_required"). Automatizace, které ho už používají, si ho po přechodu na nižší tarif ponechají.

Aktivuje se, když vaše aplikace pošle pro kontakt vlastní událost (události c:) nebo událost workspace (události w:) přes API událostí. Události ze sledovacího skriptu spuštění nezahajují, protože kdokoli s vaším veřejným sledovacím klíčem může kteréhokoli návštěvníka identifikovat jako kohokoli. Název zadejte v poli Event name:

  • purchase odpovídá c:purchase i w:purchase.
  • Název s předponou, například w:webinar.attended, odpovídá jen té jedné.
  • Když pole necháte prázdné, spouštěč se aktivuje pro jakoukoli událost workspace nebo vlastní událost.

Pole nabízí události workspace, které jste definovali, a vlastní události, které váš workspace nedávno poslal. V části Only when the properties match (optional) filtrujte podle vlastností události, například properties.total Greater than 100. U události workspace ukazuje seznam polí její definované vlastnosti.

Událost musí určit kontakt workspace pomocí ID nebo e-mailové adresy. Události od anonymních návštěvníků nebo pro adresy, které nejsou kontakty, spuštění nezahájí. Ve spuštění jsou vlastnosti k dispozici v {{payload.object.properties.total}} a podobných proměnných.

Placed an order

Stejně jako E-commerce je tento spouštěč v alfaverzi a otevřený jen týmu Emailitu. Automatizace, které ho už používají, dál běží.

Aktivuje se jednou pro každou novou objednávku kontaktu, z API pro objednávky nebo z příkazu purchase měřicího skriptu. Objednávky naimportované jako historie a objednávky bez kontaktu ho neaktivují a úpravy objednávky ho znovu neaktivují. Filtr může kontrolovat Order total, Currency, Status, Source a Coupon codes objednávky a e-maily mohou objednávku použít jako {{payload.object.total}}, {{payload.object.external_id}} a tak dále.

Abandoned a cart

Stejně jako E-commerce je tento spouštěč v alfaverzi a otevřený jen týmu Emailitu. Automatizace, které ho už používají, dál běží.

Aktivuje se pokaždé, když se košík stane opuštěným: košík známého kontaktu, který obsahuje položky a nezměnil se po dobu nastavenou v nastavení E-commerce (ve výchozím stavu 60 minut). Filtr může kontrolovat Cart total, Currency a Source. V e-mailech košík zobrazí {{cart}}, viz Produkty, kupony a košík.

Kroky Send email ve spuštění, které tento spouštěč zahájil, se přeskočí, jakmile se košík převede na objednávku, takže kupující nedostávají připomínky toho, co si právě koupili. Viz recept pro opuštěný košík.

API přijímá také contact.visits_url, ale nic ho zatím neaktivuje.

Viewed a product

Stejně jako E-commerce je tento spouštěč v alfaverzi a otevřený jen týmu Emailitu. Automatizace, které ho už používají, dál běží.

Aktivuje se, když si kontakt na vašem webu prohlédne produkt, přes příkaz product měřicího skriptu nebo pixel Emailitu na Shopify. Zobrazení může s vaším veřejným měřicím klíčem poslat kdokoli, proto spouštěč aktivují jen zobrazení kontaktu, který přišel z některého z vašich e-mailů (podepsaný odkaz) nebo se přihlásil k odběru seznamu. Filtr může kontrolovat Product ID (shop), Product title a Price. E-maily mohou použít {{payload.object.product.title}}, nebo pomocí {{products "recently_viewed"}} ukázat všechno, co si kontakt prohlížel.

Jedna návštěva má obvykle několik zobrazení produktů. Pro připomínky prohlížených produktů nastavte Wait between runs for the same contact (hours), před e-mailem počkejte a ukončete spuštění při Placed an order, jak to dělá šablona Browse abandonment.

Product back in stock

Stejně jako E-commerce je tento spouštěč v alfaverzi a otevřený jen týmu Emailitu. Automatizace, které ho už používají, dál běží.

Aktivuje se, když je znovu k dispozici produkt, na který se kontakt zeptal formulářem pro naskladnění ve vašem obchodě na Shopify, jednou za každou žádost. Filtr může kontrolovat Product ID (shop), Product title a Variant ID. E-maily mohou použít {{payload.object.product.title}}, {{payload.object.product.url}}, {{payload.object.product.image_url}} a {{payload.object.variant.title}}. Šablona Back in stock posílá svůj e-mail jako transakční, protože si o něj kontakt řekl.

Spouštěče v kontextu Email

Spouštěče e-mailů se aktivují u e-mailů ve vašem workspace: u všeho, co odešlete přes API nebo SMTP, u e-mailů z kampaní a automatizací a u Email received u příchozích e-mailů. Každé spuštění se týká jednoho e-mailu.

Spouštěč Klíč v API Spuštění začne, když Pole filtru
Email delivered email.delivered Server příjemce e-mail přijal. From, To, Subject, Status
Email bounced email.bounced E-mail trvale selhal. From, To, Subject, Status
Email failed email.failed E-mail nebylo možné odeslat kvůli chybě. From, To, Subject, Status
Email suppressed email.suppressed E-mail se neodeslal, protože příjemce je blokovaný. From, To, Subject, Status
Email complained email.complained Příjemce nahlásil e-mail jako spam. From, To, Subject, Status
Email received email.received Dorazil příchozí e-mail. Viz Příchozí e-maily. From, To, Subject
Email loaded email.loaded Příjemce načetl měřený e-mail. Recipient, Sender, Subject, IP address, User agent
Email clicked email.clicked Příjemce klikl na měřený odkaz. Recipient, Sender, Subject, Link URL, IP address, User agent

Editor uvádí také Email accepted, Email scheduled, Email attempted a Email rejected. Automatizace s těmito spouštěči zatím nelze uložit, proto zvolte některý ze spouštěčů výše. Přes API můžete použít i email.canceled, který se aktivuje, když se zruší naplánovaný e-mail nebo e-mail ve frontě.

Spouštěče v kontextu Event

Automatizace v kontextu Event lze zatím vytvářet jen přes API.

Spouštěč Klíč v API Spuštění začne, když
Manual trigger system.manual Zavoláte Ruční spuštění.
Schedule system.schedule Rezervováno. Zatím ho nic neaktivuje, proto místo něj volejte endpoint pro spuštění z vlastního plánovače, například z úlohy cron.

Manual trigger

Zavolejte endpoint pro spuštění běžící automatizace s volitelným objektem payload:

Terminal
curl https://api.emailit.com/v2/automations/aut_3Mv8Xq2nKp5Lt/trigger \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "payload": { "email": "ada@example.com", "plan": "pro" } }'

Endpoint vrátí { "message": "Automation trigger dispatched." }, nebo 422, pokud automatizace neběží. Zahájí spuštění jen této automatizace. Kroky mohou obsah číst jako {{payload.email}}, {{payload.plan}} a tak dále. Emailit do obsahu přidá automation_id.

system.manual funguje jako spouštěč i v automatizacích v kontextu Contact a Email vytvořených přes API. Pokud do obsahu přidáte contact_id (ID con_) nebo email_id, automatizace se spustí pro daný kontakt nebo e-mail.

Data dostupná v krocích

Nastavení kroků, například příjemce v kroku Send email, hodnoty v kroku Update contact fields nebo tělo kroku Webhook, mohou obsahovat proměnné, které se vyplní pro každé spuštění:

Proměnná Obsahuje
{{contact.<field>}} Kontakt spuštění v automatizacích v kontextu Contact, například {{contact.email}}, {{contact.score}} nebo {{contact.custom_fields.plan}}.
{{cf.<key>}} Vlastní pole kontaktu, například {{cf.plan}}.
{{tags}} Štítky kontaktu oddělené čárkami.
{{global.<key>}} Globální hodnota, například {{global.webinar_date}}.
{{email.<field>}} E-mail spuštění v automatizacích v kontextu Email, například {{email.rcpt_to}} nebo {{email.subject}}.
{{payload.<path>}} Událost, která spuštění zahájila. U událostí ve stylu webhooků jsou data události v payload.object, například {{payload.object.to}}. U ručních spuštění je to váš payload.
{{meta.<path>}} Další data, která Emailit o spuštění ukládá.
{{run.id}} ID spuštění (aur_…).

Šablony e-mailů odesílané krokem Send email používají Temple se stejnými daty. Viz Kroky.

Co spuštění dokáže, jakmile začne.
Události, které spuštění ukončí nebo posunou.
Události, ze kterých vycházejí spouštěče kontaktů a e-mailů.
Štítky a skóre pro spouštěče a podmínky.

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.