Premenné v správach

Premenná je zástupné miesto v texte správy. Každý príjemca na ňom dostane svoju vlastnú hodnotu — meno, názov firmy, číslo objednávky. Jeden text tak pošlete tisícom ľudí a každý si prečíta správu písanú jemu. Zápis premenných je rovnaký v kampani aj v API.

Ako sa premenná zapisuje

Premenná je názov v lomených zátvorkách, napríklad <first_name_vokativ>. Pri odoslaní sa nahradí hodnotou, ktorú pre daného príjemcu máte:

• Názov musí sedieť presne. Záleží na veľkosti písmen aj na medzerách — <First_Name> ani < first_name > sa hodnotou first_name nenahradí.
• Prázdna hodnota je to isté ako žiadna. Prázdny text alebo samé medzery sa berú ako chýbajúca hodnota — čo sa potom stane, popisuje Keď hodnota chýba.

Keď hodnota chýba

Keď pre príjemcu hodnotu nemáte, zostane premenná v správe doslova — príjemca dostane Dobrý den <first_name_vokativ>, …. Tomu zabránite predvolenou hodnotou, ktorú napíšete za dvojbodku:

Príjemca, pre ktorého hodnotu máte, dostane vo všetkých troch prípadoch tú svoju.

Filtre

Filter dosadenú hodnotu upraví — prevedie ju na veľké písmená, oreže medzery, vytvorí z mena oslovenie alebo postráži jej dĺžku. Píše sa za zvislú čiaru hneď za názov premennej: <first_name|upper>. Filtrov môžete napísať viac za sebou a použijú sa zľava doprava: <city|trim|capitalize> — viac v časti Reťazenie filtrov.

Veľkosť písmen

Úprava textu

Meno a oslovenie

Dva filtre pracujú s českými menami: vocative vytvorí oslovenie v 5. páde a gender podľa mena vyberie text pre muža, alebo pre ženu. Riadia sa rovnakými pravidlami ako premenné <first_name_vokativ> a <last_name_vokativ> — ako oslovenie vzniká, popisuje České oslovenie (vokatív).

• Oslovenie z akejkoľvek premennej. Na rozdiel od <first_name_vokativ> sa filter vocative dá použiť na ľubovoľnú premennú — napríklad na celé meno uložené v jednom poli alebo na hodnotu, ktorú posielate v API.
• Pohlavie a druh mena filter vocative rozpozná sám podľa koncovky. Keď sa netrafí, určíte ich parametrami: prvý je man (muž) alebo woman (žena), druhý first (krstné meno) alebo last (priezvisko), napríklad <last_name|vocative:woman,last>. Predvolená hodnota oboch parametrov auto nechá rozhodnutie na filtri.
• Veľkosť písmen. Každé oslovené slovo začne veľkým písmenom a ostatné písmená budú malé: NOVÁK → Nováku.
• Predvolená hodnota sa skloňuje tiež, takže ju napíšete v 1. páde: príjemca bez mena dostane z <first_name:zákazník|vocative> text Zákazníku.
• Text podľa pohlavia nahradí hodnotu, preto premennú do textu napíšte dvakrát: <first_name|gender:Milý,Milá> <first_name|vocative> dá Milý Petře, alebo Milá Jano. Text môže byť aj len koniec slova: Vážen<first_name|gender:ý pane,á paní> dá Vážený pane, alebo Vážená paní. Oba texty sú povinné, môžu však byť prázdne; nesmú obsahovať <, >, | ani čiarku.
• Bez mena sa pohlavie určí z predvolenej hodnoty — <first_name:zákazníku|gender:Milý,Milá> dá pri príjemcovi bez mena Milý. Prázdna predvolená hodnota dá vždy text pre muža.

Obmedzenie dĺžky

Filtre s číslom strážia, koľko znakov smie mať dosadená hodnota najviac. Hodí sa pri dlhých hodnotách, ako je názov firmy alebo adresa, ktoré by inak správu natiahli do ďalšej časti SMS. Filter určuje, čo sa s dlhšou hodnotou stane:

Hodnota, ktorá sa do limitu zmestí, sa dosadí celá.

Pri truncate, ellipsis a fallback môžete za čiarku napísať vlastný text, ktorý sa použije namiesto predvoleného:

Vlastný text nesmie obsahovať <, >, | ani čiarku. Prázdny text (truncate:8,) hodnotu skráti bez prípony.

Reťazenie filtrov

Filtre môžete ľubovoľne kombinovať — stačí ich napísať za seba, každý za vlastnú zvislú čiaru. Použijú sa postupne zľava doprava a každý ďalší filter dostane výsledok toho predchádzajúceho. Obmedzenie dĺžky tak môžete spojiť s úpravou veľkosti písmen aj s orezaním medzier.

V treťom príklade trim najprv odstráni medzery, truncate:8,… hodnotu skráti na Kytary… a upper ju nakoniec prevedie na veľké písmená.

• Na poradí záleží. Rovnaké filtre v inom poradí dajú iný výsledok. Pri hodnote " Ústí nad Labem " dá <city|trim|cut:4> výsledok Ústí, kým <city|cut:4|trim> najprv skráti hodnotu na úvodné medzery a potom ich oreže — nezostane nič.
• Predvolená hodnota sa píše pred filtre a celý reťazec upraví aj ju: príjemca bez mena dostane z <first_name:zákazníku|trim|upper> text ZÁKAZNÍKU.
• Každý výskyt premennej má vlastné filtre. Jednu premennú môžete v texte použiť viackrát a zakaždým inak: z Dobrý den <first_name|first_upper>, <first_name|upper> dostane príjemca s hodnotou jan text Dobrý den Jan, JAN.
• V editore kampane zodpovedá reťazec poradiu filtrov v dialógu premennej a meníte ho presunutím. Každý filter tam použijete raz.

