| name | revx-telegram |
| description | Revolut X Telegram notification connector. Use when the user asks to "set up Telegram alerts", "add Telegram bot", "manage Telegram connection", "test Telegram notification", or runs revx connector telegram commands.
|
Telegram Connector (revx connector telegram)
Configure Telegram bot integrations for alert notifications from monitors and the grid bot.
Auth required. Make sure revx is installed and configured before running these commands. If any command fails with an auth-related error — Auth not configured, No private key found, Authentication failed (401), Invalid signature, insecure permissions, or a missing key/config file at ~/.config/revolut-x/ — invoke the revx-auth skill immediately and apply the fix yourself. Do not interrupt the user to ask them to run setup. Only escalate to the user for steps only they can perform (pasting the API key, registering the public key in their Revolut X profile, choosing a passphrase). After the fix, retry the original command.
Add a Connection
revx connector telegram add --token <bot-token> --chat-id <chat-id>
revx connector telegram add --token <token> --chat-id <id> --label prod --test
| Flag | Description |
|---|
--token <token> | Telegram Bot API token (required) |
--chat-id <id> | Telegram chat ID (required) |
--label <name> | Connection label (default: "default") |
--test | Send test message after adding |
Behavioral Instructions for Claude
When the user wants to set up Telegram notifications, they need two things: a bot token and a chat ID. If either is missing, walk them through the setup below. Share the relevant steps as a message the user can follow — do not attempt to perform these steps via tools, as they require the user's Telegram app.
Setup Guide: Getting a Bot Token and Chat ID
Share the following instructions with the user when they need help setting up Telegram:
Step 1 — Create a Telegram Bot (to get the bot token):
- Open Telegram (mobile or desktop)
- Search for @BotFather and start a chat
- Send
/newbot
- BotFather will ask for a display name (e.g., "My RevX Alerts") — type any name
- BotFather will ask for a username ending in
bot (e.g., my_revx_alerts_bot) — must be unique
- BotFather replies with your bot token — it looks like
123456789:ABCdefGHI-jklMNOpqrSTUvwxYZ
- Copy the token and share it back here
Step 2 — Get your Chat ID:
- Open Telegram and find your new bot (search for the username you just created)
- Send any message to the bot (e.g., "hello")
- Open this URL in a browser — replace
<YOUR_TOKEN> with the token from Step 1:
https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates
- In the JSON response, find
"chat":{"id": <number>} — that number is your chat ID
- It's usually a positive number for personal chats (e.g.,
123456789) or a negative number for group chats (e.g., -1001234567890)
- Copy the chat ID and share it back here
Step 3 — Add the connection (Claude runs this):
Once the user provides both values, run:
revx connector telegram add --token <bot-token> --chat-id <chat-id> --test
The --test flag sends a test message to verify the connection works. If the test succeeds, the setup is complete.
Troubleshooting:
- "chat not found" or empty
getUpdates response — the user must send a message to the bot first, then retry the URL
- "Unauthorized" — the token is incorrect, ask the user to copy it again from BotFather
- For group chats: the bot must be added to the group as a member, then someone must send a message in the group before
getUpdates shows the group chat ID
Manage Connections
revx connector telegram list
revx connector telegram test <connection-id>
revx connector telegram test <id> --message "Custom test"
revx connector telegram enable <connection-id>
revx connector telegram disable <connection-id>
revx connector telegram delete <connection-id>
How Notifications Work
Once a Telegram connection is configured and enabled:
- Monitor alerts (see
revx-monitor skill) are automatically sent as Telegram messages when triggered
- Grid bot events (see
revx-strategy skill) send notifications on startup, shutdown, fills, and P&L changes
No additional configuration is needed — active monitors and the grid bot detect enabled Telegram connections automatically.
Related Skills
| Skill | Purpose |
|---|
revx-monitor | Set up price/indicator alerts that notify via Telegram |
revx-strategy | Grid bot sends trade notifications via Telegram |
revx-auth | API key setup and configuration |
