AiHummer
Türkçe▾
Oturum açHesap
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanallar/Telegram

Telegram

v1.0.x · güncellendi 2026-06-26

Telegram, AiHummer’ın üretim seviyesindeki, önerilen ilk kanalıdır. Gerçek insanların karşısına çalışan bir ajan çıkarmanın en hızlı yolu şudur: bir bot oluşturmak @BotFather, bağlayıcıya tokeni verin ve gelen mesajlar ağ geçidine akmaya başlar.

Telegram bağlantısı ürün içinden yüklenir Pazar yeri ve Yönetici UI’sinde yapılandırılır. Host yerel olarak çalışır ve gelen API üzerinden geçide bağlanır, böylece sıra motorundan bağımsız olarak ölçeklenir ve yeniden başlatılır.

Telegram’a 6 adımda bağlanın

İşte sıfırdan Telegram’da size yanıt veren bir bota giden uçtan uca yol. Tek ihtiyacınız olan bir Telegram hesabı ve AiHummer web yönetici kullanıcı arayüzünüze erişim.

  1. BotFather ile bir bot oluşturun. Telegram’da aç @BotFather, gönder /newbot, ve botun adını ayarla ve kullanıcı adı. Gördüğünüz şey: BotFather bir jeton gibi 123456789:AA… — bu botun erişim anahtarı, kopyala.
  2. Telegram bağlayıcısını kurun. Yönetici arayüzünde aç Eklentiler/Pazar Yeri, Telegram bağlayıcısını bulun kataloğa ve “Yükle”ye tıklayın. Kartın “çevrimiçi” olmasını bekleyin (bir yükleme ilerleme çubuğu gösterilir).
  3. Jetonu yapıştır. Git Kanallar ekran → Yüklenen kanalları yapılandır engelle, Telegram kartını aç ve yapıştır bot jetonu Bağlayıcı formundan alana girin. Kaydedin.
  4. Bir ajan oluştur (henüz bir tane yoksa) — bak Ajanlar: bir isim ve bir sistem istemi yeterlidir.
  5. Ajanı kanala bağlayın. Üzerinde Kanallar ekran, içinde “Bağlamalar” blok, seç varsayılan ajan Telegram için — kural “yeni Telegram konuşmaları ajan Y tarafından yürütülür”. Seçim anında kaydedilir.
  6. Bota mesaj gönder. Botunuzu Telegram’da açın ve ona bir mesaj gönderin. Ne şunu göreceksiniz: ajan sohbette cevap verir ve eşleşen konuşma görünür yönetici kullanıcı arayüzündeki “Oturumlar” ekranında.

[!NOTE] Varsayılan olarak ajan cevap verir sadece bilinen kullanıcılar (kayıtlı kişiler AiHummer). Eğer bot mesajınıza sessiz kalırsa — ya kendinizi ekleyin ya da örnek kullanıcı veya “Sadece bilinen kullanıcılara cevap ver” özelliğini kapat Kanallar ekran.

Neden Telegram ile başlamak

Telegram, herhangi bir AiHummer kanalının en az sürtünmeye sahip olanıdır: taşıyıcı yok, OAuth onay ekranı yok, uygulama incelemesi yok. Mesaj göndermek ve almak için bir bot belirteci yeterlidir ve aynı bağlayıcı hem dahili personel sohbetlerini hem de müşteriyle yüz yüze botları kapsar. Üretim düzeyinde ve tamamen kullanılmış olduğundan, AiHummer’ı değerlendirirken ilk olarak bağlamanızı önerdiğimiz kanal budur.

Anket veya web kancası

Bağlayıcı, her iki veri alma modunu da destekler, bu nedenle ağ geçidinizin genel internetten erişilebilir olup olmadığına bakılmaksızın çalışır.

  • Uzun anketleme — bağlayıcı, Telegram’dan güncellemeleri çeker. Gelen bağlantı noktası yok veya TLS gereklidir, bu da onu yerel geliştirme ve özel kullanım için ideal kılar ağlar.
  • Webhook — Telegram güncellemeleri genel bir HTTPS URL’sine gönderir. Daha düşük gecikme ve TLS’yi sonlandıran bir ters proxy arkasında üretim için daha uygun.

