What this workflow does
This workflow gets messages from Telegram users and reads what they ask about NFTs on OpenSea. It then uses AI to pick the best agent tool to collect live market data and sales info. Finally, it sends clear answers back to Telegram fast. This saves time and stops errors from doing manual NFT checks.
The system tracks conversations so users can ask follow-up questions without losing context. It covers listings, offers, ownership details, trends, and sales volumes—all powered by OpenSea API and AI tools.
Who should use this workflow
This is made for NFT buyers, sellers, and collectors who check OpenSea often. It is good for people who want real-time, easy-to-access market info without switching websites or digging through lots of data.
Users who want faster decisions and fewer missed chances will find this workflow helpful. It works on Telegram, so anyone with a Telegram bot can get instant answers.
Tools and services used
- Telegram Bot API: Receives user messages.
- OpenAI GPT-4o Mini via Langchain: Understands queries and guides data fetching.
- OpenSea API: Provides live marketplace, sales, and NFT metadata.
- n8n automation platform: Connects all nodes and APIs as a workflow.
- Langchain nodes like lmChatOpenAi, memoryBufferWindow, toolWorkflow, and agent: Manage AI conversation, multi-agent calls, and context.
Users may choose to use self-host n8n for better control and security.
Inputs, Processing Steps, and Outputs
Inputs
- Telegram user messages sent to the bot, including commands or questions.
- API credentials to access OpenSea and OpenAI services.
Processing Steps
- The Telegram Trigger node captures user messages and gets chat ID as session ID for context.
- The Adds SessionId Set node assigns the sessionId from chat ID.
- The Opensea Supervisor Brain lmChatOpenAi node processes user text and decides what info to fetch.
- The Opensea Supervisor Memory node keeps recent conversation history.
- Multiple toolWorkflow nodes run agent tools for marketplace analytics, live listings, or NFT metadata.
- The OpenSea AI-Powered Insights Agent node chooses which tools to use and combines their data.
- The Telegram node sends the AI-generated answer back to the Telegram chat.
Outputs
- User receives formatted, data-rich answers directly in Telegram chat.
- Conversation context allows multi-step questions and richer insights.
Beginner step-by-step: How to build this in n8n for production use
Step 1: Import the workflow file
- Click the Download button on this page to get the workflow file.
- Open the n8n editor where the workflow will run.
- Click on the menu and select “Import from File”.
- Choose the downloaded workflow file and load it into n8n.
Step 2: Configure credentials and parameters
- Open each node that uses APIs and enter the required API Keys for OpenSea and OpenAI.
- For the Telegram Trigger and Telegram nodes, add the Telegram Bot API token.
- Make sure workflow IDs in toolWorkflow nodes match your sub-workflows imported.
- If needed, update chat or channel IDs where messages are sent.
Step 3: Test the workflow
- Send a test question to your Telegram bot to verify message capture.
- Check if bot replies with correct, useful OpenSea data.
- Look for errors in execution logs and fix credential or mapping issues.
Step 4: Activate the workflow for production
- Switch the workflow status to active inside n8n.
- Verify messages are processed and answers are returned continuously.
- Optional: Use self-host n8n to run the workflow securely on your own server.
Customization ideas
- Clone and add new agent tools for specific OpenSea data like rarity stats or wallet activity.
- Change the system prompt in the OpenSea AI-Powered Insights Agent to tweak AI style or focus.
- Add richer Telegram responses: images, buttons, or links in outputs.
- Use environment variables for API Key storage and easy workflow migration.
- Build pagination handling in agent workflows to fetch full dataset of large collections.
Edge cases and failures to watch
- Telegram messages do not trigger the workflow if webhook URL is wrong or bot token is invalid.
- Broken conversation context if sessionId is not correctly assigned or passed.
- Incomplete agent data if OpenSea API parameters are wrong or unsupported blockchains used.
- Missing agent responses from wrong workflow IDs or bad parameter mappings.
Always verify each piece and test parts independently before live use.
Pre-production checklist
- Confirm Telegram Bot is set up and webhook URL matches the workflow.
- Test OpenAI GPT-4o Mini output separately.
- Verify all OpenSea agent sub-workflows respond correctly.
- Check sessionId assignment and memory node function.
- Run test queries covering analytics, marketplace, and NFT details.
- Backup the workflow and credentials before deployment.
Deployment guide
Activate the workflow by switching its status on in n8n.
Watch execution history to make sure all queries get answers sent back via Telegram.
Keep API keys updated and agents’ workflows functional.
Use logs to debug any issues with live queries.
Summary of benefits
✓ Saves hours of manual NFT research daily
✓ Sends fast, clear market intelligence via Telegram
✓ Keeps conversation context for complex questions
✓ Combines multiple agent tools for thorough insights
✓ Easy to customize and extend to new OpenSea data
