
API FoodSoul’dagi veb-xabarlar: CRM yangi hodisalar haqida sizning servislaringizga o‘zi xabar beradi
Endi FoodSoul o‘zi CRM tizimingizda biror narsa sodir bo‘lganda, tizimlaringizga xabar yuboradi. Masalan, yangi buyurtma kelganida, mijoz to‘lov qilganida yoki pulni qaytarib olganida, yangi mehmon ro‘yxatdan o‘tganida. Xizmat manzilingizni bir marta ko‘rsatsangiz kifoya — ma’lumotlar darhol hisob tizimingizga, botingizga, boshqa CRM yoki analitikaga yuboriladi.
Qanday voqealar haqida xabar olish mumkin
- To‘liq kartochkasi bilan yangi buyurtma. Hisob tizimi, oshxona va analitika uchun foydali.
- Buyurtma holatini o‘zgarishi. Mijozga buyurtma haqida xabar beradigan bot va call-markaz uchun mos.
- To‘lov holatini o‘zgarishi, shu jumladan qaytarish. Buxgalteriya va moliyaviy hisob uchun kerak.
- Yangi mijoz va uning ma’lumotlarini o‘zgarishi. Tashqi CRM va xabar yuborish xizmatlari uchun.
- Bonuslarni hisoblash, yechish va kuyish. Sodiqlik dasturi va mehmonlar bilan aloqa uchun.
- Yangi fikr-mulohaza. Boshqaruvchi va sifat xizmati uchun.
- Kuryerni tayinlash. Logistika va mijozga xabar berish uchun.
- Stop-listni o‘zgarishi. Sayt, oshxona va savdo maydonchalari uchun.
- Filial buyurtmalarni qabul qilishni to‘xtatdi yoki qayta boshladi. Operatsion nazorat va tarmoq rahbariyati uchun.
Qaysi voqealar haqida xabar olishni o‘zingiz tanlaysiz. Faqat kerakli voqealarni ulashingiz mumkin, masalan “yangi buyurtma” va “to‘lov”. Kerakli voqeani topmadingizmi? Bizga yozing — mamnuniyat bilan qo‘shamiz.
Qanday ulash mumkin
- Kerakli filial uchun webhooklarni yoqing — imzo kaliti avtomatik yaratiladi.
- Qaysi voqealar haqida xabar olishni tanlang.
- FoodSoul ma’lumot yuboradigan xizmat manzilingizni kiriting. Faqat HTTPS manzili mos keladi.
- Xabarlarni qabul qiladigan xizmatga imzo kalitini qo‘shing va imzo tekshiruvini sozlang. Agar webhooklar yaratishda turli manzillar ko‘rsatgan bo‘lsangiz, har bir xizmatga kalitni qo‘shing.
- Xizmat 10 soniya ichida xabarni qabul qilganini tasdiqlashiga ishonch hosil qiling, aks holda FoodSoul uni qayta yuboradi.
Qayta yuborishlarni tekshirishni sozlang: bir xabar bir necha marta kelishi mumkin. Barcha takrorlarda bir xil ID bo‘ladi (X-Webhook-ID sarlavhasi). Xizmatingiz qayta yuborilgan xabarlarning ID sini eslab qolsin va takrorlarni o‘tkazib yuborsin — shunda bir to‘lov ikki marta o‘tkazilmaydi.
Xavfsizlik: imzo kaliti nima uchun kerak
FoodSoul har bir xabarni imzo kaliti yordamida imzolaydi — bu faqat sizda va bizda bo‘lgan belgilar to‘plami. Shu imzo orqali tizimingiz xabarning FoodSoul’dan kelganini va yo‘lda o‘zgarmaganini tekshiradi.
Xizmat manzilingizga har kim so‘rov yuborishi mumkin. Masalan, firibgar “buyurtma to‘landi” degan soxta xabar yuboradi va siz to‘lanmagan buyurtmani berib yuborasiz.
Imzo bilan bunday bo‘lmaydi. Serveringiz xuddi shu kalit bilan imzoni hisoblaydi va kelgan imzo bilan solishtiradi. Agar imzolar mos kelmasa, demak xabar soxta yoki o‘zgartirilgan.
Agar nimadir noto‘g‘ri bo‘lsa
- Agar xizmatingiz vaqtincha ishlamasa, FoodSoul 10 soat davomida bir necha marta xabarni yetkazishga harakat qiladi. Qisqa uzilish yoki serverni qayta ishga tushirish voqealarni yo‘qotishga olib kelmaydi.
- Agar muammo uzoq davom etsa, obuna o‘chiriladi va sizga xat keladi: shunda muammo haqida bilib olasiz.
- Obunani qayta yoqish uchun texnik yordamga yozing. Shu yerda uzilish vaqtida yetib bormagan xabarlarni qayta yuborish mumkin.
Voqealar va ma’lumotlar formati haqida batafsil tavsif — API hujjatlarida.
Hurmat bilan, FoodSoul jamoasi! Siz uchun ishlaymiz!