Telegram va amoCRM integratsiyasi: bosqichma-bosqich

Telegramdagi suhbat menejerning shaxsiy chatida qolsa, rahbar lidni ko‘rmaydi va xodim almashganda tarix yo‘qoladi. Telegram amoCRM integratsiya orqali xabarni shunchaki nusxalash emas, mijoz, manba va keyingi qadamni bitta kartaga bog‘lashdir.

To‘g‘ri integratsiya operatorga qulay, mijozga esa tabiiy bo‘ladi. U har xabar uchun keraksiz CRM task yaratmaydi.

---

1. Kanal va identifikatorni tanlang

Rasmiy Telegram bot eng boshqariladigan variant. Telegram user ID asosiy texnik identifikator, telefon esa rozilik bilan olinadi. Shaxsiy akkaunt integratsiyasida Telegram qoidalari va maxfiylikni alohida tekshiring.

2. amoCRM maydonlari va voronka

Minimal maydon: Telegram ID, username, til, lid manbasi, xizmat turi va keyingi qadam. Yangi suhbat mavjud kontakt bilan dublikat tekshiruvdan o‘tadi. Bot barcha suhbatni bitta uzun izohga tiqmaydi; muhim xulosa va havola yozadi.

Hodisa	amoCRM amali
/start yoki birinchi xabar	kontakt/lid topish yoki yaratish
Saralash tugadi	maydon va mas’ulni yangilash
Operator kerak	task va bildirishnoma
Javob keldi	follow-up ketma-ketligini to‘xtatish
Bitim yopildi	manba va tushumni saqlash

3. Webhook, retry va xavfsizlik

Telegram webhook imzosi/tokeni serverda saqlanadi. amoCRM access token ochiq kodda emas. Har hodisa ID bo‘yicha idempotent qayta ishlanadi; vaqtinchalik xatoda retry, doimiy xatoda alohida navbat bor.

• Bot tokeni secret managerda
• Dublikat yaratish testi bor
• Operatorga topshirish ishlaydi
• O‘zbek/rus tili saqlanadi
• Audit log va monitoring bor
• Ma’lumotni o‘chirish jarayoni bor

Kanal asosini Telegram bot qo‘llanmasi, CRM asosini O‘zbekistonda CRM integratsiyasida ko‘ring. Keyingi integratsiyalar: sayt va Bitrix24, Google Sheets–Telegram–CRM, Instagram lidlari.

Integratsiyaning ishlaydigan arxitekturasi

Bu oqimda manba — Telegram botdagi yangi suhbat, qabul qiluvchi tomon esa amoCRM kontakt va bitim kartasi. Asosiy hodisa: birinchi xabar, saralash tugashi yoki operatorga ehtiyoj. Texnik vazifa shunchaki maydonlarni ko‘chirish emas; yakunda manba, til, ehtiyoj, mas’ul va keyingi qadam yo‘qolmasdan saqlanishi. Buning uchun har yozuvda barqaror tashqi ID, yaratilgan vaqt, manba va qayta ishlash statusi bo‘lishi kerak.

Hodisa kelganda server avval imzo yoki secretni tekshiradi, keyin formatni tasdiqlaydi. Shundan so‘ng mavjud yozuv tashqi ID, telefon yoki boshqa ishonchli kalit bilan qidiriladi. Yangi yozuv kerak bo‘lsa yaratiladi, mavjud bo‘lsa xavfsiz yangilanadi. Muvaffaqiyat javobi ma’lumot ishonchli saqlangandan keyingina qaytariladi. Shu tartib takroriy hodisa dublikat yaratishining oldini oladi.

AI faqat erkin matndan maqsad, til yoki qisqa xulosa olish kerak bo‘lgan joyda ishlatiladi. To‘lov summasi, buyurtma IDsi, qoldiq va bitim statusi qat’iy kod va lug‘at orqali yuradi. Model bunday maydonlarni taxmin qilmasligi kerak. O‘zbekcha va ruscha ibora turlicha bo‘lsa ham, CRMda bitta standart status saqlanadi.

Ma’lumot shartnomasi alohida jadvalda yoziladi: maydon nomi, turi, majburiyligi, manbasi va xato paytidagi qoida. Telefon yagona formatga keltiriladi, summa tiyin yoki so‘mda ekanligi aniq belgilanadi, vaqt zonasi Toshkent bo‘yicha izchil yuritiladi. Mapping o‘zgarsa, versiya va o‘tish sanasi qayd etiladi.

Qabul sinovlari va favqulodda holat

“Bir marta ishladi” integratsiya tayyor degani emas. Eng kamida yangi yozuv, mavjud mijoz, bo‘sh majburiy maydon, noto‘g‘ri telefon, takror hodisa, kechikkan hodisa, API ishlamasligi, token muddati tugashi va qo‘lda o‘zgartirilgan status sinovdan o‘tsin. Ushbu loyiha uchun muhim istisno: mavjud mijoz boshqa username bilan yozishi yoki webhook ikki marta kelishi. U alohida test holati va tushunarli xato matniga ega bo‘lishi kerak.

