Telegram botiga referal tizimini 2 daqiqada qanday qo'shish mumkin

Referal dastur — bu foydalanuvchilar sizga yangi foydalanuvchilarni olib kelganda, siz ular uchun pul to’laysiz. Oddiy eshitiladi. Lekin odatda ish shunday tugaydi: dasturchi ikki hafta davomida kod generatsiyasi, balans jadvali, firibgarlikdan himoya va to’lovlar admin panelini yozadi — keyin yana bir oy hammasini tuzatadi.

Graspil’da bularning barchasi allaqachon mavjud. Aslida faqat ikkita ish qilish kerak: botingizni ulash va referal dasturni yoqish. Har biriga bir daqiqa — bu maqolani o’qish sozlashdan ko’ra ko’proq vaqt oladi.

Referal tizimi umuman nima uchun kerak

Qisqacha: bu mavjud eng arzon jalb qilish kanali.

Referal do’stning tavsiyasi bilan keladi — ishonch allaqachon bor, to’lovga konversiya odatda yuqoriroq.
Siz natija uchun to’laysiz, ko’rsatishlar uchun emas. “Reklamaga byudjet sarfladik, faqat botlar keldi” degan holatlar bo’lmaydi.
Referrerlar uzoqroq qoladi: besh do’stini olib kelgan odam uchun botdan chiqish chegarasi ancha yuqori.
O’z-o’zidan o’sadi. Bitta mamnun foydalanuvchi → uchta yangi → ularning har biri o’z havolasi bilan.

Umuman olganda, aniq. Davom etamiz.

Tayyor holda nima mavjud

O’zingiz kod yozishingiz shart bo’lmaydigan narsalar ko’lamini tushunishingiz uchun:

Funksiya	Nima qiladi
Kodlar va havolalar	Har bir foydalanuvchi uchun noyob kod va tayyor havola `t.me/bot?start=...` — platforma tomonidan yaratiladi
“Kim kimni olib keldi” hisobi	Referrer → referal bog’lanishi havola orqali `/start` bosilganda avtomatik yoziladi
Botlar va Mini App	Oddiy botlar bilan ham, Telegram Mini App bilan ham ishlaydi — teglar bir xil qoidalar bo’yicha qayta ishlanadi
Mukofot qoidalari	To’lovdan foiz, referal uchun belgilangan summa, tashqi mukofot — hodisa qiymati bo’yicha shartlar bilan
Ko’p valyutalilik	Balans har bir valyuta bo’yicha alohida yuritiladi, majburiy konversiyasiz
Ushlab turish davri (hold)	Hisoblangan mablag’ N kun “muzlatiladi” — qaytarishlar uchun
To’lovlar	Qo’lda, webhook orqali, mashhur to’lov tizimlari orqali yoki jadval bo’yicha avtomatik
Tayyor avtomatlashtirish	Botdagi referal kabineti — katalogdan, bironta ham kod yozmasdan
Statistika	Voronka, top referrerlar, hisoblangan mablag’lar va to’lovlar dinamikasi
Referallar bo’yicha hisobotlar	Referal ma’lumotlari hisobot quruvchisida mavjud: faqat referal dasturi orqali kelganlar bo’yicha hisobot tuzish va ularni boshqalar bilan solishtirish mumkin
Moslashuvchan API	Agar bizning tayyor stsenariylarimiz mos kelmasa — kodlar, hisoblangan mablag’lar, balanslar va to’lovlar API orqali mavjud, o’z mantig’ingizni qurishingiz mumkin

Eng muhimi: Graspil referal tizimini, hatto o’zingizda allaqachon referal tizimi bo’lsa ham, ulashingiz mumkin. Bunday holda u kuzatuv rejimida ishlaydi va shunchaki analitika beradi, mavjud mantig’ingizga tegmaydi.

Botni ulash

Agar bot allaqachon Graspil’da bo’lsa — bu bo’limni o’tkazib yuboring.

To’rtta ulash usuli mavjud, lekin bizning vazifamiz uchun eng oddiysi kifoya:

Avtomatik ulash (MTProto). Bot tokenini kiriting — va tizim qolganini o’zi bajaradi. Har qanday bot yoki no-code konstruktor bilan ishlaydi, kodda hech narsani o’zgartirish shart emas, boshqa usullarga qaraganda biroz ko’proq ma’lumot yig’adi.

Tokenni berishni xohlamaysizmi? API orqali ulash mavjud: botingizdan bizga yangilanishlarni yuboradigan bitta HTTP so’rovi. Dasturchi uchun taxminan besh daqiqalik ish, lekin token sizda qoladi.

Avvalo, start parametrini hal qiling

Bu sekinlashishga arziydigan yagona joy. Bu o’zingizga zarar yetkazib, keyin hammasini qayta qilishga to’g’ri keladigan yagona bosqich.

Start parametri nima

Telegram botga ishga tushirishda ma’lumot uzatishning aynan bitta usulini beradi — deep link:

https://t.me/YourBot?start=MA'LUMOTINGIZ_SHU_YERDA

Bitta satr, ko’pi bilan 64 belgi. Hammasi shu. UTM teglaringiz ham, referal kodingiz ham shu tor eshikdan o’tishi kerak.

Oddiy rejimni o’chiring

Odatiy holatda, har bir yangi botda start qayta ishlash uchun oddiy rejim yoqilgan. U parametr tarkibini o’zgarishsiz, to’liq, bitta bo’lak sifatida oladi:

start=	Parametr	Qiymat
`docs`	yo’q	`docs`

Referal tizimi uchun bu shuni anglatadi: butun start qiymati referal kodi sifatida qaraladi. UTM ham, manba ham, kampaniya ham yo’q — faqat kod. Kimdir Telegram kanalidan ?start=kT7xQm2p havolasini ochsa, siz uni kim taklif qilganini bilasiz, lekin u haqiqatda qayerdan kelganini umuman bilmaysiz.

Shuning uchun: “Mening botlarim” → kerakli bot → “UTM teglar” (start qayta ishlash qoidalari) ga o’ting va oddiy rejimni o’chiring.

Havolalar formatini oldindan belgilang

To’liq rejim satrni ikkita ajratgich yordamida tahlil qiladi: parametrlar ajratgichi (satrni juftliklarga ajratadi) va qiymatlar ajratgichi (har bir juftlikni kalit va qiymatga ajratadi).

Masalan, parametrlar ajratgichi _ va qiymatlar ajratgichi - bilan, satr

?start=ref-kT7xQm2p_source-tgchannel

quyidagi tozalangan jadvalga tahlil qilinadi:

Parametr	Qiymat
ref	kT7xQm2p
source	tgchannel

Demak, bitta havola ham referal kodini, ham manba UTM tegini olib yuradi. Keyinchalik hisobotlarda siz shunchaki “Aziz 40 kishini olib keldi” emas, balki “Aziz 40 kishini olib keldi, ulardan 30 tasi uning kanalidan, 10 tasi shaxsiy xabarlardan” deb ayta olasiz.

Dasturni ishga tushirishdan oldin, keyin emas, hal qilinishi kerak bo’lgan uchta narsa:

Qaysi parametr referal kodini olib yuradi. Odatiy bo’yicha ref — o’zgartirish uchun sabab bo’lmasa, shunday qoldiring. Lotin harflari, raqamlar va _ ruxsat etilgan.
Qanday ajratgichlar ishlatiladi. 64 belgi chegarasini unutmang: uzun va chiroyli ajratgichlar haqiqiy ma’lumotlar uchun joyni yeydi.
Referal kodi bilan qanday UTM teglar boradi. Odatda source yetarli.

