Webhook uç noktasıyla veri alın
İki webhook yönünü birbirinden ayırın, Ayarlar bölümünden bir yakalama adresi üretin ve başka bir sistemden gelen veriyle otomasyon başlatın.
Mailsoftly’de webhook kelimesi birbirinin tam tersi iki işi anlatır ve ikisini karıştırmak yarım gününüzü alır. Giden yön, otomasyonda bir şey olduğu anda Mailsoftly’nin sizin adresinize istek göndermesidir. Gelen yön ise tersidir: Mailsoftly size bir adres verir, siz başka bir sistemi bu adrese yönlendirirsiniz ve o sistemin gönderdiği veri burada bir otomasyonu başlatır.
Bu rehber giden yöne kısaca değinir, gelen yönü ise baştan sona anlatır: uç noktasını oluşturmak, yakalama adresini kopyalamak, otomasyona bağlamak ve gerçek kişiler işin içine girmeden test etmek.
Hangi yöne ihtiyacınız olduğunu bilin
Herhangi bir otomasyonu açıp bir adım ekleyin. Adım listesinde Entegrasyon başlığı altında Webhook Gönder eylemini görürsünüz. Giden yön budur: kendi belirlediğiniz bir Webhook URL, isterseniz ad ve değer çiftleri hâlinde ekleyebileceğiniz Başlıklar ve her satıra bir ad verip karşısına bir kişi alanı seçtiğiniz bir Veri bölümü alır. Her çalışmada bu düz JSON nesnesi adresinize gönderilir. Başka bir sistemin Mailsoftly’den haber alması gerektiğinde bu eylemi kullanın.
Gelen yön bambaşka bir ekrandır ve rehberin geri kalanı onu anlatır. Trafik ters yönde aktığında, yani mağazanızın, form aracınızın ya da kendi uygulamanızın söyleyecek bir şeyi olduğunda ve Mailsoftly’nin buna göre hareket etmesini istediğinizde bu yönü kullanırsınız.
Giden eylemin ayrıntıları Entegrasyonları ve API’yi bağlayın rehberinde, çevresine otomasyon kurmanın yolu ise Karşılama otomasyonu kurun rehberindedir. İki yön de işinizi görmüyorsa ve veriyi kendi programınıza göre kendiniz istemek istiyorsanız, aradığınız şey REST API’dir: Mailsoftly API’sini kullanın.
Bir uç noktası oluşturun
Ayarlar’a gidin, sol menüde Gelişmiş başlığını açın ve Webhook’lar sayfasına geçin. Sayfanın adı Webhook Uç Noktaları’dır ve hesabınızdaki bütün uç noktalarını listeler. Daha önce hiç oluşturmadıysanız burası boştur.
Yeni Webhook Uç Noktası Oluştur düğmesine basın. Karşınıza olay gönderebileceğiniz yeni bir adres üretileceğini söyleyen bir onay penceresi çıkar. Onayladığınız anda uç noktası listenin en üstünde belirir.
- Bu sayfayı ekipteki herkes açabilir ve uç noktası oluşturabilir. Yalnızca yöneticilere açık değildir.
- İlk uç noktanızdan sonra sayfayı bir kez yenileyin. Yeni satır, boş durum panelinin yerine geçmek yerine onun üstüne ekleniyor; sayfayı yenilemek ekranı toparlar.
Oluşturma adımı bu kadar. Şimdilik ayarlanacak bir şey yok.
Yakalama adresini kopyalayın ve uç noktasına ad verin
Her satırda dört şey vardır: ad, Oluşturulma Zamanı, Toplam İstek sayacı ve yakalama adresinin kendisi. Adres, https://app.mailsoftly.com/catch/ ile başlar ve ardından uzun, rastgele bir dizi gelir. Elle yazmak yerine yanındaki kopyalama düğmesini kullanın.
Yeni uç noktalarına "Endpoint -" ve bir zaman damgasından oluşan bir ad verilir; bu ad bir hafta sonra size hiçbir şey anlatmaz. Adın üstüne tıklayıp yerinde düzenleyin ve ne işe yarıyorsa onu yazın, örneğin Mağaza siparişleri.
- İstekleri POST ile gönderin. İçerik-Type başlığını application/json yaparsanız gövde doğrudan JSON olarak okunur; istediğiniz de budur. Form verisi olarak gönderilen istekler de çalışır ve alanları aynı şekilde okunur.
- Toplam İstek, uç noktasının yakaladığı her isteği sayar. Bir şeyin ulaşıp ulaşmadığını ilk buradan anlarsınız.
Yakalama adresindeki rastgele dizi, uç noktasını koruyan tek şeydir. İmza anahtarı ya da ikinci bir doğrulama yoktur; adresi eline geçiren herkes oraya istek gönderebilir. Adresi bir parola gibi saklayın, herkese açık kod depolarına ve tarayıcıda çalışan koda koymayın, yalnızca ihtiyacı olan sisteme verin.
Uç noktasını bir otomasyona bağlayın
Uç noktası tek başına yalnızca gelen veriyi saklar. Bir iş yapması için başlatmasını istediğiniz otomasyonu açın, akışın en üstündeki tetikleyici kartına tıklayın ve Entegrasyon başlığındaki tetikleyiciyi seçin: "Bir Webhook Endpoint üzerinden veri alındığında otomasyonu başlat."
Ardından Dinlenecek Bir Webhook Uç Noktası Seçin alanından uç noktanızı seçin. Listedeki her seçeneğin yanında bir nokta vardır; böylece hangi uç noktasına veri geldiğini, hangisine gelmediğini bir bakışta görürsünüz.
- Webhook ile tetiklenen bir otomasyonun ilk adımı Kişi Bul veya Oluştur olmak zorundadır. Aksi hâlde Mailsoftly akışı etkinleştirmenize izin vermez, çünkü sonraki adımların üzerinde işlem yapacağı bir kişi olmaz.
- Bu adımın içinde, gelen verinin hangi alanında e-posta adresinin bulunduğunu seçin. Kişiyi belirleyen alan budur: Mailsoftly bu adrese sahip bir kişi varsa onu eşler, yoksa bu adresle yeni bir kişi oluşturur. Gelen veride e-posta bulunamazsa hiçbir şey çalışmaz.
- Webhook tetikleyicisini seçmek adım listesinde Kişi Verisi (Webhook) başlığını da açar; Kişi Bul veya Oluştur ile Kişiyi Güncelle adımları oradadır. Bu iki adım diğer tetikleyici türlerinde görünmez.
- Aynı uç noktasını dinleyen birden fazla aktif otomasyonunuz varsa istek geldiğinde hepsi birden çalışır ve aynı kişi her birinden mail alabilir. Bir uç noktasına tek bir aktif otomasyon bağlamak en temizi.
Alanları eşleştirebilmeniz için uç noktasının en az bir istek yakalamış olması gerekir; çünkü seçebileceğiniz alan listesi, uç noktasına ulaşan son veriden üretilir. Önce 5. adımı yapın, sonra buraya dönüp eşleştirmeyi tamamlayın.
Otomasyonlarınızı Mailsoftly’de açın
Yayına almadan önce bir test isteği gönderin
Uç noktası seçiminin yanında Webhook Uç Noktasını Test Et yazan küçük bir simge var. Bu simge, işin tamamını adım adım gösteren bir panel açar: yakalama adresini kopyalama düğmesiyle birlikte gösterir, işlemek istediğiniz veriyi JSON formatında uygulamanızdan veya Postman gibi bir araçtan göndermenizi söyler ve sonra ne geldiğini raporlar.
Örnek isteğinizi gönderip Veriyi kontrol et düğmesine basın. İstek ulaştığında "İstek alındı!" yazısını ve Bulunan alanlar listesini görürsünüz; bu liste, eşleştirme adımında seçeceğiniz alan yollarının tam olarak aynısıdır. O ana kadar panel "İlk isteğiniz bekleniyor" durumunda kalır.
- Test ederken otomasyonu Taslak durumunda bırakın. Yalnızca aktif otomasyonlar kişileri akışa alır, dolayısıyla taslak bir akış yanlışlıkla gerçek birine mail gönderemez.
- Alanlar doğru göründüğünde e-posta alanını eşleştirin, otomasyonu Etkinleştir ile yayına alın ve gerçek bir kişinin akışa girdiğini görmek için bir istek daha gönderin.
Eşleştirme için yalnızca en son gelen veri saklanır. Bu yüzden gerçek trafiğinizi en iyi temsil eden isteği en sona bırakın. Test isteklerinizden birinde canlı verinizde bulunmayacak bir alan varsa, eşleştirmeden önce gerçekçi bir istek daha gönderin.
Bir kez bile istek yakalamış uç noktası artık silinemez ve silmeyi denediğinizde çıkan hata bunun nedenini söylemez. Bu yüzden denemelerinizi silmeyi düşündüğünüz geçici bir uç noktasında değil, gerçekten kullanacağınız uç noktasında yapın.
Bu sayfanın birkaç yazısı Türkçe kaydedilmemiş durumda ve arayüzde İngilizce görünüyor: yeni uç noktası oluştururken çıkan onay penceresinin başlığı ve metni, çöp kutusu simgesinin ipucu ve silme onayı. Düğmeler Türkçe kalır. Adımları buradaki sıraya göre uygularsanız bu yazılar sizi yanıltmaz.
Kendi hesabınızda denemeye hazır mısınız?
Google Workspace veya Microsoft 365 hesabınızla ücretsiz başlayın. Kredi kartı gerekmez.
