# Webhook'lar (https://yapl.app/tr/docs/user-guides/webhooks)

# Webhook'lar

Webhook'lar, çalışma alanınızda bir şey değiştiğinde YAPL'ın harici servislere anlık bildirim göndermesini sağlar. Bir proje oluşturulduğunda, bir görev güncellendiğinde veya bir ekip üyesi eklendiğinde, YAPL Slack, Discord, Zapier, Make, n8n veya kendi özel servisleriniz gibi araçları anında bilgilendirebilir.

## Webhook'lar Nasıl Çalışır

Çalışma alanınızda bir olay gerçekleştiğinde YAPL:

1. Hangi webhook uç noktalarının o olay türü için yapılandırıldığını kontrol eder
2. Olay detaylarını içeren bir JSON yükü oluşturur
3. Eşleşen her uç noktaya bir HTTP POST isteği gönderir
4. Teslimat sonucunu (başarılı veya başarısız) kaydeder
5. Başarısız teslimatları otomatik olarak yeniden dener

## Webhook'larla Neler Yapabilirsiniz

- **Slack/Discord bildirimleri** — Proje durumu değiştiğinde ekip kanalınızda mesaj alın
- **Otomasyon platformları** — YAPL olaylarından Zapier, Make veya n8n iş akışları tetikleyin
- **Özel panolar** — Proje güncellemelerini dahili araçlarınıza aktarın
- **Denetim kayıtları** — Olay verilerini harici kayıt servislerine gönderin
- **E-posta uyarıları** — SendGrid veya Mailgun gibi servisler üzerinden e-posta bildirimleri tetikleyin

## Kullanılabilirlik

Webhook'lar **Professional** ve **Deneme** planlarında kullanılabilir. Her çalışma alanı en fazla **10 webhook uç noktasına** sahip olabilir.

| Plan | Webhook'lar |
|------|-------------|
| Deneme | 10 uç noktaya kadar |
| Basic | Kullanılamaz |
| Professional | 10 uç noktaya kadar |

Basic planındaysanız, mevcut webhook'ları görüntüleyebilir ve silebilirsiniz ancak yeni oluşturamaz veya mevcutları düzenleyemezsiniz. Webhook'ları etkinleştirmek için [planınızı yükseltin](/docs/user-guides/billing/upgrading-plan).

## Bu Bölümde

### Kurulum
- **[Webhook Oluşturma](/docs/user-guides/webhooks/creating-webhooks)** — Webhook uç noktaları oluşturun ve yapılandırın

### Referans
- **[Olay Türleri](/docs/user-guides/webhooks/event-types)** — Webhook teslimatlarını tetikleyebilecek tüm olaylar

### İzleme
- **[Teslimat Kayıtları](/docs/user-guides/webhooks/delivery-logs)** — Teslimat durumunu takip edin ve sorunları giderin

### Güvenlik
- **[İmza Doğrulama](/docs/user-guides/webhooks/verifying-signatures)** — Teslimatların YAPL'dan geldiğini doğrulayın

## Hızlı Referans

| Görev | Konum |
|-------|-------|
| Webhook oluştur | Ayarlar > Webhook'lar > Webhook Oluştur |
| Webhook düzenle | Ayarlar > Webhook'lar > [Uç Nokta] > Düzenle |
| Webhook sil | Ayarlar > Webhook'lar > [Uç Nokta] > Sil |
| Webhook test et | Ayarlar > Webhook'lar > [Uç Nokta] > Test |
| Teslimat kayıtlarını gör | Ayarlar > Webhook'lar > [Uç Nokta] > Teslimatlar |

## Webhook Yükü Formatı

Her webhook teslimatı şu yapıda bir JSON yükü gönderir:

```json
{
  "id": "evt_abc123",
  "type": "project.created.v1",
  "timestamp": "2026-03-25T10:30:00.000Z",
  "workspaceId": "ws_xyz789",
  "data": {
    "projectId": "proj_456",
    "projectName": "Ofis Renovasyonu",
    "status": "planning"
  }
}
```

| Alan | Açıklama |
|------|----------|
| `id` | Benzersiz olay tanımlayıcısı |
| `type` | Olay türü (bkz. [Olay Türleri](/docs/user-guides/webhooks/event-types)) |
| `timestamp` | Olayın gerçekleştiği zaman (ISO 8601) |
| `workspaceId` | Çalışma alanı tanımlayıcınız |
| `data` | Olaya özgü detaylar |

## Güvenlik

Her teslimat, `X-YAPL-Signature-256` başlığında bir HMAC-SHA256 imzası içerir. Alıcı servisiniz, isteğin YAPL'dan geldiğini doğrulamak için bu imzayı kontrol etmelidir. Uygulama detayları için [İmza Doğrulama](/docs/user-guides/webhooks/verifying-signatures) sayfasına bakın.

Hassas bilgiler (şifreler, tokenlar, API anahtarları) teslimat öncesinde yüklerden otomatik olarak çıkarılır.

## Yeniden Deneme Politikası

Bir teslimat başarısız olursa (ağ hatası veya 2xx olmayan yanıt), YAPL otomatik olarak yeniden dener:

| Deneme | Gecikme |
|--------|---------|
| 1. yeniden deneme | 30 saniye |
| 2. yeniden deneme | 2 dakika |
| 3. yeniden deneme | 10 dakika |
| 4. yeniden deneme | 1 saat |
| 5. yeniden deneme | 6 saat |

5 başarısız denemeden sonra teslimat başarısız olarak işaretlenir. Tüm teslimat denemelerini [Teslimat Kayıtları](/docs/user-guides/webhooks/delivery-logs)'nda görüntüleyebilirsiniz.

## İlgili Konular

- [Abonelik Planları](/docs/user-guides/billing/subscription-plans) — Plan karşılaştırması ve özellik kullanılabilirliği
- [Plan Yükseltme](/docs/user-guides/billing/upgrading-plan) — Yükselterek webhook'ları etkinleştirin
- [Çalışma Alanı Ayarları](/docs/user-guides/workspaces/workspace-settings) — Diğer çalışma alanı yapılandırması