Webhook nima va qanday ishlaydi: qo‘ng‘iroq natijasi tizimingizga o‘zi qanday tushadi
Sado AI jamoasi · · 3 daqiqada o‘qiladi
Qisqacha
Webhook (ruscha вебхук) — biror voqea sodir bo‘lishi bilan bir dastur boshqa dasturning belgilangan manziliga (URL’ga) o‘zi yuboradigan avtomatik xabar. Masalan, qo‘ng‘iroq tugadi — tizim darhol xabar yuboradi: «Bekzod, shanba 10:00, diagnostika». Sizning dasturingiz har daqiqada «yangi narsa bormi?» deb so‘rab o‘tirmaydi, xabar o‘zi keladi. AI ovozli operatorda webhook qo‘ng‘iroq natijasini — mijoz javoblari, xulosa va keyingi qadamni — sizning CRM, buyurtma dasturingiz yoki jadvalingizga qo‘lda ko‘chirmasdan yetkazadi.
Webhook oddiy tilda
Pochta qutisini har soatda ochib ko‘rish o‘rniga, xat kelganda pochtachi eshik qo‘ng‘irog‘ini bosadi. Webhook — mana shu qo‘ng‘iroq. Uning to‘rt qismi bor:
- voqea — nima bo‘lganda xabar ketadi: qo‘ng‘iroq tugadi, yangi ariza tushdi;
- manzil — xabar qayerga boradi: sizning tizimingizdagi URL;
- xabar matni — odatda JSON ko‘rinishida: ism, telefon, javoblar;
- javob — sizning tizimingiz «oldim» deydi; javob kelmasa, ko‘p tizimlar xabarni qayta yuboradi.
Webhook va API farqi
| API | Webhook | |
|---|---|---|
| Kim boshlaydi | Sizning dasturingiz so‘raydi | Tizim o‘zi xabar yuboradi |
| Qachon | Siz so‘ragan paytda | Voqea bo‘lgan zahoti |
| Misol | «Bugungi qo‘ng‘iroqlarni ber» | «Qo‘ng‘iroq tugadi, mana natijasi» |
| Qachon qulay | Ro‘yxat yuborish, ma’lumot olish | Har bir yangi voqeani darhol bilish |
Ko‘pincha ikkalasi birga ishlaydi: API orqali qo‘ng‘iroq uchun ro‘yxat yuborasiz, webhook orqali har bir qo‘ng‘iroq natijasini olasiz. Batafsil: API nima.
Misol: Toshkentdagi avtoservis
«Motor Servis» (nomi o‘ylab topilgan) mashinalarni yozuv bo‘yicha qabul qiladi, yozuvlar o‘zining kichik dasturida turadi:
- Mijoz kechqurun soat o‘nda qo‘ng‘iroq qiladi: shanba kuni diagnostikaga yozilmoqchi.
- AI operator servis bergan ish vaqti bo‘yicha shanba 10:00 ni taklif qiladi, ismini, mashina rusumini va muammoni so‘raydi.
- Qo‘ng‘iroq tugashi bilan Sado servis dasturining manziliga webhook yuboradi: ism, telefon, mashina, kun, soat va qisqa xulosa («sovuqda dvigatel taqillaydi»).
- Servis dasturi yozuvni jadvalga qo‘shadi. Ertalab usta tayyor ro‘yxatni ko‘radi.
Hech kim qo‘ng‘iroq yozuvini tinglab, ma’lumotni qo‘lda ko‘chirmadi. Kechasi kelgan mijoz ham yo‘qolmadi: ertalab unga hech kim qayta qo‘ng‘iroq qilib, hammasini boshidan so‘rab o‘tirmadi.
AI ovozli operatorga webhook nima uchun kerak
Sado’da har bir qo‘ng‘iroq portalga tushadi: yozuv, matn, mijoz javoblari, xulosa va keyingi qadam. Bitrix24 bilan tayyor ulanish bor; amoCRM, Google Sheets va 1C’ni jamoamiz ulaydi (qo‘ng‘iroqlar CRM’da). Boshqa har qanday tizim uchun webhook va REST API bor (dasturchilar uchun). Webhook bilan qilinadigan ishlar:
- o‘z CRM yoki buyurtma dasturingizga ariza tushirish;
- qo‘ng‘iroqdan keyin o‘z tizimingizdan SMS yoki to‘lov havolasini yuborish;
- hisobot jadvaliga yangi qator qo‘shish;
- kerakli xodimga vazifa ochish.
Telegram guruhga qo‘ng‘iroq kartasi esa webhook’siz ham keladi: buni Sado o‘zi qiladi. Webhook kiruvchi qo‘ng‘iroqlar uchun ham, chiquvchi qo‘ng‘iroqlar uchun ham bir xil ishlaydi.
Webhook ulashdan oldin tekshiruv ro‘yxati
- Qabul qiladigan manzil internetdan ochiq va https bo‘lsin.
- Tizimingiz darhol «oldim» (200) desin, og‘ir ishni keyin qilsin.
- Bitta xabar ikki marta kelsa, ikki marta yozilmasin: voqea raqami bo‘yicha tekshiring.
- Imzoni tekshiring: Sado har bir webhook so‘rovini imzolaydi, shuning uchun soxta xabarni ajratish oson.
- Serveringiz tashqaridan ko‘rinmasa (masalan, ofisdagi 1C), webhook o‘rniga voqealar lentasini so‘rab turing — tafsilotlar /developers sahifasida.
Webhook’ni sozlash uchun dasturchingiz kerak bo‘ladi, operatorni sozlashni esa Sado jamoasi qiladi. Jonli sinab ko‘ring yoki 78 778 01 23 ga qo‘ng‘iroq qiling. Boshqa savollar: Sado haqida savollar.
Savollar
Webhook ulash uchun dasturchi kerakmi?
Ha, xabarni qabul qiladigan tomonda kimdir uni sozlashi kerak. Bitrix24 bo‘lsa, webhook shart emas: Sado’da tayyor ulanish bor. amoCRM, Google Sheets va 1C’ni jamoamiz ulaydi.
Webhook xavfsizmi?
Ha, agar manzil https bo‘lsa va qabul qiluvchi tomon imzoni tekshirsa. Sado har bir webhook so‘rovini imzolaydi.
Webhook va API bir narsami?
Yo‘q. API’da sizning dasturingiz so‘rov yuboradi va javob oladi. Webhook’da esa tizim voqea bo‘lganda o‘zi xabar yuboradi. Ko‘pincha ikkalasi birga ishlatiladi.