Slack

Slack entegrasyonu bir bildirim adaptörüdür. Moonborn bir webhook olayı yayar; adaptör onu Slack Block Kit mesajı olarak biçimlendirir, yapılandırılan kanala gönderir.

Eğik çizgi komutu (slash command), etkileşimli bileşen veya bot kullanımı yok — v1 kapsamı dışıdır. Bugün Slack bir bildirim hedefidir.

Bu sayfayı bitirdiğinde

• Slack gelen-webhook URL'ini Moonborn'a 5 dakikada bağlayabileceksin.
• format: 'slack' bayrağının neyi otomatikleştirdiğini bileceksin.
• Kanal yönlendirme desenlerini (cx-quality, brand-voice, engineering-alerts, billing) çalışma alanına uygulayabileceksin.
• Slack-alıcısı olmanın sınırlarını (okuma yok, slash komutu yok) netleştireceksin.

Ön koşul: Team plan, Slack çalışma alanında kanala webhook ekleme yetkisi.

Kurulum — 2 adım

1. Slack'te gelen-webhook (incoming webhook) yarat

Slack çalışma alanında:

Apps → Browse → Incoming Webhooks → Add to Slack
→ Kanal seç (örn. #cx-quality)
→ "Allow"

Sana şuna benzer bir URL verir:

https://hooks.slack.com/services/T01ABC.../B02XYZ.../shortToken123

2. Moonborn webhook'unu o URL'e abone et

const hook = await client.webhooks.create({
  url: 'https://hooks.slack.com/services/T01ABC.../B02XYZ.../shortToken123',
  events: ['persona.audit_failed', 'persona.test_suite_failed'],
  description: '#cx-quality — ses + denetim uyarıları',
  format: 'slack',  // Slack Block Kit serileştirici
});

format: 'slack' bayrağı (Team ve üzeri) — Moonborn olayını ham JSON zarfı yerine Slack Block Kit mesajı olarak serileştirir. Biçimlendirilmiş mesajda:

• Olay tipi başlık (uyarılar için ember renk, hatalar için ruby renk)
• Persona adı ve link (Moonborn arayüzünde persona detayına gider)
• Drift / denetim skoru (varsa)
• Hızlı eylem düğmesi — "Open in Moonborn"

Bayrak olmadan Slack ham JSON alır — bunu ayrıştırmak için Slack'in "Workflow Builder" ya da özel bot lazım. format: 'slack' pratikte zorunludur.

Kanal yönlendirme desenleri

Çalışma alanın nasıl yapılandırılır:

Kanal başına bir webhook, yetki kapsamlı olay listesi. Slack tarafında filtrelemekten daha kolay sessize alınır — gereksiz kanal trafiği yaratmaz.

Drift önem derecesi → kanal ayrımı

// Düşük önem → #cx-quality
await client.webhooks.create({
  url: 'https://hooks.slack.com/.../cx-quality',
  events: ['persona.audit_failed'],
  format: 'slack',
  filter: { severity: ['low', 'medium'] }, // Enterprise
});
 
// Yüksek önem → #engineering-oncall (PagerDuty entegre)
await client.webhooks.create({
  url: 'https://hooks.slack.com/.../oncall',
  events: ['persona.audit_failed'],
  format: 'slack',
  filter: { severity: ['high', 'critical'] }, // Enterprise
});

Önem derecesi filtrelemesi Enterprise özelliğidir. Team planında çift webhook + Slack tarafı yönlendirme daha temizdir.

Plan gereksinimi

Dürüst kapsam

İlgili