Webhook kurma ve sorun giderme

Webhook, gönderilerle ilgili veri güncellemelerinin anlık olarak kendi sisteminize iletilmesini sağlar. Durum değiştiğinde sorgulama beklenmeden bildirim gönderilir.

Webhook tanımlama

1. Sol menüdeki Ayarlar bölümü açılır.

1. Geliştirici Araçları grubundaki Webhooklar kartı seçilir.

1. Yeni webhook eklenir ve verinin gönderileceği URL girilir.

1. Kaydedilir.

İlgili panel sayfası: Webhooklar

Uç noktanın karşılaması gerekenler

Önemli. Webhook zaman aşımı 15 saniyedir. İsteğe 15 saniye içinde yanıt dönülmezse istek başarısız sayılır ve kuyruktan yeniden denenir.

Şu iki kuralın uygulanması hem gereksiz tekrarları hem mükerrer işlemleri engeller:

1. Ağır iş istek içinde yapılmamalıdır. Gelen veri kaydedilip hemen 200 dönülmesi, e-posta gönderme, SMS ve PDF üretme gibi işlerin arka plana alınması önerilir. Yavaş bir SMTP sunucusu tek başına zaman aşımına yol açabilmektedir.

1. Mükerrer isteklere hazır olunmalıdır. Başarısız bir webhook yeniden denendiğinde aynı güncelleme ikinci kez ulaşır. Her güncellemenin gönderi kimliği ve durum çiftiyle tekilleştirilmesi, aynı güncelleme tekrar geldiğinde durum değişikliğinin ve müşteri bildiriminin yeniden tetiklenmemesini sağlar.

Mağaza eklentisi kullanılıyorsa

Mağaza entegrasyonları webhook üzerinden çalışmaktadır. Panelde veya eklentide eksik bilgi görülüyorsa sorun genellikle webhook kaynaklıdır.

1. Ayarlar > Geliştirici Araçları > Webhooklar bölümü açılır.

1. Mağazaya ait webhook kaydının görünüp görünmediğine bakılır:

• Görünmüyorsa: mağaza bağlantısı kesilip tekrar kurulur. Bağlantı yenilendiğinde webhook yeniden oluşturulur.

• Görünüyor ancak sorun sürüyorsa: detaylarıyla birlikte bize yazılabilir.

Hangi durumlarda bildirim gelir?

Gönderinin yaşam döngüsündeki durum değişiklikleri iletilir: etiket satın alma, takip kodu oluşması, kargoya verilme ve teslim gibi. Mağaza entegrasyonlarında bu veriler ayrıca mağazadaki siparişe de yazılır.

Sorun yaşanması durumunda

• Hiç istek gelmiyor — Olası neden: Webhook kaydı yok ya da URL hatalı

• İstekler geliyor ancak tekrarlıyor — Olası neden: Uç nokta 15 saniye içinde yanıt dönmüyor. Bu durum request timeout hatasına neden olmaktadır.

• Aynı bildirim iki kez işlendi — Olası neden: Tekilleştirme yapılmıyor ve webhook'a 200 dönmemiş olabilir.

• Mağazadaki sipariş güncellenmiyor — Olası neden: Mağaza bağlantısı kopmuş olabilir

• HTTPS hatası — Olası neden: Sertifikanın geçerli olması gerekmektedir

Bilgi. Uzun süre veri akmayan mağaza bağlantıları otomatik olarak koparılmaktadır. "Bağlıydı, kendiliğinden koptu" durumunun en sık nedeni budur; bağlantının yeniden kurulması yeterlidir.

İlgili makaleler

• Geliver API token nasıl oluşturulur?

• Mağaza bağlanmıyor veya siparişler düşmüyor

• Geliver WooCommerce ve kargo takip eklentisi

\---

Bu makalede yanıtını bulamadığınız bir konu olursa panelinizden destek talebi oluşturabilirsiniz. Talebe webhook adresinizin ve alınan yanıt kodunun eklenmesi süreci hızlandırır.