n8n + Telegram: Yapay Zekayla Akıllı Bildirim Botu Kurma
Slack'e ya da e-postaya bakma alışkanlığı olmayan biri için Telegram'a gelen özlü bir bildirim, on satır ham log'dan çok daha değerlidir. n8n tam da bu işi halleder: bir webhook tetikler, isteğe bağlı olarak yapay zeka verinizi özetler, ardından Telegram'a temiz bir mesaj gönderir. Bu rehberde sıfırdan çalışan bir akış kuracaksınız.
Neye İhtiyacınız Var?
- Çalışan bir n8n instance'ı (kendi instance'ınız, kendinize ait)
- Telegram'da bir bot token'ı (BotFather üzerinden dakikalar içinde alınır)
- AI node'ları için LLM kredisi — AgentRoost kullanıyorsanız bu zaten dahil, başka bir şey kurmanıza gerek yok
Adım 1: Telegram Bot Oluşturma
- Telegram'da @BotFather'ı aratın ve
/newbotkomutunu verin. - Botunuza bir ad ve kullanıcı adı atayın (ör.
SiparişAlertBot). - BotFather size bir token verecek:
7123456789:AAFxxxxxx...— bunu kopyalayın. - Bildirim almak istediğiniz sohbeti (kişisel chat, grup veya kanal) açın, bota ilk mesajı gönderin veya gruba ekleyin.
https://api.telegram.org/bot<TOKEN>/getUpdatesadresini tarayıcıda açın vechat.iddeğerini not edin.
Adım 2: n8n'de Telegram Credential Ekleme
n8n editörünüzü açın → sağ üst Credentials → New → Telegram seçin → token'ı yapıştırın → kaydedin.
Adım 3: Akışı Oluşturma
Aşağıdaki node zincirini sırayla ekleyin:
Webhook → Set → AI Agent (veya Basic LLM Chain) → Telegram
3a. Webhook Node
- HTTP Method: POST
- Path:
/siparis-alert(veya istediğiniz bir yol)
n8n size şu formatta bir URL atar:
https://<id>.agentroost.app/webhook/siparis-alert
Bu URL halka açık HTTPS'tir; SSL kurmanıza gerek yok, zaten hazır.
Test için "Listen for test event" moduna geçin ve şu örnek payload'u gönderin:
{
"order_id": "ORD-9821",
"customer": "Ayşe Kaya",
"amount": 349.90,
"items": ["Laptop Çantası", "USB Hub"],
"note": "Kapıda ödeme istiyor, büyük paket"
}
3b. Set Node (opsiyonel ama önerilen)
Sadece AI'a göndermek istediğiniz alanları saklayın, tüm payload'u değil. Örnek:
| Alan | Değer |
|---|---|
siparis_ozeti |
={{ $json.order_id }} - {{ $json.customer }} - {{ $json.amount }}₺ |
notlar |
={{ $json.note }} |
urunler |
={{ $json.items.join(', ') }} |
Bu adım, AI node'una gönderilen metni sade tutar ve token israfını önler.
3c. AI Agent / Basic LLM Chain Node
n8n'in AI kategorisini açın ve Basic LLM Chain node'unu seçin.
- Model: n8n sizin için yapılandırılmış olan modeli listeler (AgentRoost'ta bu kredi dahil olduğu için bir API anahtarı girmeden seçebilirsiniz).
- Prompt (System):
Sen bir e-ticaret asistanısın. Verilen sipariş bilgisini 3 cümleyle özetle.
Başlık: emoji + tek satır özet
Detay: müşteri adı, tutar, ürünler
Özel not: varsa müşteri notunu vurgula.
Yanıtını yalnızca Türkçe ver.
- Prompt (User / Message):
Sipariş: {{ $json.siparis_ozeti }}
Ürünler: {{ $json.urunler }}
Not: {{ $json.notlar }}
Neden AI node? Ham JSON yerine "📦 Yeni Sipariş: Ayşe Kaya — 349,90 ₺ · Kapıda ödeme isteniyor" gibi okunabilir mesajlar alırsınız. Bildirim hacmi yüksekse bu fark kritik hale gelir.
3d. Telegram Node
- Credential: az önce eklediğiniz Telegram bağlantısı
- Operation: Send Message
- Chat ID:
{{ $json.chat_id }}veya sabit değer (ör.-1001234567890) - Text:
{{ $json.output }}
$json.output, Basic LLM Chain'in yanıt alanıdır. AI Agent kullanıyorsanız{{ $json.text }}olabilir — node çıktısına bakarak doğrulayın.
- Parse Mode: Markdown (mesajı biçimlendirmek istiyorsanız)
Adım 4: Akışı Aktive Etme ve Test
- Sağ üstteki Active toggle'ını açın — akış artık canlı.
- Webhook URL'nizi gerçek sisteminizden (WooCommerce, Shopify, kendi backend'iniz) çağırın.
- Telegram'da "📦 Yeni Sipariş: ..." mesajı belirmelidir.
Sorun olursa n8n'in Executions sekmesi her adımın giriş/çıkışını gösterir — debug için idealdir.
Ekstra İpuçları
Birden fazla Telegram kanalı: IF node ekleyin; amount > 1000 ise yönetici kanalına, değilse genel kanala yönlendirin.
Hata bildirimi: Akışın sonuna bir Error Trigger node bağlayın ve hata durumunda da Telegram'a mesaj atın — akışınız sessizce ölmez.
Özet yerine tablo: Telegram HTML parse mode destekler; LLM prompt'unu <b> ve <code> etiketleri kullanacak şekilde yönlendirin.
Periyodik özet: Webhook yerine Schedule Trigger (ör. her sabah 08:00) koyun, HTTP Request ile kendi API'nizden günün siparişlerini çekin, AI ile özetleyin, Telegram'a gönderin.
AgentRoost'ta Bu Akışı Kurmak
Yukarıdaki adımların en çok zaman çalan kısmı genellikle n8n'i bir sunucuya kurmak, SSL sertifikası almak ve LLM API anahtarlarını yönetmektir. AgentRoost bunların hepsini ortadan kaldırır:
- agentroost.app adresinde hesap açın (Google, Microsoft veya Discord ile de olur).
- n8n framework'ünü seçin, instance'ınıza bir ad verin.
- Yaklaşık 2 dakika sonra kendi n8n editörünüz
https://<id>.agentroost.appadresinde açılır. - AI node'larını açın — LLM kredisi aboneliğe dahildir, API anahtarı girmenize gerek yok. Farklı modeller arasından dilediğinizi seçebilirsiniz.
- Yukarıdaki akışı kurun. Webhook URL'niz anında çalışır durumda.
Fiyat $19,99/ay'dan başlar; sunucu, AI kredisi ve kurulum dahil. İstediğiniz zaman iptal edebilirsiniz, ilk 14 gün para iade garantili.
Sıkça sorulan sorular
Telegram bot token'ını n8n'e nasıl güvenli saklarım?
n8n'in Credentials bölümünü kullanın — token, workflow JSON'una düz metin olarak gömülmez, şifreli credential deposunda saklanır. Workflow'u dışa aktardığınızda token görünmez.
AI node için ayrı bir OpenAI API anahtarı almam gerekiyor mu?
AgentRoost üzerinde çalışan n8n instance'ınızda hayır. LLM kredisi aboneliğe dahildir; credential alanını boş bırakabilirsiniz. Kendi n8n sunucunuza kurduysanız evet, ayrıca OpenAI veya başka bir sağlayıcıdan anahtar almanız gerekir.
Webhook birden fazla sistemden çağrılabilir mi?
Evet. Aynı webhook URL'sini WooCommerce, GitHub, Stripe veya herhangi bir HTTP istemcisi çağırabilir. Farklı kaynakları ayırt etmek için IF node ile $json.source gibi bir alana göre yönlendirme yapın.
AgentRoost'ta verilerim nerede? Başka kullanıcılar görebilir mi?
Her kullanıcı kendi izole, tek kiracılı (single-tenant) n8n instance'ına sahiptir. Workflow veritabanınız ve log'larınız başka kullanıcılarla paylaşılmaz.
İstediğimde iptal edebilir miyim ve verilerimi alabilir miyim?
Evet. İptal herhangi bir zamanda yapılabilir, ek ücret yoktur. n8n'in yerleşik Export özelliğiyle tüm workflow'larınızı JSON olarak indirip istediğiniz başka bir n8n kurulumuna aktarabilirsiniz. İlk 14 gün içinde iade talep ederseniz ödemeniz iade edilir.