Vlastní programovatelný blok

Jaroslav Bouška

11. dubna 2023

Sdílet článek

V tomto bloku si můžete připravit data pro šablonu, případně si vytvořit vlastní logické podmínky pro regulaci toku kontaktů v rámci automatizace. Kromě funkcí, které lze použít v šablonách nebo při přípravě kampaně má vlastní blok několik funkcí přímo pro správu toku dat – nastavení zpoždění, více výstupních bodů, ukončení toku pro kontakt aj.

Dostupné proměnné v bloku automatizace

global – obsahuje objekt se všemi daty obsahující globální proměnné

contact – obsahuje objekt s daty o kontaktu

stateData – obsahuje objekt s daty o stavu kontaktu v automatizaci. Formát objektu je proměnlivý a záleží na tom, jak kontakt do automatizace vstoupil a jak se s ním v automatizaci dále pracovalo. Může tedy například obsahovat informace o objednávce či košíku, na jejichž základu kontakt do automatizace vstoupil nebo identifikátor odeslaného transakčního e-mailu či SMS. Sem se také průběžně ukládají data z funkce saveData.

Použití:

{{ global.company.name }} - vypíše název firmy z definované globální proměnné company

{{ contact.email }} - email kontaktu - pokud kontakt existuje v seznamech příjemců
{{ contact.surname}} - příjmení kontaktu - pokud kontakt existuje v seznamech příjemců

{{ stateData.orderId }} - vrátí ID objednávky na základě které byl kontakt vložen do automatizace

Uložení dat ke kontaktu automatizace

saveData dataName data

Popis: uloží data ke kontaktu automatizace s daným názvem

Argumenty: dataName – jméno proměnné, pod kterou se data uloží. Povolené znaky jsou a-Z, pomlčky a podtržítka

Návratová hodnota: true/false – vrací true, pokud se podaří uložit data

Použití:

{{
mojeData = { "cisloProdejny" : 1 }
result = saveData 'mojeData' mojeData
}}

Nastavení stavu dokončeno

setFinishedState

Popis: aktuální stav kontaktu v automatizaci nastaví jako dokončen. Pro kontakt již automatizace nebude pokračovat

Argumenty:

Návratová hodnota: true/false – vrací true, pokud se podaří uložit data

Použití:

{{ setFinishedState }}

Nastavení výstupního bodu

setOutputPoint outputPointLetter

Popis: nastaví výstupní bod pro aktuální stav kontaktu v automatizaci

Argumenty: outputPointLetter – písmeno označení výstupního bodu – A, B, C, D, …

Návratová hodnota: true/false – vrací true, pokud se podaří uložit data

Použití:

{{ setOutputPoint 'A'}}

Nastavení dalšího zpracování na určitý čas

setNextStart customDate

Popis: pro zpracovávaný kontakt v automatizaci umožňuje nastavit zpoždění/datum a čas dalšího pokračování

Argumenty: customDate – datum a čas v UTC dalšího pokračování pro kontakt v rámci automatizace

Návratová hodnota: true/false – vrací true, pokud se podaří zvalidovat a uložit data

Použití:

{{ setNextStart '2023-04-11 11:59' }}

Odeslání emailu

sendEmail
Popis: Funkce pro odeslání emailu pomocí vlastního bloku
Argumenty:
sendEmail – název metody pro odeslání emailu
templateId – ID šablony, kterou chcete použít
to – objekt, který obsahuje data o příjemci
address – adresa příjemce
Použití:

{{
  sendEmail {
    "templateId":1,
    "to":{
      "address":"prijemce@email.cz"
      }
    }
}}