Webhooki w API FoodSoul: CRM sama informuje Twoje usługi o nowych zdarzeniach

Teraz FoodSoul sam wysyła powiadomienia do Twoich systemów, gdy w CRM coś się dzieje. Na przykład pojawia się nowe zamówienie, klient dokonuje płatności lub zwrotu pieniędzy, rejestruje się nowy gość. Wystarczy raz podać adres swojego serwisu, a dane natychmiast trafią do systemu księgowego, Twojego bota, drugiego CRM lub narzędzi analitycznych.

O jakich zdarzeniach można otrzymywać powiadomienia

1. Nowe zamówienie z pełną kartą. Przydatne dla systemu księgowego, kuchni i analityki.
2. Zmiana statusu zamówienia. Idealne dla bota informującego klienta o zamówieniu oraz dla call center.
3. Zmiana statusu płatności, w tym zwrot. Potrzebne dla księgowości i rozliczeń finansowych.
4. Nowy klient i zmiana jego danych. Dla zewnętrznego CRM i serwisów mailingowych.
5. Naliczenie, odjęcie i wygaśnięcie punktów bonusowych. Dla programu lojalnościowego i komunikacji z gośćmi.
6. Nowa opinia. Dla menedżera i działu jakości.
7. Przydzielenie kuriera. Dla logistyki i powiadomień dla klienta.
8. Zmiana listy produktów niedostępnych. Dla strony internetowej, kuchni i platform sprzedażowych.
9. Oddział wstrzymał lub wznowił przyjmowanie zamówień. Dla kontroli operacyjnej i zarządu sieci.

Sam wybierasz, które zdarzenia chcesz otrzymywać. Możesz podłączyć tylko te, które są potrzebne, na przykład „nowe zamówienie” i „płatność”. Nie znalazłeś odpowiedniego zdarzenia? Napisz do nas — z przyjemnością je dodamy.

Jak podłączyć

1. Włącz webhooki dla wybranego oddziału — klucz podpisu zostanie utworzony automatycznie.
2. Wybierz zdarzenia, o których chcesz otrzymywać powiadomienia.
3. Podaj adres swojego serwisu, na który FoodSoul będzie wysyłać dane. Akceptowany jest tylko adres z HTTPS.
4. Dodaj klucz podpisu do serwisu, który odbiera powiadomienia, i skonfiguruj weryfikację podpisu. Jeśli podczas tworzenia webhooków podałeś różne adresy, dodaj klucz do każdego serwisu.
5. Upewnij się, że serwis potwierdza odbiór powiadomienia w ciągu 10 sekund, w przeciwnym razie FoodSoul wyśle je ponownie.

6. Skonfiguruj sprawdzanie duplikatów: to samo powiadomienie może przyjść kilka razy. Wszystkie duplikaty mają ten sam ID (nagłówek X-Webhook-ID). Niech Twój serwis zapamiętuje ID obsłużonych powiadomień i pomija duplikaty — dzięki temu jedna płatność nie zostanie zaksięgowana dwa razy.

    

Bezpieczeństwo: po co jest klucz podpisu
 

FoodSoul podpisuje każde powiadomienie za pomocą klucza podpisu — ciągu znaków, który mają tylko Ty i my. Dzięki temu Twoja system może sprawdzić, że powiadomienie pochodzi od FoodSoul i nie zostało zmienione po drodze.
 

Każdy może wysłać żądanie na adres Twojego serwisu. Na przykład oszust może wysłać fałszywe powiadomienie „zamówienie opłacone”, a Ty wydasz nieopłacone zamówienie.
 

Z podpisem to się nie uda. Twój serwer oblicza podpis tym samym kluczem i porównuje go z otrzymanym. Jeśli podpisy się nie zgadzają, powiadomienie jest fałszywe lub zmienione.

 

Jeśli coś pójdzie nie tak

• Jeśli Twój serwis jest tymczasowo niedostępny, FoodSoul spróbuje jeszcze kilka razy dostarczyć powiadomienie przez 10 godzin. Krótkotrwała awaria lub restart serwera nie spowodują utraty zdarzeń.
• Jeśli problem się przedłuży, subskrypcja zostanie wyłączona, a Ty otrzymasz e-mail: w ten sposób dowiesz się o problemie.
• Aby ponownie włączyć subskrypcję, napisz do wsparcia technicznego. Tam również można ponownie wysłać powiadomienia, które nie dotarły podczas awarii.
   

Szczegółowy opis zdarzeń i formatu danych znajdziesz w dokumentacji API.

Z poważaniem, zespół FoodSoul! Pracujemy dla Ciebie!