FoodSoul API'deki Webhook'lar: CRM, yeni olaylar hakkında servislerinize kendisi bilgi verir
Artık FoodSoul, CRM'de bir şey olduğunda sistemlerinize otomatik olarak bildirim gönderiyor. Örneğin, yeni bir sipariş geldiğinde, müşteri ödeme yaptığında veya para iadesi aldığında, yeni bir misafir kaydolduğunda. Servisinizin adresini bir kez belirtmeniz yeterli; veriler hemen muhasebe sisteminize, botunuza, ikinci bir CRM'e veya analiz aracınıza gönderilecektir.
Hangi olaylar hakkında bildirim alabilirsiniz
- Tam kart ile yeni sipariş. Muhasebe sistemi, mutfak ve analiz için faydalı olacaktır.
- Sipariş durumunun değişmesi. Müşteriye sipariş hakkında bilgi veren bot ve çağrı merkezi için uygundur.
- Ödeme durumunun değişmesi, iade dahil. Muhasebe ve finansal kayıt için gereklidir.
- Yeni müşteri ve müşteri bilgilerinin değişmesi. Harici CRM ve bülten servisleri için.
- Bonusların eklenmesi, kullanılması ve yanması. Sadakat programı ve misafirlerle iletişim için.
- Yeni yorum. Yönetici ve kalite servisi için.
- Kurye atanması. Lojistik ve müşteri bilgilendirmesi için.
- Stop-listenin değiştirilmesi. Web sitesi, mutfak ve satış yaptığınız platformlar için.
- Şube sipariş alımını durdurdu veya yeniden başlattı. Operasyonel kontrol ve ağ yönetimi için.
Hangi olaylar hakkında bildirim alacağınızı kendiniz seçersiniz. Sadece ihtiyacınız olanları bağlayabilirsiniz, örneğin “yeni sipariş” ve “ödeme”. Gerekli olayı bulamadınız mı? Bize yazın — memnuniyetle ekleriz.
Nasıl bağlanır
- Gerekli şube için webhook’ları etkinleştirin — imza anahtarı otomatik olarak oluşturulacaktır.
- Hangi olaylar hakkında bildirim almak istediğinizi seçin.
- FoodSoul’un verileri göndereceği servis adresinizi belirtin. Sadece HTTPS adresi uygundur.
- Bildirimleri alan servise imza anahtarını ekleyin ve imza doğrulamasını ayarlayın. Webhook oluştururken farklı adresler belirttiyseniz, anahtarı her servise ekleyin.
- Servisinizin bildirimi 10 saniye içinde aldığını onayladığından emin olun, aksi takdirde FoodSoul bildirimi tekrar gönderecektir.
Tekrarları kontrol edecek şekilde ayarlayın: aynı bildirim birkaç kez gelebilir. Tüm tekrarların aynı ID’si vardır (X-Webhook-ID başlığı). Servisiniz işlenen bildirimlerin ID’lerini hatırlasın ve tekrarları atlatsın — böylece bir ödeme iki kez işlenmez.
Güvenlik: İmza anahtarı neden gereklidir
FoodSoul her bildirimi imza anahtarıyla imzalar — bu anahtar sadece sizde ve bizde bulunur. Sisteminiz bu imza ile bildirimin gerçekten FoodSoul’dan geldiğini ve yol boyunca değiştirilmediğini kontrol eder.
Servis adresinize herkes istek gönderebilir. Örneğin, bir dolandırıcı sahte “sipariş ödendi” bildirimi gönderebilir ve siz ödenmemiş siparişi teslim edebilirsiniz.
İmzayla bu mümkün olmaz. Sunucunuz aynı anahtarla imzayı hesaplar ve gelenle karşılaştırır. İmzalar uyuşmazsa, bildirim sahte veya değiştirilmiş demektir.
Bir şeyler ters giderse
- Servisiniz geçici olarak erişilemezse, FoodSoul bildirimi 10 saat boyunca birkaç kez daha göndermeyi dener. Kısa süreli bir kesinti veya sunucu yeniden başlatılması olayların kaybolmasına yol açmaz.
- Sorun uzun sürerse, abonelik devre dışı bırakılır ve size bir e-posta gönderilir: böylece sorundan haberdar olursunuz.
- Aboneliği tekrar etkinleştirmek için teknik desteğe yazın. Aynı yerde, kesinti sırasında ulaşmayan bildirimleri tekrar gönderebilirsiniz.
Olayların ve veri formatının ayrıntılı açıklaması — API dokümantasyonunda.
Saygılarımızla, FoodSoul ekibi! Sizin için çalışıyoruz!