FoodSoul API-də vebhooklar: CRM yeni hadisələr barədə sizin servislərinizə özü məlumat verir
İndi FoodSoul CRM-də nəsə baş verdikdə, sistemlərinizə özü bildiriş göndərir. Məsələn, yeni sifariş gəldi, müştəri ödəniş etdi və ya pulu geri qaytardı, yeni qonaq qeydiyyatdan keçdi. Xidmətinizin ünvanını bir dəfə göstərmək kifayətdir və məlumatlar dərhal uçot sisteminizə, botunuza, ikinci CRM-ə və ya analitikaya göndəriləcək.
Hansə hadisələr barədə bildirişlər almaq olar
- Tam kartla yeni sifariş. Uçot sistemi, mətbəx və analitika üçün faydalıdır.
- Sifariş statusunun dəyişməsi. Müştəriyə sifariş barədə məlumat verən bot və çağrı mərkəzi üçün uyğundur.
- Ödəniş statusunun dəyişməsi, o cümlədən geri qaytarma. Mühasibat və maliyyə uçotu üçün lazımdır.
- Yeni müştəri və onun məlumatlarının dəyişməsi. Xarici CRM və göndəriş xidmətləri üçün.
- Bonusların hesablanması, silinməsi və yanması. Loyallıq proqramı və qonaqlarla ünsiyyət üçün.
- Yeni rəy. İdarəçi və keyfiyyət xidməti üçün.
- Kuryerin təyin edilməsi. Logistika və müştəriyə bildiriş üçün.
- Stop-listin dəyişməsi. Sayt, mətbəx və satış platformaları üçün.
- Filial sifariş qəbulunu dayandırdı və ya bərpa etdi. Əməliyyat nəzarəti və şəbəkə rəhbərliyi üçün.
Hansı hadisələri almaq istədiyinizi özünüz seçirsiniz. Yalnız lazım olanları qoşa bilərsiniz, məsələn “yeni sifariş” və “ödəniş”. Lazım olan hadisəni tapmadınız? Bizə yazın — məmnuniyyətlə əlavə edərik.
Necə qoşmaq olar
- Lazım olan filial üçün webhook-ları aktiv edin — imza açarı avtomatik yaradılacaq.
- Hansı hadisələr barədə bildiriş almaq istədiyinizi seçin.
- FoodSoul-un məlumat göndərəcəyi xidmət ünvanınızı göstərin. Yalnız HTTPS ünvanı uyğundur.
- Bildirişləri qəbul edən xidmətə imza açarını əlavə edin və imzanın yoxlanmasını qurun. Əgər webhook yaradarkən müxtəlif ünvanlar göstərmisinizsə, hər bir xidmətə açarı əlavə edin.
- Xidmətin bildirişi 10 saniyə ərzində təsdiqlədiyinə əmin olun, əks halda FoodSoul onu təkrar göndərəcək.
Təkrar yoxlamasını qurun: eyni bildiriş bir neçə dəfə gələ bilər. Bütün təkrarların eyni ID-si var (X-Webhook-ID başlığı). Xidmətiniz işlənmiş bildirişlərin ID-sini yadda saxlasın və təkrarları ötürsün — beləliklə bir ödəniş iki dəfə aparılmayacaq.
Təhlükəsizlik: imza açarı nə üçün lazımdır
FoodSoul hər bir bildirişi imza açarı ilə imzalayır — bu, yalnız sizdə və bizdə olan simvollar toplusudur. Bu imza ilə sisteminiz bildirir ki, bildiriş həqiqətən FoodSoul-dan gəlib və yolda dəyişdirilməyib.
Xidmət ünvanınıza istənilən şəxs sorğu göndərə bilər. Məsələn, dələduz saxta “sifariş ödənildi” bildirişi göndərə bilər və siz ödənilməmiş sifarişi verərsiniz.
İmza ilə bu mümkün deyil. Serveriniz eyni açarla imzanı hesablayır və alınanla müqayisə edir. Əgər imzalar uyğun gəlmirsə, deməli bildiriş saxtadır və ya dəyişdirilib.
Əgər nəsə düzgün getməsə
- Əgər xidmətiniz müvəqqəti əlçatmaz olsa, FoodSoul bildirişi 10 saat ərzində bir neçə dəfə göndərməyə çalışacaq. Qısa fasilə və ya serverin yenidən başladılması hadisələrin itirilməsinə səbəb olmayacaq.
- Əgər problem uzun çəkərsə, abunəlik deaktiv ediləcək və sizə məktub gələcək: beləliklə problem barədə xəbər tutacaqsınız.
- Abunəliyi yenidən aktiv etmək üçün texniki dəstəyə yazın. Orada həmçinin nasazlıq zamanı çatmayan bildirişləri yenidən göndərmək olar.
Hadisələrin və məlumat formatının ətraflı təsviri — API sənədlərində.
Hörmətlə, FoodSoul komandası! Sizin üçün çalışırıq!