- Telegram Bot
- Getting Started with Telegram Bot
- Did you know?
- Triggers
- Watch Updates
- Restrict a Chat Member
- Promote a Chat Member
- Send a text message or reply
- Kick a Chat Member
- Send an Audio File
- Send a Document or an Image
- Send a Video
- Send a Sticker
- Send an Album
- Send a Video Note
- Send a Photo
- Send a Voice Message
- Delete a Message
- Get the Number of Members in a Chat
- Download a File
- Forward a Message
- Edit a media message
- Edit a Text Message
- Send media by URL or ID
- Searches
- Troubleshooting
Active |
---|
This application does not need additional settings. So you can make connectionUnique, active service acces point to a network. There are different types of connections (API key, Oauth…). More only by using your login credentials or by following the instructions below . |
- A configured Bot via Telegram app. You can download the Telegram Desktop app at desktop.telegram.org.
- In order to use the Telegram app, your mobile phone number has to be provided.
1. Go to https://telegram.me/BotFather.
2. To create a new bot type /newbot
to the message box and press enter.
3. Enter the name of the userCan use the system on a limited basis based on the rights assigned by the admin. More name of your new bot.
You have received the message from BotFather containing the tokenThe API token is a multi-digit code that allows a user to authenticate with cloud applications. More, which you can use to connect Telegram Bot to Boost.spaceCentralization and synchronization platform, where you can organize and manage your data. More IntegratorPart of the Boost.space system, where you can create your connections and automate your processes. More.
To add your bot to your Telegram application, click the link in the message from BotFather or enter it manually to your browser. The link is t.me/yourBotName
.
Follow Step 1 in the Creating a scenario article (choose the Telegram Bot moduleThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More instead of Twitter and Facebook module).
After the module is added to your scenario you can then see the Scenario editor.
Define what functionFunctions you can use in Boost.space Integrator - create, update, delete, get, search. you need your module to have. Here you can choose between three types of modules – TriggersEvery scenario has a trigger, an event that starts your scenario. A scenario must have a trigger. There can only be one trigger for each scenario. When you create a new scenario, the first module you choose is your trigger for that scenario. Create a trigger by clicking on the empty module of a newly created scenario or moving the..., Actions, and Searches.
You can find a lot of sample scenario templatesTemplates are predefined scenarios that you can expand and customize to create new scenarios. You can then share these with friends and colleagues. More with Telegram Bot modulesThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More at www.make.com/en/integrations/telegram.
Use this triggerEvery scenario has a trigger, an event that starts your scenario. A scenario must have a trigger. There can only be one trigger for each scenario. When you create a new scenario, the first module you choose is your trigger for that scenario. Create a trigger by clicking on the empty module of a newly created scenario or moving the... to watch for Telegram updates, such as a new message or a new file.
The Watch updates trigger cannot be combined with the modules, Get Updates or Get Chats.
WebhookA webhook is a way for an app to send real-time information to a specific URL in response to certain events or triggers. |
In order to add a webhook you need to establish a connection to your Telegram bot. Use the token provided by the BotFather (see the steps above, Configuring the Telegram Bot). |
The connection between Telegram Bot and Boost.space Integrator is now established. You can continue with other Telegram Bot actions.
This function allows you to set user rights within a supergroup.
The bot has to be set as the adminAdmins in Boost.space have exclusive access to system settings. They manage the overall system setup, including appearance, language, currency, user settings, and the availability of individual modules to users and teams. More of the corresponding supergroup.
Promote the bot to Admin via the View group info option:
Connection |
Establish a connection to your Telegram Bot using the provided token. |
Chat ID |
You can determine the Chat ID using the Telegram Bot > Watch Updates trigger:
|
User ID |
Enter the ID of the user you want to restrict. User ID can be retrieved with the help of the special Telegram bot userinfobot.
|
Until date |
Set the date that the restrictions will apply til. Valid date formats can be found here (e.g. 06/20/2016 ) |
Set if the user can send messages |
Set Yes if the user is allowed to send messages. Set No to disallow user to send messages in the supergroup. Message can be text message, contact, location and venue. |
Set if the user can send media messages |
Set Yes if the user is allowed to send media messages. Set No to disallow user to send audio files, documents, photos, videos, video notes and voice notes in the supergroup. |
Set if the user can send other messages |
Set Yes if the user is allowed to send other messages. Set No to disallow user to send animations, games, stickers and use inline bots. |
Set if the user can add web page previews |
Set Yes if the user may add web page previews to their messages. |
Use this action to promote or demote a memberCan view and manage items while using existing statuses and labels. More of a supergroup or a channel.
The bot must be an administrator of the corresponding chat with appropriate admin rights.
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
User ID |
To set the User ID follow these instructions |
Set if the administrator can change info |
Select Yes if the administrator can change the chat title, photo and other settings. |
Set if the administrator can create channel posts |
Select Yes if the administrator can create channel posts [channels only]. |
Set if the administrator can edit messages |
Select Yes if the administrator can edit messages of other usersCan use the system on a limited basis based on the rights assigned by the admin. More and can pin messages [channels only]. |
Set if the administrator can delete messages |
Select Yes if the administrator can delete messages of other users [channels only]. |
Set if the administrator can invite users |
Select Yes if the administrator can invite new users to the chat. |
Set if the administrator can restrict membersCan view and manage items while using existing statuses and labels. More |
Select Yes if the administrator can restrict, ban or unban chat members. |
Set if the administrator can pin messages |
Select Yes if the administrator can pin messages [supergroups only]. |
Set if the administrator can promote members |
Select Yes if the administrator can add new administrators with a subset of his own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by him). |
This action sends a message or a reply to your Telegram desktop app.
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
User ID |
To set the User ID follow these instructions |
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: *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: <b>bold</b>, <strong>bold</strong> <i>italic</i>, <em>italic</em> <a href="http://www.example.com/">inline URL</a> <a href="tg://user?id=123456789">inline mention of a user</a> <code>inline fixed-width code</code> <pre>pre-formatted fixed-width code block</pre> |
Disable notification |
Select Yes to send messages silently. iOS users will not receive a notification, Android users will receive a notification with no sound. |
Disable link previews |
Select Yes to disable link previews for links in this message. |
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.:
{"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 page. |
Use this action to kick a user from a channel, group or supergroup.
The bot must be an administrator of the corresponding chat with appropriate admin rights.
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
User ID |
To set the User ID follow these instructions |
Until date |
Set the date, until which the user will be banned from the chat. Valid date formats can be found here (e.g. 06/20/2016 ) |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
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 page.
For example, you can use your Dropbox to process the file. |
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 the duration of the sent video 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.:
{"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 page. |
Content type |
Select or enter the MIME type of data. |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
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 page. |
Parse mode |
Specify how you want your text to be recognized. HTML or Markdown.
Markdown syntax: *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: <b>bold</b>, <strong>bold</strong> <i>italic</i>, <em>italic</em> <a href="http://www.example.com/">inline URL</a> <a href="tg://user?id=123456789">inline mention of a user</a> <code>inline fixed-width code</code> <pre>pre-formatted fixed-width code block</pre> |
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.:
{"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 page. |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
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 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 sent video in seconds. |
Width |
Enter the video width. |
Height |
Enter the video height. |
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.:
{"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 page. |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
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 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. |
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.:
{"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 page. |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
Media |
Select the itemsItems are rows in records (order/request/invoice/purchase...) you want to add to your album. |
Disable notification |
Select Yes to send messages silently. iOS users will not receive a notification, Android users will receive a notification with no sound. |
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.:
{"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 page. |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
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 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. diameter of the video message. |
Duration |
Enter the duration of sent video (in seconds). |
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.:
{"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 page. |
ID of the original message |
ID of the original message if the message is a reply. |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
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 page. |
Parse mode |
Specify how you want your text to be recognized. HTML or Markdown.
Markdown syntax: *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: <b>bold</b>, <strong>bold</strong> <i>italic</i>, <em>italic</em> <a href="http://www.example.com/">inline URL</a> <a href="tg://user?id=123456789">inline mention of a user</a> <code>inline fixed-width code</code> <pre>pre-formatted fixed-width code block</pre> |
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.:
{"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 page. |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
Caption |
Enter the caption of the voice message. |
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 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 sent video in seconds. |
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.:
{"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 page. |
Caution | |
---|---|
Only a message sent less than 48 hours ago can be deleted. |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
Caption |
Enter the caption of the voice message. |
Message ID |
Enter the Message ID. |
Downloads a file from the Telegram server.
Connection |
Establish a connection to your Telegram Bot using the provided token |
File ID |
Enter the ID of the file that has been already uploaded to the Telegram server. |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
From chat ID |
Enter an ID of the chat where the original message was sent. |
Message ID |
Enter the message ID of the message you want to forward. |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
Message ID |
Enter the message ID of the message you want to forward. |
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. |
Parse mode |
Specify how you want your text to be recognized. HTML or Markdown.
Markdown syntax: *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: <b>bold</b>, <strong>bold</strong> <i>italic</i>, <em>italic</em> <a href="http://www.example.com/">inline URL</a> <a href="tg://user?id=123456789">inline mention of a user</a> <code>inline fixed-width code</code> <pre>pre-formatted fixed-width code block</pre> |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
Message ID |
Enter the message ID of the message 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:
*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: <b>bold</b>, <strong>bold</strong> <i>italic</i>, <em>italic</em> <a href="http://www.example.com/">inline URL</a> <a href="tg://user?id=123456789">inline mention of a user</a> <code>inline fixed-width code</code> <pre>pre-formatted fixed-width code block</pre> |
Disable link previews |
Select Yes to disable link previews. |
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.:
{"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 page. |
Connection |
Establish a connection to your Telegram Bot using the provided token |
Chat ID |
To set the Chat ID follow these instructions |
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.:
{"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 page. |
Warning | |
---|---|
The Get Updates method cannot be used while the webhook is active. Delete the webhook first. |
List of possible updates can be found on the Telegram Bot API page.
Connection |
|
limit |
Set the limit of returned updates. Values between 1—100 are accepted. |
offset |
Identifier of the first update to be returned. Must be greater by one integer than the highest among the identifiers of the previously received updates. |
Retrieves a list of administrators from a selected chat.
- Click the right mouse button on the channel name and select the View channel info option.
- Click the Add Member icon next to the member number.
- Start typing the name of your bot in the search field.
- Click on the bot name to select the bot you want to add to the channel.
- Click the INVITE button.
- Make the bot admin by clicking the respective button.
- Assign the permissions to your bot and click the SAVE button.
The bot has been added to the 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.
Now, you can send a message to the public channel using the Send a Text Message or a Reply module.
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.
- Switch the private channel to the public channel, then retrieve the ID (by sending or receiving the message in Boost.space Integrator) 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.
- Log in to your Telegram account via https://web.telegram.org.
- Click on the private channel you want to retrieve the chat ID for.
- 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
- Paste the number to the desired field and add the prefix
-100
- The Chat ID of the private channel is then -100 1424271061.You can now use the ID in the desired Telegram Bot module in Boost.space Integrator.
It is not required. You can sign in on the site, telegram.org/auth where you can change your public settings. You will receive a key in your desktop application to submit your login.
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 errorsService is unavailable due to a failure, a service responds with unexpected data or the validation of input data fails. More.
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)
One possible way to determine the ID of a private channel/group is as follows:
- Create a new scenario
- Place Telegram Bot >; Watch updates module in the scenario.
- Configure the module by creating a webhook.
- Execute the scenario.
- Send a message to the private channel/group.
- Verify the output of the module by clicking the bubble above the module.
- Find the ID in the output bundle: