Webhook ne yapar
Webhook, mağazanızdaki bir olayın ayrıntılarını gerçekleştiği anda başka bir yere gönderir. Olayı ve nereye gideceğini siz seçersiniz:
- API: Storeep olay verilerini sunucunuzun, CRM'inizin, Zapier veya Make senaryonuzun ya da reklam takip aracınızın bir web adresine (URL) gönderir.
- E-posta: Storeep olay verilerini bir e-posta adresine gönderir, örneğin her yeni sipariş için bir e-posta almak için.
Ayarlar > Webhooks bölümünü açın. Ayarlar iznine ihtiyacınız vardır.
Birçok araç için zaten hazır bir uygulama vardır ve bu daha kolaydır: Google Sheets, kurye ağları ve reklam pikselleri. Önce Uygulama pazarına göz atın.
Webhook oluşturma
Yeni webhook ekle düğmesine tıklayın, formu doldurun ve Ekle düğmesine tıklayın.
- Etkinleştir: varsayılan olarak işaretlidir. İşaretliyken olaylar hemen gönderilir. Webhook'u silmeden duraklatmak için işareti kaldırın.
- Ad: listeniz için bir etiket, örneğin "CRM yeni siparişler".
- Tip: API veya E-posta.
- Etkinlik:
- Sipariş oluşturuldu: bir müşteri yeni bir sipariş verir.
- Sipariş güncellendi: bir siparişin durumu veya ayrıntıları değişir.
- Oturum oluşturuldu: mağazanıza yeni bir ziyaretçi gelir. Yalnızca API türü için.
- Biçim: Json.
- URL (API türü): gönderilecek adres.
https://kısmı sizin için eklenir, bu yüzden geri kalanını yazın, örneğinapi.example.com/orders. - E-posta adresi (E-posta türü): e-postanın gideceği yer.
Bir E-posta webhook'u yalnızca sipariş olaylarını gönderir. E-posta türünü Oturum oluşturuldu ile seçerseniz hiçbir şey gönderilmez.
Sipariş verilerini URL'ye koyma
Olay verilerindeki herhangi bir alanı çift süslü parantezle URL'nin içine yerleştirebilirsiniz, {{field_name}}. Örneğin:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
Bu, Facebook tıklama kimliğini ve sipariş toplamını, ek bir sunucu olmadan bir reklam takip veya satış ortaklığı (affiliate) platformuna gönderir. Var olmayan bir alan boş olur. Alan adlarını görmek için aynı olay için bir E-posta webhook'u oluşturun ve aldığınız verilere bakın.
Webhook listesi
Her satır Ad, URL / E-posta, Tip, Etkinlik, Biçim ve Durum (Etkinleştirildi veya Devredışı) bilgilerini gösterir. Düzenlemek için bir satıra tıklayın. Kalıcı olarak kaldırmak için satırları işaretleyin ve Webhooks'u sil seçeneğini seçin. Mağaza başına en fazla webhook sayısı vardır ve bu sayıya ulaştığınızda bir mesaj görürsünüz.
Aynı olay için birkaç webhook oluşturabilirsiniz, örneğin biri CRM'inize, biri reklam takip aracınıza.
Bir gönderim başarısız olduğunda
- Sunucunuz bir başarı koduyla (2xx) hızlıca yanıt vermelidir. Yavaş bir yanıt başarısızlık sayılır.
- Sunucunuz kapalı veya meşgulse (5xx veya 429 yanıtı ya da hiç yanıt yoksa), Storeep sonraki birkaç dakika içinde birkaç kez yeniden dener. Yalnızca başarısız olan webhook'lar yeniden denenir, böylece diğerleri yinelenen veri almaz.
- Sunucunuz isteği reddederse (404 veya 403 gibi bir 4xx yanıtı), Storeep yeniden denemez, çünkü adres veya güvenlik ayarı yanlıştır.
- Bir webhook art arda birkaç kez başarısız olduğunda mağaza sahibi tek bir e-posta alır: "Action needed: your Storeep webhook is failing" (İşlem gerekli: Storeep webhook'unuz başarısız oluyor), webhook adı, adresi, olayı ve son hata koduyla birlikte. Webhook yeniden çalıştıktan sonra gelecekteki bir sorun yeni bir uyarı gönderebilir. Bu e-postayı Bildirimler bölümünden kapatabilirsiniz.
- E-posta webhook'ları bir kez gönderilir, yeniden denenmez.
Ödenmemiş bakiye nedeniyle duraklatılan webhook'lar
Mağazanızın ödenmemiş bir vadesi gelen tutarı varsa ve cüzdanınız bunu karşılayamıyorsa, webhook'lar bekler. Siz bakiye ekleyip tutar ödendikten sonra gönderilirler. Bkz. Cüzdan ve faturalandırma.
İpuçları
- Sunucunuz bir şifre veya anahtar gerektiriyorsa, onu URL sorgusuna koyun, örneğin
?key=yoursecret. - Oturum oluşturuldu her ziyaretçi için tetiklenir, bu da yoğun bir mağazada çok fazla olabilir. Yalnızca sunucunuz bunu kaldırabiliyorsa kullanın.
- Bir aracın siparişlerinizi ve ürünlerinizi istediği zaman okumasına izin vermek için bunun yerine bir erişim belirteci kullanın.