💡 Qoidalar sozlash sahifasida jonli oldindan ko’rish mavjud: havolalaringiz namunalarini kiriting va tizim ularni qanday tahlil qilishini darhol ko’ring. Bu bosqichni o’tkazib yubormang — havolalar allaqachon ming foydalanuvchi qo’lida bo’lganda formatni qayta ishlashni xohlamaysiz.

Agar oddiy rejim hali ham yoqilgan bo’lsa, Graspil buni referal dasturini faollashtirish ekranida to’g’ridan-to’g’ri ko’rsatadi. Biz sizni himoya qilishga harakat qildik.

Referal tizimini yoqish

Shaxsiy kabinetdagi “Referal dastur” bo’limini toping. Odatiy bo’yicha o’chirilgan — faollashtirishni bosing.

Rejimni tanlang

Manage (boshqaruv). Platforma kodlar va havolalarni o’zi yaratadi, hisoblangan mablag’larni hisoblaydi, balanslarni yuritadi va to’lovlarni amalga oshiradi. Agar sizda hali referal dasturi bo’lmasa, shu rejimni tanlang — u to’liq funksionallikni beradi va o’z tomoningizda kod yozishni talab qilmaydi.

Observe (kuzatuv). Biz shunchaki ?start= orqali qanday kodlar kelayotganini kuzatamiz va o’tishlar hamda “kim kimni olib keldi” bog’lanishini qayd qilamiz. Kodlarni botingiz yaratadi, hisoblangan mablag’lar yo’q. Agar sizda allaqachon o’z referal tizimingiz bo’lsa va uning ustiga faqat analitika kerak bo’lsa, shuni tanlang.

Rejim istalgan vaqtda sozlamalarda o’zgartirilishi mumkin, to’plangan o’tishlar tarixi saqlanib qoladi. Shuning uchun agar ikkilanayotgan bo’lsangiz — kuzatuvdan boshlang va keyinroq almashtiring.

Bir nuance: tizim mukofotlarni hisoblay olishi uchun, u kod egasini bilishi kerak. manage rejimida bu o’z-o’zidan sodir bo’ladi. observe rejimida esa — uchta yo’l bilan:

“Parametr qiymati — referrerning Telegram ID’si” opsiyasini yoqing va havolaga kod o’rniga referrerning o’z Telegram ID’sini qo’ying — shunda o’tish egasi darhol ma’lum bo’ladi, alohida “kod → foydalanuvchi” moslashtirish qatlamisiz;
POST /v1/referral/set-code-owners API orqali kod egalarini paket tarzida xabar qiling — bu ham oldindan, ham orqaga qarab ishlaydi (bunday holda shu kod orqali bo’lgan barcha oldingi o’tishlar referrerga qayta hisoblanadi);
POST /v1/referral/mark-referral orqali foydalanuvchini bevosita referal sifatida belgilang.

Qolgan faollashtirish sozlamalari

Start parametri nomi — yuqorida o’ylab topganimiz. Shu yerda referal havolasining jonli oldindan ko’rinishi ham bor.
Referalni qachon ro’yxatga olish — botning birinchi ishga tushirilishida (asosiy holat) va/yoki qayta ishga tushirish va bloklashdan keyin qaytishda.

"Dasturni faollashtirish"ni bosing va menyu quyidagi kichik bo’limlarga kengayadi: Umumiy ko’rinish, Sozlamalar, Referrerlar, Referallar, Hisoblangan mablag’lar, To’lovlar, Statistika.

Bonus: bironta ham kod yozmasdan referal kabineti

Referal tizimi pulni juda yaxshi hisoblaydi, lekin buni foydalanuvchilarga qandaydir tarzda ko’rsatish ham kerak. Va odatda aynan shu yerda “keling, /me komandasini yozamiz” degan fikr boshlanadi.

Kerak emas. Avtomatlashtirishlar katalogini oching va tayyor “Referal kabineti” shablonini oling.

U tayyor holda nima qiladi:

