Vebhukovi u API FoodSoul: CRM sama obaveštava vaše servise o novim događajima
Sada FoodSoul samostalno šalje obaveštenja vašim sistemima kada se nešto dešava u CRM-u. Na primer, stigla je nova porudžbina, klijent je platio ili vratio novac, registrovan je novi gost. Dovoljno je jednom da navedete adresu svog servisa i podaci će odmah odlaziti u računovodstveni sistem, vašeg bota, drugu CRM ili analitiku.
O kojim događajima možete primati obaveštenja
- Nova porudžbina sa kompletnom karticom. Korisno za računovodstveni sistem, kuhinju i analitiku.
- Promena statusa porudžbine. Pogodno za bota koji obaveštava klijenta o porudžbini i za kol-centar.
- Promena statusa plaćanja, uključujući povraćaj. Potrebno za knjigovodstvo i finansijsko praćenje.
- Novi klijent i izmena njegovih podataka. Za eksterni CRM i servise za slanje obaveštenja.
- Dodela, oduzimanje i isticanje bonusa. Za program lojalnosti i komunikaciju sa gostima.
- Nova recenzija. Za menadžera i službu za kvalitet.
- Dodela kurira. Za logistiku i obaveštavanje klijenta.
- Izmena stop-liste. Za sajt, kuhinju i platforme na kojima prodajete.
- Filijala je zaustavila ili obnovila prijem porudžbina. Za operativnu kontrolu i rukovodstvo lanca.
Sami birate koja obaveštenja želite da primate. Možete uključiti samo ona koja su vam potrebna, na primer “nova porudžbina” i “plaćanje”. Niste pronašli željeni događaj? Pišite nam — rado ćemo ga dodati.
Kako se povezati
- Uključite vebhukove za željenu filijalu — ključ za potpisivanje će se automatski generisati.
- Izaberite događaje o kojima želite da primate obaveštenja.
- Navedite adresu vašeg servisa na koju će FoodSoul slati podatke. Prihvatljiva je samo adresa sa HTTPS protokolom.
- Dodajte ključ za potpisivanje u servis koji prima obaveštenja i podesite proveru potpisa. Ako ste prilikom kreiranja vebhukova naveli različite adrese, dodajte ključ u svaki servis.
- Uverite se da servis potvrđuje prijem obaveštenja u roku od 10 sekundi, u suprotnom FoodSoul će ga ponovo poslati.
Podesite proveru duplikata: isto obaveštenje može stići više puta. Svi duplikati imaju isti ID (zaglavlje X-Webhook-ID). Neka vaš servis pamti ID obrađenih obaveštenja i preskače duplikate — tako se jedna uplata neće obraditi dva puta.
Bezbednost: čemu služi ključ za potpisivanje
FoodSoul potpisuje svako obaveštenje pomoću ključa za potpisivanje — niza karaktera koji imate samo vi i mi. Po tom potpisu vaš sistem proverava da li je obaveštenje stiglo od FoodSoul-a i da li ga niko nije izmenio tokom prenosa.
Bilo ko može poslati zahtev na adresu vašeg servisa. Na primer, prevarant može poslati lažno obaveštenje “porudžbina plaćena” i vi ćete izdati neplaćenu porudžbinu.
Sa potpisom to nije moguće. Vaš server izračunava potpis istim ključem i upoređuje ga sa primljenim. Ako se potpisi ne poklapaju, obaveštenje je lažno ili izmenjeno.
Ako nešto pođe po zlu
- Ako je vaš servis privremeno nedostupan, FoodSoul će još nekoliko puta pokušati da isporuči obaveštenje tokom 10 sati. Kratkotrajni prekid ili restart servera neće dovesti do gubitka događaja.
- Ako se problem produži, pretplata će biti isključena, a vi ćete dobiti e-mail: tako ćete saznati za problem.
- Da biste ponovo uključili pretplatu, pišite tehničkoj podršci. Tamo možete ponovo poslati obaveštenja koja nisu stigla tokom prekida.
Detaljan opis događaja i formata podataka nalazi se u API dokumentaciji.
S poštovanjem, tim FoodSoul! Radimo za vas!