Webhook qanday ishlaydi: biznes egasi va dasturchi uchun oddiy tushuntirish
Sado AI jamoasi · · 3 daqiqada o‘qiladi
Qisqacha
Webhook — bir tizimda hodisa bo‘lganda u ikkinchi tizimga o‘zi xabar yuborishi. Masalan, qo‘ng‘iroq tugadi va Sado natijani — qisqa xulosa va keyingi qadam bilan — sizning saytingiz yoki dasturingiz manziliga yuboradi. Siz har daqiqada «yangi narsa bormi?» deb so‘rab turmaysiz. Webhook uchun internetdan ochiq HTTPS manzil kerak; kelgan so‘rov imzosini tekshirish, tez javob qaytarish va bir xabar ikki marta kelsa, uni ikki marta yozmaslik kerak. Sado’da webhook va REST API bor.
Webhook oddiy so‘z bilan
Kuryer kutyapsiz, deylik. Bir yo‘li — har besh daqiqada qo‘ng‘iroq qilib, «yetib keldingizmi?» deb so‘rash. Ikkinchi yo‘li — kuryer yetib kelganda o‘zi xabar beradi. Birinchisi API orqali so‘rashga o‘xshaydi, ikkinchisi — webhook.
| API orqali so‘rash | Webhook | |
|---|---|---|
| Kim boshlaydi | Sizning tizimingiz | Xabar yuboruvchi tizim |
| Qachon bilasiz | Keyingi so‘rovda | Hodisa bo‘lishi bilan |
| Sizda nima kerak | Vaqti-vaqti bilan so‘raydigan dastur | Internetdan ochiq manzil (URL) |
| Qachon qulay | Server ofis ichida, tashqaridan ochiq emas | Natija darhol kerak |
Qo‘ng‘iroqlarda webhook nimaga kerak
Qo‘ng‘iroq natijasi webhook bilan kelgach, uni o‘z tizimingizda xohlagancha ishlatasiz. Masalan:
- Qo‘ng‘iroq tugadi — natija o‘zingiz yozgan CRM’ga yoki ichki dasturga tushadi.
- Mijoz qabulga yozildi — vaqt sizning kalendaringizga qo‘shiladi.
- Mijoz qiziqdi — menejerga vazifa ochiladi.
- Mijoz «menga qo‘ng‘iroq qilmang» dedi — bazangizda shu raqamga belgi qo‘yiladi.
Webhook qanday ishlaydi: qadamlar
- Dasturchingiz xabar qabul qiladigan manzil ochadi, masalan https://sizning-saytingiz.uz/sado-webhook.
- Shu manzil Sado’ga beriladi. Qanday qilinishi dasturchilar sahifasida yozilgan.
- Hodisa bo‘ladi: masalan, qo‘ng‘iroq tugab, natijasi tayyor bo‘ldi. Sado manzilga JSON ko‘rinishidagi xabar yuboradi.
- Serveringiz imzoni tekshiradi va darhol «qabul qildim» (HTTP 200) deb javob beradi.
- Shundan keyin xabarni ishlaydi: CRM’ga yozadi, vazifa ochadi yoki xabar yuboradi.
Dasturchi uchun beshta qoida
- Faqat HTTPS manzil ishlating.
- Har bir so‘rov imzosini tekshiring: xabar haqiqatan Sado’dan kelganini shu bilan bilasiz. Imzosiz yoki eski so‘rovni rad eting.
- Avval tez javob qaytaring, og‘ir ishni keyin qiling. Javob kechiksa, yuboruvchi tizim xabarni yetib bormadi deb hisoblashi mumkin.
- Bir xabar ikki marta kelishiga tayyor turing: yuboruvchi tizim javob olmasa, odatda qayta yuboradi. Hodisa ID’sini saqlang va takrorini o‘tkazib yuboring.
- Kalit va parollarni manzil ichiga yozmang, xatolarni esa jurnalga yozib boring.
Webhook ishlamasa: tekshiruv ro‘yxati
- Manzil internetdan ochiqmi: uni ofisdan tashqarida, masalan telefondagi mobil internetdan ochib ko‘ring.
- HTTPS sertifikatining muddati o‘tmaganmi.
- Server 200 qaytaryaptimi yoki xato (4xx, 5xx) beryaptimi: jurnalga qarang.
- Imzo to‘g‘ri tekshirilyaptimi: maxfiy kalit to‘liq nusxalanganmi, so‘rov tanasi o‘zgartirilmasdan tekshirilyaptimi.
- Server soati to‘g‘rimi: eski so‘rovni rad etish soatga bog‘liq.
Webhook kerakmi yoki tayyor ulanish yetadimi
Ko‘p kompaniyaga webhook umuman kerak emas. Bitrix24 bilan Sado’da tayyor ulanish bor: qo‘ng‘iroq kartasi yozuv va matn bilan CRM’ga tushadi, lid yoki bitim ochiladi. amoCRM, Google Sheets, 1C, BILLZ va MoySklad’ni jamoamiz siz bilan birga ulaydi. Webhook va REST API o‘z dasturingiz yoki boshqa tizim uchun kerak.
Batafsil: Bitrix24 bilan AI qo‘ng‘iroqlar, amoCRM bilan AI qo‘ng‘iroqlar va CRM va qo‘ng‘iroqlar. Saytingizdagi arizaga darhol qo‘ng‘iroq kerak bo‘lsa: avto qo‘ng‘iroq xizmati. Jonli sinab ko‘ring.
Savollar
Webhook va API farqi nima?
API’da sizning tizimingiz o‘zi so‘raydi: «yangi narsa bormi?». Webhook’da esa yangi narsa bo‘lganda boshqa tizim o‘zi xabar yuboradi. Ko‘pincha ikkalasi birga ishlatiladi.
Webhook uchun dasturchi kerakmi?
Ha, qabul qiladigan manzilni dasturchi ochadi. Lekin Bitrix24, amoCRM, Google Sheets, 1C, BILLZ yoki MoySklad ishlatsangiz, ularni Sado jamoasi ulaydi va webhook kerak bo‘lmaydi.
Webhook xabarida nima bo‘ladi?
Qo‘ng‘iroq natijasi: masalan, qisqa xulosa va keyingi qadam. Maydonlarning to‘liq ro‘yxati dasturchilar sahifasidagi hujjatda.
Webhook xavfsizmi?
Manzil HTTPS bo‘lsa va har bir so‘rov imzosini tekshirsangiz — ha. Kalit va parollarni manzil ichiga yozmang va ularni hech kimga chatda yubormang.