Telegram

discover how to connect engini with telegram to automate notifications, build custom bots, and manage real time communication across your workflows getting started with telegram prerequisites a telegram account you can sign up via the telegram mobile app or desktop client the botfather this is the official telegram bot used to create and manage all other bots retrieve your telegram api token open botfather in telegram search for @botfather in your telegram app start a chat initialize the botfather by sending the command /start and follow the instructions create a new bot send the command /newbot follow the instructions to give your bot a name (how users see it) and a username (its unique id, must end in "bot") copy the api token after the bot is created, botfather will provide an http api token this token is required to authorize the connection in engini configure bot privacy (optional) if you plan to use the bot in groups, send /setprivacey to botfather and set it to disabled so the bot can read all messages in the group connecting engini to telegram enter your engini account at https //app engini io https //app engini io/ navigate to connections page by clicking on the connections on the left side bar or by clicking here https //app engini io/connections click on the "new integration" option located at the top bar choose telegram option from the available applications enter the following details in the “new integration” form and press save connection name enter a meaningful name for your connection bot id when you create a new bot , you’ll receive an bot token copy it and paste it into this field save click on the save button to save your connection triggers watch updates this trigger monitors your telegram bot for real time events, such as new messages, edited posts, or member updates, and starts your workflow instantly destination url this is the webhook endpoint where telegram sends all update notifications engini uses this url to ensure that as soon as an event happens in telegram, your workflow is notified without delay add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions actions create chat invite link this action generates a new primary or additional invite link for a chat, allowing you to automate how users join your groups or channels chat id enter the unique identifier for the target group or channel add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields note admin rights the bot must be added as an admin to the specific group or channel manage invite links permission the bot must be granted the specific permission "invite users via link" within the group settings to generate links get updates this action pulls the most recent messages and interactions sent to your bot that are waiting in its inbox top n enter the number of updates you want to fetch at once if left empty, engini will retrieve all waiting updates offset set the starting point for your list of updates this helps you skip older messages you have already processed add filter click add filter to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add filters note telegram only stores these updates for 24 hours get chat this action retrieves up to date information about a specific chat, such as the title, description, member count, and current settings chat id enter the unique identifier for the chat you want to inspect this can be the id for a private conversation, a group, or a channel get file this action retrieves basic information about a file, such as its size and download path, allowing you to use it in other parts of your flow file id enter the unique identifier for the file you want to access you can typically find this id in the output data of a trigger like watch updates when a user sends an image, document, or video to your bot get administrators in a chat this action retrieves a list of all users who have management rights in a specific group or channel chat id enter the unique identifier for the chat you want to inspect this can be the id for a private conversation, a group, or a channel get the number of members in a chat this action shows you how many people are currently in a group or channel chat id enter the unique identifier for the chat you want to inspect this can be the id for a private conversation, a group, or a channel get me this action provides basic information about your bot, such as its name, username, and id delete a message this action removes a specific message from a chat, group, or channel chat id enter the unique identifier for the chat where the message is located message id enter the unique id of the specific message you want to remove you can map this id from a previous step in your engini flow delete chat invite link this action deactivates and removes an existing invite link from a group or channel chat id enter the unique identifier for the group or channel where the link was created invite link enter the full url of the invite link you want to delete once deleted, users will no longer be able to join using this specific link pin a message this action sticks a specific message to the top of a chat or channel so it is easily visible to everyone chat id enter the unique identifier for the group or channel where you want to pin the message message id enter the unique id of the message you want to stick to the top add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields note admin rights the bot must be an admin in the group or channel to pin messages pin messages permission the bot must have the specific permission to pin messages enabled in its settings unpin a message this action removes a message from the top of a chat or channel chat id enter the unique identifier for the group or channel where you want to pin the message message id enter the unique id of the message you want to stick to the top add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields note admin rights the bot must be an admin in the group or channel to pin messages un pin messages permission the bot must have the specific permission to unpin messages enabled in its settings send a text message this action sends a written message to a specific person, group, or channel through your bot chat id enter the unique identifier for the chat where the message should be sent text type the message you want to send you can use data from previous steps in your engini flow to make the message dynamic add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields send an audio file use this action to send an audio file (music or voice content) to a specific chat, group, or channel via your telegram bot chat id enter the unique identifier of the destination chat this can be a user, group, or channel id you can also select it dynamically from previous steps file id enter the audio file to send add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields send a document use this action to send a document (any file type such as pdf etc ) to a specific chat, group, or channel via your telegram bot chat id enter the unique identifier of the destination chat this can be a user, group, or channel id you can also select it dynamically from previous steps file id enter the audio file to send add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields send a image use this action to send an image to a specific chat, group, or channel via your telegram bot chat id enter the unique identifier of the destination chat this can be a user, group, or channel id you can also select it dynamically from previous steps file id enter the audio file to send add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields send a sticker use this action to send a sticker to a specific chat, group, or channel via your telegram bot chat id enter the unique identifier of the destination chat this can be a user, group, or channel id you can also select it dynamically from previous steps file id enter the audio file to send add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields send a video use this action to send a video file to a specific chat, group, or channel via your telegram bot chat id enter the unique identifier of the destination chat this can be a user, group, or channel id you can also select it dynamically from previous steps file id enter the audio file to send add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields send a video note use this action to send a video note (round video message) to a specific chat, group, or channel via your telegram bot chat id enter the unique identifier of the destination chat this can be a user, group, or channel id you can also select it dynamically from previous steps file id enter the audio file to send add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields send a voice message use this action to send a voice message (audio optimized for playback as a voice note) to a specific chat, group, or channel via your telegram bot chat id enter the unique identifier of the destination chat this can be a user, group, or channel id you can also select it dynamically from previous steps file id enter the audio file to send add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields send an invoice send api request this activity allows you to send a custom api request directly to telegram's bot base url – this is the root url of the api you’re sending the request to relative url – you can specify additional path segments or parameters that need to be added to the end of the automatically generated url this allows you to customize the specific request you want to perform method – select the http method (e g , get, post, put, delete, patch) body type – defines the format of the data in the body of your request commonly used values include application/json (as shown), which means the body will contain a json formatted payload body – contains any data that is being sent to the server add headers – additional metadata about the request, such as the type of data the engini can accept, the length of the request body, and authentication information click on the “add headers” button to add a header click on the headers field to enter the key, and on the value field to enter a value each header consists of a key value pair, where the key is the name of the parameter, and the value is the data associated with that parameter click on the “add” button to add more headers add queries – the query refers to the parameters or data that are included in the url of an http request to provide additional information or instructions to the server click on the “add queries” button to add a query click on the queries field to enter the key, and on the value field to enter a value each query consists of a key value pair, where the key is the name of the parameter, and the value is the data associated with that parameter click on the “add” button to add more queries update a message caption use this action to update the caption of an existing message (such as a photo, video, or document) sent by your telegram bot chat id enter the unique identifier of the destination chat this can be a user, group, or channel id you can also select it dynamically from previous steps message id enter the identifier of the message you want to update this value usually comes from a previous step (for example, after sending a message) add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update a chat invite link use this action to edit an existing invite link for a chat (group or channel) managed by your telegram bot chat id enter the unique identifier of the chat where the invite link was created invite link enter the invite link you want to update this must be an existing invite link created by the bot add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields kick a chat member use this action to remove a user from a group, supergroup, or channel via your telegram bot chat id enter the unique identifier of the chat where the user is a member user id enter the unique identifier of the user you want to remove this value usually comes from a previous step (for example, a trigger or user interaction) add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields promote a chat member use this action to make a user an admin in a group, supergroup, or channel using your telegram bot chat id enter the unique identifier of the chat where the user is a member user id enter the unique identifier of the user you want to remove this value usually comes from a previous step (for example, a trigger or user interaction) add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields restrict a chat member use this action to limit what a user can do in a group or supergroup using your telegram bot chat id enter the unique identifier of the chat where the user is a member user id enter the unique identifier of the user you want to remove this value usually comes from a previous step (for example, a trigger or user interaction) add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields