FoodSoul API-дегі вебхуктар: CRM жаңа оқиғалар туралы сіздің сервистеріңізге өзі хабарлайды

Енді FoodSoul CRM жүйесінде бір нәрсе болған кезде, сіздің жүйелеріңізге хабарламаларды өзі жібереді. Мысалы, жаңа тапсырыс келді, клиент төледі немесе ақшасын қайтарды, жаңа қонақ тіркелді. Қызметіңіздің мекенжайын бір рет көрсету жеткілікті, сонда деректер бірден есеп жүйесіне, ботыңызға, екінші CRM-ге немесе аналитикаға жіберіледі.

Қандай оқиғалар туралы хабарламалар алуға болады

1. Толық карточкасы бар жаңа тапсырыс. Есеп жүйесі, асхана және аналитика үшін пайдалы.
2. Тапсырыс мәртебесінің өзгеруі. Клиентке тапсырыс туралы хабарлайтын бот пен колл-орталыққа ыңғайлы.
3. Төлем мәртебесінің өзгеруі, қайтарымды қоса алғанда. Бухгалтерия мен қаржылық есеп үшін қажет.
4. Жаңа клиент және оның деректерінің өзгеруі. Сыртқы CRM мен тарату сервистеріне арналған.
5. Бонустардың есептелуі, шегерілуі және жойылуы. Лоялдылық бағдарламасы мен қонақтармен байланыс үшін.
6. Жаңа пікір. Басқарушы мен сапа қызметіне арналған.
7. Курьерді тағайындау. Логистика мен клиентке хабарлама үшін.
8. Стоп-листің өзгеруі. Сайт, асхана және сіз сататын алаңдар үшін.
9. Филиал тапсырыстарды қабылдауды тоқтатты немесе қайта бастады. Операциялық бақылау мен желі басшылығына арналған.

Қай оқиғалар туралы хабарлама алатыныңызды өзіңіз таңдайсыз. Тек қажеттілерін қосуға болады, мысалы “жаңа тапсырыс” пен “төлем”. Қажетті оқиға таппадыңыз ба? Бізге жазыңыз — қуана қосамыз.

Қалай қосуға болады

1. Қажетті филиал үшін вебхуктарды қосыңыз — қолтаңба кілті автоматты түрде жасалады.
2. Қандай оқиғалар туралы хабарлама алғыңыз келетінін таңдаңыз.
3. FoodSoul деректерді жіберетін қызметіңіздің мекенжайын көрсетіңіз. Тек HTTPS мекенжайы жарамды.
4. Хабарламаларды қабылдайтын сервиске қолтаңба кілтін қосыңыз және қолтаңбаны тексеруді баптаңыз. Егер вебхуктарды жасағанда әртүрлі мекенжайлар көрсетсеңіз, әр сервиске кілтті қосыңыз.
5. Сервис хабарламаны 10 секунд ішінде қабылдағанын растауына көз жеткізіңіз, әйтпесе FoodSoul оны қайта жібереді.

6. Қайталауларды тексеруді баптаңыз: бір хабарлама бірнеше рет келуі мүмкін. Барлық қайталаулардың ID-і бірдей (X-Webhook-ID тақырыбы). Сервисіңіз өңделген хабарламалардың ID-ін есте сақтап, қайталауларды өткізіп жіберсін — осылайша бір төлем екі рет жүргізілмейді.

    

Қауіпсіздік: қолтаңба кілті не үшін керек
 

FoodSoul әр хабарламаны қолтаңба кілтімен — тек сізде және бізде бар таңбалар жиынтығымен — қол қояды. Осы қолтаңба арқылы жүйеңіз хабарламаның FoodSoul-дан келгенін және жолда өзгермегенін тексереді.
 

Сіздің сервисіңіздің мекенжайына кез келген адам сұраныс жібере алады. Мысалы, алаяқ “тапсырыс төленді” деген жалған хабарлама жіберуі мүмкін, сонда сіз төленбеген тапсырысты беріп жібересіз.
 

Қолтаңбамен бұлай болмайды. Серверіңіз сол кілтпен қолтаңбаны есептеп, алынғанымен салыстырады. Егер қолтаңбалар сәйкес келмесе, хабарлама жалған немесе өзгертілген деген сөз.

 

Егер бірдеңе дұрыс болмаса

• Егер сервисіңіз уақытша қолжетімсіз болса, FoodSoul хабарламаны 10 сағат ішінде бірнеше рет жеткізуге тырысады. Қысқа ақау немесе серверді қайта жүктеу оқиғалардың жоғалуына әкелмейді.
• Егер мәселе ұзаққа созылса, жазылу өшіріледі, ал сізге хат келеді: осылайша мәселе туралы білесіз.
• Жазылымды қайта қосу үшін техникалық қолдауға жазыңыз. Сол жерде ақау кезінде жетпеген хабарламаларды қайта жіберуге болады.
   

Оқиғалар мен деректер форматының толық сипаттамасы — API құжаттамасында.

Құрметпен, FoodSoul командасы! Біз сіз үшін жұмыс істейміз!