Siz tanlagan hodisada ishga tushadi — masalan, /me yoki /balance komandasi.
Referrer kodi va havolasini oladi (“Kod va havolani olish”) — agar kod hali bo’lmasa, yaratadi.
Balansni tortib oladi (“Balansni olish”) — mavjud, ushlab turishda, to’langan.
Foydalanuvchiga taxminan quyidagicha xabar yuboradi:

🎁 Sizning referal kabinetingiz

🔗 Kod: kT7xQm2p
Havola: https://t.me/YourBot?start=kT7xQm2p

👥 Taklif qilingan: 12
💰 To'lov uchun mavjud: 1400

Xabar ostida — stsenariyni davom ettiradigan, **“To’lov so’rash”**ni chaqiradigan va keyin tasdiqlash bilan javob beradigan “To’lov so’rash” tugmasi.

Importdan keyin faqat bitta ishni qilish kerak: hodisa-trigerni tanlash va nashr qilish. To’lov tugmasi avtomatik ravishda botingizga ulanadi.

Bundan keyin shablonni har qanday oddiy avtomatlashtirish kabi moslashtirish mumkin: salomlashish xabariga “Referrerni ro’yxatga olish” operatsiyasini qo’shish, “faqat balans noldan katta bo’lsa to’lov tugmasini ko’rsatish” shartini o’rnatish, ko’p tilli matnlarni ulash — xabar blokidagi til almashtirgichi bu yerda ham ishlaydi.

Nima uchun to’lash va qanday to’lash

Bu eng mazmunli qism, lekin u ham bosishlar bilan bajariladi.

Mukofot qoidalari

Sozlamalar → Mukofot qoidalari. Tayyor to’plamlar mavjud — To'lovlardan %, Referal uchun belgilangan summa, Xizmatni uzaytirish, Maxsus maydonga — tayyorini olib, sozlash mumkin.

Qoida mantig’i gap kabi o’qiladi: qaysi hodisa uchun → qancha hisoblash → yana nima qilish.

Qaysi hodisa uchun. Platforma allaqachon biladigan botingizning istalgan hodisasi: to’lov, ro’yxatdan o’tish, bosqichni bajarish. Hisobotlarda ishlatiladigan xuddi shu ro’yxat.

Qiymat bo’yicha qo’shimcha shartlar. Hodisaning sonli qiymati bo’yicha filtr: faqat value ≥ value_min, ≤ value_max yoki = value_eq bo’lsa hisoblash. Klassik holat: “to’lovlardan 10%, lekin faqat 1000 dan yuqori chеklardan”.

Qancha hisoblash — uchta mukofot turi:

Tur	Qanday hisoblanadi
Belgilangan summa	Tanlangan valyutadagi aniq summa — referalning har bir to’lovi uchun 100 tanga
Foiz	Hodisa qiymatidan foiz. Valyuta hodisaning o’zidan meros bo’lib o’tadi, alohida tanlash shart emas
Tashqi	Platforma summani hisoblamaydi, shunchaki webhookingizni ishga tushiradi. “Obunani 7 kunga uzaytirish” kabi holatlar uchun — pulda o’lchanmaydigan narsalar

Ushlab turish oynasi (hold), kunlarda. Hisoblangan mablag’ to’lovga mavjud bo’lishidan oldin qancha vaqt “ushlab turishda” holatda turadi. Agar sizda 14 kunlik qaytarish bo’lsa, 14 qo’ying va xotirjam uxlang.

Effektlar — hisoblanganda yana nima qilish kerak:

Webhook — shablon tanasi va o’zgaruvchilarni almashtirish bilan URL’ingizga POST so’rovi: {{referrer_id}}, {{amount}}, {{event_value}} va boshqalar.
Maxsus maydon — referrer profilidagi maxsus maydonni oshirish (inc) yoki o’rnatish (set). To’plangan balansni to’g’ridan-to’g’ri profilda saqlashni va uni tarqatish segmentlarida ishlatishni xohlasangiz qulay.

