Webhooks

Güncelleme: Ekim 2026

Webhook, bağlantının en yalın biçimidir: belirlediğin bir adrese gönderilen bir HTTP iletisi. Slack, Discord ve Microsoft Teams böyle iletileri doğrudan kanal gönderisi olarak kabul eder; kendi sistemlerin ise bununla ne isterlerse yapabilir.

Tipik kullanımlar: Destek adresi yeni talepleri ekip kanalına bildirir. Sipariş onayı stok yönetim sistemini tetikler. Bir müşterinin sunucu uyarısı Discord’da görünür.

Uç nokta kurma

1. Ayarlar → Entegrasyonlar → Webhooks bölümünü aç ve Webhook’ları etkinleştir seçeneğini aç.
2. Uç nokta ekle seçeneğini seç ve bir Ad ile URL gir.
3. Yük ön ayarı altında Slack, Discord, Microsoft Teams ya da Generic JSON seç. Ön ayar, Yük şablonu (JSON) alanını uygun bir temel iskeletle doldurur; onu dilediğin gibi uyarlayabilirsin.
4. Test et, örnek verilerle bir deneme iletisi gönderir. Slack ve benzerlerinde onu hemen kanalda görürsün.

URL’yi ilgili hizmetten alırsın:

• Slack: api.slack.com/apps altında Incoming Webhooks içeren bir uygulama oluştur; üretilen URL uç noktadır.
• Discord: Kanal Ayarları → Entegrasyonlar → Webhooks.
• Teams: Kanalda, Workflows uygulaması üzerinden bir webhook isteği alındığında gönderi yayımlama şablonuyla.
• Kendi sistemlerin: JSON’u HTTP POST ya da PUT ile kabul eden her adres.

Birden çok uç nokta mümkündür, her biri ayrı ayrı kapatılabilir: Destek kanalı ve kendi betiğin yan yana var olabilir.

Kural ile tetikleme

Gönderim yalnızca otomasyon üzerinden yapılır: bir kuraldaki Webhook gönder eylemi, hedef olarak seçtiğin uç nokta ile.

Tam olarak neyin gönderileceği uç noktanın yük şablonunda yazar. Oraya, gönderim sırasında tetikleyen e-postanın verileriyle doldurulan, çift süslü parantez içindeki değişkenleri yerleştirirsin: {{subject}}, {{from}}, {{from_name}}, {{to}}, {{cc}}, {{date}}, {{preview}} (metnin başı), {{tags}}, {{mailbox}}, {{account_id}} ve {{rule_name}}. Şablonun altındaki Değişken referansı her birini açıklar. Destek kanalı için bir Slack bildirimi örneğin şöyle görünür:

{ "text": "{{from_name}} kişisinden yeni talep: {{subject}}" }

Kendi sunucuların için

• İmza: Bir HMAC anahtarı (isteğe bağlı) girersen her istek, içeriğin HMAC-SHA256 imzasını taşıyan X-YouniqMail-Signature: sha256=… başlığını içerir. Sunucun bununla iletinin senden geldiğini doğrular.
• Yinelemeler: Sunucu hatalarında (5xx) ve ağ sorunlarında YouniqMail 1, 2 ve 4 saniyelik aralarla üç kereye kadar yeniden dener. Reddetmeler (4xx) yinelenmez. Zaman aşımını her uç nokta için ayrı ayarlarsın, en fazla 30 saniye.
• Yöntem: POST varsayılandır, PUT yalnızca uç noktan bunu istiyorsa. Yönlendirmeler izlenmez.

Bilmekte fayda var

• İleti, belirttiğin uç noktaya gider. URL’yi dikkatle denetle, çünkü onu bilen herkes kanala yazabilir. Webhook URL’lerine parola gibi davran.
• İçeriği sen belirlersin: Şablonda ne yazıyorsa o aktarılır. Yalnızca konu ve göndereni yerleştiren, yalnızca onları paylaşır.
• Pro özelliği: Webhooks Pro kapsamına aittir.