# Webhook Oluşturma (https://yapl.app/tr/docs/user-guides/webhooks/creating-webhooks)

# Webhook Oluşturma

Bu kılavuz, YAPL çalışma alanınızdan anlık bildirimler almak için bir webhook uç noktası oluşturma sürecinde size yol gösterir.

## Ön Koşullar

- **Çalışma alanı sahibi** olmanız gerekir
- Çalışma alanınız **Professional** veya **Deneme** planında olmalıdır
- Webhook teslimatlarını alacak servisin URL'sine ihtiyacınız vardır

## İlk Webhook'unuzu Oluşturma

1. **Ayarlar > Webhook'lar** sayfasına gidin
2. **Webhook Oluştur** düğmesine tıklayın
3. Uç nokta detaylarını doldurun:
   - **Ad** — Açıklayıcı bir ad (örn. "Slack Proje Güncellemeleri")
   - **URL** — Teslimatları alacak HTTPS uç noktası
   - **Açıklama** — Bu webhook'un ne yaptığına dair isteğe bağlı notlar
4. **Kaydet** düğmesine tıklayın
5. **İmzalama sırrını kopyalayın** — Bu yalnızca bir kez gösterilir ve imzaları doğrulamak için gereklidir

### Önemli: Sırrınızı Kaydedin

Bir webhook oluşturduğunuzda YAPL benzersiz bir imzalama sırrı üretir. Bu sır, oluşturma işleminden hemen sonra **yalnızca bir kez** görüntülenir. Güvenli bir şekilde kopyalayın ve saklayın — [webhook imzalarını doğrulamak](/docs/user-guides/webhooks/verifying-signatures) için buna ihtiyacınız olacak.

Sırrınızı kaybederseniz, webhook'u silip yenisini oluşturmanız gerekir.

## Uç Nokta URL Gereksinimleri

- Geçerli bir HTTPS URL'si olmalıdır (HTTP yalnızca geliştirme ortamlarında izin verilir)
- İnternetten herkese açık erişimli olmalıdır
- 10 saniye içinde yanıt vermelidir
- Özel IP adresleri ve dahili ağlar güvenlik nedeniyle engellenmiştir

## Olay Türlerini Yapılandırma

Varsayılan olarak yeni bir webhook **tüm olayları** alır. Hangi olayların teslimat tetikleyeceğini sınırlamak için:

1. Webhook'un düzenleme diyaloğunu açın
2. Almak istediğiniz belirli olay türlerini seçin
3. Değişikliklerinizi kaydedin

Örneğin, yalnızca proje bildirimlerini istiyorsanız, proje olaylarını seçin ve diğerlerini işaretlenmemiş bırakın. Tam liste için [Olay Türleri](/docs/user-guides/webhooks/event-types) sayfasına bakın.

## Özel Başlıklar

YAPL'ın her teslimatla birlikte göndereceği özel HTTP başlıkları ekleyebilirsiniz. Bu şu durumlar için faydalıdır:

- **Kimlik doğrulama** — Alıcı servisiniz için bir `Authorization` başlığı ekleyin
- **Yönlendirme** — Altyapınız içinde teslimatları yönlendirmek için özel başlıklar ekleyin
- **Tanımlama** — YAPL teslimatlarını diğer kaynaklardan ayırt etmek için başlıklar ekleyin

Özel başlık eklemek için:

1. Webhook Oluştur veya Düzenle diyaloğunu açın
2. **Başlık Ekle** düğmesine tıklayın
3. Başlık adı ve değerini girin
4. Gerektiğinde daha fazla başlık ekleyin

## Webhook Düzenleme

1. **Ayarlar > Webhook'lar** sayfasına gidin
2. Listede uç noktayı bulun
3. Menü simgesine tıklayın ve **Düzenle** seçin
4. Değişikliklerinizi yapın
5. **Kaydet** düğmesine tıklayın

Adı, URL'yi, açıklamayı, olay türlerini, özel başlıkları ve aktif durumunu güncelleyebilirsiniz. İmzalama sırrı değiştirilemez — yeni bir sırra ihtiyacınız varsa yeni bir webhook oluşturun.

## Etkinleştirme ve Devre Dışı Bırakma