Vaqtinchalik xato queue va retry orqali qayta ishlanadi. Doimiy xato cheksiz takrorlanmaydi; u alohida navbatga tushadi va mas’ul xodimga hodisa IDsi bilan xabar boradi. Logda shaxsiy ma’lumotning keraksiz qismi emas, hodisa va texnik natija saqlanadi. Secretlar kod yoki Google Sheets ichida emas, himoyalangan muhit o‘zgaruvchisida turadi.

Favqulodda rejada uch savolga javob bo‘lsin: oqimni qanday to‘xtatamiz, o‘tkazib yuborilgan hodisani dublikatsiz qanday qaytaramiz va foydalanuvchi ishini vaqtincha qanday davom ettiradi? Bu yo‘l hujjatlangan bo‘lsa, integratsiya bir ishlab chiquvchiga bog‘lanib qolmaydi.

Qabul testini faqat dasturchi bajarmasin. CRM menejeri yoki buxgalter odatiy vazifani o‘zi bajarib ko‘rsin va xato unga tushunarli ekanini tasdiqlasin. Texnik jihatdan to‘g‘ri, ammo biznes foydalanuvchisi tiklay olmaydigan oqim ekspluatatsiyada qimmatga tushadi.

Ishga tushgandan keyingi 30 kun

Birinchi hafta kiruvchi hodisalar soni, muvaffaqiyat, dublikat va xatolar har kuni solishtiriladi. Ikkinchi hafta API limitlari, token yangilanishi va pik paytdagi kechikish kuzatiladi. Uchinchi hafta xodimlar qo‘lda tuzatgan maydonlar tahlil qilinadi. Agar bir maydon doim tuzatilsa, sabab ko‘pincha intizom emas, noto‘g‘ri mapping yoki noaniq biznes qoidasidir.

To‘rtinchi hafta biznes ko‘rsatkichiga qarang: birinchi javob vaqti, yo‘qolgan lid, solishtirilmagan to‘lov, noto‘g‘ri qoldiq yoki qo‘lda ko‘chirishga ketgan vaqt. Texnik “99 foiz muvaffaqiyat” foydali, ammo biznes natijasi bilan bog‘lanmasa yetarli emas. Kichik nazorat tanlovi orqali manba va qabul qiluvchi tizimdagi yozuvlar ham solishtiriladi.

Ekspluatatsiya egasi token almashtirish, xatoni qayta yuborish va yangi maydon qo‘shish tartibini bilishi kerak. Har oy kirish huquqlari va log saqlash muddati ko‘rib chiqiladi. Har chorakda bir favqulodda tiklash testi o‘tkazish tizim haqiqatda boshqarilishini tekshiradi.

Amaliy qabul ro‘yxati:

• Hodisa takror kelsa dublikat yaratilmaydi
• Manba va UTM yo‘qolmaydi
• O‘zbekcha va ruscha qiymatlar standart statusga tushadi
• Vaqtinchalik xato retry qilinadi
• Doimiy xato mas’ulga ko‘rinadi
• Audit logdan muammo sababi topiladi
• Qo‘lda ishlash va tiklash yo‘li hujjatlangan

Fokusli integratsiya odatda haftalarda ishga tushadi, lekin monitoring va istisnolar “keyin qo‘shiladigan bezak” emas. Ular birinchi versiyaning bir qismi bo‘lmasa, oddiy uzilish lid, buyurtma yoki pulning jim yo‘qolishiga olib keladi.

Xavfsizlik tekshiruvida har bir tokenning egasi, vakolati va yangilanish sanasi yoziladi. Ishdan ketgan xodimning shaxsiy akkauntiga bog‘langan integratsiya katta xavf. Texnik kabinetlar kompaniya nazoratida, kirish esa rol bo‘yicha bo‘lishi kerak. Ortiqcha ruxsatni olib tashlash oddiy xatoni katta ma’lumot sizishiga aylanishidan saqlaydi.

Monitoring faqat “server ishlayaptimi?” degan savolga javob bermasin. So‘nggi bir soatda nechta hodisa keldi, nechasi bajarildi, navbatda eng eski hodisa qancha turibdi va qaysi xato ko‘paydi — shu ko‘rsatkichlar ko‘rinsin. Biznes egasiga texnik kod emas, ta’sirlangan lid yoki buyurtmalar soni yuboriladi.

Tez-tez so‘raladigan savollar

Eski Telegram mijozlari birlashadimi? Telefon yoki boshqa ishonchli moslik bo‘lsa; taxminiy birlashtirishni inson tasdiqlasin.

Har xabar CRMda saqlanadimi? Talab va maxfiylikka bog‘liq. Ko‘pincha xulosa va muhim hodisa yetadi.

Integratsiya uzilsa lid yo‘qoladimi? Queue, retry va alert bo‘lsa yo‘qolmasligi kerak.

Telegram–amoCRM oqimini xavfsiz pilot qilish uchun Fera Tech xizmatlarini ko‘ring va biz bilan bog‘laning.