Reference automatizací

Vše na této stránce se generuje z kódu validátoru Poštárny a testy ověřují, že každý příklad validátor přijme, že bez povinného pole automatizace nejde zapnout a že výčtové hodnoty odpovídají validátoru. Stejná schémata jsou v OpenAPI jako AutomationNode_<typ>, ConditionRule_<typ>, SegmentRule_<typ> a TimeSpec.

Technické popisy polí jsou anglicky, stejně jako v OpenAPI.

Uzly#

Každý uzel: {"id": "<klíč>", "type": "<typ>", "name"?, "note"?, "position"?, "config": {...}}. Pole se sloupcem „Povinné“ = ano musí být vyplněná, jinak automatizace nejde zapnout ani otestovat (graf se ale uloží, viz validace). Další pole bývají povinná jen u některých hodnot (například listId u události list_added); popis to uvádí.

Spouštěče#

trigger_now#

Starts once, right at the activation, with the contacts of the shop matching the filter (SmartEmailing "Hned teď").

Výstupy: next · SmartEmailing: run

{
  "id": "trigger-now-1",
  "type": "trigger_now",
  "config": {
    "reentry": "once"
  }
}

trigger_scheduled#

Starts once at a local date and time (SmartEmailing "V plánovaný čas").

Výstupy: next · Povinné pro zapnutí: at · SmartEmailing: scheduled-time

{
  "id": "trigger-scheduled-1",
  "type": "trigger_scheduled",
  "config": {
    "at": "2026-12-01T09:00",
    "reentry": "once"
  }
}

trigger_repeat#

Starts repeatedly every every from startAt (default the activation) until stopAt, with the contacts matching the filter (SmartEmailing "Opakovat").

Výstupy: next · Povinné pro zapnutí: every · SmartEmailing: repeat

{
  "id": "trigger-repeat-1",
  "type": "trigger_repeat",
  "config": {
    "every": {
      "value": 1,
      "unit": "days"
    },
    "startAt": "2026-11-01T08:00",
    "reentry": "parallel",
    "filter": {
      "type": "group",
      "match": "all",
      "rules": [
        {
          "type": "contact_anniversary",
          "field": "nameDay",
          "relation": "now"
        }
      ]
    }
  }
}

trigger_event#

Starts when an event happens to a contact (SmartEmailing "Při události"). Only events after the activation count. Event specific settings: cart_updated: The contact's cart changed (POST /contact-events type cart). shopId narrows the shop. contact_created: A new contact of the automation's shop. order_created: A new order (shopId: shop of the order, default the automation's shop). order_changed: An order changed state (state narrows to one state). list_added: The contact was added to listId. contact_updated: A profile field changed (fieldFilter narrows to one field and its values before / after). action_failed: An action of an automation failed (failureType, failureNode narrow it). list_status_changed: The contact's state in listId changed to status. email_sent: An e-mail of emailNode (a send_email node of ANOTHER automation) was sent. page_visit: A web tracking visit (POST /contact-events type visit): url, urlOperator, visitType. link_clicked: The contact clicked a link (link, compareParams) in an e-mail of emailNode (another automation). engagement_changed: The contact's engagement level changed. custom: A custom event named customEvent (POST /contact-events type custom, or a fire_event node of another automation). form_submitted: A form was submitted and confirmed (formId narrows to one form). blacklisted: The contact was blacklisted. order_completed: An order was completed (paid, shipped or delivered). subscribed: The contact subscribed (sources narrows the source; imports only when listed). manual: Contacts added by hand: POST /automations/{id}/contacts.

Výstupy: next · Povinné pro zapnutí: event · SmartEmailing: on-event

{
  "id": "trigger-event-1",
  "type": "trigger_event",
  "config": {
    "event": "cart_updated",
    "shopId": "1",
    "reentry": "restart"
  }
}

trigger_date#

Starts once a day at at for contacts whose date is today: name day, birthday, a date custom field (shifted by offsetDays), fixed holidays (every contact of the shop), or the first completed order exactly days ago.

Výstupy: next · Povinné pro zapnutí: kind, at

{
  "id": "trigger-date-1",
  "type": "trigger_date",
  "config": {
    "kind": "name_day",
    "at": "08:00",
    "reentry": "parallel"
  }
}

trigger_reorder#

Starts once a day at at for customers whose last completed order is older than their usual interval between orders ("buy again"): the average gap of their order days, defaultDays with one order day, clamped to minDays..maxDays, plus graceDays.

Výstupy: next · Povinné pro zapnutí: at

{
  "id": "trigger-reorder-1",
  "type": "trigger_reorder",
  "config": {
    "at": "10:00",
    "defaultDays": 30,
    "minDays": 14,
    "maxDays": 120,
    "graceDays": 3,
    "reentry": "parallel"
  }
}

Operátory#

condition#

Splits the run: output yes when the definition holds, else no. With waitUntilMet the contact waits until it holds (then yes) or the time runs out (then no); checked every 20 minutes to once a day.

Výstupy: yes, no · Povinné pro zapnutí: definition · SmartEmailing: condition

{
  "id": "condition-1",
  "type": "condition",
  "config": {
    "definition": {
      "type": "group",
      "match": "all",
      "rules": [
        {
          "type": "email_activity",
          "operator": "opened",
          "nodeId": null
        }
      ]
    }
  }
}

wait#

Waits. mode time: until the time spec (relative to the arrival at the node, or to the entry with countFrom scenario); preferred: until the contact's usual reading time (most frequent quarter hour of opens, else no wait); spread: releases the contacts evenly over the period; duration: value units; time_of_day: the next HH:MM; weekday: the next listed weekday at time; date: a local date and time. At most 10 years.

Výstupy: next · Povinné pro zapnutí: mode · SmartEmailing: wait

{
  "id": "wait-1",
  "type": "wait",
  "config": {
    "mode": "duration",
    "value": 2,
    "unit": "days"
  }
}

ab_test#

Splits contacts randomly (stable per run) into 2 to 10 variants; outputs v1..vN.

Výstupy: v1, ..., v10 · Povinné pro zapnutí: variants · SmartEmailing: ab

{
  "id": "ab-test-1",
  "type": "ab_test",
  "config": {
    "variants": [
      {
        "key": "v1",
        "share": 50
      },
      {
        "key": "v2",
        "share": 50
      }
    ]
  }
}

holding#

Storage (Odkladiště): contacts wait here until an edge out of the node is added (then they continue) or 90 days pass.

Výstupy: next · SmartEmailing: storage

Bez nastavení.

{
  "id": "holding-1",
  "type": "holding",
  "config": {}
}

goal#

Goal of the scenario: before every step the goals are checked; a contact who meets one leaves the scenario wherever it is. No edges in or out.

Výstupy: - · Povinné pro zapnutí: definition

{
  "id": "goal-1",
  "type": "goal",
  "config": {
    "definition": {
      "type": "group",
      "match": "all",
      "rules": [
        {
          "type": "ordered_since_entry",
          "operator": "yes",
          "shopId": null
        }
      ]
    }
  }
}

Akce#

send_email#

Sends an e-mail from a template (once per node and contact within the company's window). Only to mailable contacts, rechecked right before sending.

Výstupy: next · Povinné pro zapnutí: templateId · SmartEmailing: send-email

{
  "id": "send-email-1",
  "type": "send_email",
  "config": {
    "templateId": "301",
    "subject": "Zapomněli jste něco v košíku",
    "trackOpens": true,
    "trackClicks": true
  }
}

list_change#

Sets the contact's state in manual lists (confirmed adds, unsubscribed and removed take out). Lists bound to an e-shop cannot be changed.

Výstupy: next · Povinné pro zapnutí: status, listIds · SmartEmailing: add-to-list

{
  "id": "list-change-1",
  "type": "list_change",
  "config": {
    "status": "confirmed",
    "listIds": [
      "101"
    ]
  }
}

webhook#

Calls a URL (queued, retried 5 times 5 minutes apart on a non-2xx answer, then an action failure "other"). Merge tags work in url (percent-encoded), body (JSON-escaped when the Content-Type is JSON; POST defaults to application/json) and header values. Only public addresses, no redirects.

Výstupy: next · Povinné pro zapnutí: url · SmartEmailing: send-webhook

{
  "id": "webhook-1",
  "type": "webhook",
  "config": {
    "url": "https://crm.example.cz/hooks/postarna",
    "method": "POST",
    "body": "{\"email\": \"{{df_emailaddress}}\", \"event\": \"cart\"}",
    "headers": [
      {
        "name": "X-Source",
        "value": "postarna"
      }
    ]
  }
}

set_field#

Sets or clears a contact field. valueKind fixed (a value of the field's type), relative (dates: a time spec from now) or template (text fields: merge tags).

Výstupy: next · Povinné pro zapnutí: field, action · SmartEmailing: set-field

{
  "id": "set-field-1",
  "type": "set_field",
  "config": {
    "field": "cf:62",
    "action": "set",
    "valueKind": "fixed",
    "value": "VIP"
  }
}

reset#

Ends the contact's other active runs of this scenario that wait in nodes after this one (SmartEmailing Reset).

Výstupy: next · SmartEmailing: reset

Bez nastavení.

{
  "id": "reset-1",
  "type": "reset",
  "config": {}
}

fire_event#

Fires a custom event of the contact that event triggers (custom) of OTHER automations listen to.

Výstupy: next · Povinné pro zapnutí: name · SmartEmailing: fire-event

{
  "id": "fire-event-1",
  "type": "fire_event",
  "config": {
    "name": "vip-reached",
    "data": {
      "level": "gold"
    }
  }
}

notify#

Notifies the team in the app (notification centre).

Výstupy: next · Povinné pro zapnutí: message

{
  "id": "notify-1",
  "type": "notify",
  "config": {
    "message": "Zákazník dosáhl VIP úrovně",
    "important": false
  }
}

goto#

Jumps to another node of this graph (not a trigger or goal; the jump counts as an edge for cycles, so only forward).

Výstupy: - · Povinné pro zapnutí: target

end#

Ends the run (the contact leaves).

Výstupy: -

Bez nastavení.

{
  "id": "end-1",
  "type": "end",
  "config": {}
}

Zatím nedostupné#

Podmínky automatizací#

Pravidla uzlu condition, cíle a filtru spouštěčů (spolu s pravidly segmentů níže). Každé smí mít negate.

ab_test_significant#

The difference between nodes A and B is significant (95 %, two-proportion z-test).

ab_test_winner#

Node A beats node B (two send_email nodes of this graph) in open or click rate.

cart_items#

Old name of cart_items_count (still accepted).

{
  "type": "cart_items",
  "operator": "gt",
  "value": 0
}

cart_items_count#

Items in the contact's cart (a cart not changed since an order counts as empty).

{
  "type": "cart_items_count",
  "operator": "gt",
  "value": 0,
  "shopId": "1"
}

contact_anniversary#

Today is (or is offset from) the contact's birthday, name day or a date custom field. nameDay: the contact's own name day, else the calendar of the first name (calendar auto = Slovak for language sk, else by the shop's language).

{
  "type": "contact_anniversary",
  "field": "nameDay",
  "calendar": "auto",
  "relation": "now"
}

contact_field#

A contact field (system field or cf:<id>) compared with a value. Text: eq, filled, empty, gt, gte, lt, lte, starts, contains; dates: date_eq, date_filled, date_empty, date_after, date_from, date_before, date_until with a time spec value; numbers: eq, gt, gte, lt, lte, filled, empty; gender: eq (f / m); checkbox: checked, unchecked; choice: eq_option; multi: has_option.

{
  "type": "contact_field",
  "field": "city",
  "operator": "eq",
  "value": "Brno"
}

contact_in_any_list#

Contact is in any list in a state.

{
  "type": "contact_in_any_list"
}

contact_in_automation#

Contact is in an automation (another active run of it). automationId null = this automation (not allowed in a trigger filter).

{
  "type": "contact_in_automation",
  "automationId": "201"
}

contact_in_list#

Contact is in a list in a state.

{
  "type": "contact_in_list",
  "listId": "101",
  "state": "confirmed"
}

contact_in_list_label#

Contact is in a list with this label.

{
  "type": "contact_in_list_label",
  "label": "newsletter"
}

contact_origin#

Contact came from a source.

{
  "type": "contact_origin",
  "origin": "signup_form"
}

contact_purpose#

Contact has a valid consent with a purpose.

{
  "type": "contact_purpose",
  "purposeId": "51"
}

day_of_month#

Today is one of these days of the month.

{
  "type": "day_of_month",
  "days": [
    1,
    15
  ]
}

day_of_week#

Today is one of these weekdays (1 = Monday).

{
  "type": "day_of_week",
  "weekdays": [
    6,
    7
  ]
}

email_activity#

The contact opened / clicked an e-mail of this run (nodeId null = any). Run only. (not allowed in trigger filters (needs a run))

{
  "type": "email_activity",
  "operator": "opened",
  "nodeId": null
}

engagement_score#

Engagement level of the contact.

{
  "type": "engagement_score",
  "levels": [
    "A",
    "B"
  ]
}

event_attribute#

A value of the data of the custom event that started the run (data of POST /contact-events type custom, or of a fire_event node of another automation). Other triggers have no such data. Run only. (not allowed in trigger filters (needs a run))

{
  "type": "event_attribute",
  "attribute": "plan",
  "operator": "eq",
  "value": "gold"
}

feed_item_count#

Number of items of a feed.

{
  "type": "feed_item_count",
  "feedId": "71",
  "operator": "gt",
  "value": 0
}

hour_of_day#

The current hour (local) is one of these.

{
  "type": "hour_of_day",
  "hours": [
    8,
    9,
    10
  ]
}

opened_email#

The contact opened an e-mail of a node.

{
  "type": "opened_email",
  "emailNode": {
    "automationId": "201",
    "nodeKey": "email-1"
  }
}

opened_emails_count#

Number of e-mails the contact opened.

{
  "type": "opened_emails_count",
  "operator": "eq",
  "value": 0
}

ordered_attribute#

A value of an order: code, state, status, sourceStatus, currency, companyId, totalWithVat, totalWithoutVat, or any delivery data field.

{
  "type": "ordered_attribute",
  "attribute": "currency",
  "operator": "eq",
  "value": "CZK"
}

ordered_product#

The contact ordered a product by id (product code) or name.

{
  "type": "ordered_product",
  "productField": "id",
  "operator": "eq",
  "value": "SKU-001"
}

ordered_product_by_attribute#

The contact ordered a product with a feed attribute.

{
  "type": "ordered_product_by_attribute",
  "attribute": "brand",
  "operator": "eq",
  "value": "Example"
}

ordered_since_entry#

The contact ordered since the run entered. Run only. (not allowed in trigger filters (needs a run))

{
  "type": "ordered_since_entry",
  "operator": "yes",
  "shopId": null
}

orders_count#

Number of orders.

{
  "type": "orders_count",
  "operator": "eq",
  "value": 1,
  "paid": "any"
}

orders_total_value#

Sum (or avg, min, max) of the contact's orders with VAT in one currency.

{
  "type": "orders_total_value",
  "operator": "gte",
  "value": "3000",
  "currency": "CZK"
}

passed_node#

This run went (or did not go) through a node. Run only. (not allowed in trigger filters (needs a run))

promo_code#

The contact got (assigned) or used a coupon of a stack.

{
  "type": "promo_code",
  "state": "used",
  "stackId": "81"
}

script#

A Twig script; true when it prints {{ result.returnTrue() }}. Not allowed in trigger filters. (not allowed in trigger filters (needs a run))

{
  "type": "script",
  "script": "{% if contact.city == 'Brno' %}{{ result.returnTrue() }}{% endif %}"
}

sent_email#

An e-mail was sent to the contact: of one node (mode node) or of an automation (mode automation, automationId null = any).

{
  "type": "sent_email",
  "mode": "node",
  "emailNode": {
    "automationId": "201",
    "nodeKey": "email-1"
  }
}

sent_emails_count#

Number of e-mails sent to the contact.

{
  "type": "sent_emails_count",
  "operator": "gte",
  "value": 3
}

tracking_url_clicked#

The contact clicked a link in an e-mail of a node.

{
  "type": "tracking_url_clicked",
  "emailNode": {
    "automationId": "201",
    "nodeKey": "email-1"
  },
  "link": "https://www.example.cz/akce"
}

tracking_url_clicked_any#

The contact clicked any link of a node (emailNode null = any e-mail node of this automation).

{
  "type": "tracking_url_clicked_any",
  "emailNode": null
}

visited_attribute#

A web tracking visit with an attribute.

{
  "type": "visited_attribute",
  "attribute": "category",
  "operator": "eq",
  "value": "Káva"
}

visited_url#

A web tracking visit of a URL.

{
  "type": "visited_url",
  "url": "https://www.example.cz/kosik",
  "urlOperator": "starts"
}

Zatím nedostupné podmínky#

Pravidla segmentů#

Pravidla segmentů (a podmínek automatizací). Hodnoty jsou řetězce.

campaign#

Delivered / opened / clicked a campaign (not_* also matches contacts that never got it); linkUrl narrows clicks to one link.

{
  "type": "campaign",
  "operator": "opened",
  "campaignId": "121",
  "days": null
}

custom_field#

A custom field. kind must match the field type: text and textarea -> text, number -> number, date -> date, checkbox -> bool, select and radio -> choice, multi_checkbox -> multi_choice (400 definition.<path>.kind otherwise). Operators: text like the text fields, number gte/lte/eq/is_empty/is_not_empty, date like the date fields, bool is_true/is_false, choice is/is_not, multi_choice contains_any/contains_all/not_contains_any.

{
  "type": "custom_field",
  "fieldId": "62",
  "kind": "text",
  "operator": "equals",
  "value": "VIP"
}

engagement#

Engagement level A (best) to E, N = new.

{
  "type": "engagement",
  "operator": "in",
  "values": [
    "A",
    "B"
  ]
}

field#

A contact field compared with a value. Text operators ignore case and diacritics; date operators count calendar days of the company. Text fields: email, firstName, lastName, city, company, companyId, phone, mobile, street, postalCode, note, country. Enum fields: status (pending/subscribed/unsubscribed/bounced/complained/customer), gender (f/m), language (cs/sk), source (erp_order/signup_form/import/api/manual/shoptet/smartemailing), consentBasis (soft_opt_in_customer/double_opt_in/imported/none). Date fields: createdAt, lastOpenAt, lastClickAt, lastSentAt, statusAt, consentAt.

{
  "type": "field",
  "field": "lastOpenAt",
  "operator": "in_last_days",
  "value": "60"
}

last_order#

The last completed order: within / older than N days, or before / after a date.

{
  "type": "last_order",
  "operator": "older_than_days",
  "value": "180"
}

list#

Membership in a list. in / not_in = confirmed or unconfirmed member; status_is compares the exact state; added_before / added_after compare the day the contact was added; longer_than_days / shorter_than_days: in the list longer / shorter than N days.

{
  "type": "list",
  "operator": "in",
  "listId": "101"
}

list_label#

Confirmed or unconfirmed member of any list with this label.

{
  "type": "list_label",
  "operator": "in",
  "label": "vip"
}

opens#

Number of the contact's e-mails (campaigns and automations) with an open.

{
  "type": "opens",
  "operator": "gte",
  "value": "3",
  "days": "90"
}

order_attribute#

A completed order has an item whose product code, category, brand or another item attribute (as stored on the order item) equals the value; with scope order an attribute of the order itself.

{
  "type": "order_attribute",
  "operator": "is",
  "attribute": "brand",
  "value": "Example"
}

order_count#

Number of completed orders.

{
  "type": "order_count",
  "operator": "gte",
  "value": "2",
  "shopId": null,
  "currency": null,
  "days": "365"
}

order_value#

Sum of completed orders with VAT in one currency (CZK and EUR are never added up).

{
  "type": "order_value",
  "operator": "gte",
  "amount": "2000",
  "currency": "CZK",
  "shopId": "1",
  "days": "365"
}

product_bought#

A completed order has an item whose name contains the text or whose product code equals it (case and diacritics ignored).

{
  "type": "product_bought",
  "operator": "is",
  "value": "Espresso",
  "days": "30"
}

purpose#

A valid (not withdrawn, within its validity) consent with a purpose of processing.

{
  "type": "purpose",
  "operator": "has",
  "purposeId": "51"
}

segment#

Member of another segment of the same shop (never itself; chains at most 5 deep, no cycles).

{
  "type": "segment",
  "operator": "not_in",
  "segmentId": "91"
}

web_attribute#

A page visit whose attribute matches: visitType = the page type, other names = the visit's own attributes; gt to lte compare numbers.

{
  "type": "web_attribute",
  "attribute": "visitType",
  "operator": "is",
  "value": "product"
}

web_visit#

A page visit recorded by the shop's script or the API; any = any page.

{
  "type": "web_visit",
  "operator": "contains",
  "url": "/kava/",
  "days": "30"
}

Časové údaje#

A moment relative to a base moment (SmartEmailing's "Varianta výběru času"). The base is the moment the contact arrived at the node (or entered the scenario, countFrom scenario), or now in conditions. Days and longer keep the local wall time; months are calendar months. In waits only calendar, interval with sign "+" and event without the words yesterday and previous are allowed. Preview any spec with POST /automations/resolve-time.

calendar#

A local calendar date and time.

interval#

Base plus or minus a number of units.

event#

A named day: today, tomorrow, this/next/previous weekday, working day, week, month or year, or the last day of this or next month.

[
  {
    "variant": "interval",
    "sign": "+",
    "value": 2,
    "unit": "days",
    "time": "09:00"
  },
  {
    "variant": "event",
    "word": "next",
    "unit": "monday",
    "time": "08:00"
  },
  {
    "variant": "calendar",
    "date": "2026-12-24",
    "time": "09:00"
  }
]