Shablonlar va xat konstruktori
Shablon — bitta kanal uchun tayyor xabar: xat, Telegram xabari, SMS, Web Push, webhook va boshqalar. Bitta shablondan zanjirlar, kampaniyalar va profil kartasidan qoʻlda yuborish foydalanadi. Oʻzgaruvchilar matnga mijoz ismi, buyurtma summasi va boshqa maʼlumotlarni qoʻyadi.
Boʻlim Kommunikatsiyalar → Shablonlar menyusida joylashgan. Shablonlarni barcha rollar koʻrishi mumkin, yaratish va oʻzgartirishni esa «Menejer» va undan yuqori rollar bajaradi.
Shablon yaratish
- Shablonlar boʻlimini oching. Yuqori oʻng tomonda loyihada yoqilgan har bir kanal uchun tugma bor, masalan, Email yoki Telegram. Keraklisini bosing.
- Umumiy maydonlarni toʻldiring (quyidagi jadval).
- Mazmun blokini toʻldiring. Maydonlar toʻplami kanalga bogʻliq. Xatda bular Mavzu, Prexeder (xatlar roʻyxatida mavzu yonidagi matn), Xat konstruktori yoki HTML, shuningdek Matnli versiya. Agar matnli versiya toʻldirilmasa, u HTML dan yigʻiladi.
- Saqlash tugmasini bosing. Har bir saqlashdan keyin versiya raqami oshadi («Versiya 3»).
| Maydon | Nimani anglatadi |
|---|---|
| Nomi | Faqat interfeysda koʻrinadi: shablonlar, zanjirlar va kampaniyalar roʻyxatlarida |
| Kanal | Yaratishda tanlanadi, keyin uni oʻzgartirib boʻlmaydi |
| Obuna mavzusi | Masalan, marketing yoki news. Mijoz faqat shu mavzudan obunani bekor qilishi mumkin |
| Tranzaksion xabar | Obuna, chastota va sokin soatlar tekshiruvisiz yuboriladi, lekin qabul qiluvchida yopiq kanalga emas: pochta qutisi yoki raqam yoʻq, bot bloklangan. Faqat buyurtmani tasdiqlash, parolni tiklash va shunga oʻxshash xabarlar uchun ishlating, qarang: Tranzaksion xabarlar va kaskadlar |

Shablonni oʻchirish uchun roʻyxatdagi uning qatoridagi savat belgisini bosing.
Oʻzgaruvchilar
Shablonlar Twig tilida yoziladi. Oʻzgaruvchi ikki qavat jingalak qavslarga olinadi. Mazmun ostidagi Oʻzgaruvchilar blokini ochsangiz, misollar bilan toʻliq roʻyxat koʻrinadi.
| Oʻzgaruvchi | Nima qoʻyiladi |
|---|---|
profile.email, profile.phone, profile.user_id |
Mijoz identifikatorlari |
traits.first_name va boshqa traits.* |
Profil xususiyatlari |
event.name, event.properties.amount |
Xabarni ishga tushirgan hodisa |
context.data.*, context.nodes.* |
Zanjir maʼlumotlari: API orqali kirishda uzatilganlar va «Webhook» tugunining javobi |
project.name, unsubscribe_url |
Loyiha nomi va obunani bekor qilish havolasi |
loyalty.points, loyalty.tier, loyalty.expiring, loyalty.expire_at, loyalty.referral_url |
Sodiqlik dasturidagi hisob: balans, daraja, muddati tugayotgan ballar va ularning sanasi, taklif havolasi |
promo_code('welcome') |
welcome pulidan xaridorning promokodi: yuborishda beriladi, oldindan koʻrishda — namuna |
order.number, order.amount, order.tracking_url |
Doʻkon xati buyurtmasi: raqam, summa, kuzatuv havolasi; valyutali summa — {{ order.amount|money(order.currency) }} |
product('SKU-1') |
Xat tilidagi katalog mahsuloti: name, url, image, price, old_price, currency, available, stock — yuborish paytidagi holat (mahsulotlar narxi va mavjudligi) |
Assalomu alaykum, {{ traits.first_name|default('hurmatli mijoz') }}!
{% if event.properties.amount > 5000 %}Yetkazib berish bepul.{% endif %}
Shablonlar xavfsiz qumdonda (sandbox) bajariladi. Unda if shartlari, for sikllari, set, date, min, max funksiyalari hamda default, date, upper, lower, capitalize, number_format, round, join, replace, striptags va boshqa filtrlar bor. Agar oʻzgaruvchi boʻlmasa, boʻsh satr qoʻyiladi, shuning uchun muhim joylar uchun default belgilang. Taqiqlangan konstruksiya ishlatilsa, saqlashda «Shablonda taqiqlangan konstruksiya» xatosi chiqadi. Tayyor xabar 512 KB dan katta boʻlishi mumkin emas.
Oldindan koʻrish va test yuborish
- Oldindan koʻrish panelida profil ID si, email yoki user_id ni kiriting va koʻz belgisini bosing. Maydon boʻsh qoldirilsa, maʼlumotlar oxirgi faollikka ega profildan olinadi.
- Xat uchun Kompyuter, Telefon va Tungi rejim rejimlarini almashtiring.
- Test yuborish panelida integratsiyani tanlang. Oʻz manzilingiz yoki chat id ni koʻrsating, aks holda xabar profil manziliga yuboriladi. Testni yuborish tugmasini bosing: tugma ostida xabar holati paydo boʻladi.
Test yuborish «Menejer» va undan yuqori rollar uchun mavjud. Bunda obuna, chastota va sokin soatlar tekshirilmaydi. Oldindan koʻrishda trigger hodisasi yoʻq, shuning uchun event.* oʻzgaruvchilari boʻsh qoladi. Agar Sizda shaxsiy maʼlumotlarni koʻrish ruxsati boʻlmasa, email va telefon maskalanadi.

