From fb38780e2dea90bc3c9f0f0634a10b411d39ec23 Mon Sep 17 00:00:00 2001 From: mstfyldz Date: Sun, 16 Aug 2026 17:33:58 +0300 Subject: [PATCH] docs: add Voice Note STT and AI Mood Curator guide to TELEGRAM_N8N_AUTOMATION.md --- TELEGRAM_N8N_AUTOMATION.md | 71 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) diff --git a/TELEGRAM_N8N_AUTOMATION.md b/TELEGRAM_N8N_AUTOMATION.md index 351e81c..0429990 100644 --- a/TELEGRAM_N8N_AUTOMATION.md +++ b/TELEGRAM_N8N_AUTOMATION.md @@ -152,6 +152,77 @@ const clean = text.trim(); ### 3. Polaroid Fotoğraf Gönderme Telegram'dan bir fotoğraf yükleyip altına açıklama yazdığınızda otomatik olarak `polaroid` formatına dönüştürülür. +### 4. Sesli Mesaj (Voice Note) Gönderme +Telegram'dan sesli mesaj attığınızda n8n akışındaki **OpenAI Whisper Node** sesi deşifre eder ve otomatik olarak `audio` formatında kaset çalar görünümüyle deftere ekler. + +--- + +## 🎙️ Sesli Mesaj (Voice Note) Mimarisi + +Telegram'dan bir sesli mesaj gönderdiğinizde izlenen adımlar: + +1. **Telegram Get File Node:** Gelen `msg.voice.file_id` ses dosyasını Telegram sunucusundan indirir. +2. **OpenAI Whisper Node (STT):** Ses dosyasını metne dönüştürür (*Speech-to-Text*). +3. **Audio Format Özellikleri:** + - `type`: `"audio"` + - `content`: Whisper tarafından deşifre edilen konuşma metni. + - `audioTitle`: `"Telegram_Ses_Kaydi.m4a"` + - `audioDuration`: Telegram'dan alınan süre bilgisi (Örn: `01:45`). + - `marginNotes`: `["* Whisper AI ile otomatik deşifre edildi 🎙️"]` + +--- + +## 🧠 AI (Yapay Zeka) ile Akıllı Mood, Kenar Notu ve Etiket Tespiti + +### **Kesinlikle AI Eklemenizi Öneririm! Neden mi?** + +İnsan ruh hali ve yazılan düşünceler karmaşıktır. Statik kod kuralları (`if text.includes(...)`) yerine n8n içerisine **OpenAI (GPT-4o-mini)** veya **Claude 3.5 Haiku** düğümü eklediğinizde AI sizin **Kişisel Editörünüz & Mood Küratörünüz** gibi davranır. + +### AI Eklemenin Kazandırdığı 4 Harika Özellik: + +1. **Akıllı Mood Tespiti:** Yazdığınız samimi cümlenin ruh halini doğrudan 5 ana kategoriden birine eşler (`spark`, `focus`, `night`, `calm`, `visual`). +2. **Esprili Kenar Notları (Marginalia):** AI, yazdığınız mesaja uygun samimi el yazısı kenar notları uydurur (Örn: *"← tam olarak bu!"*, *"çayı tazelemeyi unutma ☕"*, *"derleyici yine haklı çıktı"*). +3. **Damga Seçimi:** AI mesaja en çok uyan damgayı belirler (`ONAYLANDI`, `COMPILED`, `SUÇLU`, `DOĞRU TESPİT`). +4. **Bağlamsal Etiketler:** Metnin özünden en doğru etiketleri üretir (Örn: `["yazılım", "felsefe", "kadıköy"]`). + +### AI Node Prompt Örneği (n8n OpenAI / LLM Node): + +> **Sistem Rolü:** Sen Mustafa Yıldız'ın (mstfyldz) kişisel dijital günlüğünün yapay zeka yayın editörüsün. Görevin, Telegram'dan gelen döküntü metinleri veya ses transkriptlerini inceleyerek JSON formatında mood ve meta veri çıkarmaktır. +> +> **Taramak İstediğimiz Mood Türleri:** +> 1. `spark`: Fikir Patlaması (Ani aydınlanmalar, harika fikirler, heyecanlı projeler) +> 2. `focus`: Aşırı Odak & Kaos (Kod yazma, teknik problemler, 15 katmanlı soyutlamalar) +> 3. `night`: Gece Melankolisi (Saat 03:00 varoluşsal düşünceleri, derin felsefe) +> 4. `calm`: Sakin & Karalama (Çay/kahve anları, yürüyüş gözlemleri, dinginlik) +> 5. `visual`: Polaroid & Kırıntılar (Fotoğraf açıklamaları, doğa) +> +> **Beklenen Çıktı (Sadece JSON):** +> ```json +> { +> "mood": "spark", +> "moodLabel": "Fikir Patlaması", +> "stampedText": "ONAYLANDI", +> "tags": ["felsefe", "yazılım"], +> "marginNotes": ["← tam olarak bu!", "çayı tazelemeyi unutma ☕"], +> "title": "İsteğe bağlı kısa başlık" +> } +> ``` + +### AI Entegrasyonu Sonrası Tam Akış Şeması: + +``` +[ Telegram Sesli/Metin Mesajı ] + │ + ▼ +[ OpenAI Whisper (Sesli Mesajsa Metne Çevir) ] + │ + ▼ +[ OpenAI GPT-4o-mini (Mood, Kenar Notu, Etiket & Damga Belirle) ] + │ + ▼ +[ POST https://mstfyldz.com/api/posts ] ───► [ PostgreSQL DB ] +``` + --- ## 📦 n8n Hazır Workflow JSON (Import Edilebilir)