Skip to content

Telegram integration

Get each Formkove submission as a message from your own Telegram bot, in a private chat, a group or a channel. This is a Pro and Agency feature. Free accounts can use it on their first 50 submissions.

You need two things: a bot token and the chat ID of where messages should go.

  1. In Telegram, message @BotFather and send /newbot
  2. Pick a name and a username for the bot
  3. Copy the token BotFather sends back. It looks like 123456789:AAH...
  • Private chat: open your bot and press Start
  • Group: add the bot to the group
  • Channel: add the bot as an administrator that can post messages
  1. Send any message in the chat (in a group, mention the bot so it sees it)
  2. Open https://api.telegram.org/bot<token>/getUpdates in your browser, with your token in place of <token>
  3. Find "chat":{"id": in the response and copy the number. Group and channel IDs start with a minus sign, like -1001234567890

For a public channel you can use its username instead, like @yourchannel.

  1. Open app.formkove.com and select your form
  2. Go to Integrations → Telegram
  3. Paste the bot token and the chat ID and click Connect Telegram
  4. Click Send test on the new connection

The bot token is stored encrypted and never shown again.

Each submission is one message with:

  • Heading: “New submission for” and the form name (“Test submission for” for tests)
  • AI: sentiment and tags, when AI classification is on for the form
  • Fields: each field name and value, up to 800 characters per value. Telegram caps a message at 4,096 characters, so very long submissions are cut; the full one is in your dashboard
  • Files: a download link for each uploaded file, valid for 7 days
  • The submission ID

Link previews are off.

Want only some submissions in this chat? Add routing rules to the connection, by AI result or by any form field.

Problem Fix
“Invalid Telegram bot token” Copy the whole token from BotFather, including the part before the colon
Delivery history shows 400 “chat not found” The chat ID is wrong, or the bot isn’t in that chat. Add the bot and check the ID again
Delivery history shows 403 The bot was removed from the chat or blocked. Add it back, or press Start again in a private chat
Delivery history shows 401 The token was revoked in BotFather. Delete the connection and add it again with the new token
getUpdates returns an empty list Send another message in the chat, mentioning the bot, and reload

Every delivery attempt is listed under Integrations → Delivery history.