Telegram
telegramTelegram is a cloud-based messaging app with a focus on security and speed. Build bots to send messages, manage chats, and interact with users.
Acciones disponibles (17)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Answer Callback QueryTELEGRAM_ANSWER_CALLBACK_QUERYAcciónUse this method to send answers to callback queries sent from inline keyboards. the answer will be displayed to the user as a notification at the top of the chat screen or as an alert.
TELEGRAM_ANSWER_CALLBACK_QUERYAcciónUse this method to send answers to callback queries sent from inline keyboards. the answer will be displayed to the user as a notification at the top of the chat screen or as an alert.
Parámetros de entrada
urlstringURL that will be opened by the user's client. If you have created a Game and accepted the conditions via @Botfather, specify the URL that opens your game – note that this will only work if the query comes from a callback_game button.
textstringText of the notification. If not specified, nothing will be shown to the user, 0-200 characters
cache_timeintegerThe maximum amount of time in seconds that the result of the callback query may be cached client-side. Telegram apps will support caching starting in version 3.14. Defaults to 0.
show_alertbooleanIf True, an alert will be shown by the client instead of a notification at the top of the chat screen. Defaults to false.
callback_query_idstringObligatorioUnique identifier for the query to be answered
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete MessageTELEGRAM_DELETE_MESSAGEAcciónDelete a message, including service messages, with certain limitations.
TELEGRAM_DELETE_MESSAGEAcciónDelete a message, including service messages, with certain limitations.
Parámetros de entrada
chat_idintegerObligatorioUnique identifier for the target chat or username of the target channel
message_idintegerObligatorioIdentifier of the message to delete
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Edit MessageTELEGRAM_EDIT_MESSAGEAcciónEdit text messages sent by the bot.
TELEGRAM_EDIT_MESSAGEAcciónEdit text messages sent by the bot.
Parámetros de entrada
textstringObligatorioNew text of the message, 1-4096 characters after entities parsing
chat_idintegerRequired if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel
message_idintegerRequired if inline_message_id is not specified. Identifier of the message to edit
parse_modestringMode for parsing entities in the message text. Options: 'Markdown', 'MarkdownV2', 'HTML'
reply_markupstringJSON-serialized object for an inline keyboard
inline_message_idstringRequired if chat_id and message_id are not specified. Identifier of the inline message
disable_web_page_previewbooleanDisables link previews for links in this message
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Export Chat Invite LinkTELEGRAM_EXPORT_CHAT_INVITE_LINKAcciónGenerate a new primary invite link for a chat; any previously generated primary link is revoked. the bot must be an administrator in the chat for this to work and must have the appropriate administrator rights.
TELEGRAM_EXPORT_CHAT_INVITE_LINKAcciónGenerate a new primary invite link for a chat; any previously generated primary link is revoked. the bot must be an administrator in the chat for this to work and must have the appropriate administrator rights.
Parámetros de entrada
chat_idintegerObligatorioUnique identifier for the target chat or username of the target supergroup or channel
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Forward MessageTELEGRAM_FORWARD_MESSAGEAcciónForward messages of any kind. service messages can't be forwarded.
TELEGRAM_FORWARD_MESSAGEAcciónForward messages of any kind. service messages can't be forwarded.
Parámetros de entrada
chat_idintegerObligatorioUnique identifier for the target chat or username of the target channel
message_idintegerObligatorioMessage identifier in the chat specified in from_chat_id
from_chat_idintegerObligatorioUnique identifier for the chat where the original message was sent (or channel username in the format @channelusername)
disable_notificationbooleanSends the message silently. Users will receive a notification with no sound.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Chat InfoTELEGRAM_GET_CHATAcciónGet up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.).
TELEGRAM_GET_CHATAcciónGet up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.).
Parámetros de entrada
chat_idintegerObligatorioUnique identifier for the target chat or username of the target supergroup or channel
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Chat AdministratorsTELEGRAM_GET_CHAT_ADMINISTRATORSAcciónGet a list of administrators in a chat. on success, returns an array of chatmember objects that contains information about all chat administrators except other bots.
TELEGRAM_GET_CHAT_ADMINISTRATORSAcciónGet a list of administrators in a chat. on success, returns an array of chatmember objects that contains information about all chat administrators except other bots.
Parámetros de entrada
chat_idintegerObligatorioUnique identifier for the target chat or username of the target supergroup or channel
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Chat HistoryTELEGRAM_GET_CHAT_HISTORYAcciónGet chat history messages. note: this uses the getupdates method with specific parameters to retrieve historical messages.
TELEGRAM_GET_CHAT_HISTORYAcciónGet chat history messages. note: this uses the getupdates method with specific parameters to retrieve historical messages.
Parámetros de entrada
limitintegerLimits the number of messages to be retrieved. Values between 1-100 are accepted. Defaults to 100.
offsetintegerSequential number of the first message to be returned; negative values are allowed. Default is 0.
chat_idintegerObligatorioUnique identifier for the target chat or username of the target supergroup or channel
message_idintegerIdentifier of a message in the chat as a starting point for getting history. If not specified, returns recent messages.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Chat Members CountTELEGRAM_GET_CHAT_MEMBERS_COUNTAcciónGet the number of members in a chat. the bot must be an administrator in the chat for this to work.
TELEGRAM_GET_CHAT_MEMBERS_COUNTAcciónGet the number of members in a chat. the bot must be an administrator in the chat for this to work.
Parámetros de entrada
chat_idintegerObligatorioUnique identifier for the target chat or username of the target supergroup or channel
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Bot InfoTELEGRAM_GET_MEAcciónGet basic information about the bot using the bot api getme method.
TELEGRAM_GET_MEAcciónGet basic information about the bot using the bot api getme method.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get UpdatesTELEGRAM_GET_UPDATESAcciónUse this method to receive incoming updates using long polling. an array of update objects is returned.
TELEGRAM_GET_UPDATESAcciónUse this method to receive incoming updates using long polling. an array of update objects is returned.
Parámetros de entrada
limitintegerLimits the number of updates to be retrieved. Values between 1-100 are accepted. Defaults to 100
offsetintegerIdentifier of the first update to be returned. Must be greater by one than the highest among the identifiers of previously received updates
timeoutintegerTimeout in seconds for long polling. Defaults to 0, i.e. usual short polling. Should be positive, short polling should be used for testing purposes only
allowed_updatesstring[]A JSON-serialized list of the update types you want your bot to receive. Specify an empty list to receive all update types except chat_member
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send DocumentTELEGRAM_SEND_DOCUMENTAcciónSend general files (documents) to a telegram chat using the bot api.
TELEGRAM_SEND_DOCUMENTAcciónSend general files (documents) to a telegram chat using the bot api.
Parámetros de entrada
captionstringDocument caption (may also be used when resending documents by file_id), 0-1024 characters after entities parsing
chat_idintegerObligatorioUnique identifier for the target chat or username of the target channel
documentstringObligatorioFile to send. Pass a file_id as 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 file using multipart/form-data. More info on Sending Files: https://core.telegram.org/bots/api#sending-files
thumbnailstringThumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side
parse_modestringMode for parsing entities in the document caption. Options: 'Markdown', 'MarkdownV2', 'HTML'
reply_markupstringJSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user
reply_to_message_idintegerIf the message is a reply, ID of the original message
disable_notificationbooleanSends the message silently. Users will receive a notification with no sound.
disable_content_type_detectionbooleanDisables automatic server-side content type detection for files uploaded using multipart/form-data
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send LocationTELEGRAM_SEND_LOCATIONAcciónSend point on the map location to a telegram chat using the bot api.
TELEGRAM_SEND_LOCATIONAcciónSend point on the map location to a telegram chat using the bot api.
Parámetros de entrada
chat_idintegerObligatorioUnique identifier for the target chat or username of the target channel
headingintegerFor live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.
latitudenumberObligatorioLatitude of the location
longitudenumberObligatorioLongitude of the location
live_periodintegerPeriod in seconds for which the location will be updated (see Live Locations), should be between 60 and 86400
reply_markupstringJSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user
horizontal_accuracynumberThe radius of uncertainty for the location, measured in meters; 0-1500
reply_to_message_idintegerIf the message is a reply, ID of the original message
disable_notificationbooleanSends the message silently. Users will receive a notification with no sound.
proximity_alert_radiusintegerFor live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send MessageTELEGRAM_SEND_MESSAGEAcciónSend a text message to a telegram chat using the bot api.
TELEGRAM_SEND_MESSAGEAcciónSend a text message to a telegram chat using the bot api.
Parámetros de entrada
textstringObligatorioText of the message to be sent, 1-4096 characters after entities parsing
chat_idintegerObligatorioUnique identifier for the target chat or username of the target channel (in the format @channelusername)
parse_modestringMode for parsing entities in the message text. Options: 'Markdown', 'MarkdownV2', 'HTML'
reply_markupstringJSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.
reply_to_message_idintegerIf the message is a reply, ID of the original message
disable_notificationbooleanSends the message silently. Users will receive a notification with no sound.
disable_web_page_previewbooleanDisables link previews for links in this message
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send PhotoTELEGRAM_SEND_PHOTOAcciónSend photos to a telegram chat using the bot api.
TELEGRAM_SEND_PHOTOAcciónSend photos to a telegram chat using the bot api.
Parámetros de entrada
photostringObligatorioPhoto to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data
captionstringPhoto caption (may also be used when resending photos by file_id), 0-1024 characters after entities parsing
chat_idintegerObligatorioUnique identifier for the target chat or username of the target channel
parse_modestringMode for parsing entities in the photo caption. Options: 'Markdown', 'MarkdownV2', 'HTML'
reply_markupstringJSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user
reply_to_message_idintegerIf the message is a reply, ID of the original message
disable_notificationbooleanSends the message silently. Users will receive a notification with no sound.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send PollTELEGRAM_SEND_POLLAcciónSend a native poll to a telegram chat using the bot api.
TELEGRAM_SEND_POLLAcciónSend a native poll to a telegram chat using the bot api.
Parámetros de entrada
typestringPoll type, 'quiz' or 'regular', defaults to 'regular'
chat_idintegerObligatorioUnique identifier for the target chat or username of the target channel
optionsstring[]ObligatorioA list of answer options, 2-10 strings 1-100 characters each
questionstringObligatorioPoll question, 1-300 characters
is_closedbooleanPass True, if the poll needs to be immediately closed. This can be useful for poll preview.
close_dateintegerPoint in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with open_period.
explanationstringText that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing
open_periodintegerAmount of time in seconds the poll will be active after creation, 5-600. Can't be used together with close_date.
is_anonymousbooleanTrue, if the poll needs to be anonymous, defaults to True
reply_markupstringJSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user
correct_option_idinteger0-based identifier of the correct answer option, required for polls in quiz mode
reply_to_message_idintegerIf the message is a reply, ID of the original message
disable_notificationbooleanSends the message silently. Users will receive a notification with no sound.
explanation_parse_modestringMode for parsing entities in the explanation. Options: 'Markdown', 'MarkdownV2', 'HTML'
allows_multiple_answersbooleanTrue, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to False
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Set Bot CommandsTELEGRAM_SET_MY_COMMANDSAcciónUse this method to change the list of the bot's commands. see https://core.telegram.org/bots#commands for more details about bot commands.
TELEGRAM_SET_MY_COMMANDSAcciónUse this method to change the list of the bot's commands. see https://core.telegram.org/bots#commands for more details about bot commands.
Parámetros de entrada
scopestringJSON-serialized object, describing scope of users for which the commands are relevant. Defaults to BotCommandScopeDefault.
commandsobject[]ObligatorioA list of bot commands to be set as the list of the bot's commands. At most 100 commands can be specified.
language_codestringA two-letter ISO 639-1 language code. If empty, commands will be applied to all users from the given scope, for whose language there are no dedicated commands
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not