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. Faqat buyurtmani tasdiqlash, parolni tiklash va shunga oʻxshash xabarlar uchun ishlating |

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 |
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.

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.pro 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 |
| 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.
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.
