# Olay Türleri (https://yapl.app/tr/docs/user-guides/webhooks/event-types)

# Webhook Olay Türleri

YAPL projeler, ekipler, planlar ve çalışma alanları genelindeki olaylar için webhook bildirimleri gönderebilir. Bu sayfa, her kullanılabilir olay türünü ne zaman tetiklendiğine dair bir açıklama ile listeler.

## Olay Türü Formatı

Olay türleri `alan.eylem.sürüm` kalıbını izler:

```
project.created.v1
│       │       │
│       │       └── Sürüm (gelecek uyumluluk için)
│       └────────── Ne oldu
└────────────────── Hangi alan
```

## Proje Olayları

Projeler oluşturulduğunda, güncellendiğinde veya durum değiştirdiğinde tetiklenir.

| Olay Türü | Açıklama |
|------------|----------|
| `project.created.v1` | Yeni bir proje oluşturuldu |
| `project.updated.v1` | Bir projenin detayları değiştirildi (ad, açıklama, tarihler, bütçe) |
| `project.deleted.v1` | Bir proje kalıcı olarak silindi |
| `project.archived.v1` | Bir proje arşive taşındı |
| `project.restored.v1` | Arşivlenmiş bir proje aktif duruma geri yüklendi |
| `project.statusChanged.v1` | Bir projenin durumu değişti (örn. Planlama'dan Aktif'e, Aktif'ten Beklemede'ye) |

## Ekip Olayları

Ekipler veya ekip üyeliği değiştiğinde tetiklenir.

| Olay Türü | Açıklama |
|------------|----------|
| `team.created.v1` | Yeni bir ekip oluşturuldu |
| `team.updated.v1` | Bir ekibin detayları değiştirildi (ad, açıklama) |
| `team.deleted.v1` | Bir ekip silindi |
| `team.member-added.v1` | Bir ekibe üye eklendi |
| `team.member-removed.v1` | Bir ekipten üye çıkarıldı |
| `team.member-role-changed.v1` | Bir ekip üyesinin rolü değiştirildi (örn. Üye'den Lider'e) |

## Plan Olayları

Planlar (projeler içindeki zamanlama dokümanları) değiştirildiğinde tetiklenir.

| Olay Türü | Açıklama |
|------------|----------|
| `plan.created.v1` | Yeni bir plan oluşturuldu |
| `plan.published.v1` | Bir plan yayınlandı (ekibe görünür hale getirildi) |
| `plan.archived.v1` | Bir plan arşivlendi |
| `plan.restored.v1` | Arşivlenmiş bir plan geri yüklendi |
| `plan.deleted.v1` | Bir plan kalıcı olarak silindi |
| `plan.task.added.v1` | Bir plana yeni bir görev eklendi |
| `plan.task.updated.v1` | Bir plan içindeki görev güncellendi |
| `plan.task.deleted.v1` | Bir plandan görev çıkarıldı |

## Çalışma Alanı Olayları

Çalışma alanı düzeyinde ayarlar değiştiğinde tetiklenir.

| Olay Türü | Açıklama |
|------------|----------|
| `workspace.updated.v1` | Çalışma alanı ayarları değiştirildi (ad, açıklama, yapılandırma) |

## Olay Yükü Örnekleri

### Proje Oluşturuldu

```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",
    "teamId": "team_321",
    "teamName": "Operasyon",
    "actorName": "Ahmet Yılmaz"
  }
}
```

### Ekibe Üye Eklendi

```json
{
  "id": "evt_def456",
  "type": "team.member-added.v1",
  "timestamp": "2026-03-25T11:00:00.000Z",
  "workspaceId": "ws_xyz789",
  "data": {
    "teamId": "team_321",
    "teamName": "Mühendislik",
    "memberId": "user_890",
    "memberName": "Ayşe Demir",
    "role": "member",
    "actorName": "Ahmet Yılmaz"
  }
}
```

### Görev Güncellendi

```json
{
  "id": "evt_ghi789",
  "type": "plan.task.updated.v1",
  "timestamp": "2026-03-25T14:15:00.000Z",
  "workspaceId": "ws_xyz789",
  "data": {
    "planId": "plan_555",
    "planName": "Q2 Programı",
    "taskId": "task_777",
    "taskName": "Temel Çalışması",
    "actorName": "Ayşe Demir"
  }
}
```

## Olayları Filtreleme

Bir webhook uç noktası oluştururken veya düzenlerken hangi olay türlerini alacağını seçebilirsiniz:

- **Tüm olaylar** — Her şeyi almak için olay türlerini boş bırakın (varsayılan)
- **Belirli olaylar** — Yalnızca entegrasyonunuzla ilgili olayları seçin

Örneğin, proje güncellemeleri için bir Slack kanalı yalnızca `project.created.v1`, `project.statusChanged.v1` ve `project.archived.v1` olaylarına abone olabilir.

## Veri Hassasiyeti

YAPL, teslimat öncesinde webhook yüklerinden hassas alanları otomatik olarak çıkarır. Aşağıdaki alanlar asla dahil edilmez:

- Şifreler ve şifre hash'leri
- Erişim tokenları ve yenileme tokenları
- API anahtarları ve sırlar
- Oturum tanımlayıcıları
- IP adresleri ve kullanıcı ajanları

## İlgili Konular

- [Webhook Oluşturma](/docs/user-guides/webhooks/creating-webhooks) — Uç noktaları oluşturun
- [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