Bağlayıcı şu adresi dinliyor port 8800 normal bir dağıtımda ya da 8091 yerel bir çalıştırma için. Her gelen mesaj, yapılandırılmış olan ağ geçidi URL’sine gönderilir AIHUMMER_INBOUND_URL, paylaşılan gelen sır ile doğrulandı.

Zengin mesajlar, mesaj reaksiyonları ve anketler

Düz metnin ötesinde, Telegram kanalı sunar Zengin Mesajlar — bir ajanın yapılandırılmış çıktısını Telegram’ın yerel mesaj özelliklerine eşleyen biçimlendirilmiş yanıtlar. Ayrıca destekler mesaj tepkileri ve anketler, böylece bir ajan, bir tur kapsamında kullanıcının mesajına yanıt verebilir veya sohbete hızlı bir anket ekleyebilir.

[!TIP] Telegram, AiHummer tarafından tanımlanan kanaldır telegram. O kanalı kullan Bir ajan bağladığınızda veya görüşmeleri kaynağa göre filtrelediğinizde kimlik.

Döngü korumalı bottan-bota

Ajanlar diğer botlarla konuşabilir. Bunu güvenli hale getirmek için, bağlantı sağlayıcı bir döngü koruyucu: bu, sınırsız ping-pong’a dönüşmeden önce kaçak bot-bot etkileşimlerini tespit eder ve durdurur. Bu, klasik geri bildirim döngüsü hata modunu yaşamadan çoklu bot iş akışları oluşturmanıza olanak tanır.

OIDC üzerinden gizli aracılık

Bot tokeni ve diğer bağlayıcı gizli bilgileri asla hizmete sabit kodlanmaz. Bunun yerine bağlayıcı, bunları çalışma zamanında bir yerden alır OIDC üzerinden Gizli Servis — kimlik doğrulaması yapar, sonra ihtiyaç duyduğu kimlik bilgilerini alır. Sırlar şifrelenmiş kasada kalır ve yapılandırma dosyalarından ve işlem argümanlarından uzak tutulur.

[!NOTE] Gelen mesajlar şuraya gönderilir AIHUMMER_INBOUND_URL ve tarafından güvence altına alınmış paylaşılan HMAC gelen gizli anahtar (AIHUMMER_INBOUND_SECRET). Ağ geçidinin sahip olması gerekiyor varsayılan çalışma alanı onları gönderecek şekilde yapılandırıldı.

Eğer işe yaramadıysa

  • Telegram konektörü ‘Kanallar’ ekranında değil — önce bunu yükle Eklentiler/Pazar Yeri ekran; kurulana kadar kanal gösterilmiyor. Community planında yalnızca Telegram kullanılabilir; geri kalanlar bir yükseltmeye ihtiyaç duyuyor (HTTP 402).
  • Bot cevap vermiyor — kontrol et: (1) token doğru yapıştırıldı ve Telegram kartı “çevrimiçi”; (2) kanal “Bağlamalar”da bir ajana bağlı; (3) gönderen sistemde kayıtlıdır (varsayılan olarak temsilci yalnızca yanıt verir bilinen kullanıcılar).
  • Yanıtlar şablon gibi görünüyor — sahte model muhtemelen hâlâ aktif; bağlan sağlayıcı üzerinde Modeller sayfa.
  • “Yetkisiz” / jeton reddedildi — token yanlış veya iptal edilmiş; oluştur yeni bir tane ile @BotFather (/token) ve tekrar yapıştır.
  • Webhook gelmiyor — webhook modunda geçit şunlardan ulaşılabilir olmalıdır herkese açık bir HTTPS URL’si; özel bir ağda, gelen hiçbir şeye ihtiyaç duymayan uzun sorgulamayı kullanın port veya TLS.

Sonra nereye?