Ustuvorlik. Bitta hodisa uchun bir nechta qoida mos kelishi mumkin — masalan, buyurtma hajmiga qarab turli stavkalar. Qoidalar ustuvorlik ortib borish tartibida qo’llaniladi; tartibni sudrab o’zgartirish mumkin.

To’lovlar

Sozlamalar → To’lovlar.

Qo’lda (manual). Pulni o’zingizga qulay usulda o’tkazasiz, keyin tizimda to’lovni izoh bilan “To’langan” yoki “Muvaffaqiyatsiz” deb belgilaysiz. Platforma hisobni yuritadi, hamyonni siz yuritasiz.

Webhook. To’lov ishga tushirilganda, biz URL’ingizga “Z foydalanuvchisiga Y valyutasida X hisoblang” tarzida POST so’rovi yuboramiz. Serveringiz hisoblaydi va 2xx qaytaradi — to’lov to’langan deb belgilanadi. external_ref qaytarsangiz, uni solishtirish uchun tranzaksiya ID’ingiz sifatida saqlaymiz. O’z hamyoningiz yoki to’lov tizimingiz bo’lsa mos keladi.

To’lov tizimlari. Mashhur to’lov xizmatlari va kriptovalyuta orqali to’lovlar alohida usul sifatida ulanadi — joriy ro’yxatni to’lov sozlamalarida ko’ring.

🛠 Kerakli to’lov tizimini topa olmadingizmi? Qo’llab-quvvatlash xizmatiga yozing. Bir kun ichida qo’shamiz.

Avtomatik to’lovlar — alohida mexanizm, belgi bilan yoqiladi: jadval (oyiga bir marta yoki har N kunda), standart usul va valyuta bo’yicha chegaralar (“faqat mavjud summa ≥ 5000 bo’lsa to’lash”). Qo’lda va API orqali to’lovlar jadvaldan qat’i nazar har doim ishlaydi.

To’lovni referrer kartochkasidan, “To’lovlar” bo’limidan, POST /v1/referral/payout API orqali yoki avtomatlashtirish ichidagi tugma orqali boshlash mumkin.

Hayot sikli:

So'ralgan → Qayta ishlanmoqda → Bajarildi
                             ↘ Muvaffaqiyatsiz (summa balansga qaytadi)

Balansga nima bo’ladi

Balans har bir valyuta bo’yicha alohida yuritiladi va to’rtta qismdan iborat:

Nima	Ma’nosi
Mavjud	To’lovga bog’lanmagan tasdiqlangan hisoblangan mablag’lar. Hozir to’lash mumkin
Rezervlangan	Allaqachon jarayondagi to’lovga kiritilgan
Ushlab turishda	Hold davri hali o’tmagan
To’langan	Barcha muvaffaqiyatli to’lovlar jami

Hisoblangan mablag’ quyidagi yo’lni bosib o’tadi: Ushlab turishda → Tasdiqlangan → To'lovda → To'langan, Qaytarilgan (kompensatsion hisoblangan mablag’) va Bekor qilingan shoxobchalari bilan.

Natijalarni ko’rish

Umumiy ko’rinish — 30 kunlik xulosa: jami referrerlar, olib kelingan referallar, faol qoidalar, hisoblangan mablag’lar; valyutalar bo’yicha balanslar; “yangi foydalanuvchilar → trigger-hodisa → hisoblangan mablag’lar → to’lovlar” voronkasi; kunlik dinamika; daromad va referallar soni bo’yicha top-5.

Referrerlar — filtrlar bilan ro’yxat (davr, valyuta, “mavjud balans bor”, minimal referallar soni), daromad bo’yicha saralash va eksport bilan. Referrer kartochkasidan — uning havolasi va to’lov tugmasi.

Hisoblangan mablag’lar va To’lovlar — holatlar bilan to’liq daftar. Har bir tiyin o’z joyida, agar biror narsa noto’g’ri ketgan bo’lsa — aynan nima ekanligi ko’rinadi.

