Webhooklar muayyan hodisalar yuz berganda sayt va ilovalar oʻrtasida maʼlumotlarni avtomatik yuborish mexanizmidir. Maʼlumotlar HTTP soʻrovi orqali uzatiladi: bir ilova ularni internet orqali boshqa ilovaning oldindan koʻrsatilgan manziliga yuboradi.

Webhooklarning imkoniyatlari
FLOWINda webhooklar yoʻnaltirishlar bilan ishlaydi. Ular asl chatda (manbada) xabar paydo boʻlganda, oʻzgartirilganda, oʻchirilganda yoki qadalganda, shuningdek, xabarlar yoʻnaltiriladigan chatda (manzilda) tugma bosilganda ishga tushishi mumkin.
Shu yoʻl bilan FLOWINni ijtimoiy tarmoqlar, birjalar, jadvallar va CRM (mijozlar bilan ishlash tizimlari) bilan bogʻlash mumkin. Bunday bogʻlanish integratsiya deb ataladi va quyidagilarga imkon beradi:
- Telegramdan CRMga murojaatlarni avtomatik qoʻshish.
- Telegramdagi savdo signallarini avtomatik kuzatib savdo qilish, yaʼni shu signallar asosida bitimlarni avtomatik tuzish uchun birjaga uzatish.
- Telegramdagi xabarlarni boshqa ijtimoiy tarmoqlarga yoʻnaltirish.
- Post va xabarlarni Google Sheetsʼga nusxalash.
- Botda avtomatik javob berishni sozlash.
Har bir ssenariy uchun sayt yoki ilova tomonida maʼlumotlarni qabul qilish va kerakli amalni sozlash lozim.
Webhook yaratish
Webhookni maʼlumotlarni qabul qilish uchun manzil beradigan va kelgan soʻrovlarni koʻrsatadigan webhook.site saytida tekshiramiz. Unga Telegramdagi yangi xabarning matnini yuboramiz.
Buning uchun FLOWINda sozlangan va ishlayotgan yoʻnaltirish kerak.
Birinchi sinov uchun
Alohida sinov chatidan va oʻylab topilgan murojaatdan foydalaning. Tekshirish uchun ism, telefon va boshqa shaxsiy maʼlumotlarsiz matnni yuborishning oʻzi yetarli.
@flow_in_bot botini oching,
/startbuyrugʻini yuboring va «Boshqaruv paneli» tugmasini bosing.Alohida varaqda webhook.site saytini oching. «Your unique URL» maydonidan soʻrovlarni qabul qilish manzilini nusxalang.
FLOWIN panelida «Menyu» → «Webhooklar» boʻlimini oching va «Yaratish» tugmasini bosing.
Nusxalangan manzilni yuqoridagi maydonga joylashtiring. «Soʻrov tanasi» maydoniga
{"message":"<message-text>"}deb yozing va «Yaratish» tugmasini bosing. Bu yuboriladigan maʼlumotlar shabloni: FLOWIN<message-text>oʻrniga xabar matnini qoʻyadi, qabul qiluvchi esa unimessagemaydonida koʻradi.Yaratilgan webhookdagi «Qoʻllash» tugmasini bosing. Kerakli yoʻnaltirishni belgilang va «Saqlash» tugmasini bosing.
Manba chatiga «№1042 murojaat: mebel katalogi kerak.» kabi sinov xabarini yuboring. webhook.siteʼga qayting: birinchi qabul qilingan soʻrov avtomatik ochiladi. «Request Content» blokining
messagemaydonida murojaat matni paydo boʻladi. Endi FLOWIN har bir yangi xabarning matnini manzil chatiga yoʻnaltirishdan oldin koʻrsatilgan manzilga avtomatik yuboradi.
Webhook sozlamalari
Yaratilgan webhook misolida sozlamalarni qanday oʻzgartirishni va har bir maydon nimani anglatishini koʻrib chiqamiz.
Sozlamalarni qayerdan olish kerak
Boshqa sayt yoki ilovani ulash uchun uning hujjatlaridan foydalaning. Maʼlumotlarni qabul qilish qoidalari odatda boshqa dasturlar bilan oʻzaro ishlashni tavsiflovchi API boʻlimida boʻladi. Quyidagi maydonlarni toʻldirish uchun manzil, HTTP usuli va maʼlumotlar formati shu yerda koʻrsatiladi.
Webhook sozlamalarini qanday oʻzgartirish mumkin
«Webhooklar» roʻyxatida kerakli webhookdagi «Oʻzgartirish» tugmasini bosing.
Kerakli maydonlarni oʻzgartiring va «Saqlash» tugmasini bosing.
HTTP usuli
HTTP usuli soʻrov amalini belgilaydi: POST maʼlumotlarni ishlov berish uchun yuboradi, GET maʼlumotlarni soʻraydi, PUT ularni almashtiradi. Standart holatda sinovimizga mos POST tanlangan. Boshqa sayt yoki ilova uchun uning hujjatlarida koʻrsatilgan usulni tanlang.
URL manzil
URL internetdagi manzilni anglatadi. Bu yerda ulanayotgan sayt yoki ilovadan olingan maʼlumotlarni qabul qilish manzili koʻrsatiladi. Misolimizda uni webhook.site berdi.
Soʻrov tanasi
Soʻrov tanasida yuboriladigan maʼlumotlar JSON formatida boʻladi: «maydon nomi: qiymat» juftliklari. Maydonlar tarkibi ulanayotgan sayt yoki ilova talablariga bogʻliq.
Metateglar FLOWIN xabar maʼlumotlari bilan almashtiradigan belgilardir. Masalan, <message-text> oʻrniga matn, <author-name> oʻrniga esa muallif ismi qoʻyiladi. Metateglar roʻyxatini maydon ostidagi «metateglar» havolasi orqali ham ochish mumkin.
Quyidagi roʻyxatda foydalanuvchi, xabar, chat va mavzu raqamlari ularning Telegramdagi identifikatorlarini (ID) anglatadi.
Xabar va muallif
- Xabar matni:
<message-text>. - Xabar sanasi:
<message-date>. - Xabar vaqti:
<message-time>. - Muallif raqami:
<author-id>. - Muallif ismi:
<author-name>. - Profiliga HTML havola koʻrinishidagi muallif ismi:
<author-name-link>. - Muallif ismi xeshteg koʻrinishida:
<author-name-tag>. - Muallifning foydalanuvchi nomi:
<author-username>.
Manba
- Xabar matni:
<src-message-text>. - Xabar raqami:
<src-message-id>. - Xabarga havola:
<src-message-link>. - Chat raqami:
<src-chat-id>. - Chat nomi:
<src-chat-name>. - Chatning foydalanuvchi nomi:
<src-chat-username>. - Mavzu raqami:
<src-topic-id>. - Mavzu nomi:
<src-topic-name>.
Manzil
- Xabar matni:
<dst-message-text>. - Xabar raqami:
<dst-message-id>. - Xabarga havola:
<dst-message-link>. - Chat raqami:
<dst-chat-id>. - Chat nomi:
<dst-chat-name>. - Chatning foydalanuvchi nomi:
<dst-chat-username>. - Mavzu raqami:
<dst-topic-id>. - Mavzu nomi:
<dst-topic-name>.
Manzildagi xabar raqami va havolasi yoʻnaltirilgandan keyin paydo boʻladi. Ularni yuborish uchun «Soʻrov triggeri» maydonida «Yuborilgach» variantini tanlang.
Tugma bosilishi
- Tugmani bosgan foydalanuvchi raqami:
<clicker-id>. - Tugmani bosgan foydalanuvchi ismi:
<clicker-name>. - Tugma maʼlumotlari:
<clicker-data>. - Bosilgan sana:
<click-date>. - Bosilgan vaqt:
<click-time>.
Matnni tanlash
- Muntazam ifoda matnni qidirish qoidasini belgilaydi. Masalan,
<regexp>(short|sell)</regexp>ifodasishortyokisellvariantlaridan topilgan birinchi moslikni qoʻyadi. - Tasodifiy matn uchun
<random>1|2|3|4|5</random>besh variantdan birini qoʻyadi. Teglar orasiga oʻz variantlaringizni|belgisi bilan ajratib yozishingiz mumkin.
Soʻrov sarlavhalari
«Soʻrov sarlavhalari»da qabul qiluvchi uchun xizmat maʼlumotlari boʻladi. Masalan, kirish kaliti soʻrovni kim yuborganini tekshirish imkonini beradi. Sarlavhalar JSON formatida beriladi. Odatda bu maydonni oʻzgartirish shart emas; kerakli qiymatlar ulanayotgan sayt yoki ilova hujjatlaridan olinadi.
Soʻrov triggeri
«Soʻrov triggeri» webhook koʻrsatilgan manzilga soʻrov yuborishi kerak boʻlgan hodisa va vaqtni belgilaydi. Hodisa sifatida quyidagilarni tanlash mumkin:
- Standart holatda «Yuborish» tanlangan. Webhook yangi xabar yoʻnaltirilganda ishga tushadi.
- «Tahrirlash» manbadagi xabarning oʻzgarishiga ishlov berilganda ishga tushadi.
- «Qadash» manbadagi xabarning qadalanishiga ishlov berilganda ishga tushadi.
- «Oʻchirish» manbadagi xabarning oʻchirilishiga ishlov berilganda ishga tushadi.
- «Tugma bosilishi» manzil chatidagi qayta chaqiruvli (callback) tugmalar uchun ishga tushadi. Bunday tugma botga bosilgani haqida xabar beradi va oʻzi uchun belgilangan maʼlumotlarni uzatadi. Oddiy havolali tugma bu webhookni ishga tushirmaydi.
Yuborish vaqti soʻrov yoʻnaltirishning qaysi bosqichida ketishini belgilaydi:
- «Ishlovdan oldin»: soʻrov tarjimadan va xabarga sunʼiy intellekt (AI) yordamida ishlov berishdan oldin yuboriladi.
- «Qayta ishlangach»: soʻrov tarjimadan va AI ishlovidan keyin yuboriladi.
- «Yuborilgach»: soʻrov xabar manzil chatiga muvaffaqiyatli yuborilgan yoki unda oʻzgartirilgan paytda ketadi.
Mavjud yuborish vaqtlari
Uchala variant ham «Yuborish» va «Tahrirlash» hodisalari uchun mavjud. «Qadash», «Oʻchirish» va «Tugma bosilishi» uchun «Ishlovdan oldin» ishlatiladi, boshqa vaqtni tanlab boʻlmaydi.
Tavsif
«Tavsif» qulayligingiz uchun izoh boʻlib xizmat qiladi va webhookning ishlashiga taʼsir qilmaydi. Maydonni boʻsh qoldirish mumkin.
Webhook bilan bajariladigan amallar
Yaratilgan webhooklarni «Webhooklar» roʻyxatidan boshqarish mumkin:
- «Oʻzgartirish» webhookning asosiy sozlamalarini ochadi.
- «Yana» menyusidagi «Nusxa yaratish» webhook sozlamalarining nusxasini yaratadi.
- «Yana» menyusidagi «Loyihani tanlash» webhookni loyihaga qoʻshadi.
- «Yana» menyusidagi «Oʻchirish» webhookni oʻchiradi.
Bundan tashqari, har bir webhookda «Yoʻnaltirishlar [N]» tugmasi bor. U webhook qoʻllanadigan yoʻnaltirishlarni tanlash oynasini ochadi. N tanlangan yoʻnaltirishlar sonini bildiradi. Yoʻnaltirishlar hali tanlanmagan boʻlsa, uning oʻrnida «Qoʻllash» tugmasi koʻrsatiladi.
Koʻp soʻraladigan savollar
Sodda qilib aytganda, webhook nima?
Bu muayyan hodisa yuz berganda maʼlumotlarni boshqa ilovaga avtomatik uzatish usuli. Masalan, yangi xabar yoʻnaltirilganda FLOWIN uning matnini siz koʻrsatgan manzilga HTTP soʻrovi orqali yuboradi. Bu yerda soʻrovni FLOWIN yuboradi; Telegramning setWebhook metodi esa boshqa yoʻnalishni sozlaydi: yangilanishlarni Telegramdan botga xizmat koʻrsatuvchi dasturga yetkazish.
CRM manzilini koʻrsatishning oʻzi yetarlimi?
Yoʻq. CRM hujjatlaridan olingan maʼlumotlarni qabul qilish manzili, shuningdek, mos HTTP usuli, JSON maydonlari va kirish uchun zarur boʻlsa sarlavhalar kerak. CRM saytining oddiy manzili bunga mos kelmaydi. FLOWIN soʻrov yuboradi, murojaat yaratish yoki boshqa amal esa CRM qabul qilingan maʼlumotlarga qanday ishlov berishiga bogʻliq. Maydonlarning qiymatlari «Webhook sozlamalari» boʻlimida tushuntirilgan.
Nega manzildagi xabarga havola boʻsh?
Yangi xabar muvaffaqiyatli yuborilmaguncha, FLOWINda uning manzildagi raqami va havolasi hali yoʻq. <dst-message-id> va <dst-message-link> qiymatlarini yuborish uchun «Soʻrov triggeri» maydonida «Yuborish» yoki «Tahrirlash» hodisasini va «Yuborilgach» vaqtini tanlang. Havola kanallar va superguruhlar uchun hosil qilinadi. Shaxsiy chat yoki oddiy guruh uchun <dst-message-link> yuborilgandan keyin ham boʻsh qoladi.
Oddiy URL tugmasini bosib webhookni ishga tushirish mumkinmi?
Yoʻq. Oddiy URL tugmasi havolani ochadi. «Tugma bosilishi» hodisasi uchun manzil chatida qayta chaqiruvli (callback) tugma kerak: u botga bosilgani haqidagi maʼlumotlarni uzatadi. Bu farq «Soʻrov triggeri» boʻlimida tushuntirilgan.
Tashqi xizmat maʼlumotlarni olganini qanday tekshirish mumkin?
Oʻylab topilgan xabarni yuboring va xizmat tomonida qabul qilingan soʻrovni tekshiring. webhook.site misolida murojaat matni «Request Content» blokida paydo boʻladi. Telegramda muvaffaqiyatli yoʻnaltirishning oʻzi tashqi xizmat maʼlumotlarni qabul qilganini yoki kerakli amalni bajarganini tasdiqlamaydi. Tekshirish uchun ism, telefon va boshqa shaxsiy maʼlumotlarsiz matnning oʻzi yetarli.















