Telegram
A Raycast extension for viewing and sending messages to your Telegram Saved Messages.
Features
- 📥 View Saved Messages: Browse your Telegram saved messages directly in Raycast
- 📤 Send to Saved Messages: Quickly send notes and messages to yourself
- 🔐 Secure Authentication: Uses official Telegram API with session persistence
Setup
1. Get Telegram API Credentials
Before using this extension, you need to obtain API credentials from Telegram:
- Go to https://my.telegram.org/apps
- Log in with your phone number
- Click on "API development tools"
- Fill in the application details:
- App title: Can be anything (e.g., "Raycast Telegram")
- Short name: Can be anything (e.g., "raycast")
- Platform: Choose any platform
- Click "Create application"
- You'll receive:
- api_id: A numeric ID (e.g., 12345678)
- api_hash: A 32-character hash (e.g., abcdef1234567890abcdef1234567890)
⚠️ Important: Keep these credentials private. Do not share them with anyone.
2. Configure the Extension
- Open Raycast preferences (⌘ + ,)
- Navigate to Extensions → Telegram
- Enter your credentials:
- API ID: The numeric ID from step 1
- API Hash: The 32-character hash from step 1
3. Authenticate
- Run the "Authenticate with Telegram" command in Raycast
- Open Telegram on your phone: Settings > Devices > Link Desktop Device
- Scan the QR code displayed in Raycast (enter your 2-Step Verification password if prompted)
- You're all set! 🎉
The extension remembers your session between commands. If Telegram invalidates or revokes the session, the extension will offer an Authenticate with Telegram action so you can sign in again.
Commands
Authenticate with Telegram
Log in to your Telegram account before using the other commands, or sign in again when your saved session is no longer valid.
View Saved Messages
Browse your Telegram saved messages in a list view. Features:
- Search through your messages
- See message timestamps
- Copy messages to clipboard
- Refresh the list (⌘ + R)
Send to Saved Messages
Quickly send a message to your Telegram saved messages. Perfect for:
- Saving quick notes
- Storing links for later
- Sending reminders to yourself
Privacy & Security
- Your API credentials are stored securely in Raycast preferences
- Your session is stored locally using Raycast's LocalStorage API
- No data is sent to any third-party servers
- The extension connects directly to Telegram's servers
Troubleshooting
"Not Authenticated" Error
If you see this error, run the "Authenticate with Telegram" command to log in.
"Invalid API ID" Error
Make sure you've entered the correct API ID and API Hash in the extension preferences. The API ID should be a number, not a string.
"Failed to Load Messages" Error
If the extension shows Sign In to Telegram, use Authenticate with Telegram to restore access. Telegram has rejected the saved session; the error alone does not identify why it became invalid. Network errors preserve your saved session, so retry the request once connectivity returns.
Future Features
Coming soon:
- View all chats
- Send messages to other users and groups
- Media support (photos, files)
- Message search
- Notifications
License
MIT
