Telegram gives you instant push notifications for smart contract alerts directly on your phone or desktop. Setup takes under 2 minutes.
- A Telegram account (download Telegram if you don't have one)
- The Telegram app installed on your phone or desktop
- Log in to your ChainRaven dashboard
- Go to Profile > Integrations
- In the Telegram section, click Connect Telegram
- Click the link that appears to open Telegram
- In Telegram, press Start to link your account
You'll see a confirmation message in Telegram when the connection is successful.
- Go to Profile > Alert Preferences
- Expand each alert type you want delivered via Telegram
- Check the Telegram checkbox
- Click Save Changes
Recommended: Always send a test alert after connecting to confirm everything is working before relying on it for real alerts.
From the Integrations page, click Send Test Message in the Telegram section. You should receive a test alert in your Telegram chat within a few seconds.
Each Telegram alert includes:
- Event type with severity indicator (🔴 Critical, 🟠High, 🟡 Medium, 🔵 Low)
- Contract address and blockchain network
- Event-specific details (addresses, amounts, etc.)
- Link to view the transaction on the block explorer
- Link to open your ChainRaven dashboard
You can interact with the ChainRaven bot using these commands:
| Command | What it does |
|---|
/start | Link your Telegram account |
/help | Show available commands |
/status | Check your connection status |
- Verify you entered the correct bot token in ChainRaven
- Make sure you pressed Start in Telegram after clicking the connect link
- Try disconnecting and reconnecting from the Integrations page
- Go to Alert Preferences and verify Telegram is checked for the alert types you want
- Review your cooldown settings — a high cooldown blocks repeated alerts from the same contract
- Check Sent Alerts in the dashboard to see if alerts were triggered and whether delivery was attempted
- Go to Profile > Integrations
- Click Disconnect in the Telegram section