Telegram'da yönlendirme için webhook yapılandırma

Webhook'lar, belirli olaylar gerçekleştiğinde siteler ve uygulamalar arasında otomatik veri gönderilmesini sağlayan bir mekanizmadır. Veriler HTTP isteğiyle aktarılır: bir uygulama, verileri internet üzerinden diğer uygulamanın önceden belirtilmiş adresine gönderir.

Webhook'ların sunduğu olanaklar

FLOWIN'de webhook'lar yönlendirmelerle birlikte çalışır. Kaynak sohbette (kaynakta) bir mesaj oluşturulduğunda, düzenlendiğinde, silindiğinde veya sabitlendiğinde ya da mesajların yönlendirildiği sohbette (hedefte) bir düğmeye tıklandığında tetiklenebilirler.

Böylece FLOWIN'i sosyal ağlara, borsalara, elektronik tablolara ve CRM'lere (müşteri ilişkilerini yönetmeye yönelik sistemlere) bağlayabilirsiniz. Bu bağlantıya entegrasyon denir ve şunları yapmanızı sağlar:

• Telegram'daki talepleri otomatik olarak CRM'ye eklemek.
• Telegram'daki alım satım sinyallerini otomatik takip için, yani bu sinyallere göre otomatik işlem yapılması amacıyla bir borsaya aktarmak.
• Telegram'daki mesajları diğer sosyal ağlara yönlendirmek.
• Gönderileri ve mesajları Google E-Tablolar'a kopyalamak.
• Botta bir otomatik yanıtlayıcı ayarlamak.

Her senaryo için site veya uygulama tarafında verilerin alınmasını ve istenen işlemin yapılmasını yapılandırmak gerekir.

Webhook oluşturma

Webhook'u, veri almak için bir adres sağlayan ve alınan istekleri gösteren webhook.site sitesinde test edelim. Buraya Telegram'daki yeni bir mesajın metnini göndereceğiz.

Bunun için FLOWIN'de yapılandırılmış ve çalışan bir yönlendirme gerekir.

0. @flow_in_bot’u açın, /start komutunu gönderin ve “Kontrol paneli” düğmesine tıklayın.

   

1. Ayrı bir sekmede webhook.site sitesini açın. “Your unique URL” alanındaki, istekleri almak için verilen adresi kopyalayın.

   

2. FLOWIN panelinde “Menü” → “Webhook'lar” bölümünü açın ve “Oluştur” düğmesine tıklayın.

   

   

3. Kopyaladığınız adresi üstteki alana yapıştırın. “İstek gövdesi” alanına {"message":"<message-text>"} yazın ve “Oluştur” düğmesine tıklayın. Bu, gönderilecek verilerin şablonudur: FLOWIN, <message-text> yerine mesajın metnini yerleştirir; alıcı ise bu metni message alanında görür.

   

4. Oluşturduğunuz webhook'ta “Uygula” düğmesine tıklayın. İstediğiniz yönlendirmeyi işaretleyin ve “Kaydet” düğmesine tıklayın.

   

   

5. Kaynak sohbete örneğin “Talep №1042: mobilya kataloğu istiyorum.” gibi bir test mesajı gönderin. webhook.site'a dönün: alınan ilk istek otomatik olarak açılır. “Request Content” bloğunda talebin metni message alanında görünür. Artık FLOWIN, her yeni mesajın metnini hedef sohbete yönlendirmeden önce belirtilen adrese otomatik olarak gönderecektir.

   

   

Webhook ayarları

Oluşturduğumuz webhook üzerinden ayarları inceleyelim: bunların nasıl değiştirildiğine ve her alanın ne anlama geldiğine bakalım.

Webhook ayarları nasıl değiştirilir?

1. “Webhook'lar” listesinde istediğiniz webhook'un “Değiştir” düğmesine tıklayın.

   

2. İstediğiniz alanları değiştirin ve “Kaydet” düğmesine tıklayın.

   

   

HTTP yöntemi

