Telegram, kullanıcı dostu yapısı ve esnek entegrasyon seçenekleriyle benim sıkça tercih ettiğim bir mesajlaşma platformudur. Son dönemde özellikle otomasyon projelerimde tercih ettiğim n8n platformu sayesinde, Telegram üzerinde kolayca güçlü ve kullanışlı Yapay Zeka ajanları oluşturmak mümkün. Bu yazıda, sıfırdan başlayarak adım adım bir Telegram Yapay Zeka ajanı kurulumunu, kendi tarzımda anlatacağım.
n8n ve Telegram Bot Nedir?
n8n Hakkında Kısa Bilgi
n8n, benim de severek kullandığım açık kaynaklı ve kodlama gerektirmeyen (low-code) bir otomasyon platformudur. Kullanıcı dostu görsel arayüzü sayesinde iş akışlarını ve entegrasyonları hızlıca oluşturmak mümkündür.
Telegram Botları Ne İşe Yarar?
Telegram botları, otomatik olarak mesajlara yanıt veren, kullanıcıları bilgilendiren ve belirli görevleri yerine getiren programlardır. Benim projelerimde de Telegram botları, işleri otomatik hale getirmek için sıklıkla tercih ettiğim araçlardan biridir.
Kurulum Öncesi Hazırlıklar
Başlamadan önce aşağıdaki araçları hazır bulundurman gerekiyor:
- Bir Telegram hesabı
- Telegram Bot Token (API Anahtarı)
- n8n hesabı (Bulut veya kendi sunucun)
- OpenAI API Anahtarı (Yapay zeka desteği için)
Adım Adım Telegram Bot Kurulumu
Adım 1: Telegram Botunu Oluştur
Telegram botunu oluşturmak için Telegram’ın resmi botu olan BotFather‘ı kullanıyoruz:
- Telegram’da @BotFather hesabını aç ve
/newbotyaz. - Botun için bir isim belirle (örn: n8nYapayZeka).
- Ardından benzersiz bir kullanıcı adı oluştur (örn: n8n_yapayzeka_bot).
- Oluşturulan API token’ını mutlaka kaydet.
Adım 2: n8n Kurulumu ve İlk Ayarlar
n8n platformunu n8n.io adresinden bulut veya kendi sunucunda kurabilirsin.
- Hızlıca bulut hesabı oluşturabilir veya Docker ile sunucuna kurabilirsin:
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-v ~/.n8n:/home/node/.n8n \
n8nio/n8n
Kurulum sonrası paneli http://localhost:5678 adresinden açarak başlayabilirsin.
Adım 3: Telegram ile n8n Entegrasyonu
- n8n panelinde yeni bir workflow oluştur.
- İlk adım olarak “Telegram Trigger” node’unu ekle:
- Credential ekleyerek Telegram token’ını bağla.
- “Updates” modunu etkinleştir.
Adım 4: OpenAI API Bağlantısı
- Yeni node olarak “OpenAI” seç ve API anahtarını bağla.
- Benim tercihim GPT-4 olacak, ancak GPT-3.5 de seçebilirsin.
- Prompt kısmına aşağıdaki örneği girerek mesajları işle:
Sen bir yardımcı botsun. Kullanıcılardan gelen soruları kısa ve anlaşılır yanıtla.
Soru: {{$json["message"]["text"]}}
Yanıt:
Adım 5: Otomatik Cevap Gönderimi
- OpenAI node sonrası bir Telegram node’u ekle ve mesaj gönderimini seç (sendMessage).
- Chat ID için Telegram Trigger’dan gelen veriyi kullan:
{{$json["message"]["chat"]["id"]}}
- Mesaj kısmına OpenAI node çıktısını ekle:
{{$json["choices"][0]["text"]}}
- Workflow’u kaydet ve etkinleştir.
Adım 6: Botu Test Et
Telegram üzerinden botunu bul ve basit bir soru sorarak test et (örn. “Bugün hava nasıl?”). Botun otomatik olarak OpenAI yardımıyla yanıtlamalıdır.
Adım 7: İleri Düzey Özelleştirmeler
Telegram botunu geliştirmek için şu özellikleri ekleyebilirsin:
- Mesaj Filtreleme: IF node kullanarak özel koşullar tanımla.
- Dosya ve Görsel Gönderimi: Telegram node ayarlarından sendPhoto veya sendDocument seçeneklerini kullanarak içerik gönderimi yapabilirsin.
- Düzenli Bildirimler: Cron node kullanarak belirli aralıklarla otomatik bildirimler oluşturabilirsin.
Sonuç
Bu yazımda n8n kullanarak Telegram üzerinde çalışan bir yapay zeka ajanı oluşturma konusuna değindik. Tabi ki sonuç olarak üzerine kafa patlatılması gereken konuların başında geliyor. Denemeler yaparak sen de kendi yapay zeka ajanını oluşturabilirsin.
Öneri Yazı : n8n Nasıl Kullanılır



