Panelden adım adım
| Alan | Ne girilir |
|---|---|
| Ad | Tanımanızı sağlayan açıklama; boşsa tarih saatli bir ad atanır |
| Durum | Etkin, Duraklatıldı ya da Devre dışı |
| Konu | Olay türü, ör. Sipariş güncellendi |
| Eylem olayı | Konu “Eylem” seçilirse tetikleyecek WordPress eylemi |
| Teslim adresi | Bildirimin gönderileceği HTTP ya da HTTPS adres |
| Gizli anahtar | İmza üretmekte kullanılan değer |
Kaydet düğmesine bastığınızda webhook oluşur. Belgeye göre webhook ilk kez Etkin durumla kaydedildiğinde WooCommerce teslim adresine bir deneme (ping) isteği gönderir.
Gizli anahtarı boş bırakmayın. Boş kalırsa WooCommerce varsayılan bir değer üretir; belgeler bu değeri farklı tarif ediyor ve alıcı taraf imzayı doğrulayamayabilir. Karşı sistemin size verdiği anahtarı elle yazın.
Çekirdek konular
| Kaynak | Konular |
|---|---|
| Siparişler | order.created, order.updated, order.deleted |
| Ürünler | product.created, product.updated, product.deleted |
| Müşteriler | customer.created, customer.updated, customer.deleted |
| Kuponlar | coupon.created, coupon.updated, coupon.deleted |
| Özel | action.EYLEM_ADI, ör. action.woocommerce_add_to_cart |
Etkin eklentilere göre listede başka konular da görünebilir. Stok ve sipariş senkronu için en çok order.created, order.updated ve product.updated kullanılır.
API ile webhook yönetimi
- Oluşturma: POST /webhooks; topic ve delivery_url zorunlu, name, status ve secret isteğe bağlı
- Listeleme: GET /webhooks; status ile all, active, paused ya da disabled süzülür
- Güncelleme: PUT /webhooks/ID; devre dışı kalan webhook burada yeniden etkinleştirilir
- Silme: DELETE /webhooks/ID; kalıcı silmek için force=true
- Toplu işlem: POST /webhooks/batch, varsayılan 100 nesne
Webhook nesnesinde resource, event ve hooks alanları salt okunurdur; konudan türetilir. secret alanı yalnız yazılır, yanıtta geri dönmez.
Teslim ve otomatik devre dışı kalma
Belgeye göre teslimat varsayılan olarak arka planda, WordPress’in zamanlanmış görev sistemi wp-cron ile yapılır. Gövde JSON’dur ve ürün, sipariş gibi kaynaklarda REST API yanıtıyla aynıdır.
| Kural | Satıcı belgesi | Geliştirici belgesi |
|---|---|---|
| Hata sayılan yanıt | 2xx, 301 ve 302 dışındaki her yanıt | 2xx dışındaki yanıt |
| Devre dışı kalma | Art arda beşten fazla hata | Art arda 5 hata |
| Yeniden açma | Webhook’u düzenleyip etkinleştirmek | REST API ile düzenlemek |
Eşik woocommerce_max_webhook_delivery_failures filtresiyle değiştirilebilir. Teslim kayıtları WooCommerce > Durum > Günlükler altında webhooks-delivery kaynağında durur; her kayıtta istek, yanıt kodu ve süre bulunur.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| Webhook kendiliğinden Devre dışı oldu | Alıcı art arda hata döndürdü | Alıcıyı düzeltip webhook’u yeniden etkinleştirin |
| Alıcı 401 veriyor | Gizli anahtar alıcıdakiyle aynı değil | Anahtarı yeniden kopyalayın |
| Bildirim hiç gitmiyor | Güvenlik duvarı ya da eklenti giden isteği engelliyor | Günlüklerde yanıtı kontrol edin |
| Eski webhook’lar çalışmıyor | Legacy REST API’ye bağlılar | Legacy API eklentisini kurun ya da v3 ile yeniden oluşturun |
Sık sorulanlar
WooCommerce webhook nasıl kurulur?
WooCommerce > Ayarlar > Gelişmiş > Webhook’lar ekranında “Webhook ekle” ile konu, teslim adresi ve gizli anahtarı girip durumu Etkin yaparak kaydedersiniz.
Stok senkronu için hangi webhook konuları gerekir?
Genellikle order.created, order.updated ve product.updated. Silinen ürünleri izlemek için product.deleted de eklenebilir.
Webhook neden Devre dışı oldu?
Alıcı adres art arda hata döndürünce WooCommerce webhook’u kapatır. Alıcıyı düzeltip webhook’u yeniden etkinleştirmeniz gerekir.
Webhook teslim kayıtlarını nerede görürüm?
WooCommerce > Durum > Günlükler altında webhooks-delivery kaynağını seçin. Her kayıtta istek, yanıt ve süre bulunur.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı