Webhook Entegrasyonu: ERP ve İzleme Sistemlerinizi Kurumsal Mesajlaşmaya Bağlayın

Bir sunucunun diski dolduğunda, üretim hattı durduğunda ya da ERP'de bir fatura onay beklediğinde, ilgili ekibin bunu hemen öğrenmesi gerekir. Bu bildirimler çoğu zaman kimsenin bakmadığı e-posta kutularına gider. Webhook entegrasyonu, sistemlerinizin bu olayları doğrudan ekibin konuştuğu kanala yazmasını sağlar.

SyncMessage'da entegrasyon için üç araç vardır: gelen webhook, API anahtarı ve giden webhook. Bu rehberde her birinin ne işe yaradığını ve güvenli kullanım için nelere dikkat etmeniz gerektiğini anlatıyoruz.

Gelen webhook: Sistemleriniz kanala yazsın

Kanal Ayarları'ndaki Entegrasyonlar bölümünden ya da Yönetici Paneli'nden yeni bir gelen webhook oluşturursunuz. Webhook'a bir ad (ör. “Sunucu İzleme”) ve simge verirsiniz; mesajlar kanalda bu kimlikle ve “Uygulama” rozetiyle görünür. Size gösterilen adresi dış sisteme girersiniz. Dış sistem bu adrese başlık, metin, alanlar, bağlantı ve seviye (bilgi, uyarı, hata, başarı) içeren bir JSON gönderir.

• Kart masaüstünde, telefonda, aramada ve bildirimlerde aynı kimlikle görünür.
• Mesaj kanalın erişim kuralına uyar: kısıtlı kanaldaysa yalnız üyeler görür.
• Ekip karta yanıt verebilir, konu açabilir, tepki bırakabilir, sabitleyebilir.
• Gövde webhook'un adını ya da simgesini değiştiremez; bir webhook başka bir kişi gibi görünemez.

API anahtarı: Kapsamı sınırlı erişim

Dış bir sistemin yalnız mesaj göndermesi değil, kanalları listelemesi ya da mesaj okuması gerekiyorsa API anahtarı kullanılır. Anahtarı oluştururken kapsamları (mesaj gönder, mesajları oku, kanalları listele, kullanıcıları listele, departmanları listele), geçerli olacağı kanalları ve geçerlilik süresini seçersiniz.

• Anahtar yalnız oluşturulduktan hemen sonra bir kez gösterilir; sunucu yalnız karmasını saklar.
• Anahtar yönetim uçlarına, kullanıcı oturumuyla çalışan uçlara ve dosyalara erişemez.
• Her çağrı yöntem, yol, sonuç ve IP ile çağrı günlüğüne yazılır.
• Kullanılmayan ya da sızdığından şüphelenilen anahtar İptal et ile hemen geçersiz kılınır.

Giden webhook: SyncMessage olaylarını dışarı iletin

Giden webhook ile SyncMessage'daki olaylar kendi sistemlerinize iletilir. Kanala mesaj düşmesi, kullanıcı ya da kanal oluşturulması, duyuru yayınlanması ve bir talebin sonuçlanması (onay akışlarında son onay ya da ret) bu olaylar arasındadır. Örneğin onaylanan bir izin talebini İK sisteminize otomatik aktarabilirsiniz; onay akışlarının ayrıntıları için onay akışı yazısına bakabilirsiniz.

• Her istek bir imza anahtarıyla imzalanır; alıcı sistem imzayı doğrulamalıdır.
• Alıcı 10 saniye içinde başarılı yanıt vermezse teslim 24 saat boyunca artan aralıklarla yeniden denenir.
• Teslim günlüğünde her teslimin durumu, deneme sayısı ve yanıt kodu görünür; başarısız teslim yeniden gönderilebilir.
• Birebir mesajlar ve uygulama mesajları hiçbir zaman dışarı gönderilmez.
• İç ağ adreslerine gönderim, yönetici açıkça izin vermedikçe engellidir.

Adım adım: İlk gelen webhook'u kurmak

Teoride kolay görünen entegrasyonlar pratikte küçük ayrıntılarda takılır. Aşağıdaki sıra, bir izleme sisteminin uyarılarını kanala taşımak için çoğu kurumda yarım saatten kısa süren bir yol izler.

1. Uyarıların düşeceği kanalı belirleyin. Mümkünse yalnız ilgili ekibin üye olduğu, erişimi kısıtlı bir kanal seçin.
2. Kanalın dişlisinden Kanal Ayarları'nı açın, Entegrasyonlar'da yeni webhook oluşturun; ad ve simgeyi ekibin tanıyacağı şekilde seçin.
3. Gösterilen adresi kopyalayıp izleme sistemindeki bildirim ayarına girin. Adres bir daha gösterilmeyeceği için güvenli bir yerde not edin.
4. Aynı ekrandaki Deneme mesajı gönder ile bağlantıyı sınayın; kart kanalda görünmelidir.
5. İzleme sisteminde uyarı seviyelerini kartın seviyeleriyle eşleştirin: bilgi, uyarı, hata ve başarı.
6. Bir hafta sonra Yönetici Paneli'ndeki çağrı günlüğüne bakın; reddedilen istek varsa nedenini görürsünüz.

Sık karşılaşılan yanıtlar ve çözümleri

Giden webhook tarafında en sık sorun, alıcı adresin iç ağda olmasıdır. Güvenlik gereği iç ağ adreslerine gönderim varsayılan olarak engellidir; hedef gerçekten iç ağdaysa yönetici bu izni bilerek açar ve işlem kayda geçer.

Örnek senaryolar

Yetki, kayıt ve KVKK

Entegrasyonları yönetme izni dış sistemlerin kanallara yazmasına ya da kanal içeriğinin dışarı akmasına yol açabildiği için hazır profillerden yalnız yöneticide bulunur. Bütün oluşturma, değiştirme, silme ve iptal işlemleri işlem loglarına yazılır.

Uygulama mesajları kanal mesajı sayılır ve kanal saklama süresine tabidir. Giden webhook teslim günlüğü 30 gün, gelen webhook ve API çağrı günlüğü 90 gün saklanır. Giden webhook'la aktarılan veri için alıcı sistemin de kurumunuzun veri işleme envanterine dahil edilmesi gerekir.

Kanal tabanlı entegrasyon alışkanlığından gelen ekipler için Slack alternatifi yazısı da faydalı olabilir.