# Webhook'lar

> AI CodeOps etkinliklerini Slack, Discord, Teams veya kendi HTTPS uç noktanıza gönderin, imzalı payload'ları doğrulayın ve bir değişiklik merge edildiğinde dağıtım pipeline'ınızı çağırın.

Kaynak: https://aicodeops.dev/tr/docs/webhooks · Son güncelleme: 2026-10-18

AI CodeOps webhook'ları dışarı gönderir; içeri almaz. Şunları yapabilirsiniz:

- **bildirim uç noktaları** ile çalışma alanı etkinliklerini sohbete veya kendi uç noktanıza göndermek;
- **dağıtım webhook'ları** ile bir AI CodeOps pull request'i merge edildiğinde dağıtım pipeline'ınızı çağırmak.

## Gelen Git webhook'u yok

Oturumlar repolarınıza webhook kaydetmez. AI CodeOps GitHub, GitLab, Bitbucket, Gitea ve Forgejo ile bağladığınız hesap üzerinden çalışır ve bir pull request'in durumunu Git platformunuza sorarak kontrol eder. Eklediği tek webhook, **Build & Test → Builds** altında bağladığınız bir repoya eklenir; böylece bir push veya pull request bir build başlatabilir. Kendi yönettiğiniz bir Git sunucusu da oturumlar için gelen webhook gerektirmez, ancak AI CodeOps ona ulaşabilmelidir: herkese açık https adresini kullanın (özel bir ağdaki sunucu yalnızca operatör onu izin listesine alırsa çalışır). Bkz. [GitHub'ı bağlama](https://aicodeops.dev/tr/docs/git/github) ve diğer Git kılavuzları.

## Bildirim uç noktaları

### Bir uç nokta ekleyin

1. **Configure → Settings** sayfasını açın ve **Notification endpoints** bölümünü bulun.
2. **Add endpoint** düğmesini seçin.
3. Şunları doldurun:
   - **Name**: örneğin "Nöbetçi Slack kanalı".
   - **Kind**: Slack, Discord, MS Teams veya Generic webhook.
   - **Target URL**: sohbet aracınızdaki incoming-webhook URL'si veya kendi uç noktanız.
   - **Min severity**: info (all), low+, medium+, high+ veya critical only.
   - **Events to send**: istediğiniz etkinlikleri işaretleyin. Hiçbiri işaretli değilse tüm etkinlikler gönderilir.
   - **Signing secret** (yalnızca Generic webhook): en az 8 karakter.
4. **Create endpoint** düğmesini seçin.

Owner, Admin ve DevOps Admin rolleri uç noktaları yönetebilir. Bkz. [Roller ve izinler](https://aicodeops.dev/tr/docs/roles-and-permissions).

Hedef URL herkese açık bir HTTPS adresi olmalıdır. `localhost`, özel ağlar veya bulut metadata adreslerine yapılan teslimatlar reddedilir ve yönlendirmeler izlenmez.

### Etkinlikler

| Etkinlik           | Tür                        | Ne zaman                                                               |
| ------------------ | -------------------------- | ---------------------------------------------------------------------- |
| Deploy failed      | `deployment.failed`        | Bir dağıtım başarısız oldu                                             |
| Deploy succeeded   | `deployment.completed`     | Bir dağıtım başarılı oldu                                              |
| Deploy recorded    | `deployment.recorded`      | Herhangi bir durumdaki her dağıtım kaydı                               |
| Incidents & policy | `policy_decision.recorded` | Bir olay (incident) açılır veya değişir ya da bir politika karar verir |
| Approval requested | `approval.requested`       | Bir talep karar bekliyor                                               |
| Approval decided   | `approval.decided`         | Bir talep onaylandı veya reddedildi                                    |
| Run completed      | `workflow_run.completed`   | Bir oturum bitti                                                       |
| New finding        | `agent_finding.created`    | Bir inceleme bir bulgu kaydetti                                        |
| Schedule failed    | `schedule.failed`          | Zamanlanmış bir iş akışı çalışamadı                                    |

Hiçbir etkinlik işaretli değilken uç nokta oturum ve ajan adımı ilerleme güncellemelerini de alır.

**Min severity** yalnızca bulgular, olaylar (incident) ve başarısız zamanlamalar gibi bir önem derecesi taşıyan etkinlikleri filtreler. Önem derecesi taşımayan etkinlikler her zaman gönderilir.

### Payload'lar

Slack ve Microsoft Teams `{"text": "<summary>"}` alır. Discord `{"content": "<summary>"}` alır. Özet tek satırdır; örneğin:

```text
Deploy prj_01JA2B3C4D5E6F7G8H9J0K1M2R → production @ 3f9c2a1b: failed — The deploy webhook answered HTTP 502.
```

Bir **Generic webhook**, özeti ve etkinliği `Content-Type: application/json` ile JSON olarak alır:

```json
{
  "summary": "Deploy prj_01JA2B3C4D5E6F7G8H9J0K1M2R → production @ 3f9c2a1b: failed — The deploy webhook answered HTTP 502.",
  "event": {
    "kind": "deployment.failed",
    "workspaceID": "wrk_01JA2B3C4D5E6F7G8H9J0K1M2N",
    "entityID": "dep_01JA2B3C4D5E6F7G8H9J0K1M2P",
    "workflowRunID": "wfr_01JA2B3C4D5E6F7G8H9J0K1M2Q",
    "status": "failed",
    "emittedAt": "2026-10-18T09:00:00.000Z",
    "metadata": {
      "projectID": "prj_01JA2B3C4D5E6F7G8H9J0K1M2R",
      "environment": "production",
      "sequence": 3,
      "commitSHA": "3f9c2a1b7d4e5f60718293a4b5c6d7e8f9012345",
      "strategy": "rolling",
      "errorSummary": "The deploy webhook answered HTTP 502."
    }
  }
}
```

Her etkinlikte `kind`, `workspaceID`, `entityID` ve `emittedAt` bulunur. `workflowRunID`, `status` ve `metadata` geçerli olduklarında görünür. Etkinlik hafiftir: ayrıntılara ihtiyacınız varsa konsoldan alın.

### İmzayı doğrulayın

Signing secret'ı olan bir Generic webhook iki başlık gönderir:

```http
X-CodeOps-Signature: sha256=<hex HMAC-SHA256 of the raw body, keyed with your secret>
X-CodeOps-Event: deployment.failed
```

Doğrulamak için ham istek gövdesinin HMAC-SHA256 değerini secret'ınızla hesaplayın ve başlıkla sabit zamanlı olarak karşılaştırın. Örneğin Node.js'te:

```js
import { createHmac, timingSafeEqual } from "node:crypto"

function verify(rawBody, header, secret) {
  const expected = "sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex")
  return header.length === expected.length && timingSafeEqual(Buffer.from(header), Buffer.from(expected))
}
```

Gövde baytlarını, JSON'u ayrıştırmadan önce, tam olarak alındıkları hâliyle kullanın. İmzada zaman damgası yoktur; bu yüzden yinelenenleri elemek için `kind`, `entityID` ve `emittedAt` alanlarını birlikte kullanın; bir teslimat yeniden denendiğinde `emittedAt` aynı kalır.

### Test, yeniden denemeler ve teslimat günlüğü

Her uç noktada **Test**, **Deliveries**, **Disable** ve **Delete** bulunur.

- **Test**, uç noktanın filtreleri ne olursa olsun hemen örnek bir etkinlik gönderir.
- **Deliveries**, her denemeyi durumu, etkinlik türü, HTTP durum kodu, deneme numarası, gecikmesi ve ayrıntısıyla gösterir. Teslimat geçmişi 30 gün saklanır.
- Bir teslimat 8 saniye sonra zaman aşımına uğrar. Ağ hataları, zaman aşımları ve HTTP 408, 425, 429, 500, 502, 503 ve 504 yanıtları 30 saniye, 2 dakika ve 8 dakika sonra yeniden denenir. Diğer hatalar yeniden denenmez.
- Art arda 10 başarısız teslimattan sonra uç nokta devre dışı bırakılır. Sorunu giderin ve **Enable** düğmesini seçin.

Henüz bir düzenleme formu yoktur: bir uç noktayı değiştirmek için onu silip yeniden ekleyin.

## Dağıtım webhook'ları

Bir dağıtım webhook'u, bir AI CodeOps pull request'i konsoldan merge edildiğinde pipeline'ınızı çağırır.

1. **Release → Deployments** sayfasını açın ve **Deploy targets** düğmesini seçin.
2. Her proje için bir **Deploy webhook URL**, bir **Environment** ve isteğe bağlı bir **Signing secret** girin.
3. Kaydedin.

Merge sırasında AI CodeOps şunu gönderir:

```json
{
  "event": "pr_merged",
  "workspaceID": "wrk_01JA2B3C4D5E6F7G8H9J0K1M2N",
  "projectID": "prj_01JA2B3C4D5E6F7G8H9J0K1M2R",
  "repo": "acme/api",
  "prNumber": 42,
  "prUrl": "https://github.com/acme/api/pull/42"
}
```

Bir signing secret varsa, yukarıdakiyle aynı şekilde hesaplanan `X-CodeOps-Signature: sha256=…` başlığını ekler. URL herkese açık HTTPS olmalıdır. Bir [çalışma alanı politikası](https://aicodeops.dev/tr/docs/policy-engine) `release.deploy` kuralı, bir ortama otomatik dağıtımları engelleyebilir.

## Sonraki adımlar

- [API](https://aicodeops.dev/tr/docs/api)
- [Politika kuralları referansı](https://aicodeops.dev/tr/docs/policy-engine)
- [Onaylar ve politikalar](https://aicodeops.dev/tr/docs/approvals-and-policies)

## Sık sorulan sorular

### Git repoma bir webhook eklemem gerekiyor mu?

Oturumlar için hayır; oturumlar Git platformunuzla bağlantınızın token'ı üzerinden iletişim kurar. Yalnızca Build & Test → Builds altında bağladığınız bir repo webhook alır ve onu sizin için AI CodeOps ekler; böylece bir push veya pull request bir build başlatabilir.

### Bildirim payload'ları imzalanır mı?

Signing secret'ı olan Generic webhook'lar X-CodeOps-Signature başlığında HMAC-SHA256 ile imzalanır. Slack, Discord ve Teams mesajları imzalanmaz.

### Uç noktam çalışmıyorsa ne olur?

Başarısız teslimatlar 30 saniye, 2 dakika ve 8 dakika sonra yeniden denenir. Art arda 10 başarısızlıktan sonra uç nokta devre dışı bırakılır.
