Integrations / Messaging

Telegram

Send and edit messages as a Telegram bot, look up chats and members, answer button presses, and trigger workflows from updates the bot receives.

9 tools 15 trigger events

Tools

telegram.send_message writes

Send a text message to a chat. Chat IDs are integers like 123456789 or -1001234567890, or @channelusername for public channels.

chat_id*text*parse_modereply_to_message_idmessage_thread_iddisable_notification

telegram.edit_message_text writes

Replace the text of a message the bot sent earlier, identified by chat ID and integer message ID.

chat_id*message_id*text*parse_mode

telegram.answer_callback_query writes

Acknowledge a press on an inline keyboard button, optionally showing the user a notification or alert.

callback_query_id*textshow_alert

telegram.get_chat

Get up-to-date information about a chat by its ID or @username.

chat_id*

telegram.get_chat_member

Get a user's membership status in a chat, e.g. to check whether they are an administrator. User IDs are integers.

chat_id*user_id*

telegram.set_webhook writes

Register the URL Telegram delivers the bot's updates to, with the secret token it sends back in every delivery. Pass an empty url to remove the webhook.

url*secret_token*allowed_updatesdrop_pending_updates

telegram.get_webhook_info

Get the bot's current webhook URL, pending update count and the last delivery error.

telegram.api_get

Send a GET request to any Telegram API path under https://api.telegram.org/bot{bot_token} and return the response. For endpoints the named tools don't cover.

path*params

telegram.api_request writes

Send a POST, PUT, PATCH or DELETE request to any Telegram API path under https://api.telegram.org/bot{bot_token}.

method*path*paramsbody

Tick Allow raw writes on the connection to add api_request, which can send POST, PUT, PATCH and DELETE requests to any Telegram API path.

Connect

  1. In Telegram, message @BotFather, send /newbot (or /token for an existing bot) and copy the bot token it replies with.
  2. Paste it as the connection's bot token.
  3. To trigger workflows, make up a secret token of 1 to 256 letters, digits, underscores and hyphens, paste it as the connection's webhook secret, then run the set_webhook tool with the request URL shown on the connection page and that same secret.

Credentials

Bot token Webhook secret token

Telegram API docs

Triggers

Run the set_webhook tool with this URL and the secret token you saved on this connection. Telegram then sends the bot's updates here.

Events

messageedited_messagechannel_postedited_channel_postcallback_queryinline_querychosen_inline_resultmessage_reactionpollpoll_answermy_chat_memberchat_memberchat_join_requestpre_checkout_querybusiness_message
 trigger
kind: telegram
connection: telegram
events: [message]
chats: [...]
chat_types: [...]

Your next automation is one sentence away.

14-day free trial with $5 of built-in AI included. Cancel anytime.

Start free trial Talk to us