Webhook'lar ne işe yarar?
Webhook, belirli bir mağaza olayına yapılan bir aboneliktir. Bu olay gerçekleştiğinde Storeep, olay verilerini belirttiğiniz bir URL'ye (API türü) veya belirttiğiniz bir e-posta adresine (E-posta türü) hemen gönderir. Webhook'lar genellikle sipariş takibi entegrasyonları, CRM senkronizasyonları, reklam platformu dönüşümleri ve otomatik bildirimler için kullanılır.
Webhook'ları yönetmek için Ayarlar → Webhook'lar bölümüne gidin.
Webhook sınırları
- Mağaza başına maksimum 20 webhook. 21. webhook eklenmeye çalışıldığında hata döner.
- Webhook'lar en yeniden en eskiye doğru listelenir, sayfa başına 40 adet.
Webhook oluşturma
Yeni webhook ekle düğmesine tıklayın.
Etkinleştir düğmesi
İşaretlendiğinde (varsayılan), webhook kaydedildiği andan itibaren canlıdır ve olaylar hemen gönderilir. Olayları almadan webhook'u devre dışı durumda kaydetmek için işareti kaldırın. Bir webhook'u istediğiniz zaman düzenleyerek etkinleştirebilir veya devre dışı bırakabilirsiniz.
Ad
- Zorunludur.
- Maksimum 50 karakter.
- Webhook listesinde gösterilen açıklayıcı bir etiket. Örnek: Facebook CAPI, sipariş oluşturuldu.
Tür
Olay yükünün nasıl iletileceğini belirler. İki seçenek:
- API: Storeep, olay verilerini belirttiğiniz URL'ye HTTP POST isteği olarak gönderir.
- E-posta: Storeep, olay verilerini belirttiğiniz adrese e-posta olarak gönderir.
Olay
Bu webhook'u tetikleyen mağaza olayı. Üç olay mevcuttur:
- Oturum oluşturuldu: mağazanızda yeni bir ziyaretçi oturumu oluşturulduğunda tetiklenir.
- Sipariş oluşturuldu: yeni bir sipariş verildiğinde tetiklenir.
- Sipariş güncellendi: mevcut bir siparişin durumu veya verileri değiştiğinde tetiklenir.
Biçim
Olay yükünün veri biçimi. Şu anda bir seçenek mevcuttur:
- Json: yük bir JSON belgesi olarak gönderilir.
URL (yalnızca API türü)
- Tür API olduğunda zorunludur.
- Maksimum 500 karakter. Yüksek sınır, birden fazla yer tutucu segment içeren URL'lere uyum sağlar.
- Uç nokta URL'sini
https://öneki olmadan girin; otomatik olarak eklenir. Örnek:api.example.com/events/order. - Dinamik URL yer tutucuları: olay yükündeki herhangi bir alan, çift süslü parantez söz dizimi kullanılarak URL'ye eklenebilir:
{{alan_adi}}. Örneğin:https://example.com/postback?cid={{fbclid}}&payout={{order_total}}
Bu, ayrı bir proxy sunucusu olmadan reklam platformlarına doğrudan webhook URL'sinden dönüşüm verisi göndermenizi sağlar. - Yer tutucular çözümlendikten sonra URL yapısı geçersizse bir doğrulama hatası alırsınız.
E-posta adresi (yalnızca e-posta türü)
- Tür E-posta olduğunda zorunludur.
- Geçerli bir e-posta adresi olmalıdır, maksimum 127 karakter.
Webhook düzenleme
Düzenleyiciyi açmak için herhangi bir webhook satırına tıklayın. Tüm alanlar düzenlenebilir. URL alanı yalnızca geçerli tür API ise; e-posta alanı yalnızca geçerli tür E-posta ise önceden doldurulur. Tür değiştirildiğinde diğer alan temizlenir.
Webhook'ları etkinleştirme ve devre dışı bırakma
Düzenleyicinin üstündeki Etkinleştir onay kutusu webhook'un tetiklenip tetiklenmeyeceğini belirler. Listede durum Etkin veya Devre Dışı olarak gösterilir. Devre dışı bırakılan bir webhook teslimat kaydetmez ancak silinmez; bu nedenle yeniden yapılandırmaya gerek kalmadan daha sonra yeniden etkinleştirilebilir.
Webhook listesi sütunları
- Ad: oluşturulma tarihiyle birlikte webhook etiketi.
- URL / E-posta: hedef adres.
- Tür: API veya E-posta.
- Olay: olay adı (Oturum oluşturuldu, Sipariş oluşturuldu veya Sipariş güncellendi).
- Biçim: Json.
- Durum: Etkin veya Devre Dışı.
Webhook silme
Bir veya daha fazla webhook seçin ve Webhook'ları sil düğmesine tıklayın. Bu işlem kalıcıdır ve söz konusu abonelik için gelecekteki tüm teslimatları durdurur.
İpuçları ve dikkat edilmesi gereken noktalar
- Aynı olay için birden fazla webhook oluşturabilirsiniz; örneğin Sipariş oluşturuldu olayını hem bir CRM'e hem de bir reklam platformuna ayrı webhook girişleri olarak gönderebilirsiniz.
- Uç noktanız kimlik doğrulama gerektiriyorsa kimlik bilgilerini olay verilerinden gelen bir
{{yer tutucu}}kullanarak URL sorgu dizesine ekleyin ya da gerçek uç noktaya iletmeden önce kimlik doğrulamayı işleyen bir proxy sunucusu kurun. - Oturum oluşturuldu olayı her benzersiz ziyaretçi oturumunda tetiklenir; bu durum popüler mağazalarda yüksek hacimlere ulaşabilir. Yalnızca uç noktanız bu iş yükünü kaldırabiliyorsa bu olaya abone olun.