Til versiyalari
Bitta shablon bir nechta tildagi versiyalarni oʻz ichiga olishi mumkin. Har bir qabul qiluvchi oʻz profili tilidagi versiyani (language atributi), bunday versiya boʻlmasa — asosiysini oladi. Tanlash mumkin boʻlgan tillar loyiha sozlamalarida belgilanadi.
- Tarkib bloki ustida Til qoʻshish tugmasini bosing va tilni tanlang. Yangi versiya ochiq versiyaning nusxasi sifatida yaratiladi: dizayn, rasmlar va havolalar joyida, faqat matnlarni tarjima qilish qoladi.
- Versiyalar orasida til tugmalari bilan almashing. Asosiy versiya «asosiy» deb belgilangan.
- Oʻz versiyasi boʻlmagan qabul qiluvchilar boshqa tilni olishi uchun shu til versiyasini oching va Asosiy qilish tugmasini bosing. Versiyani oʻchirish ochiq versiyani olib tashlaydi.
- Saqlash tugmasini bosing. Har bir versiya alohida tekshiriladi; xatoli versiya ogohlantirish belgisi bilan belgilanadi.
Tarjima qoralamasi
Versiyani noldan qoʻlda tarjima qilmaslik uchun uni oching va Tarjima qoralamasi tugmasini bosing. OneTrace.ru asosiy versiyani ochiq tab tiliga tarjima qiladi: mavzu, prexeder, konstruktor bloklari matnlari, matnli versiya, SMS, push va messenjerlar matnlari. {{ traits.first_name }} kabi oʻzgaruvchilar, havolalar, rasmlar va dizayn oʻzgarmaydi.
Qoralama faqat shaklga qoʻyiladi. Uni oʻqib chiqing, ifodalarni tuzating va Saqlash tugmasini bosing. Agar biror maydonni oʻzgaruvchilarni yoʻqotmasdan tarjima qilib boʻlmasa, u asl tilda qoladi va OneTrace.ru bunday maydonlar sonini koʻrsatadi. Agar versiya allaqachon asosiy versiyadan farq qilsa, almashtirishdan oldin savol chiqadi.
Oyiga qoralamalar soni tarif bilan cheklangan — qarang: Tariflar. Agar tarjima sizning oʻrnatishingizda ulanmagan boʻlsa, tugma boʻlmaydi.
Versiya shunday tanlanadi: avval tilning aniq mosligi, keyin mintaqasiz til (pt-BR tilidagi xaridor pt versiyasini oladi), keyin oʻsha tilning boshqa varianti. Oldindan koʻrish va test yuborish ochiq versiyani koʻrsatadi, {{ language }} oʻzgaruvchisida yuborilayotgan versiya tili boʻladi.
Xat konstruktori
Email shablonida «Xat konstruktori» maydonidagi Konstruktorni ochish tugmasini bosing. Agar shablonda allaqachon HTML boʻlsa, konstruktor xatni qaytadan boshlaydi va eski kod saqlashda almashtiriladi. Pochta mijozlari, jumladan Outlook va telefonlar uchun kodni OneTrace.ru saqlashda oʻzi yigʻadi.
Kanvasning oʻng tomonida uchta yorliq bor:
- Bloklar — blok qoʻshish. U tanlangan blokdan keyin yoki xat oxiriga, pastki qismdan oldin joylashadi.
- Blok — kanvasda tanlangan blok sozlamalari. Bloklarni yuqoriga koʻtarish, pastga tushirish, sudrab olib borish, nusxalash va oʻchirish mumkin.
- Xat — fon, xat foni, matn va havolalar ranglari, shrift, xat kengligi (480–800 px), chekkalar va rasmlarni koʻrsatish usuli.
| Blok | Vazifasi |
|---|---|
| Sarlavha, Matn | Formatlash va oʻzgaruvchilar bilan matn, masalan, {{ traits.first_name }} |
| Rasm | Mediatekadagi rasm: muqobil matn, havola, kengligi 10–100 % |
| Tugma | Matn, havola, ranglar va burchak yumaloqligi |
| Ajratgich, Boʻshliq | Chiziq va boʻsh joy |
| Ustunlar | Sarlavhalar, matn, rasmlar, tugmalar va boʻshliqlar bilan 2–3 ustun. Telefonda ustunlar bir-birining ostiga joylashadi |
| Mahsulotlar | Tavsiyalardan tanlov: shaxsiy, mashhur, «Birga koʻriladi», «Oʻxshash» va h. k. 1–4 ustunda, narx va tugma bilan 1 dan 12 tagacha mahsulot koʻrsatish mumkin. Agar mos mahsulotlar boʻlmasa, blok xatga tushmaydi |
| Buyurtma | Doʻkon xatidagi buyurtma: mahsulotlar, summalar, posilkani kuzatish va manzillar. Buyurtmasiz xatlarda blok yoʻq |
| HTML | Oʻz kodingiz oʻzgarishsiz |
| Pastki qism | Matn va obunani bekor qilish havolasi |

