Search Amazon Products in Telegram with a Gemini Assistant

# 🛒 Intelligent Telegram Shopping Assistant Bot ## 📱 INPUT SECTION Sticky Note: "Message Entry Point" - Receives all incoming Telegram messages - Triggers the entire workflow - Webhook-based activation --- ## 🧹 PREPROCESSING SECTION Sticky Note: "Query Cleanup & Preparation" - Removes platform mentions (Amazon, Flipkart) - Strips punctuation and normalizes text - Prepares search-ready query format --- ## 🤖 INTENT CLASSIFICATION SECTION Sticky Note: "Smart Message Routing" - AI determines if message is product-related - Returns structured JSON response - Separates shopping from casual chat --- ## 🔀 DECISION ROUTING SECTION Sticky Note: "Workflow Split Point" - Routes to product search OR chat response - Based on AI classification results - Two distinct workflow paths --- ## 💬 CHAT RESPONSE PATH Sticky Note: "Non-Product Conversations" - Handles greetings, questions, casual chat - AI generates helpful responses - Explains bot capabilities when needed --- ## 🛒 PRODUCT SEARCH PATH Sticky Note: "Amazon Product Discovery" - Scrapes Amazon using Apify API - Fetches top 10 matching products - Returns detailed product data --- ## 📊 DATA PROCESSING SECTION Sticky Note: "Product Data Transformation" - Extracts key product information - Standardizes data format - Prepares for AI analysis --- ## 📋 DATA AGGREGATION SECTION Sticky Note: "Combine All Products" - Merges individual product data - Creates single dataset for analysis - Prepares bulk data for recommendations --- ## 🎯 RECOMMENDATION ENGINE SECTION Sticky Note: "Smart Product Analysis" - AI analyzes all products together - Ranks by relevance and value - Generates top 5 recommendations - Formats for Telegram delivery --- ## 📤 OUTPUT SECTIONS Sticky Note: "Message Delivery" - Two separate output paths - Chat responses for non-product queries - Product recommendations for shopping queries - Both deliver to same Telegram chat --- ## 🧠 AI MODELS SECTION Sticky Note: "Google Gemini Integration" - Three specialized AI models - Chat responses, intent detection, product analysis - All powered by Google Gemini - Consistent AI experience across workflow