Telegram Integration
Send an automatic Telegram message to yourself, a group, or a channel whenever a form submission arrives.
Step 1 — Create a Bot
- Open Telegram and start a chat with @BotFather
- Send
/newbotand follow the prompts (choose a name and username) - BotFather will reply with a bot token — copy it and paste it into the Telegram Bot Token field in your form's Integrations tab
Step 2 — Get Your Chat ID
Telegram requires a Chat ID to know where to deliver the message.
Method 1: @userinfobot (fastest — for personal chats)
- Search for @userinfobot on Telegram and click Start
- It replies with
Id: 123456789— that number is your Chat ID - Paste it into the Chat ID field in Formboost
Method 2: Bot API (for groups and channels)
- Add your bot to the group or channel and make it an admin
- Send any message in the group/channel
- Open this URL in your browser (replace the token):
https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates
- Find the
chat.idfield in the JSON response — that is your Chat ID
For public channels you can also use the channel username (e.g.
@mychannel) instead of a numeric ID.
What the Message Looks Like
📋 New submission — My Contact Form
name: John Doe
email: [email protected]
message: Hello, I'd like to learn more.
Testing
After saving, click Send Test in the Integrations tab. Your bot should deliver a test message to the configured chat within a few seconds.
If you don't see a message, make sure you've started a conversation with the bot first (send it any message), or that it has been added and promoted to admin in the target group/channel.
Troubleshooting
| Problem | Fix |
|---|---|
| "Chat not found" | Start a conversation with the bot, or confirm the Chat ID is correct |
| Bot is in the group but no messages arrive | Promote the bot to admin in the group/channel settings |
getUpdates returns an empty array | Send a message to the bot/group first, then reload the URL |
| Bot token invalid | Regenerate the token via /token in BotFather |
| Messages stopped | Check if the bot was removed from the group or blocked |
Notes
- Each Formboost form supports one Telegram bot + chat combination. To notify multiple chats, use a separate Telegram bot for each.
- Bot tokens are sensitive — keep them private and rotate via BotFather if exposed.
- Telegram bots cannot initiate conversations; a user must message the bot first before it can send to a private chat.