Webhook'u silmeden teslimatları geçici olarak durdurmak için:

1. Webhook'u düzenleyin
2. **Aktif** anahtarını kapatın
3. Kaydedin

Devre dışı bırakılan webhook'lar listenizde kalır ancak teslimat almaz. Devam ettirmek için anahtarı tekrar açın.

## Webhook Test Etme

Önemli bildirimler için bir webhook'a güvenmeden önce test edin:

1. **Ayarlar > Webhook'lar** sayfasına gidin
2. Uç noktadaki menü simgesine tıklayın
3. **Test** seçin
4. YAPL uç noktanıza bir test yükü gönderir
5. Sonucu kontrol edin — detaylarla birlikte başarı veya başarısızlık

Test teslimatı örnek bir yük kullanır ve [teslimat kayıtlarında](/docs/user-guides/webhooks/delivery-logs) kaydedilir.

## Webhook Silme

1. **Ayarlar > Webhook'lar** sayfasına gidin
2. Uç noktadaki menü simgesine tıklayın
3. **Sil** seçin
4. Silme işlemini onaylayın

Webhook silme kalıcıdır. O uç noktaya ait tüm teslimat kayıtları da kaldırılır. Webhook'a tekrar ihtiyacınız olabilecekse, silmek yerine devre dışı bırakmayı düşünün.

## Uç Nokta Limitleri

Her çalışma alanı en fazla **10 webhook uç noktasına** sahip olabilir. Bu limit hem aktif hem de devre dışı uç noktaları içerir.

Daha fazla uç noktaya ihtiyacınız varsa, birleştirmeyi düşünün — tüm olayları alan tek bir uç nokta oluşturup kendi servisiniz içinde yönlendirebilirsiniz.

## Yaygın Yapılandırmalar

### Slack Gelen Webhook

1. Slack'te bir [Gelen Webhook](https://api.slack.com/messaging/webhooks) oluşturun
2. Webhook URL'sini kopyalayın
3. Bu URL ile bir YAPL webhook'u oluşturun
4. Slack kanalınıza gönderilmesini istediğiniz olayları seçin

### Discord Webhook

1. Discord'da Kanal Ayarları > Entegrasyonlar > Webhook'lar bölümüne gidin
2. Yeni bir webhook oluşturun ve URL'yi kopyalayın
3. Discord webhook URL'sine `/slack` ekleyin (Discord, Slack uyumlu formatı destekler)
4. Bu URL ile bir YAPL webhook'u oluşturun

### Zapier / Make / n8n

1. **Webhook** tetikleyicisi ile yeni bir Zap, Senaryo veya İş Akışı oluşturun
2. Otomasyon platformunun sağladığı webhook URL'sini kopyalayın
3. Bu URL ile bir YAPL webhook'u oluşturun
4. Gelen olay verilerini kullanarak otomasyonunuzu oluşturun

## Sorun Giderme

### Webhook teslimat almıyor

- Uç noktanın **Aktif** olduğundan emin olun (devre dışı değil)
- URL'nin herkese açık erişimli olduğunu kontrol edin
- Sunucunuzun 10 saniye içinde yanıt verdiğinden emin olun
- Hata detayları için [teslimat kayıtlarını](/docs/user-guides/webhooks/delivery-logs) inceleyin

### "URL'ye izin verilmiyor" hatası

- YAPL özel IP adreslerini engeller (10.x.x.x, 192.168.x.x, vb.)
- YAPL localhost ve metadata uç noktalarını engeller
- Herkese açık erişimli bir URL kullanın

### Sır kayboldu

- Sırlar oluşturma sırasında yalnızca bir kez gösterilir
- Webhook'u silip yenisini oluşturun
- Alıcı servisinizi yeni sırla güncelleyin

## İlgili Konular

- [Olay Türleri](/docs/user-guides/webhooks/event-types) — Teslimatları tetikleyen olaylar
- [Teslimat Kayıtları](/docs/user-guides/webhooks/delivery-logs) — Teslimat durumunu izleyin
- [İmza Doğrulama](/docs/user-guides/webhooks/verifying-signatures) — Uç noktanızı güvence altına alın