Telegram Integration | Rooster Docs

Attributes

DestinationsOne Telegram destination per workspace: private chat, group, supergroup, or channel.

ConnectionPrivate chats use Telegram deep links and /start payloads. Groups and channels use short-lived /connect codes.

Eventsubmission.created after a linked website or hosted form submission is saved.

ControlsSubmission details, field privacy, notification prefixes, source links, delivery logs, and test messages.

Setup

Open Integrations in the dashboard.
Find Telegram in Available.
Click Connect.
Select Private chat, Group or supergroup, or Channel.
Generate a connection.
Follow the Telegram link or copy the /connect command into the destination.
Return to Rooster and refresh the integration status.
Send a test message.

After Telegram is connected, it appears in your account's connected integrations, but it only receives submissions from websites or hosted forms where you link it.

Bot Commands

/start connects a private chat when it is opened from the Rooster-generated Telegram link.
/connect <code> connects a group, supergroup, or channel after you generate a connection code in Rooster.

Choose Private chat, generate a connection, then open the Telegram link. Telegram opens @roosterhostBot with a signed /start payload. Press Start or send the prefilled command. Rooster connects the destination after Telegram sends that update to the webhook.

Private chat connections cannot be created from a username, phone number, or Telegram user ID alone. The user has to start the bot first, because Telegram bots cannot initiate a new private conversation with someone who has not opened the bot.

Group Or Supergroup

Choose Group or supergroup, generate a connection, add @roosterhostBot to the group, then send the generated /connect <code> command in that group. Rooster validates the short-lived code, stores the group chat_id, and replies in Telegram when the connection succeeds.

The person connecting the group should be allowed to add bots and send the command in that chat. If the group later blocks or removes the bot, Rooster marks the integration as needing attention.

Channel

Choose Channel, generate a connection, add @roosterhostBot as a channel admin with permission to post messages, then publish the generated /connect <code> command in the channel. Rooster verifies the code and destination, stores the channel chat_id, and uses that channel for future notifications.

Channel usernames alone are not enough for setup. Rooster needs the webhook update from Telegram so it can verify the destination and save the correct channel identifier.

How To Use It

After Telegram is connected and linked to a source, Rooster sends a submission.created notification after that source saves a submission.

Use Show submission details in Telegram to decide whether messages include submitted field values. You can hide sensitive fields, allow only specific fields, add a message prefix, and add notification rules that only post when a field matches a value.

Send a test message after setup. A successful test confirms the bot can still post to the selected private chat, group, supergroup, or channel.

Link Telegram To A Website Or Hosted Form

To send website submissions to Telegram:

Open Websites.
Open the website action menu.
Choose Link integration or View integration.
Click Add integration if you are viewing existing links.
Choose Telegram from the dropdown.
Review the Telegram settings for that website, including submission details, hidden fields, allowlisted fields, prefixes, and notification rules.
Click Link integration.

The website must have a valid connected domain before Telegram can be linked.

To send hosted form submissions to Telegram:

Open Form builder.
Open the hosted form action menu.
Choose Link integration or View integration.
Click Add integration if you are viewing existing links.
Choose Telegram from the dropdown.
Review the Telegram settings for that hosted form, including submission details, hidden fields, allowlisted fields, prefixes, and notification rules.
Click Link integration.

The hosted form must be published before Telegram can be linked.

Manage Or Remove Telegram

Open Integrations, then click Manage Telegram to review the connected destination, update message settings, send a test message, reconnect, disable delivery, or disconnect Telegram from your account.

From a website or hosted form's View integration modal, use the edit icon to change Telegram settings only for that source. Use the delete icon to remove Telegram from that source only.

Message Content

When submission details are disabled, Telegram messages include safe metadata only: form, website, source page, submitted time, and a dashboard button.

When enabled, Rooster adds submitted fields, truncates long values, summarizes arrays and nested values, and hides sensitive field names such as password, token, secret, SSN, and card numbers by default.

Health And Retries

Telegram delivery attempts are logged with status, response code, response time, and a short sanitized response preview. Retryable failures are retried with backoff. Bot blocks, missing chats, permission failures, and repeated failures surface reconnect warnings in the dashboard.