n8n ile Telegram Botu Nasıl Yapılır?

Telegram'da kullanıcıların mesaj gönderdiği bir bot, n8n'de kurulan bir workflow'la çalıştırılabilir. Dil modeli, metin işleyip yeni metin üretebilen yapay zekâ modelidir. Bu tür bir workflow bota gelen her mesajı alır, cevap metnini bir dil modeline hazırlatır ve cevabı mesajın geldiği sohbete gönderir.

n8n ile Telegram botu nasıl çalışır?

Bot, bir programın yönettiği Telegram hesabıdır. n8n'de her otomasyona workflow, workflow'daki her adıma da node denir. Editörde her node bir kutu olarak görünür. Workflow'u başlatan node'a trigger node adı verilir. Trigger node, workflow'un ilk node'udur.

Bir Telegram botu için kurulan n8n workflow'u şu parçalardan oluşur:

Örnek: Bir dil kursu, öğrencilerin kelime sorularını cevaplayan bir Telegram botu kurar. Öğrenci bota bir kelime yazar. Workflow mesajı dil modeline gönderir ve gelen açıklamayı aynı sohbete yazar.

Temel n8n kavramları n8n nedir yazısında anlatılır.

Telegram botu nasıl oluşturulur?

Telegram botu, Telegram'ın BotFather adlı botuyla oluşturulur. Credential, n8n'in bir uygulamaya bağlanmak için sakladığı bilgidir. n8n belgelerine göre adımlar şunlardır:

1. Telegram'da BotFather ile bir sohbet başlat.
2. Sohbete /newbot komutunu yaz.
3. BotFather'ın istediği bot adını ve kullanıcı adını gir.
4. BotFather'ın verdiği erişim anahtarını (token) kopyala.
5. n8n'de yeni bir Telegram credential'ı oluştur ve anahtarı Access Token alanına yapıştır.

Aynı credential hem Telegram Trigger node'unda hem de Telegram node'unda kullanılır.

Gelen mesajlara cevap veren bot nasıl kurulur?

Bu örnek workflow Telegram Trigger, Basic LLM Chain, bir dil modeli ve Telegram node'larından oluşur. Prompt, dil modeline ne yapacağını anlatan metindir. Chat ID ise mesajın gönderileceği sohbetin kimliğidir. Expression, n8n'in bir alana önceki node'lardan gelen veriyi yerleştirmek için kullandığı yazım biçimidir.

1. Telegram Trigger node'unu ekle, credential'ı seç ve olay olarak Message'ı seç.
2. Basic LLM Chain node'unu ekle ve node'a bir dil modeli bağla.
3. Basic LLM Chain node'unun promptuna Telegram'dan gelen mesaj metnini expression olarak ekle.
4. Telegram node'unu ekle ve Send Message işlemini seç.
5. Chat ID alanına Telegram Trigger node'undan gelen değeri, Text alanına dil modelinin cevabını expression olarak ekle.
6. Workflow'u yayımla ve bota Telegram'dan bir mesaj gönder.

Belgelere göre Send Message işlemi bir mesajda en çok 4.096 karakter gönderebilir. Bu işlem mesajın sonuna varsayılan olarak "This message was sent automatically with n8n" cümlesini ekler. Belgelere göre bu cümle, Additional Fields bölümündeki Append n8n Attribution seçeneği kapatılarak kaldırılır.

Bot önceki mesajları nasıl hatırlar?

Hafıza, dil modelinin aynı sohbetteki önceki mesajları bilmesini sağlar. n8n belgelerine göre Basic LLM Chain gibi chain node'ları hafıza kullanamaz, AI Agent node'u ise kullanabilir.

Önceki mesajları hatırlayan bir bot için Basic LLM Chain yerine AI Agent node'u kullanılır. Araç, dil modelinin bir işi yapmak için kullanabildiği ek bir node'dur. Belgelere göre AI Agent node'una bir dil modeli ve en az bir araç bağlanmalıdır.

AI Agent node'una bağlanan Simple Memory node'u, sohbet geçmişini workflow'da saklar. Simple Memory node'unun iki ayarı vardır:

On Chat Message trigger node'u, n8n'in kendi sohbet ekranından mesaj alır. Belgelere göre bu trigger node kullanılmıyorsa Session Key değeri elle belirlenir. Telegram botunda Session Key alanına sohbetin Chat ID'si yazılırsa her Telegram sohbeti ayrı bir anahtarla saklanır. Ajanların çalışma biçimi yapay zekâ ajanı nedir yazısında anlatılır.

Örnek: Bir dil kursunun Telegram botuna farklı öğrenciler yazar. Session Key alanında Chat ID kullanıldığı için her öğrencinin sohbeti ayrı saklanır. Bot bir öğrencinin önceki sorusunu başka bir öğrencinin sohbetine karıştırmaz.

Telegram botunda hangi sorunlar çıkar?

Telegram, bota gelen mesajları n8n'e webhook adı verilen bir adres üzerinden iletir. n8n belgelerine göre en sık görülen sorunlar şunlardır:

n8n'in kurulum yolları n8n kurulumu nasıl yapılır yazısında anlatılır.

Bot sadece belirli kişilere cevap verecekse Telegram Trigger node'undaki Restrict to User IDs seçeneğine bu kişilerin kullanıcı kimlikleri yazılır. Belgelere göre bu durumda workflow sadece listedeki kullanıcıların mesajlarıyla başlar.

Sonraki adım

BotFather ile bir test botu oluştur ve gelen mesaja dil modeliyle cevap veren workflow'u kur. Bota kısa bir soru ve uzun bir metin gönder, iki cevabı da kontrol et. Cevaplar doğruysa Restrict to User IDs seçeneğine kendi kullanıcı kimliğini yaz. Böylece bot sadece senin mesajlarınla çalışır.