Static Forms - Secure form backend and form endpoint for contact forms
Native

Telegram Integration

Post every form submission to a Telegram chat, channel, or group

Static Forms has a built-in Telegram integration. Connect a Telegram bot and every form submission is posted as a formatted message to the chat, channel, or group of your choice using the Telegram Bot API.

Pro & Agency Feature

The Telegram integration is available on the Pro and Agency plans (and their trials). Upgrade your plan to unlock this feature.

How It Works

  • Telegram is configured per form, on that form's Delivery settings page — not in global settings.
  • Connect using a Telegram bot token (created via @BotFather) and the chat ID of the chat, channel, or group you want to post into.
  • Each submission is posted as a formatted message to that chat via the Telegram Bot API (sendMessage).
  • Delivery runs in the background and is non-blocking — the submitter's response is never delayed, and your normal email forwarding still happens.
  • Your bot token is stored encrypted and is never shown again after you save it.

Messages don't count toward your quota

Telegram messages are delivered through the Bot API and do not count toward your monthly email quota.

Setup

1

Create a Telegram bot

In Telegram, start a chat with @BotFather and send /newbot. Follow the prompts to name your bot, then copy the bot token it gives you.

2

Send the bot a message

Add the bot to the target channel or group, or open a direct message with it in Telegram. Then send it any message — this creates a conversation record that StaticForms can detect.

Do not use the bot's own ID or @username

The numeric prefix of your bot token (e.g. 123456789 from 123456789:AAH…) is the bot's own user ID, and its @username is its own handle — neither is a valid chat ID. StaticForms will reject both with a clear error. Always use the ID of the chat you want to receive notifications in.

3

Connect on Static Forms

Open your form, then go to Edit → Delivery → Telegram. Paste the bot token — a Find my chat ID link will appear next to the Chat ID field. Click it and StaticForms will detect available chats automatically. Select the one you want and click Connect Telegram.

If auto-detection shows no results, make sure you sent the bot a message in Step 2, then try again. You can also enter the chat ID manually — open this URL in your browser and copy the chat.id value from the JSON:

https://api.telegram.org/botYOUR_TOKEN/getUpdates

Group and channel IDs are negative numbers (e.g. -1001234567890). Direct message IDs are positive.

4

Send a test message

Click Send test message to verify the connection end-to-end. Check your Telegram chat for the test notification.

Managing the Integration

Update credentials

Because the bot token is stored encrypted and never displayed again, re-enter the token if you need to rotate it or point the integration at a different bot. The chat ID can be changed at any time to post to a different chat, channel, or group.

Troubleshooting

  • Bot not in the chat — Make sure the bot has been added to the target channel or group, and that you have started a chat with it for direct messages.
  • Wrong chat ID / "bot can't send messages to the bot" — You may have entered the bot's own user ID (the numeric prefix of the token) instead of your chat ID. Send the bot a message, then call /getUpdates (see Step 2 above) to find the correct chat ID.
  • Invalid or revoked token — Generate a fresh token from @BotFather and re-save it on the Delivery page.
Previous
Discord
Next
Make

Documentation