AiHummer
Azərbaycanca▾
Daxil olŞəxsi kabinet
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanallar/Telegram

Telegram

v1.0.x · yeniləndi 2026-06-26

Telegram AiHummer-in istehsal səviyyəli, tövsiyə olunan ilk kanalıdır. İşləyən bir agenti real insanların qarşısına çıxarmağın ən sürətli yolu budur: bir bot yaratmaq @BotFather, birləşdiriciyə tokeni verin və daxil olan mesajlar qapıya axmağa başlayır.

Telegram birləşdiricisi məhsul içindən quraşdırılır Bazar və Admin UI-də konfiqurasiya olunub. O, host-native şəkildə işləyir və giriş API vasitəsilə qapıçıya qoşulur, beləliklə, dönüş mühərrikindən müstəqil olaraq miqyaslana və yenidən başlada bilər.

Teleqramı 6 addımda qoşun

Budur sıfırdan Telegram-da sizə cavab verən bir bot yaratmağa qədər olan tam yol. Yalnız bir Telegram hesabınız və AiHummer veb admin UI-a girişiniz olmalıdır.

  1. BotFather ilə bir bot yaradın. Teleqramda açın @BotFather, göndər /newbot, və botun adını təyin et və istifadəçi adı. Nə görəcəksiniz: BotFather birini qaytarır simvol bəyənmək 123456789:AA… — bu botun giriş açarıdır, onu kopyalayın.
  2. Telegram əlaqələndiricisini quraşdırın. İdarəçi istifadəçi interfeysində açın Plugins/Bazar yeri, Telegram əlaqələndiricisini tapa kataloqa baxın və “Quraşdır” düyməsini klikləyin. Kartın “onlayn” vəziyyətə keçməsini gözləyin (bir quraşdırma) proqramın gediş barı göstərilir).
  3. Tokeni yapışdırın. Getmək Kanallar ekran → Quraşdırılmış kanalları konfiqurasiya et blok, Telegram kartını açın və yapışdırın bot tokeni Qoşqu formasından sahəyə. Yadda saxla.
  4. Agent yaradın (əgər hələ yoxdursa) — bax Agentlər: bir ad və bir sistem göstərişi kifayətdir.
  5. Agentin kanala qoşulmasını təmin edin. Üzərində Kanallar ekran, daxilində Bağlamalar blok, seçmək default agent Telegram üçün — Qayda “yeni Telegram söhbətləri agent Y tərəfindən idarə olunur”. Seçim dərhal yadda saxlanılır.
  6. Bot-a mesaj göndərin. Botunuzu Telegramda açın və ona mesaj göndərin. Nə siz görəcəksiniz: agent çatda cavab verir və uyğun söhbət görünür idarəçi istifadəçi interfeysində “Sessiyalar” ekranında.

[!NOTE] Standart olaraq agent cavab verir yalnız məlum istifadəçilər (qeydiyyatdan keçmiş insanlar AiHummer). Əgər bot mesajınıza cavab vermirsə — ya özünüzü əlavə edin nümunə istifadəçi, yoxsa “Yalnız tanınan istifadəçilərə cavab ver” funksiyasını söndür Kanallar ekran.

Niyə Telegram ilə başlamaq

Telegram hər hansı AiHummer kanalından ən az maneəyə malikdir: operator yoxdur, OAuth icazə ekranı yoxdur, tətbiq icmalı yoxdur. Mesaj göndərmək və qəbul etmək üçün yalnız bot tokeni kifayətdir və eyni konnektor həm daxili personal çatlarını, həm də müştəriyə yönəlmiş botları əhatə edir. Çünki bu, istehsal səviyyəsindədir və tam işlədilmişdir, AiHummer-i qiymətləndirərkən ilk olaraq qoşmağı tövsiyə etdiyimiz kanaldır.

Sorğulama və ya webhook

Bu birləşdirici həm qəbul rejimlərini dəstəkləyir, buna görə də qapınız ictimai internetdən əlçatan olub-olmamasından asılı olmayaraq işləyir.

  • Uzun sorğu — konnektor Telegram-dan yeniləmələri çəkir. Giriş portu yoxdur və ya TLS tələb olunur, bu isə onu yerli inkişaf və şəxsi istifadə üçün ideal edir şəbəkələr.
  • Webhook — Telegram yeniləmələri ictimai HTTPS URL ünvanına göndərir. Daha aşağı gecikmə və TLS-ni dayandıran tərs proksi arxasında istehsal üçün daha uyğundur.

