---
title: Telegram Bot
slug: telegram
image: https://make-cxp-documentation.ams3.digitaloceanspaces.com/apps-center-icons/PREVIEW_telegram.png
docTags:
createdAt: 2025-02-03T13:28:28.553Z
---
::::VerticalSplit{layout="left"}
:::VerticalSplitItem
::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/_98GU4x-1_q3VB6gZsoXC-20251029-170656.png" size="50" width="800" height="800" position="center" showCaption="false"}
:::
:::VerticalSplitItem
Telegram is a cloud-based instant messaging service that offers secure, encrypted communication, media sharing, and group chat capabilities.
With the Telegram Bot modules in Make, you can manage messages, share various media types, and send media by URL or ID, edit media messages and message captions, download files, and perform other actions.
:::
::::
# Requirements
To use the Telegram Bot app in Make, you must have a [Telegram account on a desktop app](https://desktop.telegram.org). In order to use the Telegram app, you have to provide your mobile phone number.
# Connect Telegram Bot and Make
To create the connection between Telegram Bot and Make, you need to:
::::WorkflowBlock
:::WorkflowBlockItem
[Configure the Telegram Bot](docId\:ZtpIDhOX_U5Qdloxeaeqm).
:::
:::WorkflowBlockItem
[Create the connection in Make](docId\:ZtpIDhOX_U5Qdloxeaeqm).
:::
::::
### Configure the Telegram Bot
::::WorkflowBlock
:::WorkflowBlockItem
Go to [https://telegram.me/BotFather.](https://telegram.me/BotFather)
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/t1pmEkzSOxeeI7tsrFzZl_uuid-e2046bc7-277f-38a1-686c-6810d065a51e.gif" size="58" width="477" height="752" position="center" showCaption="false"}
:::
:::WorkflowBlockItem
To create a new bot type `/newbot` to the message box and press enter.
:::
:::WorkflowBlockItem
Enter the username of your new bot.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/yJArHyEG8u_aPuoeHRdMv_uuid-878f59aa-5050-92ee-e636-177b3670dd05.gif" size="90" width="697" height="501" position="center" showCaption="false"}
:::
:::WorkflowBlockItem
You will receive the message from BotFather containing the token.
:::
:::WorkflowBlockItem
Copy the **token** value and store it in a safe place.
:::
::::
You'll use this value in the **Token** connection field in Make.
To add your bot to your Telegram app, click the link in the message from BotFather or enter it manually into your browser. The link is `t.me/yourBotName`.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/w2Aif9sqxD1NWo6sRCtkZ_uuid-39208449-66c0-5edc-5685-3bafdc8346c3.png" size="84" width="697" height="501" position="center" showCaption="false"}
### Create the connection in Make
Once you have your Telegram Bot token, you're ready to create the connection in Make.
To create the connection:
:::::WorkflowBlock
::::WorkflowBlockItem
Log in to your Make account, add a Telegram Bot module to your scenario, and click **Create a connection**.
:::hint{type="info"}
If you add a module with an instant tag, click **Create a webhook**, then **Create a connection**.
:::
::::
:::WorkflowBlockItem
Optional: In the **Connection name** field, enter a name for the connection.
:::
:::WorkflowBlockItem
In the **Token** field, enter the token you copied from your Telegram Bot account.
:::
:::WorkflowBlockItem
Click **Save**.
:::
:::WorkflowBlockItem
If prompted, authenticate your account and confirm access.
:::
:::::
You've successfully created the connection and can now use the Telegram Bot app in your scenarios. If you want to make changes to your connection in the future, follow the steps [here](https://help.make.com/connect-an-application#tN2pJ).
# Set up a Telegram Bot webhook
The Telegram Bot app has an `instant` **Watch Updates** module that uses a webhook to instantly trigger a scenario in Make following updates in Telegram.
To set up the webhook:
::::WorkflowBlock
:::WorkflowBlockItem
Add an `instant` **Watch Updates **module to your scenario and click **Create a webhook**.
:::
:::WorkflowBlockItem
Optional: Enter a name for the webhook in the **Webhook name** field.
:::
:::WorkflowBlockItem
In the **Connection** field, select a connection for the webhook.
If you haven't created a Telegram Bot connection yet, refer to the [Connect Telegram Bot and Make](docId\:ZtpIDhOX_U5Qdloxeaeqm) section above.
:::
:::WorkflowBlockItem
In the **Token** field, enter the token you copied from your Telegram Bot account.
:::
:::WorkflowBlockItem
Click **Save**.
:::
::::
Your webhook is now set up. When the selected change occurs in Telegram, Make will immediately be notified and start your scenario.
# Telegram Bot modules
After connecting to the Telegram Bot app, you can use the following types of modules to build your scenarios.
## Messages
::::ExpandableHeading
### Send a Text Message or Reply
Sends a text message or a reply to your Telegram Desktop application.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **User ID** | [To set the UserID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Text** | Enter (or map) the text content of the message you want to send. |
| **Message Thread ID** | A Unique identifier for the forum's target message thread (topic). Applicable for forum supergroups only. |
| **Parse mode** | Specify how you want your text to be recognized. HTML or Markdown.
Markdown syntax:
:::BlockQuote
\*bold text\*
\_italic text\_
\[inline URL]\(http\://www\.example.com/)
\[inline mention of a user]\(tg://user?id=123456789)
\`inline fixed-width code\`
\`\`\`block\_language
pre-formatted fixed-width code block
\`\`\`
:::
HTML syntax:
:::BlockQuote
\bold\, \bold\
\italic\, \italic\
\inline URL\
\inline mention of a user\
\inline fixed-width code\
\pre-formatted fixed-width code block\
::: |
| **Disable Notifications** | Select whether you want to send messages silently. iOS users will not receive a notification; Android users will receive a notification with no sound. |
| **Disable Link Previews** | Select whether you want to disable link previews for links in this message. |
| **Original Message ID** | The ID of the original message if the message is a reply. |
| **Enter/Assemble the Reply Markup Field** | Enter additional interface options that are a JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user, e.g.:
:::BlockQuote
\{"inline\_keyboard":\[\[\{"text":"Some button text 2","url":"https\://botpress.org"}]]} or \{"keyboard":\[\["Yes","No"],\["Maybe"]]}
:::
More information about custom keyboards can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
| **Reply Markup** | Enter additional interface options that are a JSON-serialized object, including an inline keyboard, a custom reply keyboard, instructions to remove the reply keyboard, or instructions to force a reply from the user, e.g.
`{"inline_keyboard":[[{"text":"Some button text 2","url":"https://botpress.org"}]]} or {"keyboard":[["Yes","No"],["Maybe"]]}.`
The keyboard cannot be used with channels. |
::::
::::ExpandableHeading
### Edit a Text Message
Edits text or game messages.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Edit** | Select the message type you want to edit. |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message ID** | Enter the Message ID you want to forward. |
| **Text** | Enter (or map) the text content of the message you want to send. |
| **Parse mode** | Specify how you want your text to be recognized. HTML or Markdown.
Markdown syntax:
:::BlockQuote
\*bold text\*
\_italic text\_
\[inline URL]\(http\://www\.example.com/)
\[inline mention of a user]\(tg://user?id=123456789)
\`inline fixed-width code\`
\`\`\`block\_language
pre-formatted fixed-width code block
\`\`\`
:::
HTML syntax:
:::BlockQuote
\bold\, \bold\
\italic\, \italic\
\inline URL\
\inline mention of a user\
\inline fixed-width code\
\pre-formatted fixed-width code block\
::: |
| **Disable Link Previews** | Select whether you want to disable link previews. |
| **Enter/Assemble the Reply Markup Field** | Enter additional interface options that are a JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user, e.g.:
:::BlockQuote
\{"inline\_keyboard":\[\[\{"text":"Some button text 2","url":"https\://botpress.org"}]]} or \{"keyboard":\[\["Yes","No"],\["Maybe"]]}
:::
More information about custom keyboards can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
| **Reply Markup** | Enter additional interface options that are a JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user, e.g.:
:::BlockQuote
\{"inline\_keyboard":\[\[\{"text":"Some button text 2","url":"https\://botpress.org"}]]} or \{"keyboard":\[\["Yes","No"],\["Maybe"]]}
:::
More information about custom keyboards can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page.
Keyboards cannot be used with channels. |
::::
:::ExpandableHeading
### Forward a Message
Forwards messages of any kind. This module can be used to forward messages only within Telegram.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **From chat ID** | Enter the Chat ID where the original message was sent (or channel username in the format @channelusername). |
| **Message ID** | Enter the message ID of the message you want to forward in the `from_chat_id` format. |
| **Disable Notifications** | Select whether you want to send the message silently. iOS users will not receive a notification; Android users will receive a notification with no sound. |
:::
::::ExpandableHeading
### Delete a Message
Deletes a message. A message can only be deleted if it was sent less than 48 hours ago.
:::hint{type="warning"}
Only a message sent less than 48 hours ago can be deleted.
:::
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| -------------- | ---------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message ID** | Enter the Message ID you want to delete. |
::::
:::ExpandableHeading
### Pin a Message
Pins a message.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message ID** | Enter the message ID you want to pin. |
| **Disable Notifications** | Select whether you want to disable the notifications. If selected **Yes**, sends the message silently. iOS users will not receive a notification, Android users will receive a notification with no sound. |
:::
:::ExpandableHeading
### Unpin a Message
Unpins a message.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| -------------- | ---------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message ID** | Enter the message ID you want to unpin. |
:::
## Media
::::ExpandableHeading
### Send an Audio File
Sends an audio file to your Telegram Desktop application.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message Thread ID** | A unique identifier for the target message thread (topic) of the forum. For forum supergroups only. |
| **Caption** | Enter the caption of the audio. |
| **Send by** | Audio file to send. Pass a file\_id as a string to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a string for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. Further details about sending audio files can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page.
For example, you can use your Dropbox to process the file.
:inlineImage[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/1QQEGks6S9THIZPDHl6NW_uuid-7b7320e2-44c4-71af-01a0-312011f67f1a.png" alt caption} |
| **Parse Mode** | Select Markdown-style or HTML-style of the text, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message. |
| **Disable notification** | Select *Yes* to send messages silently. iOS users will not receive a notification, Android users will receive a notification with no sound. |
| **Duration** | Enter duration of sent audio in seconds. |
| **Performer** | Enter a performer. |
| **Title** | Enter a track name. |
| **Reply markup - additional interface options** | Enter additional interface options that are a JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user, e.g.:
:::BlockQuote
\{"inline\_keyboard":\[\[\{"text":"Some button text 2","url":"https\://botpress.org"}]]} or \{"keyboard":\[\["Yes","No"],\["Maybe"]]}
:::
More information about custom keyboards can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
| **Content type** | Select or enter the MIME type of data. |
::::
::::ExpandableHeading
### Send a Document or an Image
Sends a document or an image to your Telegram Desktop application.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message Thread ID** | A unique identifier for the target message thread (topic) of the forum. For forum supergroups only. |
| **Caption** | Enter the caption of the audio. |
| **Send by** | Image file to send. Pass a file\_id as a string to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a string for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Further details about sending files can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
| **Parse mode** | Specify how you want your text to be recognized. HTML or Markdown.
Markdown syntax:
:::BlockQuote
\*bold text\*
\_italic text\_
\[inline URL]\(http\://www\.example.com/)
\[inline mention of a user]\(tg://user?id=123456789)
\`inline fixed-width code\`
\`\`\`block\_language
pre-formatted fixed-width code block
\`\`\`
:::
HTML syntax:
:::BlockQuote
\bold\, \bold\
\italic\, \italic\
\inline URL\
\inline mention of a user\
\inline fixed-width code\
\pre-formatted fixed-width code block\
::: |
| **Disable notification** | Select *Yes* to send messages silently. iOS users will not receive a notification, Android users will receive a notification with no sound. |
| **Content type** | Select or enter the MIME type of data. |
| **ID of the original message** | The ID of the original message if the message is a reply. |
| **Reply markup - additional interface options** | Enter additional interface options that are a JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user, e.g.:
:::BlockQuote
\{"inline\_keyboard":\[\[\{"text":"Some button text 2","url":"https\://botpress.org"}]]} or \{"keyboard":\[\["Yes","No"],\["Maybe"]]}
:::
More information about custom keyboards can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
::::
::::ExpandableHeading
### Send an Album
Sends a group of photos or videos as an album.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Media** | Select the items you want to add to your album. |
| **Message Thread ID** | A unique identifier for the target message thread (topic) of the forum. Applicable only for forum supergroups only. |
| **Disable notification** | Select *Yes* to send messages silently. iOS users will not receive a notification, Android users will receive a notification with no sound. |
| **Enter/Assemble the Reply Markup Field** | Select the option to enter or assemble the reply markup field. |
| **Reply Markup** | Enter additional interface options that are a JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user, e.g.:
:::BlockQuote
\{"inline\_keyboard":\[\[\{"text":"Some button text 2","url":"https\://botpress.org"}]]} or \{"keyboard":\[\["Yes","No"],\["Maybe"]]}
:::
More information about custom keyboards can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
::::
::::ExpandableHeading
### Send a Photo
Sends a photo to your Telegram Desktop application.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message Thread ID** | A unique identifier for the target message thread (topic) of the forum. For forum supergroups only. |
| **Caption** | Enter the caption of the video. |
| **Send by** | Image file to send. Pass a file\_id as a string to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a string for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Further details about sending files can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
| **Parse mode** | Specify how you want your text to be recognized. HTML or Markdown.
Markdown syntax:
:::BlockQuote
\*bold text\*
\_italic text\_
\[inline URL]\(http\://www\.example.com/)
\[inline mention of a user]\(tg://user?id=123456789)
\`inline fixed-width code\`
\`\`\`block\_language
pre-formatted fixed-width code block
\`\`\`
:::
HTML syntax:
:::BlockQuote
\bold\, \bold\
\italic\, \italic\
\inline URL\
\inline mention of a user\
\inline fixed-width code\
\pre-formatted fixed-width code block\
::: |
| **ID of the original message** | ID of the original message if the message is a reply. |
| **Reply markup - additional interface options** | Enter additional interface options that are a JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user, e.g.:
:::BlockQuote
\{"inline\_keyboard":\[\[\{"text":"Some button text 2","url":"https\://botpress.org"}]]} or \{"keyboard":\[\["Yes","No"],\["Maybe"]]}
:::
More information about custom keyboard can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
::::
::::ExpandableHeading
### Send a Sticker
Sends a .webp sticker to your Telegram Desktop application.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message Thread ID** | A unique identifier for the target message thread (topic) of the forum. For forum supergroups only. |
| **Send by** | Image file to send. Pass a file\_id as a string to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a string for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Further details about sending files can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
| **Disable Notifications** | Select *Yes* to send messages silently. iOS users will not receive a notification, Android users will receive a notification with no sound. |
| **Original Message ID** | ID of the original message if the message is a reply. |
| **Reply Markup** | Enter additional interface options that are a JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user, e.g.:
:::BlockQuote
\{"inline\_keyboard":\[\[\{"text":"Some button text 2","url":"https\://botpress.org"}]]} or \{"keyboard":\[\["Yes","No"],\["Maybe"]]}
:::
More information about custom keyboards can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
::::
::::ExpandableHeading
### Send a Video
Sends a video file to your Telegram Desktop Application.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message Thread ID** | A unique identifier for the target message thread (topic) of the forum. For forum supergroups only. |
| **Caption** | Enter the caption of the video. |
| **Send by** | Image file to send. Pass a file\_id as a string to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a string for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Further details about sending files can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
| **Disable notification** | Select *Yes* to send messages silently. iOS users will not receive a notification, Android users will receive a notification with no sound. |
| **Content type** | Select or enter the MIME type of data. |
| **Duration** | Enter the duration of the video sent in seconds. |
| **Width** | Enter the video width. |
| **Height** | Enter the video height. |
| **Enter/Assemble the Reply Markup Field** | Select if to enter or assemble the reply markup field. |
| **Reply Markup** | Enter additional interface options that are a JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user, e.g.:
:::BlockQuote
\{"inline\_keyboard":\[\[\{"text":"Some button text 2","url":"https\://botpress.org"}]]} or \{"keyboard":\[\["Yes","No"],\["Maybe"]]}
:::
More information about custom keyboards can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
::::
:::ExpandableHeading
### Send a Video Note
As of v4.0, Telegram clients support rounded square mp4 videos of up to one minute long. Use this method to send video messages.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message Thread ID** | A unique identifier for the forum's target message thread (topic). For forum supergroups only. |
| **Send by** | Image file to send. Pass a file\_id as a string to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a string for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Further details about sending files can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
| **Disable notification** | Select *Yes* to send messages silently. iOS users will not receive a notification, Android users will receive a notification with no sound. |
| **Content type** | Select or enter the MIME type of data. |
| **Length** | Video width and height, i.e., the diameter of the video message. |
| **Duration** | Enter the duration of the sent video (in seconds). |
| **Original Message ID** | ID of the original message if the message is a reply. |
| **Enter/Assemble the Reply Markup Field** | Select if to enter or assemble the reply markup field. |
| **Reply Markup** | Enter additional interface options that are a JSON-serialized object including an inline keyboard, a custom reply keyboard, instructions to remove the reply keyboard, or instructions to force a reply from the user, e.g.
`{"inline_keyboard":[[{"text":"Some button text 2","url":"https://botpress.org"}]]} or {"keyboard":[["Yes","No"],["Maybe"]]}`
Note: keyboard cannot be used with channels. |
:::
::::ExpandableHeading
### Send a Voice Message
Send a voice message.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message Thread ID** | A unique identifier for the forum's target message thread (topic). For forum supergroups only. |
| **Caption** | Enter the audio caption. |
| **Send by** | Image file to send. Pass a file\_id as a string to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a string for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Further details about sending files can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
| **Disable notification** | Select *Yes* to send messages silently. iOS users will not receive a notification, Android users will receive a notification with no sound. |
| **Content type** | Select or enter the MIME type of data. |
| **Duration** | Enter duration of sent audio in seconds. |
| **Enter/Assemble the Reply Markup Field** | Select whether to enter or assemble the reply markup field. |
| **Reply Markup** | Enter additional interface options that are a JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user, e.g.:
:::BlockQuote
\{"inline\_keyboard":\[\[\{"text":"Some button text 2","url":"https\://botpress.org"}]]} or \{"keyboard":\[\["Yes","No"],\["Maybe"]]}
:::
More information about custom keyboards can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
::::
::::ExpandableHeading
### Edit a Media Message
Edits photo or video messages.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message ID** | Enter the message ID of the message you want to edit. |
| **Media type** | Select whether you want to edit a photo or video. |
| **Caption** | Enter the photo/video caption. |
| **Source file** | Define the source file you want to edit. [More information about working with files](docId\:OAUIOo6OUjV0FYGlzMRte). |
| **Parse mode** | Specify how you want your text to be recognized. HTML or Markdown.
Markdown syntax:
:::BlockQuote
\*bold text\*
\_italic text\_
\[inline URL]\(http\://www\.example.com/)
\[inline mention of a user]\(tg://user?id=123456789)
\`inline fixed-width code\`
\`\`\`block\_language
pre-formatted fixed-width code block
\`\`\`
:::
HTML syntax:
:::BlockQuote
\bold\, \bold\
\italic\, \italic\
\inline URL\
\inline mention of a user\
\inline fixed-width code\
\pre-formatted fixed-width code block\
::: |
| **Enter/Assemble the Reply Markup Field** | Select whether to enter or assemble the reply markup field. |
| **Reply Markup** | Enter additional interface options that are a JSON-serialized object including an inline keyboard, a custom reply keyboard, instructions to remove the reply keyboard or instructions to force a reply from the user, e.g.
`{"inline_keyboard":[[{"text":"Some button text 2","url":"https://botpress.org"}]]} or {"keyboard":[["Yes","No"],["Maybe"]]}`
Keyboard cannot be used with channels. |
::::
::::ExpandableHeading
### Edit a Message Caption
Edits a caption of a message.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Message ID** | Enter the message ID to edit its caption. |
| **Caption** | Enter the caption of the message. |
| **Parse Mode** | Specify how you want your text to be recognized. HTML or Markdown.
Markdown syntax:
:::BlockQuote
\*bold text\*
\_italic text\_
\[inline URL]\(http\://www\.example.com/)
\[inline mention of a user]\(tg://user?id=123456789)
\`inline fixed-width code\`
\`\`\`block\_language
pre-formatted fixed-width code block
\`\`\`
:::
HTML syntax:
:::BlockQuote
\bold\, \bold\
\italic\, \italic\
\inline URL\
\inline mention of a user\
\inline fixed-width code\
\pre-formatted fixed-width code block\
::: |
| **Enter/Assemble the Reply Markup Field** | Select whether to enter or assemble the reply markup field. |
| **Reply Markup** | Enter additional interface options that are a JSON-serialized object including an inline keyboard, a custom reply keyboard, instructions to remove the reply keyboard or instructions to force a reply from the user, e.g. `{"inline_keyboard":[[{"text":"Some button text 2","url":"https://botpress.org"}]]} or {"keyboard":[["Yes","No"],["Maybe"]]`}. Note: keyboard cannot be used with channels. |
::::
:::ExpandableHeading
### Send an Invoice
Sends an invoice.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Title** | Enter the product name for which you want to send invoice. |
| **Description** | Enter the product details. |
| **Payload** | A Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes. |
| **Provide Token** | Payment provider token, obtained via `@BotFather`. |
| **Currency** | Three-letter ISO 4217 currency code, see more on [currencies](https://core.telegram.org/bots/payments#supported-currencies). |
| **Prices** | Add the product label and price details. |
| **Max Tip Amount** | The maximum accepted amount for tips in the smallest units of the currency (integer, not float/double). For example, for a maximum tip of `US$ 1.45` pass `Max Tip Amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0 |
| **Suggested Tip Amounts** | Add the tip amounts suggested for this invoice. |
| **Message Thread ID** | Enter the unique identifier for the target message thread (topic) of the forum (for forum supergroups only). |
| **Start Parameter** | Unique deep-linking parameter. If left empty, forwarded copies of the sent message will have a Pay button, allowing multiple users to pay directly from the forwarded message, using the same invoice. If non-empty, forwarded copies of the sent message will have a URL button with a deep link to the bot (instead of a Pay button), with the value used as the start parameter |
| **Provider data** | A detailed description of required fields should be provided by the payment provider. |
| **Photo URL** | Enter URL address of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. |
| **Need Name** | Select whether if you require the user's full name to complete the order |
| **Need Phone Number** | Select whether if you require the user's phone number to complete the order. |
| **Need Email** | Select whether if you require the user's email address to complete the order. |
| **Need Shipping Address** | Select whether if you require the user's shipping address to complete the order. |
| **Send Phone Number to Provider** | Select whehter if the user's phone number should be sent to the provider. |
| **Send Email to Provider** | Select whether if the user's email address should be sent to the provider. |
| **Is Flexible** | Select whether Pass true if the final price depends on the shipping method. |
| **Disable Notifications** | Select whether you disable notifications. IF so, sends the message silently. iOS users will not receive a notification; Android users will receive a notification with no sound. |
| **Original Message ID** | Enter the ID of the original message. |
| **Enter/Assemble the Reply Markup Field** | Select if to enter or assemble the reply markup field. |
| **Reply Markup** | Enter additional interface options that are a JSON-serialized object including an inline keyboard, a custom reply keyboard, instructions to remove the reply keyboard or instructions to force a reply from the user, e.g.
`{"inline_keyboard":[[{"text":"Some button text 2","url":"https://botpress.org"}]]} or {"keyboard":[["Yes","No"],["Maybe"]]}`
Keyboard cannot be used with channels. |
:::
::::ExpandableHeading
### Send media by URL or ID
Sends a file (document, photo, video, audio, ...) by HTTP URL or by ID that exists on the Telegram servers.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat ID** | [To set the Chat ID, follow these instructions.](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| **Media type** | Select whether you want to edit a photo or video. |
| **Caption** | Enter the photo/video caption. |
| **Send by** | Select a file. Set a file\_id as a string to send a file that exists on the Telegram servers (recommended), or select an HTTP URL as a string for Telegram to get a file from the Internet. |
| **Disable notification** | Select *Yes* to send messages silently. iOS users will not receive a notification, Android users will receive a notification with no sound. |
| **ID of the original message** | ID of the original message if the message is a reply. |
| **Reply markup - additional interface options** | Enter additional interface options that are a JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user, e.g.:
:::BlockQuote
\{"inline\_keyboard":\[\[\{"text":"Some button text 2","url":"https\://botpress.org"}]]} or \{"keyboard":\[\["Yes","No"],\["Maybe"]]}
:::
More information about custom keyboards can be found on the [Telegram Bot API](https://core.telegram.org/bots/api) page. |
::::
:::ExpandableHeading
### Download a File
Downloads a file from the Telegram server.
| **Connection** | [Establish a connection to your Telegram Bot using the provided token](docId\:ZtpIDhOX_U5Qdloxeaeqm) |
| -------------- | ---------------------------------------------------------------------------------------------------- |
| **File ID** | Enter the ID of the file already uploaded to the Telegram server. |
:::
## Chats and Updates
:::ExpandableHeading
### Create a Chat Invite Link
Creates an additional invite link for a chat.
:::
:::ExpandableHeading
### Edit a Chat Invite Link
Edits a non-primary invite link created by the bot.
:::
:::ExpandableHeading
### List Updates
Retrieves a list of updates from the Telegram server. By default, updates starting with the earliest unconfirmed update are returned. If you want to list more, you need to set the offset. This module cannot be used with webhooks. To use this module, you must switch off and remove all your Telegram webhooks.
:::
:::ExpandableHeading
### List Chats
List available Telegram chats. By default, chats starting with the earlier unconfirmed update are returned. If you want to list more, you need to set the offset. This module cannot be used with webhooks. To use this module, you must switch off and remove all your Telegram webhooks.
:::
:::ExpandableHeading
### Revoke a Chat Invite Link
Revokes an invite link created by the bot.
:::
:::ExpandableHeading
### Watch Updates
Triggers when there is a new update from your Telegram Desktop Application.
The Watch updates trigger cannot be combined with the Get Updates or Get Chats modules.
:::
## Members
:::ExpandableHeading
### List Administrators in a Chat
Retrieves a list of administrators from a selected chat.
:::
:::ExpandableHeading
### Get the Number of Members in a Chat
Use this module to get the number of members in a chat.
:::
:::ExpandableHeading
### Kick a Chat Member
Use this method to kick a user from a group, a supergroup, or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights.
:::
:::ExpandableHeading
### Promote a Chat Member
Promotes or demotes a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights.
:::
:::ExpandableHeading
### Restrict a Chat Member
Restricts a user in a supergroup.
:::
## Other
:::ExpandableHeading
### Make an API Call
Performs an arbitrary authorized API call.
:::
:::ExpandableHeading
### Answer an inline Query
Sends an answer to an inline query.
:::
# Templates
You can look for Telegram Bot templates in [Make's template gallery](https://www.make.com/en/templates), where you'll find thousands of pre-created scenarios.
## Troubleshooting
Check the following procedures if you are facing difficulties when using the Telegram bot app.
:::ExpandableHeading
### How to find out the ID of a private channel/group
One possible way to determine the ID of a private channel/group is as follows:
1. Create a new Make
2. Place Telegram Bot >; Watch updates module in the Make.
3. Configure the module by creating a webhook.
4. Execute the Make.
5. Send a message to the private channel/group.
6. Verify the output of the module by clicking the bubble above the module.
7. Find the ID in the output bundle:
:::
:::ExpandableHeading
### How to find out the user ID
To find out the ID of a Telegram user, forward their message to the **userinfobot**. Check out the following procedure for steps on how to do that:
1. Add the **userinfobot** to your Telegram app. You can do that by entering `@userinfobot` in the search bar and selecting the **userinfobot**.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/0VPbDgCpySndCOJ3cQdWs_uuid-065f8e7b-39f9-3de5-8198-507b827e4e02.gif" size="100" width="697" height="501" position="center" showCaption="false" indent="2"}
2. Go to the chat with the user you want to retrieve the ID from.
3. Forward his message to **userinfobot.**
4. Copy the User ID and paste it to the Make module.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/6CC_kxYin115C9S04DpxY_uuid-6a10ce31-221e-5b94-aef4-bc6d7a8b93d1.png" size="100" width="695" height="500" position="center" showCaption="false" indent="2"}
:::
:::ExpandableHeading
### Adding Your Bot To the Channel
1. Click the right mouse button on the channel name and select the *View channel info* option*.*
2. Click the *Add Member* icon next to the member number.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/mYHa6NbzIdGANySQp8U9J_uuid-05d46f27-b331-f859-4cba-12a7db02453c.png" size="58" width="390" height="437" position="center" showCaption="false" indent="2"}
3. Start typing the name of your bot in the search field.
4. Click on the bot name to select the bot you want to add to the channel.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/Zsfdej-JOfNQnP8y9DkcW_uuid-913c4f24-ee0b-843a-2a3f-ab518d97e0d1.png" size="46" width="361" height="543" position="center" showCaption="false" indent="2"}
5. Click the *INVITE* button.
6. Make the bot admin by clicking the respective button.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/mHHqotQOajokzMcZdpWm0_uuid-6a89ecdf-52c5-56c9-fd02-adcdc9f5f718.png" size="54" width="364" height="167" position="center" showCaption="false" indent="2"}
7. Assign the permissions to your bot and click the *SAVE* button.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/21jiUDHYLcM7rXRaIYxez_uuid-1c3f8f03-baaf-1297-73af-eab190d72999.png" size="66" width="362" height="491" position="center" showCaption="false" indent="2"}
The bot has been added to the channel.
:::
:::ExpandableHeading
### Testing a Public Channel
###
To test the public channel you need to obtain the *Chat ID.* The *Chat ID* is part of the channel link.
The *channel name* is **NOT** the channel *link*/*chat ID.*
If the public channel link is, for example, *t.me/IMTtest*, then `@IMTtest` is your ***Chat ID***.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/yjvN5tn8jsYPZ50mSxmOx_uuid-1c64c350-71a9-8b66-bdd3-dc3b8ff08e02.png" size="66" width="359" height="316" position="center" showCaption="false"}
Now, you can send a message to the public channel using the *Send a Text Message or a Reply* module.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/ZnCMZPSNS2jO8_yhSVWyX_uuid-daeb0cb8-a30a-3d3c-a8ac-064a22632779.png" size="76" width="509" height="360" position="center" showCaption="false"}
:::
:::ExpandableHeading
### Testing a Private Channel
You need to obtain the Chat ID to test the private channel. There are three options to retrieve the ID:
- [Retrieve the ID from the web version of Telegram](docId\:ZtpIDhOX_U5Qdloxeaeqm).
- Switch the private channel to the public channel, then retrieve the ID (by sending or receiving the message in Make) and switch back the channel type to *private*.
- Invite the bot `get_id_bot` to your private channel and using the `/my_id@get_id_bot` command.
:::
:::ExpandableHeading
### Retrieving the ID From the Web Version of Telegram
1. Log in to your Telegram account via [https://web.telegram.org](https://web.telegram.org/).
2. Click on the private channel you want to retrieve the chat ID for.
3. Copy the number between the c letter and the underscore from the URL. If the URL is `https://web.telegram.org/#/im?p=c1424271061_11793697872942794544 `then copy the `1424271061`
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/yrQFuE0heO5To1CM0-qJm_image.png" size="100" isUploading="false" width="886" height="393" showCaption="false" indent="2"}
4. Paste the number to the desired field and **add the prefix**`-100`
5. The Chat ID of the private channel is then **-100***1424271061.*
6. You can now use the ID in the desired Telegram Bot module in Make.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/ppWTX8n2YrkZ0fGHSQ_dx_image.png" size="62" width="509" height="362" position="center" showCaption="false"}
:::
:::ExpandableHeading
### Registration and Login
It is not required. You can sign in on the site, [telegram.org/auth](https://my.telegram.org/auth) where you can change your public settings. You will receive a key in your desktop application to submit your login.
:::
:::ExpandableHeading
### My bot is hitting limits, how do I avoid this?
When sending messages inside a particular chat, avoid sending more than one message per second. We may allow short bursts that go over this limit, but eventually you'll begin receiving 429 errors.
If you're sending bulk notifications to multiple users, the API will not allow more than 30 messages per second or so. Consider spreading out notifications over large intervals of 8—12 hours for best results.
Also note that your bot will not be able to send more than 20 messages per minute to the same group.
(source: [https://core.telegram.org/bots/faq#my-bot-is-hitting-limits-how-do-i-avoid-this](https://core.telegram.org/bots/faq#my-bot-is-hitting-limits-how-do-i-avoid-this))
:::