AI Telegram Image Analyzer Agent with OpenAI

Unlock Instant Image Understanding with this AI Agent

This AI Agent seamlessly integrates with Telegram to provide on-demand image analysis powered by OpenAI. When an image is uploaded to your configured Telegram bot, the agent automatically triggers, sends the image to OpenAI's vision API for detailed analysis, and returns a descriptive text back to the user in the same Telegram chat. Its core ability is 'image analysis', making it invaluable for quick visual insights without manual effort.

This workflow is designed for solopreneurs, founders, and technical teams looking to leverage AI for efficient image processing and automated responses within their Telegram communications.

Key Features & Benefits

• AI-Driven Image Analysis: Utilizes OpenAI's advanced vision models (e.g., GPT-4o, GPT-4 Vision) to accurately interpret and describe image content.
• Telegram Integration: Triggers via a Telegram bot when a message with an image is received. Downloads the image for processing.
• Automated Responses: Delivers the AI-generated image description directly to the originating Telegram chat.
• Smart Input Handling: Employs a Switch node to differentiate messages with images from those without. If no image is detected, it sends a polite prompt to the user.
• Streamlined Process: The agent first captures the image from Telegram, then routes it to OpenAI for analysis, and finally composes and sends the result back via Telegram.
• Time-Saving Automation: Eliminates the need for manual image review for many common tasks, boosting productivity.
• Adaptable: Built on n8n, allowing for easy customization and extension to fit more complex use cases.

• An n8n instance (Cloud or self-hosted).
• OpenAI API Key with access to a vision-capable model (e.g., gpt-4o, gpt-4-vision-preview).
• Telegram API credentials (Bot Token).

1. Download the n8n workflow JSON file.
2. Import the workflow into your n8n instance.
3. Configure the 'Get the Image' (Telegram Trigger) node:
   • Under 'Credentials', select or create new 'Telegram API' credentials using your Telegram Bot Token.
   • Ensure 'Updates' is set to 'message' and 'Download' under 'Additional Fields' is enabled.
4. Configure the 'Analyze image' (OpenAI) node:
   • Under 'Credentials', select or create new 'OpenAI API' credentials using your OpenAI API Key.
   • Verify the 'Resource' is 'Image' and 'Operation' is 'Analyze'. Adjust model if needed.
5. Review the 'Switch ( image or not )' node. The default rule checks for the presence of message.photo.
6. Configure the 'Send Content for the Analyzed image' (Telegram) node:
   • Ensure it uses the same Telegram credentials as the trigger node.
   • Verify the Chat ID expression is ={{ $('Get the Image').item.json.message.chat.id }}.
7. Configure the 'Update Telegram Error Message' (Telegram) node:
   • Ensure it uses the same Telegram credentials.
   • Verify the Chat ID expression ={{ $('Get the Image').item.json.message.chat.id }} (Note: This might need to be adjusted if the Switch node splits items in a way that the original trigger data isn't directly available in the 'Empty' path as $json. You might need to use {{ $('Switch ( image or not )').item.json.message.chat.id }} or ensure data is merged if split).
8. Test the workflow by sending an image to your Telegram bot, and then a message without an image.
9. Activate the workflow for continuous operation.