> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram

> How to set up the Telegram connector, plus the actions and events that are available.

![Telegram](https://stackone-logos.com/api/telegram/filled/svg)

v1.2.0[See changelog](https://docs.stackone.com/connectors/telegram/changelog.md)

[38 actions](#actions) · [28 events](#events) · 1 auth method

Messaging

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [Bot Token · Connector Profile](https://docs.stackone.com/connectors/telegram/guides/connector-profile/bot-token.md)
>
> Create a Telegram bot and obtain the Bot Token from BotFather. Open Telegram, search for @BotFather, send /newbot, follo...

Optionally, configure receiving Events for Telegram into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/telegram/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [Bot Token · Link Account](https://docs.stackone.com/connectors/telegram/guides/link-account/bot-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

38 actions

ActionDescription

Get Bot Info`telegram_get_me`

Get information about the bot

Get Updates`telegram_get_updates`

Get incoming updates for the bot

Get Webhook Info`telegram_get_webhook_info`

Get current webhook status

Set Webhook`telegram_set_webhook`

Set a webhook URL to receive updates

Delete Webhook`telegram_delete_webhook`

Remove the webhook and switch to polling

Answer Callback Query`telegram_answer_callback_query`

Send a response to a callback query from an inline keyboard button

Get Chat`telegram_get_chat`

Get information about a chat

Get Chat Administrators`telegram_get_chat_administrators`

Get a list of administrators in a group or channel

Get Chat Member Count`telegram_get_chat_member_count`

Get the number of members in a chat

Get Chat Member`telegram_get_chat_member`

Get information about a member of a chat

Ban Chat Member`telegram_ban_chat_member`

Ban a user from a chat

Unban Chat Member`telegram_unban_chat_member`

Unban a previously banned user from a chat

Leave Chat`telegram_leave_chat`

Make the bot leave a group, supergroup, or channel

Create Chat Invite Link`telegram_create_chat_invite_link`

Create an additional invite link for a group or channel

Export Chat Invite Link`telegram_export_chat_invite_link`

Get or regenerate the primary invite link for a group or channel

Get File`telegram_get_file`

Get basic information about a file and prepare it for downloading

Get User Profile Photos`telegram_get_user_profile_photos`

Get a list of profile pictures for a user

Send Message`telegram_send_message`

Send a text message to a chat

Forward Message`telegram_forward_message`

Forward a message to another chat

Copy Message`telegram_copy_message`

Copy a message to another chat without a forwarding link

Edit Message Text`telegram_edit_message_text`

Edit the text of a previously sent message

Delete Message`telegram_delete_message`

Delete a message from a chat

Send Photo`telegram_send_photo`

Send a photo to a chat

Send Document`telegram_send_document`

Send a document or file to a chat

Pin Message`telegram_pin_message`

Pin a message in a chat

Unpin Message`telegram_unpin_message`

Unpin a specific message in a chat

Send Audio`telegram_send_audio`

Send an audio file to a chat

Send Video`telegram_send_video`

Send a video file to a chat

Send Animation`telegram_send_animation`

Send an animation (GIF or H.264/MPEG-4 AVC video without sound) to a chat

Send Voice`telegram_send_voice`

Send a voice message to a chat

Send Location`telegram_send_location`

Send a geographic location to a chat

Send Contact`telegram_send_contact`

Send a phone contact to a chat

Send Poll`telegram_send_poll`

Send a native poll to a chat

Send Dice`telegram_send_dice`

Send an animated emoji that displays a random value

Send Chat Action`telegram_send_chat_action`

Send a chat action indicator to show the bot is processing

Delete Messages`telegram_delete_messages`

Delete multiple messages in a chat

Forward Messages`telegram_forward_messages`

Forward multiple messages to another chat

Copy Messages`telegram_copy_messages`

Copy multiple messages to another chat without the original source attribution

## Events

Tags

Select all
|
Clear

Boosts

Business

Channels

Chat Members

Health Checks

Inline Mode

Interactions

Managed Bots

Messages

Payments

Polls

Reactions

No tags found

28 events

EventDescriptionTags

Active Check`telegram_active_check`

Responds with 200 OK to any Telegram webhook delivery that does not carry a recognized update type.

Health Checks

Message`telegram_webhook_message`

Fired when the bot receives a new message of any kind (text, photo, sticker, document, etc.) in a private chat, group, o...

Messages

Edited Message`telegram_webhook_edited_message`

Fired when a message known to the bot is edited.

Messages

Channel Post`telegram_webhook_channel_post`

Fired when a new post is published in a channel where the bot is an administrator.

Channels

Edited Channel Post`telegram_webhook_edited_channel_post`

Fired when a channel post known to the bot is edited.

Channels

Business Connection`telegram_webhook_business_connection`

Fired when the bot is connected to or disconnected from a Telegram Business account, or the connection is edited.

Business

Business Message`telegram_webhook_business_message`

Fired when a connected Telegram Business account receives a new message.

Business

Edited Business Message`telegram_webhook_edited_business_message`

Fired when a message in a connected Telegram Business account is edited.

Business

Deleted Business Messages`telegram_webhook_deleted_business_messages`

Fired when messages are deleted from a connected Telegram Business account.

Business

Guest Message`telegram_webhook_guest_message`

Fired when the bot receives a new guest message.

Messages

Message Reaction`telegram_webhook_message_reaction`

Fired when a user changes their reaction to a message in a chat where the bot is an administrator.

Reactions

Message Reaction Count`telegram_webhook_message_reaction_count`

Fired when anonymous reaction counts on a message change in a chat where the bot is an administrator.

Reactions

Inline Query`telegram_webhook_inline_query`

Fired when a user types an inline query addressed to the bot (@botname query).

Inline Mode

Chosen Inline Result`telegram_webhook_chosen_inline_result`

Fired when a user picks one of the bot's inline query results and sends it to a chat.

Inline Mode

Callback Query`telegram_webhook_callback_query`

Fired when a user presses an inline keyboard button attached to one of the bot's messages.

Interactions

Shipping Query`telegram_webhook_shipping_query`

Fired when a user enters a shipping address for an invoice with a flexible price.

Payments

Pre-Checkout Query`telegram_webhook_pre_checkout_query`

Fired when a user confirms payment and Telegram asks the bot to approve the checkout.

Payments

Purchased Paid Media`telegram_webhook_purchased_paid_media`

Fired when a user purchases paid media with a non-empty payload that the bot sent in a non-channel chat.

Payments

Poll`telegram_webhook_poll`

Fired when the state of a poll changes — only for polls sent by the bot and polls that are manually stopped.

Polls

Poll Answer`telegram_webhook_poll_answer`

Fired when a user changes their answer in a non-anonymous poll sent by the bot.

Polls

My Chat Member`telegram_webhook_my_chat_member`

Fired when the bot's own member status changes in a chat (added, removed, promoted, or blocked).

Chat Members

Chat Member`telegram_webhook_chat_member`

Fired when a member's status changes in a chat where the bot is an administrator (joined, left, promoted, restricted, or...

Chat Members

Chat Join Request`telegram_webhook_chat_join_request`

Fired when a user requests to join a chat where the bot can approve join requests.

Chat Members

Chat Boost`telegram_webhook_chat_boost`

Fired when a boost is added to or changed in a chat where the bot is an administrator.

Boosts

Removed Chat Boost`telegram_webhook_removed_chat_boost`

Fired when a boost is removed from a chat where the bot is an administrator.

Boosts

Managed Bot`telegram_webhook_managed_bot`

Fired when a new bot is created to be managed by this bot, or a managed bot's token or owner changes.

Managed Bots

Subscription`telegram_webhook_subscription`

Fired when a user's payment subscription to the bot changes.

Payments

Stopped Message Generation`telegram_webhook_stopped_message_generation`

Fired when a user asks the bot to stop generating a message.

Messages


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.