HTTP yöntemi, isteğin yapacağı işlemi belirler: POST verileri işlenmek üzere gönderir, GET veri talep eder, PUT ise verileri yenileriyle değiştirir. Varsayılan olarak testimize uygun olan POST seçilidir. Başka bir site veya uygulama için onun belgelerinde belirtilen yöntemi seçin.

URL adresi

URL, internetteki adres anlamına gelir. Buraya, bağlanacak site veya uygulamadan alınan veri alma adresi yazılır. Örneğimizde bu adresi webhook.site sağladı.

İstek gövdesi

İstek gövdesi, gönderilecek verileri JSON biçiminde, “alan adı: değer” çiftleri olarak içerir. Hangi alanların bulunacağı, bağlanacak site veya uygulamanın gereksinimlerine bağlıdır.

Meta etiketleri, FLOWIN'in mesaj verileriyle değiştirdiği yer tutuculardır. Örneğin, <message-text> metinle, <author-name> ise gönderenin adıyla değiştirilir. Meta etiketlerinin listesi, alanın altındaki “meta etiketleri” bağlantısına tıklanarak da açılır.

İstek başlıkları

“İstek başlıkları”, alıcı için teknik bilgiler içerir. Örneğin, bir erişim anahtarı isteği kimin gönderdiğini doğrulamayı sağlar. Başlıklar JSON biçiminde belirtilir. Genellikle bu alanı değiştirmek gerekmez; gerekli değerler, bağlanacak site veya uygulamanın belgelerinden alınır.

İstek tetikleyicisi

“İstek tetikleyicisi”, webhook'un belirtilen adrese hangi olayda ve ne zaman istek göndereceğini belirler. Olay olarak şunlar seçilebilir:

• “Gönderme” varsayılan olarak seçilidir. Webhook, yeni bir mesaj yönlendirilirken tetiklenir.
• “Düzenleme”, kaynaktaki bir mesaj değişikliği işlenirken tetiklenir.
• “Sabitleme”, kaynaktaki bir mesajın sabitlenmesi işlenirken tetiklenir.
• “Silme”, kaynaktaki bir mesajın silinmesi işlenirken tetiklenir.
• “Düğme tıklaması”, hedef sohbetteki geri çağırma (callback) düğmeleri için tetiklenir. Böyle bir düğme, tıklandığını bota bildirir ve kendisi için belirlenmiş verileri iletir. Bağlantı içeren sıradan bir düğme bu webhook'u tetiklemez.

Gönderim zamanı, isteğin yönlendirmenin hangi aşamasında gönderileceğini belirler:

• “İşlemeden önce”: istek, mesajın çevrilmesinden ve yapay zekâ (YZ) ile işlenmesinden önce gönderilir.
• “İşledikten sonra”: istek, çeviri ve yapay zekâ ile işleme tamamlandıktan sonra gönderilir.
• “Gönderdikten sonra”: istek, mesaj hedef sohbette başarıyla gönderildikten veya düzenlendikten sonra gönderilir.

Açıklama

“Açıklama”, size kolaylık sağlayan bir not alanıdır ve webhook'un çalışmasını etkilemez. Bu alan boş bırakılabilir.

Webhook ile yapılabilecek işlemler

Oluşturulan webhook'lar “Webhook'lar” listesinden yönetilebilir:

• “Değiştir”, webhook'un temel ayarlarını açar.
• “Diğer” menüsündeki “Çoğalt”, webhook ayarlarının bir kopyasını oluşturur.
• “Diğer” menüsündeki “Proje seç”, webhook'u bir projeye ekler.
• “Diğer” menüsündeki “Sil”, webhook'u siler.

Ayrıca her webhook'un, uygulanacağı yönlendirmeleri seçmenizi sağlayan bir “Yönlendirmeler [N]” düğmesi vardır. N, seçili yönlendirmelerin sayısını belirtir. Henüz yönlendirme seçilmediyse bunun yerine “Uygula” düğmesi gösterilir.