revx-telegram

Original：🇺🇸 English

Translated

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.

14installs

Sourcerevolut-engineering/revolut-x-api

Added on2026-04-30

NPX Install

npx skill4agent add revolut-engineering/revolut-x-api revx-telegram

SKILL.md Content

View Translation Comparison →

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

bash

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:

bash

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

bash

revx connector telegram list                       # List all connections
revx connector telegram test <connection-id>       # Send test message
revx connector telegram test <id> --message "Custom test"
revx connector telegram enable <connection-id>     # Enable connection
revx connector telegram disable <connection-id>    # Disable connection
revx connector telegram delete <connection-id>     # Delete connection

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

revx-telegram

NPX Install

Tags

SKILL.md Content

Telegram Connector (
`revx connector telegram`
)

Add a Connection

Behavioral Instructions for Claude

Setup Guide: Getting a Bot Token and Chat ID

Manage Connections

How Notifications Work

Related Skills

revx-telegram

NPX Install

Tags

SKILL.md Content

Telegram Connector (revx connector telegram)

Add a Connection

Behavioral Instructions for Claude

Setup Guide: Getting a Bot Token and Chat ID

Manage Connections

How Notifications Work

Related Skills

Telegram Connector (
`revx connector telegram`
)