Connect your app to Telegram

Telegram is a messaging platform that lets your Lovable app communicate with users through chats, groups, and channels. The Telegram connector lets your app send notifications, respond to user messages, and trigger workflows directly from Telegram conversations through a bot you own. Telegram is available as an app + chat connector: one shared connection that works in the chat while you build and in your published apps. With Telegram, your app can:

• Send messages, photos, documents, and other media to users or groups
• Receive and respond to user messages and commands through a webhook
• Create interactive buttons and custom keyboards
• Guide users through workflows such as booking, ordering, or submitting requests
• Deliver alerts, reports, and reminders through chat
• Broadcast updates to Telegram groups or channels

Telegram is a good fit when your app needs to notify users about events, broadcast updates, or let users request information directly through chat.

​

Common use cases and example apps

These examples show what you can build with Telegram, each with a prompt to start from.

​

How Telegram connections work

Each Telegram connection uses a bot token, which represents a single Telegram bot created through @BotFather. Within your Lovable workspace:

• Each connection represents one Telegram bot
• You can create multiple connections if you want to use multiple bots
• Multiple projects can use the same connection

Telegram authenticates with the bot token, not OAuth, so you see no authorization window and the token never needs refreshing. Requests go through Lovable’s connector gateway, which adds the bot token for you. See Gateway-based connectors for details on authentication and usage limits.

​

How to connect Telegram

Who can create Telegram connections depends on your plan and workspace settings. App + chat connectors are available by default on Free, Pro, and Business plans. On Enterprise plans, they are effectively disabled at first: Who can create connections and clients defaults to No one until an admin changes it in Connectors → Admin settings → App + chat connectors. You can create multiple Telegram connections using different bots, which is useful for separating environments (for example, development and production) or running several bots. When the connection is created, you can link it to the projects where you want to use it. Anyone building in a project can ask Lovable in chat to link their project to it.

​

Prerequisites

Before connecting Telegram, make sure you have:

• A Telegram account
• A Telegram bot and its bot token, created with @BotFather
• Permission to create connections in your Lovable workspace (see Who can create connections and clients)

​

Step 1: Create a Telegram bot and get a bot token

Telegram bots are created and managed through @BotFather, Telegram’s official bot management tool. To create a bot and get its token: See Telegram documentation for more: BotFather and the Telegram Bot API.

​

Step 2: Connect Telegram to Lovable

You can create multiple connections using different bot tokens. When connected, anyone building in a project can ask Lovable in chat to link their project to Telegram (based on configured connection-level access). Your Lovable apps can then send and receive Telegram messages through your bot.

​

Receiving messages

To receive messages, your app needs a public endpoint that Telegram calls when someone writes to the bot. When you ask Lovable to handle incoming messages, it creates that endpoint in your project and registers it as the bot’s webhook through the connector gateway. Users then message the bot as they would any other Telegram bot, and your app replies. A bot token can have only one webhook at a time. If you use the same bot in two projects, the most recent webhook registration wins.

​

Limitations

The Telegram connector cannot:

• Create bots or change bot settings such as the name, description, or commands for you. Manage those with @BotFather.
• Refresh or rotate bot tokens automatically. To rotate, revoke the token in @BotFather, create a new one, and update the Lovable connection.
• Support per-end-user Telegram login. Each connection represents a single bot shared across all projects linked to it.

​

Manage your connection

Connections are managed from Connectors: select , then open the connection.

• Unlink projects to remove access from specific projects while keeping the connection available for others. See Unlink projects from a connection for the steps.
• Delete the connection to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use stop working until a new connection is added. See Delete a connection for the steps and who can delete.