Telegram stock chart analyst with voice messages

Telegram stock chart analyst with voice messages

An n8n workflow. Send a Telegram bot a stock ticker by text or voice note. An AI agent has Chart-Img draw the chart with
volume, RSI and MACD, gpt-4o reads the picture, and the bot replies with a technical reading and the chart.

What is inside

• workflow.json: the workflow as n8n exports it, 22 nodes in two parts, two of them sticky notes. The top part is the
  bot and its agent. The bottom part, which starts at Workflow Input Trigger, is the chart tool the agent calls. The
  file holds no credential. The two API keys and the chat ID are placeholders, and the agent's tool Get Chart arrives
  empty, so n8n marks it red until you point it at this workflow.
• README.md: these notes.

Before you start

• An n8n instance that Telegram can reach over HTTPS, on n8n Cloud or your own server.
• A Telegram bot token from BotFather, and the chat ID the chart pictures should go to.
• An OpenAI API key.
• A Chart-Img API key.
• A Twelve Data API key.

Set it up

1. In n8n, create a workflow, open its menu and choose Import from File. Pick workflow.json, then save once so the
   workflow has an ID.
2. Add a Telegram API credential with the bot token and select it in Telegram Trigger, Download File,
   Send Analysis and Send Chart.
3. Add an OpenAI credential and select it in OpenAI Chat Model, Transcribe and Technical Analysis.
4. Open Get Chart, the red tool under AI Agent, and choose this same workflow from the list. Its call starts the
   bottom part at Workflow Input Trigger.
5. In Get Chart URL, replace YOUR_CHART_IMG_KEY in the x-api-key header with your Chart-Img key.
6. In Lookup Exchange, replace <YOUR_TWELVE_DATA_KEY> at the end of the address with your Twelve Data key, brackets
   included.
7. In Send Chart, replace YOUR_CHAT_ID with the chat the pictures go to (below).
8. In Telegram Trigger, set Restrict to User IDs under Additional Fields to your own ID, unless others should use it.
9. Save, press Publish and send the bot a ticker.

Where the chart picture goes

Send Chart sits in the bottom part, which receives the ticker and the interval but not the chat. Every picture goes to
the one chat ID you type in, whoever asked. For a bot only you use, put your own ID there: message the bot once while you
test and read message.chat.id in the output of Telegram Trigger.

For a bot several people use, pass the chat along. Add a third input, chatId, to Workflow Input Trigger. In
Get Chart, set it to {{ $('Telegram Trigger').item.json.message.chat.id }}. Then set the Chat ID of Send Chart to
{{ $('Workflow Input Trigger').item.json.chatId }}.

What happens to a message

| Step | Nodes | What happens |
|---|---|---|
| Voice or text | Switch | A voice note goes to Download File and Transcribe, and a text message to Set Text |
| The agent | AI Agent, OpenAI Chat Model, Window Buffer Memory | gpt-4o reads the text with the chat's last five exchanges and calls Get Chart for a ticker |
| The ticker | Check Ticker Format, Lookup Exchange, Parse Interval | A ticker without an exchange, such as AAPL, is looked up on Twelve Data. One with it, such as NASDAQ:AAPL, goes straight on |
| The chart | Get Chart URL, Download Chart | Chart-Img draws a dark chart with volume, RSI and MACD, stores it and returns its address |
| The reading | Technical Analysis | gpt-4o reads the picture and writes a report in seven sections |
| The replies | Send Chart, response, Send Analysis | The picture goes to the chat in Send Chart, the report returns to the agent, and the agent's answer goes to the chat that asked |

The seven sections cover candlesticks, MACD, volume, RSI, support and resistance, short-term takeaways and anything else
the chart shows. The agent also answers general finance questions without a chart, and its prompt has it decline
anything off the topic of markets.

Intervals and exchanges

The agent asks for a weekly chart unless you name an interval. Parse Interval turns your words into a code for
Chart-Img, checking them in this order:

| You say | Code sent |
|---|---|
| 1d or daily | 1D |
| 1w or weekly | 1W |
| 1m, monthly or 1 month | 1M |
| 3m or quarter | 3M |
| 6m or half year | 6M |
| 1y, 1 year or yearly | 1Y |
| 5m, and also 15m, which contains it | 5 |
| 30m | 30 |
| 1h, hourly or 60 | 60 |

Chart-Img's documentation, read on 2 November 2026, lists intraday intervals as 5m, 15m, 30m and 1h. The codes
5, 30 and 60 are not on that list, so an intraday chart may be refused. Daily and longer intervals match it.

Exchanges follow three rules in the code. A ticker that already has a prefix keeps it. After a lookup, Twelve Data's
first match gets NASDAQ: when it trades on NASDAQ and NSE: for any other exchange, NYSE included. A lookup with no
match falls back to NSE:RELIANCE.

Change the result

• Default interval: the agent's system message and Parse Interval, both set to 1W.
• Chart look: the body of Get Chart URL, with its dark theme, its three studies and the MACD signal line's color.
• Report sections: the prompt in Technical Analysis.
• Topics: the guard at the top of the agent's system message.
• Exchanges: the prefix rules near the end of Parse Interval.

Good to know

• Lost interval: when a ticker has no exchange, Parse Interval reads Twelve Data's reply, which carries no interval,
  so the chart is weekly whatever you asked for. Write the exchange in front, as in NSE:INFY, to get the interval.
• No link for the agent: response returns only the report, so a chart link in the agent's answer points nowhere. The
  photo from Send Chart is the chart.
• Picture reading: gpt-4o reads RSI values and price levels off an image, not from price data, and can misread them.
  Nothing the bot says is financial advice.
• Open bot: anyone who finds it spends your OpenAI, Chart-Img and Twelve Data calls until you restrict the trigger.
• Costs: two gpt-4o calls for each chart, a transcription for each voice note, and one Chart-Img and one Twelve Data
  call.
• Long replies: Telegram takes up to 4,096 characters a message, and a longer answer fails at Send Analysis.
• Where the data goes: messages and voice notes go to OpenAI, and tickers go to Twelve Data and Chart-Img. Chart-Img
  keeps each picture at a public address until it expires, after a time set by your plan.