Qoşqu dinləyir port 8800 normal yerləşdirmədə, yaxud 8091 yerli iş üçün. Hər bir daxil olan mesaj təyin edilmiş keçid URL-ə göndərilir AIHUMMER_INBOUND_URL, daxil olan ümumi gizli məlumat ilə təsdiqlənmişdir.

Zəngin mesajlar, mesaj reaksiyaları və sorğular

Sadə mətndən kənarda, Telegram kanalı təqdim edir Zəngin Mesajlar — agentin strukturlaşdırılmış çıxışını Telegramın yerli mesaj xüsusiyyətlərinə uyğunlaşdıran formatlaşdırılmış cavablar. O həmçinin dəstəkləyir mesaj reaksiyaları və sorğular, beləliklə, agent bir istifadəçinin mesajına cavab verə və ya bir dövrənin bir hissəsi kimi söhbətə sürətli sorğu yerləşdirə bilər.

[!TIP] Telegram AiHummer tərəfindən tanınan kanaldır telegram. O kanaldan istifadə et agent-i bağlayanda və ya söhbətləri mənbəyə görə süzgəcdən keçirəndə id.

Bot-bot ilə döngə qoruyucusu

Agentlər digər botlarla danışa bilərlər. Bunu təhlükəsiz etmək üçün, birləşdirici göndərir döngü qoruyucusu: bu, sonsuz ping-pong-a çevrilmədən əvvəl qaçan bot-bot mübadilələrini aşkarlayır və dayandırır. Bu, sizə çoxbotlu iş axınlarını klassik rəy-döngüsü uğursuzluğu olmadan yaratmağa imkan verir.

OIDC üzərindən gizli vasitəçilik

Bot tokeni və digər konnektor sirləri heç vaxt xidmətdə sərt kodlaşdırılmır. Bunun əvəzinə konnektor onları işləmə vaxtında əldə edir. OIDC üzərindən Secrets Xidməti — o təsdiqləyir, sonra lazım olan etimadnamələri əldə edir. Sirlər şifrəli anbara qalır və konfiqurasiya faylları ilə proses arqumentlərindən kənarda saxlanılır.

[!NOTE] Gələn mesajlar yerləşdirilir AIHUMMER_INBOUND_URL və tərəfindən təmin edilmiş paylaşılan HMAC daxil olan gizli açar (AIHUMMER_INBOUND_SECRET). Gateway-in olmalıdır Onları göndərmək üçün standart iş sahəsi qurulub.

Əgər işləmdisə

  • Telegram qoşucusu “Kanallar” ekranında deyil — əvvəlcə onu quraşdır o Plugins/Bazar yeri ekran; quraşdırılana qədər kanal göstərilmir. Yalnız Community planında Telegram mövcuddur; qalanları təkmilləşdirməyə ehtiyac duyur (HTTP 402).
  • Bot cavab vermir — yoxlayın: (1) token düzgün yapışdırılıb və Telegram kartı “onlayn”dır; (2) kanal “Bağlamalar”da bir vasitəyə bağlıdır; (3) göndərən sistemdə qeydiyyatdan keçib (dəfərən agent yalnız cavab verir məlum istifadəçilər).
  • Cavablar şablon kimi görünür — saxta model ehtimal ki hələ də aktivdir; qoşun təchizatçı üzərində Modellər səhifə.
  • “Avtorizə olunmayıb” / token rədd edildi — token yanlışdır və ya ləğv edilib; yaradın yeni biri ilə @BotFather (/token) və onu yenidən yapışdırın.
  • Webhook gəlmir — webhook rejimində qapı nöqtəsinə çatmaq mümkünsüz olmamalıdır publik HTTPS URL; özəl şəbəkədə isə heç bir daxil olan tələbə ehtiyac duymayan uzun sorğu istifadə edin port və ya TLS.

Növbəti haradır