Initial commit: Telegram Assistant workflows

2025-12-19 09:54:03 +01:00
commit b789b060ea
12 changed files with 2404 additions and 0 deletions
--- a/SETUP_COMPLETE.md
+++ b/SETUP_COMPLETE.md
@@ -0,0 +1,147 @@
+# Telegram AI Assistant - Setup Complete! 🎉
+
+## ✅ What's Been Created
+
+All 5 workflows have been successfully imported into n8n:
+
+1. **Telegram Assistant - Receiver** - Webhook listener for Telegram messages
+2. **Telegram Assistant - Router** - Command routing and dispatch
+3. **Telegram Assistant - Deck Integration** - Nextcloud Deck task management
+4. **Telegram Assistant - Email Search** - IMAP email search
+5. **Telegram Assistant - AI Chat** - OpenAI-powered chat
+
+## 📍 Next Steps
+
+### 1. Activate Workflows in n8n
+
+Open https://flow.egonetix.de/ and activate each workflow:
+- Click on each workflow
+- Toggle the "Active" switch at the top
+- Verify webhook endpoints are listening
+
+### 2. Configure Telegram Webhook
+
+You need to get your Telegram bot token and set the webhook URL:
+
+```bash
+# Replace <YOUR_BOT_TOKEN> with your actual bot token
+curl -X POST "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook" \
+  -H "Content-Type: application/json" \
+  -d '{"url":"https://flow.egonetix.de/webhook/8f3f59db-aaa5-4762-9416-94be04131fd2"}'
+```
+
+To get your bot token:
+- Open Telegram and search for @BotFather
+- Send `/mybots`
+- Select your bot
+- Click "API Token"
+
+### 3. Test Your Bot
+
+Send these commands to your Telegram bot:
+
+```
+/start          - Welcome message
+/help           - Show all commands
+/deck add Review project proposal by Friday
+/email search invoice
+/ask What's the weather like today?
+```
+
+## 🔧 Credentials Used
+
+The workflows use these existing n8n credentials:
+- **Telegram API**: `Csk5cg4HtaSqP5jJ`
+- **OpenAI API**: `openai_api_key`
+- **IMAP**: `BntHPR3YbFD5jAIM`
+
+If any credentials are missing, add them in n8n Settings → Credentials.
+
+## 📋 Available Commands
+
+### Deck Commands
+- `/deck add <task>` - Add task to Nextcloud Deck
+  - Example: `/deck add Review Q4 reports by tomorrow`
+  - AI extracts: title, description, due date (supports German dates)
+
+### Email Commands
+- `/email search <query>` - Search your inbox
+  - Example: `/email search invoice November`
+- `/email recent` - Show 5 most recent emails
+
+### AI Commands
+- `/ask <question>` - Ask AI anything
+  - Example: `/ask Explain quantum computing`
+
+### Other
+- `/start` - Welcome message
+- `/help` - Show this help
+
+## 🐛 Troubleshooting
+
+### Webhook Not Working
+```bash
+# Check webhook status
+curl "https://api.telegram.org/bot<TOKEN>/getWebhookInfo"
+
+# Verify n8n workflow is active
+curl https://flow.egonetix.de/webhook/8f3f59db-aaa5-4762-9416-94be04131fd2
+```
+
+### Workflows Not Executing
+- Check n8n logs: `docker logs n8n`
+- Verify all workflows are "Active" in n8n UI
+- Check webhook endpoints are green/listening
+
+### Deck Card Creation Fails
+```bash
+# Test bash script manually
+docker exec n8n /home/node/create_card_from_ai.sh "Test Task" "Description" ""
+```
+
+### OpenAI API Errors
+- Verify API key in n8n credentials
+- Check OpenAI quota/billing
+
+## 📁 Project Structure
+
+```
+/home/icke/assistant/
+├── README.md                    # Main documentation
+├── SETUP_COMPLETE.md           # This file
+├── import_workflows.sh          # Import script (already run)
+└── workflows/
+    ├── telegram-receiver.json   # ✅ Imported
+    ├── telegram-router.json     # ✅ Imported
+    ├── telegram-deck.json       # ✅ Imported
+    ├── telegram-email.json      # ✅ Imported
+    └── telegram-ai.json         # ✅ Imported
+```
+
+## 🔐 Security Reminders
+
+⚠️ **Important:**
+- Change n8n password from `changeme`
+- Telegram bot token is sensitive - keep it secret
+- Consider adding user whitelisting (only your Telegram ID)
+- Enable rate limiting if bot becomes public
+
+## 🚀 Future Enhancements
+
+Ideas for expansion:
+- Deck task listing and completion
+- Calendar integration
+- Voice message transcription
+- File uploads to Nextcloud
+- Scheduled reminders
+- Multi-turn conversations with context
+
+## 📖 Full Documentation
+
+See [README.md](README.md) for complete technical details, architecture overview, and development guide.
+
+---
+
+**Status:** ✅ All workflows imported and ready to activate  
+**Date:** 2025-12-02  
+**Location:** /home/icke/assistant/