How to Connect Telegram to Flowti

Connect Telegram to Flowti to receive messages through a Telegram bot and handle conversations using your Flowti workflows and AI agents.

In this guide, you will create a bot with Telegram's official BotFather, copy its bot token, and use it to enable a new Telegram connection in Flowti.

Before you begin

Make sure you have:

• Access to your Flowti account.
• The Telegram app installed or access to Telegram Web.
• A Telegram account that can create and manage bots.
• An active Flowti flow and agent if you want the bot to reply automatically during the final test.

Important: Your Telegram bot token is a private credential. Anyone with this token may be able to control your bot. Never publish it, include it in screenshots, or share it with unauthorized people.

1. Open Connections in Flowti

From your Flowti dashboard, open the Connections module from the left sidebar. This page displays all the communication channels currently connected to your account.

Click New connection in the upper-right corner.

2. Select Telegram

On the Create connection page, locate and select Telegram. The Telegram card should appear highlighted once selected.

Click Next to continue.

3. Review the Telegram connection form

Flowti will display the information required to connect your Telegram bot:

• Bot token: The private token generated by BotFather.
• Visible name: The name that will identify this connection inside Flowti. This field is optional; if left empty, Flowti will use the bot's name.

You will also find a setup summary on the right side of the page. Keep this Flowti page open while you create the bot in Telegram.

4. Find the official BotFather in Telegram

Open Telegram and search for BotFather.

Select the official, verified account with the username @BotFather. Check the username and verification badge carefully, as other accounts may use similar names.

Open the BotFather conversation or bot-management screen.

5. Create a new Telegram bot

In BotFather, select Create a New Bot. If Telegram displays the standard BotFather chat instead, send the command /newbot.

BotFather will ask you for two values:

1. Bot name: Enter the public display name for your bot, for example, Flowti Support.
2. Bot username: Enter a unique username. It must end in bot, for example, flowti_support_bot.

After the username is accepted, BotFather creates the bot and makes its API token available.

6. Copy the bot token

Open the bot you just created in BotFather. Locate its API token and tap Copy.

The token usually follows a format similar to:

123456789:AAExampleTokenValue

Do not copy extra spaces before or after the token, and do not share it publicly.

7. Connect the bot to Flowti

Return to the Telegram connection form in Flowti and complete the following fields:

1. Paste the token into Bot token.
2. Enter a Visible name to identify the connection inside Flowti. You can leave this field empty if you want Flowti to use the Telegram bot's name.
3. Click Connect Telegram.

Flowti validates the token and configures the webhook automatically. You do not need to configure a webhook manually in Telegram.

8. Verify the connection and test your bot

After the connection is created, Flowti returns you to the Connections page. Your Telegram connection should now appear with a green Connected status.

To test it:

1. Open Telegram using a different Telegram account from the one used to create the bot.
2. Search for the bot using the username you created with BotFather.
3. Open the bot and tap Start if this is the first conversation.
4. Send a test message.
5. Confirm that the conversation appears in Flowti and, if an active flow and agent are assigned to this connection, that the bot replies successfully.

Troubleshooting

Flowti reports that the token is invalid

Copy the token again directly from BotFather and make sure it does not contain spaces or missing characters. If the token was revoked, generate a new one in BotFather and use the new token in Flowti.

The bot does not reply

Make sure you tapped Start before sending the first message. Also verify that the Telegram connection is assigned to an active Flowti flow with an agent configured to respond.

The bot username is unavailable

Telegram bot usernames must be unique and must end in bot. Try a more specific alternative, such as your company name followed by _support_bot.

The token was exposed

Revoke the exposed token in BotFather, generate a new token, and update or reconnect the Telegram channel in Flowti as soon as possible.

Next step

Your Telegram channel is now connected. You can use it in a Flowti flow so your AI agent can receive and respond to Telegram conversations.