Webhook'lar

Karar ve vaka hareketlerini kendi sisteminize itmek için webhook kullanırsınız. Uç noktayı Settings → Webhooks altında tanımlarsınız.

Olay tipleri

Olay	Ne zaman
`decision.created`	Bir karar üretildi
`case.created_from_workflow`	İş akışı kuralı bir vaka açtı
`case.created_manually`	Bir vaka elle açıldı
`case.updated`	Vakanın durumu, sonucu ya da ataması değişti
`case.decisions_updated`	Vakaya karar eklendi ya da çıkarıldı
`case.decision_reviewed`	Bir karar incelenip sonuca bağlandı
`case.comment_created`	Vakaya not eklendi
`case.file_created`	Vakaya dosya eklendi
`case.tags_updated`	Vakanın etiketleri değişti
`case.assigned`	Bir vaka birine verildi — otomatik ya da elle
`case.escalated`	Bir vaka yanıt süresini aştı
`decision.review_required`	Onay dışında bir sonuç çıktı: birinin bakması gerekiyor

İnsanı uyaran üç olay

Son üç olay, bir sisteme veri taşımak için değil, kuyruğu çalıştıran kişiyi uyarmak için vardır. Slack, Teams, e-posta ve SMS bağlantıları da bu olaylardan beslenir: Settings → Integrations. case.assigned, case.updated’dan ayrıdır. Plakasına iş düştüğünde haber almak isteyen bir analist, bunu öğrenmek için her vakanın her düzenlemesine abone olmak zorunda kalmamalıdır — her şeyi alan kanal susturulur, ve o andan sonra hiçbir şey duyulmaz. decision.review_required de decision.created’dan ayrıdır: kararların ezici çoğunluğu onaydır, ve hepsini alan bir kanal okunmayan kanaldır.

decision.review_required, isteğin with_decision_webhooks alanına bakmaz. O alan çağıranın kendi webhook’ları içindir; bir çağıran, payload’ından bir alan çıkararak uyum ekibinin alarmını susturamamalıdır.

Eskalasyon süpürmesi ihlali kaydeder ve bu olayı üretir — ama hâlâ yeniden atama ya da yönlendirme yapmaz. Haber vermek, kimin devralacağına karar vermek değildir.

İmza doğrulama

Krino, Standard Webhooks biçimini kullanır. Her istek üç başlık taşır:

Başlık	İçerik
`webhook-id`	İsteğin tekil kimliği
`webhook-timestamp`	Unix zaman damgası (saniye)
`webhook-signature`	`v1,<base64 HMAC-SHA256>`

İmzalanan dizge şudur:

{webhook-id}.{webhook-timestamp}.{ham gövde}

Ham gövdeyi imzalayın — JSON’u ayrıştırıp yeniden diziyeleştirirseniz imza tutmaz. Çoğu çatıda gövdeyi ham okumak için ayrı bir ayar gerekir.

Node.js örneği

import crypto from 'node:crypto';

function verify(headers, rawBody, secret) {
  const id = headers['webhook-id'];
  const ts = headers['webhook-timestamp'];
  const sig = headers['webhook-signature'];

  // Eski bir isteğin tekrar oynatılmasını engelle.
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;

  const expected = crypto
    .createHmac('sha256', Buffer.from(secret, 'base64'))
    .update(`${id}.${ts}.${rawBody}`)
    .digest('base64');

  // Sabit zamanlı karşılaştırma: normal eşitlik sızıntı yapar.
  return sig
    .split(' ')
    .some(part => crypto.timingSafeEqual(
      Buffer.from(part.replace(/^v1,/, '')),
      Buffer.from(expected),
    ));
}

Uç noktanızdan beklenenler

Hızlı yanıt verin

2xx döndürün ve işi kuyruğa alın. Uzun süren işleri istek içinde yapmayın.

Tekrarları tolere edin

Aynı olay birden çok kez gelebilir. webhook-id değerini saklayıp daha önce gördüğünüz kimlikleri yok sayın.

Sıralamaya güvenmeyin

Olaylar üretildikleri sırada varmayabilir. Kararı gövdedeki zaman damgasına göre verin, geliş sırasına göre değil.

Yeniden deneme

Uç noktanız 2xx dışında bir şey dönerse ya da zaman aşımına uğrarsa Krino artan aralıklarla yeniden dener. Kalıcı olarak başarısız olan uç noktalar Settings → Webhooks ekranında görünür.

Başlangıç

Platform

Kararlar

Veri ve olaylar

Sinyaller ve tarama

Yapay zeka

Kendi sunucunuzda

Olay tipleri

İnsanı uyaran üç olay

İmza doğrulama

Node.js örneği

Uç noktanızdan beklenenler

Yeniden deneme

​Olay tipleri

​İnsanı uyaran üç olay

​İmza doğrulama

​Node.js örneği

​Uç noktanızdan beklenenler

​Yeniden deneme

Olay tipleri

İnsanı uyaran üç olay

İmza doğrulama

Node.js örneği

Uç noktanızdan beklenenler

Yeniden deneme