Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vibeflow.ai/llms.txt

Use this file to discover all available pages before exploring further.

Telegram Bot API integration for sending messages, photos, documents, polls, locations, managing chats, and receiving updates. Required Configuration:
  • Bot token authentication

​
Setup

1

Create a Telegram Bot

Open Telegram and start a chat with @BotFather. Send /newbot and follow the prompts to choose a name and username for your bot.BotFather will return a bot token that looks like 123456789:ABCdefGhIJKlmNoPQRstuVWXyz.
2

Add Bot Token to VibeFlow

In VibeFlow, navigate to Settings > Connectors, select Telegram, and paste your bot token into the connector modal.Your bot token is encrypted by default and stored securely.

​
Finding a Chat ID

Most Telegram endpoints require a chat_id to identify which chat to send to. Chat IDs are not visible in the Telegram UI, so you’ll need a helper bot to look them up.
1

For your personal chat ID

Open Telegram and start a chat with @userinfobot. Send any message and it will reply with your numeric user ID — this is the chat_id to use when your bot messages you directly.
2

For a group or channel chat ID

Add @RawDataBot (or @getmyid_bot) to the group or channel. It will post a message containing the chat’s id field — that’s the chat_id. Group chat IDs are negative numbers (e.g. -1001234567890); user IDs are positive.You can remove the helper bot once you have the ID.
3

For a chat with your own bot

Have the user send a message to your bot first, then call POST /api/actions/telegram/get-updates — the response includes chat.id for each incoming message.
Bots can only message users who have started a conversation with them first (by sending /start or any message). For groups, the bot must be added as a member.

​
Available Endpoints

Send a text message to a chat.
Edit a previously sent message.
Delete a message.
Forward a message from one chat to another.
Send a photo to a chat.
Send a document to a chat.
Send a location to a chat.
Send a poll to a chat.
Get information about a chat.
Get the list of administrators in a chat.
Get information about a specific member of a chat.
Get the number of members in a chat.
Get information about the bot.
Receive incoming updates using long polling.
Send a response to a callback query from an inline keyboard button.
Generate a new invite link for a chat.
Set a webhook URL to receive incoming updates.
Retrieve incoming messages.