# Webhook kurma ve sorun giderme

> Gönderi verilerinin anlık olarak kendi sisteminize iletilmesi için Geliver webhook tanımlama, eklenti bağlantılarında webhook kontrolü ve eksik bilgi sorunlarının çözümü.

Kaynak: https://geliver.io/help/webhook-kurma · Kategori: Geliştirici Araçları · Son güncelleme: 2026-10-31

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.

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

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

4. Kaydedilir.

**İlgili panel sayfası:** [Webhooklar](https://app.geliver.io/webhooks)

#### 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.

2. **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.

2. 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](https://app.geliver.io/supporttickets) oluşturabilirsiniz.
Talebe webhook adresinizin ve alınan yanıt kodunun eklenmesi süreci
hızlandırır.