Telegram'ı bağlayın: adım adım kılavuz
Size ait bir bot aracılığıyla başarısızlık uyarıları (NEXUS_TELEGRAM_NOTIFY=true olduğunda test başına bir uyarı) ve paylaşmayı seçtiğiniz raporlar ile dosyalar gönderir. Ortak bir bot yoktur. Bu kılavuz, sıfırdan başlayarak doğrulanmış bir bağlantı kurmanızı sağlar ve karşılaşabileceğiniz hataları nedenleri ve çözümleriyle listeler.
Son güncelleme:
Kimlik bilgilerinizi gizli tutun. Bir sohbete asla belirteç, anahtar, parola veya webhook URL'si yapıştırmayın. Bunları yalnızca Studio → Ayarlar → Entegrasyonlar bölümüne girin; burada çalışma alanınızın .env dosyasına kaydedilir ve nokta olarak gösterilir. Aynı kural yapay zekâ asistanı için de geçerlidir: bu kılavuzda size yol gösterebilir, ancak belirtecinize asla ihtiyaç duymaz.
Gereksinimler
- Bir Telegram hesabı.
- @BotFather ile bir kez oluşturacağınız, size ait bir bot ve bu botun erişim belirteci.
- Eşleştirme QR kodunu taramak için bir telefon veya Telegram uygulaması.
- Etkinleştirmeden önce: Telegram, raporlar ve PDF'ler gibi dosyaları alabilir ve bu dosyalar Telegram sunucularına gider. Mevzuata tabi bir ortamda çalışıyorsanız önce uyum ekibinize danışın.
Kimlik bilgilerini alın
- Telegram'da https://t.me/BotFather adresini açın ve /newbot gönderin. Bota bir ad ve kullanıcı adı verin.
- BotFather, botun erişim belirtecini içeren bir yanıt verir (örneğin 123456:ABC…). Bunu kopyalayın.
- Panonuzda tutun. Studio dışında hiçbir yere yapıştırmayın (sonraki adım).
Studio'da bağlantıyı kurun
- Studio'da Ayarlar → Entegrasyonlar → Telegram'ı Bağla'yı açın.
- Botun erişim belirtecini yapıştırın ve kaydedin. Eşleştirme QR kodu görünür.
- QR kodunu telefonunuzla tarayın ve Telegram'da Başlat'a dokunun. Birkaç saniye içinde Studio'da "uyarıların gönderileceği sohbet …" görünür ve bot "Nexus StudioQA bağlantısı kuruldu." der.
TELEGRAM_ENABLEDseçeneğini açın. Başarısız olan her test için bir uyarı almak istiyorsanızNEXUS_TELEGRAM_NOTIFYseçeneğini de açın.
Çalıştığını doğrulayın
- Taramadan sonra bot, sohbetinize "Nexus StudioQA bağlantısı kuruldu. Başarısız testler burada bildirilecek." mesajını gönderir.
- Studio, sohbet bilgilerini maskeleyerek "uyarıların gönderileceği sohbet" ifadesini gösterir.
Sık karşılaşılan hatalar
| Gördüğünüz | Neden | Çözüm |
|---|---|---|
| "Telegram kapalı" | TELEGRAM_ENABLED false olarak ayarlanmış ve eşleştirme için açık olması gerekiyor. | TELEGRAM_ENABLED seçeneğini açın ve tekrar Telegram'ı Bağla'ya basın. |
| "Bot erişim belirteci yok" | TELEGRAM_TOKEN boş. | BotFather'dan aldığınız belirteci Ayarlar → Entegrasyonlar bölümüne yapıştırıp kaydedin. |
| "Telegram: Yetkisiz" (veya "Bulunamadı") | Bot belirteci yanlış, BotFather'da iptal edilmiş veya kopyalanırken eksik alınmış. | Belirteci yeniden almak için BotFather'a /token gönderin (veya yeni bir bot oluşturun) ve belirteci kaydedin. |
| "QR kodunun süresi taranmadan önce doldu" | QR kodu yalnızca birkaç dakika geçerlidir. | Yeni bir kod oluşturmak için Telegram'a bağlan düğmesine basın ve kodu hemen tarayın. |
| QR kodu tarandı ancak Studio hâlâ bekliyor | Tarama sohbeti açtı ancak Başlat'a dokunulmadı veya Studio penceresi kapatıldı. | Bot sohbetinde Başlat'a dokunun. Hâlâ bekliyorsa yeni bir QR kodu oluşturun. |
| "Telegram'a ulaşılamadı (ENOTFOUND)" veya "20 saniye içinde yanıt vermedi" | Bu bilgisayar api.telegram.org adresine ulaşamıyor: VPN, güvenlik duvarı veya ara sunucu engelliyor ya da ağ bağlantısı yok. | Aynı bilgisayardan ağ bağlantısını kontrol edin ve tekrar deneyin. |
| Bir başarısızlıktan sonra uyarı gelmiyor | TELEGRAM_ENABLED false değerinde, hiçbir sohbet eşleştirilmemiş veya test başına uyarılar kapalı (NEXUS_TELEGRAM_NOTIFY). | Bir sohbet eşleştirin ve her iki anahtarı da açın. |
Ayar anahtarları
| Anahtar | Ne yapar | Geçerli değer | Nasıl denetlenir |
|---|---|---|---|
TELEGRAM_ENABLED | Uyarıları Telegram'a gönder | true veya false | Eşleştirme QR kodu için bunun açık olması gerekir. |
TELEGRAM_TOKEN | Telegram bot erişim kodu (gizlidir, yalnızca bu bilgisayarda saklanır) | BotFather'dan alınan bot belirteci, örneğin 123456:ABC…, tek satır | QR kodu yalnızca Telegram belirteci kabul ederse görünür. |
TELEGRAM_CHAT_ID | Uyarılar için Telegram sohbeti | QR eşleştirmesiyle doldurulur; elle yazmayın | Studio, "uyarılar … sohbetine gönderilir" mesajını gösterir. |
NEXUS_TELEGRAM_NOTIFY | Her başarısızlık için Telegram uyarısı | true veya false | Başarısız olan her test için bir uyarı gelir. |
Daha fazlası: tüm entegrasyonlar, Ayarlar kılavuzu, sorun giderme. Diğer kılavuzlar: Jira Cloud, Azure Boards, Slack, Microsoft Teams, GitHub Issues.
Hâlâ çözüme ulaşamadınız mı? Studio'nun gösterdiği hata satırını aynen ekleyerek [email protected] adresine yazın. Erişim belirteci eklemeyin.