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 командасы! Біз сіз үшін жұмыс істейміз!