Web Kancaları

Web Kancaları Entegrasyonu

Web Kancaları, Supsis Ai panelinde gerçekleşen belirli olayların anlık olarak harici sistemlerinize (CRM, ERP veya özel veritabanları) HTTP istekleri aracılığıyla iletilmesini sağlar. Bu entegrasyon sayesinde iş akışlarınızı otomatikleştirerek veri aktarımını gerçek zamanlı hale getirebilirsiniz.

1-) Entegrasyon İşlemleri

Webhook kanalınızı oluşturmak ve yapılandırmak için aşağıdaki adımları takip edin:

1.a – Webhook Kanalı Oluşturma

a – Entegrasyonlara Erişim
Supsis Ai panelinizin sol menüsünde yer alan Entegrasyonlar simgesine tıklayarak entegrasyonlar menüsüne giriş yapınız.
b – Web Kancaları
Entegrasyon listesi içerisinde, "Web" kategorisi altında bulunan Web Kancaları kartını bulun ve üzerine tıklayın.

c – Webhook Ekle
Açılan listede, yeni bir kanal tanımlamak için mavi renkli "+ Webhook Ekle" butonuna basın. Bu işlem sizi Webhook yapılandırma ekranına yönlendirecektir.

1.b – Webhook İçeriği
Yeni Webhook ekranında, verinin gönderileceği hedef sistemi tanımlayan teknik detayları doldurmanız gerekmektedir.

a – Webhook Adı
Webhook kanalınızı panelinizde tanımanızı sağlayan isimdir.
b – Webhook URL
Verinin (Payload) gönderileceği hedef sunucu (HTTP) adresidir. Seçenekler alanından belirlenen olay gerçekleştiğinde bu HTTP URL’sine olayın detayları iletilir.
c – Webhook Token (Zorunlu Değil)
İsteklerin güvenliğini sağlamak için kullanılan özel anahtardır. Bu alan zorunlu değildir, isteklerin güvenliğini arttırmak için opsiyonel olarak ekleyebilirsiniz.
d – Basic Auth (Zorunlu Değil)
Hedef sistem kullanıcı adı ve şifre doğrulaması gerektiriyorsa ilgili bilgiler buraya girilir.
e – Headers (Zorunlu Değil)
HTTP isteğine eklenecek özel başlık (Key-Value) bilgileridir. Bu seçeneğin içeriğinin doldurulması zorunlu değildir opsiyonel olarak doldurabilirsiniz.
f – Webhook Tetikleyicileri
Webhook ekranının alt kısmında yer alan Seçenekler bölümünden, hangi olaylar gerçekleştiğinde harici sisteminize veri gönderileceğini belirleyebilirsiniz.
Sohbet Durumları: Chat kapandığında veya puanlandığında.
Ticket İşlemleri: Yeni bir destek bileti oluşturulduğunda veya güncellendiğinde.
Kullanıcı Yönetimi: Yeni kullanıcı oluşturulması, güncellenmesi veya silinmesi durumunda.
Mesajlaşma: Gelen/giden mesajlar ve mesaj güncellemeleri anında iletilir.
Temsilci Durumu: Temsilcinin çevrimiçi/çevrimdışı olma durumu değiştiğinde.

1.c – Webhook Güvenliği, Yetkilendirme ve Veri İzolasyonu

Webhook uç noktaları, işletmenizin CRM, ERP veya özel veritabanı sistemlerine ait hedef bağlantı adreslerini, kimlik doğrulama anahtarlarını ve veri aktarım kurallarını barındırır. Bu nedenle Supsis, webhook yapılandırmalarının korunması için sıkı bir güvenlik, yetkilendirme ve veri izolasyonu mimarisi uygular.

Güvenlik Alanı	Kapsam ve Koruma Mekanizması	Uygulanan Standart
Zorunlu Kimlik Doğrulama (Authentication)	Webhook listeleme, ekleme, güncelleme ve silme (`GET`, `POST`, `PUT`, `DELETE`) işlemlerinin tümünde geçerli bir oturum doğrulaması (`getAuthorize`) zorunludur.	Anonim veya kimlik doğrulaması bulunmayan harici istekler derhal reddedilir (`401 Unauthorized` / `403 Forbidden`). Yalnızca `site-id` bilgisiyle listeye ulaşılamaz.
Hedef Uç Nokta İzolasyonu	İşletmenizin 3. parti entegrasyon URL'leri ve webhook hedefleri kamuya açık (public) ağlardan tamamen gizlenir.	Harici tarayıcılar, yetkisiz botlar veya 3. şahıslar sistem uç noktalarını ve izleme hedeflerini internetten keşfedemez.
Hassas Veri Maskeleme	Webhook isteklerinde tanımlanan doğrulama anahtarları (Verification Token), Basic Auth kullanıcı/şifreleri ve özel Header bilgileri.	Hassas kimlik ve sır alanları arayüz ve liste yanıtlarında güvenlik gereği maskelenerek korunur.

Webhook Güvenlik Standartları ve En İyi Uygulamalar

Tam Oturum İzolasyonu: Webhook servisleri kamuya açık bir API yüzeyi barındırmaz. Müşterinin API anahtarı veya yetkili kullanıcı oturumu olmaksızın hiçbir webhook kaydı sorgulanamaz.
Tetikleyici Uç Güvenliği (Token Kullanımı): Dış sunucunuza iletilen HTTP isteklerinin yalnızca Supsis altyapısından geldiğini doğrulamak için webhook yapılandırmasında opsiyonel Webhook Token veya özel bir Header anahtarı tanımlamanız önerilir.
Rol ve Yetki Denetimi: Webhook oluşturma, düzenleme veya silme işlemleri yalnızca panelde yetkilendirilmiş yönetici rolleri tarafından gerçekleştirilebilir.

Uç Nokta ve Veri İzolasyonu Garantisi

Supsis, webhook hedeflerinizi ve entegrasyon yapılandırmalarınızı işletmenize özel güvenli bir katmanda saklar. Kamuya açık web servislerinden veya kimlik doğrulaması bulunmayan harici istemcilerden webhook URL'lerine ve konfigürasyon detaylarına erişim kesinlikle engellenmiştir.