Lekin eng qiziqarlisi keyin boshlanadi. Har bir hisoblangan mablag’ analitikaga alohida hodisa sifatida yoziladi, referal ma’lumotlari va start parametridagi UTM teglar esa hisobot quruvchisida mavjud. Bu shuni anglatadiki, siz shunchaki “qancha tarqatdik” emas, balki haqiqiy mahsulot hisobotlarini qurishingiz mumkin:

Referallar kohortalari boshqa foydalanuvchilarga qarshi — taklif qilingan foydalanuvchilarning ushlab qolinishi deyarli har doim yuqoriroq, va buni raqamlarda ko’rish yoqimli.
Referal havola manbai bo’yicha voronka — agar ref va sourceni turli parametrlarga ajratgan bo’lsangiz (buni birinchi qismda muhokama qilgan edik), referrerlaringiz haqiqatan qaysi kanallardan to’lov qiluvchi foydalanuvchilarni olib kelishi, qaysilari esa shunchaki trafik olib kelishi ko’rinadi.
Dastur iqtisodiyoti — referallar qancha daromad keltirgani va ularni jalb qilish uchun referrerga qancha to’laganingiz. Shu asosda, sezgi emas, qoida stavkasini oshirish yoki tushirish mumkin.
Qoidalar bo’yicha tendensiyalar — qaysi qoida haqiqatan ishlayapti, qaysi biri shunchaki pul tarqatyapti.

Agar biz o’z tizimimizga yoki boshqasiga o’tmoqchi bo’lsak-chi?

Bu referal dasturingizni istalgan xizmatga topshirishdan oldin berish kerak bo’lgan oqilona savol. Halol javob: ko’chib o’tish mumkin, va ma’lumotlaringiz siz bilan qoladi.

Tizim to’plagan hamma narsa API orqali mavjud:

Kodlar va ularning egalari — qaysi foydalanuvchi qaysi kodga ega.
Referallar — kim kimni olib keldi, to’liq ro’yxat.
Hisoblangan mablag’lar — summalar, valyutalar, holatlar va har birini qaysi qoida ishga tushirgani bilan butun daftar.
Balanslar — mavjud, ushlab turishda, to’langan, har bir valyuta bo’yicha.
To’lovlar tarixi — nima, qachon, qaysi usulda va qaysi tashqi tranzaksiya ID’si bilan.

Qo’shimcha ravishda — interfeysdan to’g’ridan-to’g’ri referrerlarni eksport qilish.

Demak, hamma narsani chiqarib olib, o’z bazangizga yuklash — bu bir kechalik skript, qo’llab-quvvatlash xizmati bilan muzokara emas. Biz ma’lumotlaringizga hech qanday qulf qo’ymaymiz: agar Graspil bir kun sizga mos kelmay qolsa, dasturingizning butun tarixi bilan birga ketasiz. Aslida shunday bo’lishi kerak.

Xulosa

Butun tekshiruv ro’yxati oltita qadamga sig’adi:

Botni token orqali ulading.
Start qayta ishlashning oddiy rejimini o’chirdingiz va havola formatini belgiladingiz.
Referal dasturni manage rejimida faollashtirdingiz.
Mukofot qoidasini yaratdingiz.
To’lov usulini tanladingiz.
Avtomatlashtirishlar katalogidan "Referal kabineti"ni import qildingiz.

Haqiqatan vaqt sarflashga arziydigan yagona qadam — ikkinchisi. Havola formatini qayta qilish og’riqli; qolgan hammasi istalgan vaqtda sozlamalarda o’zgartiriladi.

Sozlash bo’yicha savollaringiz qolsa yoki hali mavjud bo’lmagan to’lov usuli kerak bo’lsa — qo’llab-quvvatlash xizmatiga yozing.

Botingizga referal tizimini 2 daqiqada qanday qo'shish mumkin