Na čo si dať pozor

Názov filtra píšete malými písmenami a bez medzier, číslo iba číslicami.

Zastaraný zápis so znakom rovnosti

Kedysi sa dĺžka obmedzovala skratkou: za znak rovnosti sa písal limit a za neho písmeno, ktoré určovalo, čo sa s dlhšou hodnotou stane. Tento zápis je zastaraný — v nových správach používajte filtre. Správy, ktoré ho obsahujú, fungujú ďalej a editor kampane ho prepíše na filter.

Skratka sa použije ako prvý filter, aj keď sú za ňou pripísané ďalšie: <company_name=8|upper> je to isté ako <company_name|cut:8|upper>.

Premenné v kampani

Kampaň berie hodnoty z kontaktov, ktoré do nej pridáte — z adresára, z importu súboru aj z ručne zadaných čísel.

1. Najprv pridajte príjemcov. Ponuka premenných ukazuje iba polia, ktoré má vyplnené aspoň jeden príjemca kampane. Bez príjemcov je prázdna.
2. V editore textu kliknite na ikonu Pridajte premennú, alebo rovno napíšte @. Písaním názvu ponuku zúžite.
3. Vyberte premennú. Pri každej vidíte, koľko percent príjemcov pre ňu má dáta.

Premenná sa v texte zobrazí ako štítok s názvom poľa a farbou ukazuje, ako ste na tom s dátami:

• bez zvýraznenia — dáta má každý príjemca, alebo je nastavená predvolená hodnota,
• varovanie — dáta má 30 až 99 % príjemcov,
• chyba — dáta má menej než 30 % príjemcov, alebo také pole neexistuje.

Kliknutím na štítok uvidíte súhrn premennej vrátane aktívnych filtrov v poradí, v akom sa použijú, a odtiaľ ju upravíte:

• Keď hodnota chýba — doplníte náhradný text, necháte premennú vynechať, alebo ju ponecháte v texte.
• Filtre — pridávate ich jeden po druhom z ponuky rozdelenej na veľkosť písmen, úpravu textu, meno a oslovenie a dĺžku. Pri filtroch s parametrom vyplníte číslo alebo text, prípadne vyberiete možnosť. Poradie zmeníte presunutím za úchyt, filtre sa použijú zhora nadol, a filter, ktorý nepotrebujete, zmažete. Na ukážkovej hodnote vidíte, čo filter urobí.

Editor premennú uloží v rovnakom zápise, aký popisujú Keď hodnota chýba a Filtre, napríklad <company_name:vaša firma|trim|cut:8>. Staršiu skratku so znakom rovnosti pritom prepíše na filter.

Ktoré polia môžete použiť

Pri importe zo súboru priradíte každý stĺpec k jednému z týchto polí. Stĺpec, pre ktorý sa žiadne nehodí — číslo objednávky, výška zľavy —, priraďte k vlastnému poľu a v texte použite napríklad <custom_field_0>.

Kanály, dĺžka a náhľad

• Kanály. Premenné fungujú v texte správy SMS, Viber aj RCS, pri RCS aj v titulku.
• Dĺžka a cena. Počítadlo znakov v editore počíta s hodnotami kontaktu, ktorého máte vybraného v náhľade. Každý príjemca však môže mať inak dlhé hodnoty — počet častí SMS a cena sa preto počítajú pre každého zvlášť, až po dosadení.
• Unicode. Diakritika z dosadenej hodnoty prepne SMS do Unicode iba vtedy, keď ho máte v nastavení textu zapnutý.
• Náhľad. Náhľad správy aj Poslať testovaciu správu dosadzujú hodnoty kontaktu vybraného v náhľade — ešte pred odoslaním tak vidíte, ako text dopadne. Výnimkou sú filtre vocative a gender: náhľad v editore meno neskloňuje, iba ho označí 🗣️, a pri gender ukáže oba texty, napríklad Milý/Milá. S týmito tvarmi počíta aj počítadlo znakov. Skutočný výsledok uvidíte v testovacej správe.

Premenné v API

V API posielate hodnoty priamo v požiadavke, v parametri variables: objekt, kde kľúč je názov premennej a hodnota to, čo sa má dosadiť. V texte platí rovnaký zápis vrátane predvolených hodnôt a filtrov.

Príjemca dostane Dobrý den Petře, objednávka 12345 je na cestě. Názov premennej si môžete zvoliť ľubovoľný — <order> v príklade nie je pole kontaktu, iba kľúč z variables.

Kam premenné patria

Aké hodnoty posielať

• Text alebo číslo. Čísla sa dosadia tak, ako sú (12 → 12).
• null, false a prázdny text sa berú ako chýbajúca hodnota — uplatní sa predvolená hodnota, inak premenná zostane v texte doslova.
• Pole ani objekt ako hodnotu Advanced API neprijme a vráti chybu invalid_input_parameters.
• Kľúče navyše, ktoré v texte nie sú, sa ignorujú.
• 5. pád. Advanced API z first_name a last_name samo dopočíta first_name_vokativ a last_name_vokativ — vlastné hodnoty týchto dvoch kľúčov prepíše. Integration API 5. pád nedopočítava. Ako oslovenie funguje, popisuje České oslovenie (vokatív).

Kanály a dĺžka

Počet častí SMS aj cena sa počítajú z textu po dosadení. Diakritika z dosadenej hodnoty prepne SMS do Unicode iba s "unicode": true. Text Viberu, RCS a WhatsAppu, ktorý po dosadení prerastie limit kanála (Viber 1 000 znakov, RCS a WhatsApp 5 000), sa skráti.