Telegram
Send deployment notifications to Telegram
Telegram Provider
Send HTML-formatted notifications to any Telegram chat, group, or channel.
Features
- Clean HTML formatting with bold, code blocks, and links
- Works with private chats, groups, and channels
- Branch, commit, and deployment URL display
- Build error details for failed deployments
- Automatic retry with backoff for rate limits
Setup
Create a Telegram Bot
- Open Telegram and search for @BotFather
- Send
/newbotand follow the prompts - Copy the bot token (looks like
123456789:ABCdefGHI...)
Get Your Chat ID
For a private chat:
- Start a conversation with your bot
- Send any message to the bot
- Visit
https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates - Find
"chat":{"id":123456789}— that's your chat ID
For a group:
- Add the bot to your group
- Send a message in the group
- Visit the getUpdates URL above
- Find the negative chat ID (e.g.,
-1001234567890)
For a channel:
- Add the bot as an admin to your channel
- The chat ID is
@yourchannelor the numeric ID
Redeploy
Redeploy your Versend instance to apply the changes.
Example Output
A successful deployment notification looks like:
✅ Deployment succeeded
Project: myapp
Environment: production
🌿 Branch: main
📝 Commit: abc1234
feat: add new feature
🌐 View DeploymentLinks are clickable and the message uses Telegram's HTML formatting.