- Ana sayfa
- Dokümantasyon
- Webhook'lar
Webhook'lar
Son güncelleme
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.
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 ve diğer Git kılavuzları.
Bildirim uç noktaları
Bir uç nokta ekleyin
- Configure → Settings sayfasını açın ve Notification endpoints bölümünü bulun.
- Add endpoint düğmesini seçin.
- Ş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.
- Create endpoint düğmesini seçin.
Owner, Admin ve DevOps Admin rolleri uç noktaları yönetebilir. Bkz. Roller ve izinler.
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:
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:
{
"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:
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:
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.
- Release → Deployments sayfasını açın ve Deploy targets düğmesini seçin.
- Her proje için bir Deploy webhook URL, bir Environment ve isteğe bağlı bir Signing secret girin.
- Kaydedin.
Merge sırasında AI CodeOps şunu gönderir:
{
"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ı release.deploy kuralı, bir ortama otomatik dağıtımları engelleyebilir.
Sonraki adımlar
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.