«Xat» yorligʻidagi HTML ga oʻtish tugmasi xatni oddiy kodga aylantiradi. Shundan keyin konstruktorga qaytib boʻlmaydi.
Havola yoki biriktirma
| Havola (CDN) | Xatga biriktirilgan | |
|---|---|---|
| Xat hajmi | Yengil | Rasmlar hajmicha kattaroq |
| Koʻrsatish | Rasm ochilganda yuklanadi. Agar pochta rasmlarni bloklasa, faqat izoh koʻrinadi | Rasm darhol koʻrinadi |
Sukut boʻyicha usul «Xat» yorligʻidagi Rasmlar uchun standart usul maydonida belgilanadi. Alohida rasm uchun uni Koʻrsatish usuli maydonida oʻzgartirish mumkin. Bitta xatning barcha biriktirmalari birgalikda — 1 MB dan oshmasligi kerak. Agar oʻrnatmada ochiq havolalar sozlanmagan boʻlsa, faqat biriktirmalar mavjud.
Tayyor xatni import qilish
Agar xat boshqa xizmatda allaqachon tayyorlangan boʻlsa, uni qaytadan yigʻish shart emas. Shablonlar sahifasida Xatni import qilish (SI) tugmasini bosing:
- Faylni tanlang va pochta dasturidan saqlangan xatni (
.eml) yoki.htmlsahifani yuklang. Yoki HTML kodni tanlab, xat kodini joylashtiring. - Import qilish tugmasini bosing. SI odatda xatni bir daqiqagacha qayta ishlaydi.
- Yangi email shablon bilan muharrir ochiladi: xat konstruktor bloklariga ajratilgan, rasmlar mediatekaga koʻchirilgan, qabul qiluvchining ismi
{{ traits.first_name }}oʻzgaruvchisi bilan almashtirilgan, obunani bekor qilish havolasi esa «Pastki qism» blokiga oʻtkazilgan. Matnlar va havolalar xatdagidek qoladi. - Shablonni tekshiring va Saqlash tugmasini bosing. Saqlanmaguncha shablon yoʻq.


Agar xatning bir qismini koʻchirib boʻlmasa, forma ustida roʻyxat paydo boʻladi: qaysi rasmlar koʻchirilmagani yoki qaysi bloklar oʻtkazib yuborilgani. Agar xat bloklarga ajralmasa, u bitta «HTML» bloki sifatida koʻchiriladi. Kuzatuv piksellari va «Brauzerda ochish» havolasi koʻchirilmaydi.
Import «Oʻsish» va «Korporativ» tariflarida mavjud; oyiga importlar soni tarifga bogʻliq — Tariflar boʻlimiga qarang. «Start» tarifida tugma funksiya qaysi tarifdan mavjudligini koʻrsatadi.
Mediateka
Mediateka «Rasm» blokini qoʻshganingizda yoki Rasm tanlash tugmasini bosganingizda ochiladi.
- Yuklash 10 MB gacha boʻlgan JPEG, PNG, GIF, WebP va AVIF fayllarini qabul qiladi. Keng rasmlar 1200 px gacha kichraytiriladi. WebP va AVIF qayta kodlanadi, chunki ularni hamma pochta mijozlari ham koʻrsatmaydi. GIF animatsiyasi bilan birga oʻzgarishsiz qoladi.
- Agar xuddi shu fayl qayta yuklansa, nusxa yaratilmaydi.
- Shablonda ishlatilayotgan rasmni uni shablondan olib tashlamaguningizcha oʻchirib boʻlmaydi.
- Rasmlar egallagan joy tarif limitiga kiradi.
