Paralel Bot Bağlantısı¶

Hotline, botları diğer sistemlerle — bot yapıcıları, özel betikler veya harici hizmetlerle — paralel olarak bağlamaya izin verir. Hemen hemen her bot, Hotline'a paralel modda bağlanabilir ve mesaj akışıyla bir çalışma konu grubu aracılığıyla çalışma yeteneği kazanabilir.

Hotline oturumları ile Telegram Bot API arasındaki fark

Bir bot token'ını Hotline'a bağlanmak için göndermek, standart Telegram Bot API kullanılırken olduğu gibi mevcut oturumu sonlandırmaz. Bu durumda her iki oturum aynı anda çalışır ve birbirlerinin işlevselliğini tamamlar.

Nasıl Çalışır¶

Paralel bağlantı ile, Hotline ana rolünü yerine getirmeye devam eder — bağlı botun kullanıcılarından arka uç grubuna ve geri, arka uç grubu tarafındaki operatörlerden kullanıcılara mesajları aktarır (yeteneklere genel bakışta daha fazla ayrıntı).

Hotline ayrıca bağlı bottan kullanıcılara paralel oturumdan giden mesajları görür ve bunları grupta yakalananlar olarak gösterebilir (intercepted mesajları).

Paralel bağlantı, mevcut Hotline parametrelerinin kullanımına herhangi bir kısıtlama getirmez, bu da bu tür paketler için birçok kullanım seçeneği açar.

Aynı zamanda, paralel bağlı bot şunları yapabilir:

Kendi karşılamasını göstermek (medya veya düğmelerle)
Komutlarını ve kullanıcılardan düğme basışlarını işlemek
Kullanıcılardan gelen mesajları ayrıştırmak
webapp arayüzü sağlamak ve çok daha fazlası

Esnek konu aktivasyonu

PRIVATE_KEYWORDS parametresini kullanarak, arka uç grubunda konu aktivasyonunu yalnızca kullanıcıdan özel bir komut aldıktan sonra yapılandırabilirsiniz (örneğin: "operatörü ara", "yardım", /help, /chat).

Paralel bağlantı güvenlidir

Paralel oturum bağlantıyı kesmez ve botunuzun mevcut oturumunu hiçbir şekilde etkilemez. Botunuz, kullanıcılardan gelen tüm mesajları ve düğme basışlarından callback'leri görmeye devam edecektir. Aynı zamanda, botunuz Hotline oturumu üzerinden giden mesajları görmeyecektir.

Ana Kullanım Senaryoları¶

Operatörlerle İletişim

İşlevselliğinizle (düğmeler, webapps, senaryolar, formlar) bottan doğrudan bir destek operatörüyle iletişim kurma yeteneği.
AI Bot Kontrolü

AI botunun kullanıcılarla yazışmalarını izlemek için uygun arayüz, diyaloga operatör müdahalesi yeteneğiyle.
Yedekleme Sistemi

Bot aracılığıyla mesaj akışını koruma ve ana araç arızaları durumunda Hotline üzerinden iletişim kurma yeteneği.
Mobil Erişim

Büyük bir CRM ile çalışmanın uygun olmadığı durumlarda, Telegram üzerinden herhangi bir cihazdan bot adına hızlı yanıtlar.
Yayınlar ve Segmentasyon

Ana iletişim sisteminizle paralel olarak Hotline'ın yayın sistemini kullanma.
İşlevsellik Genişletmesi

Hotline'ın temel işlevselliğine düğmeler, menüler, WebApp veya ek mesaj ayrıştırma ekleme.

Uygulama Örneği¶

Gösteri botumuuz paralel bağlantı çalışmasını gösterir:

@demobuttons_bot'u başlatın ve ona ilginç bir mesaj gönderin
Bu bot, token'ı ile Hotline'a ve popüler n8n yapıcısına paralel olarak bağlıdır, üzerinde düğme gösterimi ve basışlarına tepkiler uygulanmıştır
Bot /start komutuna yanıt verir ve başvuru konusunu seçmek için düğmelerle bir karşılama gösterir, Hotline ise düğmelerle giden mesajları ve kullanıcıdan gelen mesajları arka uç grubuna aktarır, operatörler buradan kullanıcıya yanıt verebilir
https://t.me/+GCqhEvR4iKM2NWJi bağlantısı üzerinden çalışma grubuna katılabilirsiniz, orada paralel bottan yakalanan mesajlar görünür olacak ve kendinize bir mesaj göndermeyi test edebilirsiniz
Bağlantı için HIDE_INFO parametresi etkinleştirilmiştir, bu nedenle kullanıcı adları gizlidir, ayrıca gruptaki /info komutu devre dışıdır
Botun ayrıca paralel bağlantı çalışması hakkında bize geri bildirim gönderebileceğiniz bir formla WebApp düğmesi vardır

Paralel Bağlantılar İçin Parametreler¶

Paralel bağlantılar kullanılırken çoğu zaman aşağıdaki parametreler kullanılabilir.

Karşılamayı devre dışı bırakma veya ayarlama:

WELCOME

Kullanıcının ilk irtibatta ve talebi kapatıldığında (/close durumuna geçtiğinde) aldığı hoş geldiniz mesajı. Ücretli versiyonda tamamen devre dışı bırakılabilir. Ücretsiz versiyon hoş geldiniz mesajında Hotline bağlantısı gerektirir.

Varsayılan değer: İngilizce standart hoş geldiniz mesajı.

Parametre hakkında daha fazla bilgi

Çift karşılama

Paralel bot bir karşılama verirse, ona Hotline'dan bir karşılama eklenir. Hotline'ın ücretsiz sürümünde, sistem telif haklarıyla birlikte mesaj kaldırılamaz.

Olası hataların çıktısını devre dışı bırakma:

SILENT_MODE

Mesajlarını işlerken müşterilere olası hataların gösterilip gösterilmeyeceği.

Varsayılan değer: hataları göster.

Bu parametre hakkında daha fazla bilgi

Hotline'ın giden mesajları engellemesini devre dışı bırakma:

INTERCEPT_EXTERNAL

Bağlı bot veya hesapların paralel oturumlarından giden yakalanan mesajların backend grubuna çoğaltılmasını devre dışı bırakır.

Varsayılan değer: TRUE (mesajlar çoğaltılır).

Bu parametre hakkında daha fazla bilgi

Diyalogda yalnızca anahtar kelimelerle konular oluşturma:

PRIVATE_KEYWORDS

Özel mesajları filtrelemek için anahtar kelimeler ve ifadelerin dizisi. Yalnızca kullanıcının mesajında anahtar kelimeler tespit edildiğinde etkinleşir.

Varsayılan değer: KAPALI (filtreleme yok).

Bu parametre hakkında daha fazla bilgi

Mesaj aktarımı

PRIVATE_KEYWORDS parametresi kullanılmazsa, kullanıcıdan gelen tüm mesajlar ilk başvuru anından itibaren arka uç grubuna aktarılır.

Önemli Notlar

Alternatif yaklaşım

Büyük işlevselliğe ve önemli kullanıcı akışına sahip bir botunuz varsa, ona paralel bağlantı kullanmak yerine özel olarak Hotline ve destek hizmeti için ayrı bir bot oluşturmak daha doğru olabilir (bu birçok güncelleme tüketebilir).

Yapıcı kısıtlamaları

Bazı bot yapıcıları rastgele kullanıcı mesajlarını almaya izin vermez ve hatalar verir. Bu tür sistemler için paralel bağlantı tavsiye edilmez.

Yardım Alın¶

Hotline sisteminin ücretli sürümünü satın almak istiyorsanız veya paralel bağlantı kurulumunda kişisel yardıma ihtiyacınız varsa, destek hizmetimizle iletişime geçin.