Webhook'ai FoodSoul API: CRM pati praneša jūsų paslaugoms apie naujus įvykius

Dabar FoodSoul pats siunčia pranešimus jūsų sistemoms, kai CRM įvyksta kokie nors pokyčiai. Pavyzdžiui, atėjo naujas užsakymas, klientas sumokėjo ar grąžino pinigus, užsiregistravo naujas svečias. Pakanka vieną kartą nurodyti savo paslaugos adresą, ir duomenys iš karto bus perduodami į apskaitos sistemą, jūsų botą, antrąją CRM ar analitiką.

Apie kokius įvykius galima gauti pranešimus

1. Naujas užsakymas su pilna kortele. Naudinga apskaitos sistemai, virtuvei ir analitikai.
2. Užsakymo statuso pasikeitimas. Tinka botui, kuris informuoja klientą apie užsakymą, ir skambučių centrui.
3. Apmokėjimo statuso pasikeitimas, įskaitant grąžinimą. Reikalinga buhalterijai ir finansų apskaitai.
4. Naujas klientas ir jo duomenų pakeitimas. Išorinei CRM ir naujienlaiškių paslaugoms.
5. Premijų suteikimas, nurašymas ir galiojimo pabaiga. Lojalumo programai ir komunikacijai su svečiais.
6. Nauja atsiliepimas. Vadovui ir kokybės tarnybai.
7. Kurjerio paskyrimas. Logistikai ir kliento pranešimams.
8. Stop sąrašo pakeitimas. Tinklalapiui, virtuvei ir pardavimo platformoms.
9. Filialas sustabdė arba atnaujino užsakymų priėmimą. Operacinei kontrolei ir tinklo vadovybei.

Jūs patys pasirenkate, apie kokius įvykius gauti pranešimus. Galite prijungti tik reikalingus, pavyzdžiui, „naujas užsakymas“ ir „apmokėjimas“. Neradote reikiamo įvykio? Parašykite mums — mielai jį pridėsime.

Kaip prijungti

1. Įjunkite webhook’us reikiamam filialui — parašo raktas bus sukurtas automatiškai.
2. Pasirinkite įvykius, apie kuriuos norite gauti pranešimus.
3. Nurodykite savo paslaugos adresą, į kurį FoodSoul siųs duomenis. Tinka tik HTTPS adresas.
4. Pridėkite parašo raktą į paslaugą, kuri priima pranešimus, ir sukonfigūruokite parašo tikrinimą. Jei kuriant webhook’us nurodėte skirtingus adresus, pridėkite raktą į kiekvieną paslaugą.
5. Įsitikinkite, kad paslauga patvirtina pranešimo gavimą per 10 sekundžių, kitaip FoodSoul jį išsiųs pakartotinai.

6. Sukonfigūruokite pasikartojimų tikrinimą: tas pats pranešimas gali ateiti kelis kartus. Visi pasikartojimai turi tą patį ID (antraštė X-Webhook-ID). Tegul jūsų paslauga įsimena apdorotų pranešimų ID ir praleidžia pasikartojimus — taip viena apmokėjimo operacija nebus atlikta du kartus.

    

Saugumas: kam reikalingas parašo raktas
 

FoodSoul pasirašo kiekvieną pranešimą parašo raktu — simbolių rinkiniu, kurį turite tik jūs ir mes. Pagal šį parašą jūsų sistema patikrina, kad pranešimas atėjo iš FoodSoul ir pakeliui nebuvo pakeistas.
 

Užklausą į jūsų paslaugos adresą gali siųsti bet kas. Pavyzdžiui, sukčius atsiųs netikrą pranešimą „užsakymas apmokėtas“, ir jūs atiduosite neapmokėtą užsakymą.
 

Su parašu taip nebus. Jūsų serveris apskaičiuoja parašą tuo pačiu raktu ir palygina jį su gautuoju. Jei parašai nesutampa, vadinasi, pranešimas yra suklastotas arba pakeistas.

 

Jei kas nors nepavyko

• Jei jūsų paslauga laikinai nepasiekiama, FoodSoul dar kelis kartus bandys pristatyti pranešimą per 10 valandų. Trumpalaikis sutrikimas ar serverio perkrovimas nesukels įvykių praradimo.
• Jei problema užsitęs, prenumerata bus išjungta, o jūs gausite laišką: taip sužinosite apie problemą.
• Norėdami vėl įjungti prenumeratą, parašykite techninei pagalbai. Ten pat galima pakartotinai išsiųsti pranešimus, kurie nebuvo pristatyti per sutrikimą.
   

Išsamus įvykių ir duomenų formato aprašymas — API dokumentacijoje.

Pagarbiai, FoodSoul komanda! Mes dirbame Jums!