Telegram Integration

Get instant Telegram notifications with cleanly formatted submission details every time someone fills out your form.

What the Telegram message looks like

Flowqen uses Telegram's sendMessage API with HTML parse mode. Each submission appears as a clean, structured notification in your chat:

Telegram message (HTML parse mode)

New submission: Contact Form

name: Jane Smith

email: jane@example.com

message: I'd like to learn more about your services.

Submitted via Flowqen | 4/3/2026, 12:34 PM

Prerequisites

A Telegram account
A bot created via @BotFather
A group, supergroup, or private chat where the bot is a member
A Flowqen form ready to receive submissions

Setup

Create a bot via @BotFather

Open Telegram and search for @BotFather. Send /newbot, follow the prompts to name your bot, and copy the HTTP API token it gives you.

Get your Chat ID

Add your new bot to the group or channel where you want notifications. Then send a message in that chat and visit the Bot API URL to find your chat_id.

Use this URL to find your chat ID:

Bot API URL

https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates

Configure in Flowqen

Go to your form's Settings tab, then Integrations. Scroll down to the Telegram section and:

Toggle "Enable Telegram notifications" on
Paste your Bot Token and Chat ID
Click Save Settings, then "Send Test Message" to verify

Flowqen dashboard — Telegram integration settings

Payload

Under the hood, Flowqen sends a POST request to the Telegram Bot API. Here's what the structure looks like:

POSThttps://api.telegram.org/bot{token}/sendMessage

sendMessage payload

{
  "chat_id": "-1001234567890",
  "parse_mode": "HTML",
  "text": "<b>New submission: Contact Form</b>\n\n<b>name:</b> Jane Smith\n<b>email:</b> jane@example.com\n<b>message:</b> I'd like to learn more..."
}

The HTML-formatted message body that Telegram renders:

HTML message body

<b>New submission: Contact Form</b>

<b>name:</b> Jane Smith
<b>email:</b> jane@example.com
<b>message:</b> I'd like to learn more about your services.

<i>Submitted via Flowqen | 4/3/2026, 12:34 PM</i>

Good to know

Telegram notifications are fire-and-forget — they never delay or block the form submission
Up to 10 form fields are included in the message (values truncated at 200 characters)
Your bot token is stored securely and never exposed to form submitters
Use the "Send Test Message" button to verify the integration before going live
Works with groups, supergroups, and private chats