rocketkind
Communication

Telegram

Telegram is a messaging app, and this connector acts as one Telegram bot.

Authentication

  • Bot token

Actions

Generic API request. Call any Telegram Bot API method on this connection, for the case where no shipped action covers it yet — getChat, pinChatMessage, sendPhoto by file id, and the rest. The connection supplies the base URL, the bot token and the egress route, so only the method name, query and body are yours to fill.

  • Add sticker to setAdd one sticker to a set the bot created with Create sticker set.
  • Answer button pressAcknowledge a press of one of the bot's inline-keyboard buttons, optionally showing the person a short notification or an alert.
  • Answer guest queryReply to a guest message: a message from a chat the bot is not a member of, where someone summoned it in guest mode.
  • Answer inline queryShow the results for an inline query someone typed after @yourbot in any chat; the person picks one and it is sent into that chat as their message.
  • Answer join request queryDecide a join request the bot is assigned to process: approve it, decline it, or queue it for the chat's other administrators.
  • Answer pre-checkout queryConfirm or refuse a payment after the buyer has entered their payment and shipping details, the last step before they are charged.
  • Answer shipping queryTell a buyer whether the bot can deliver to the shipping address they entered, and offer the shipping options and prices for it.
  • Answer Web App queryFinish a Web App (Mini App) session by sending a message into the chat the Web App was opened from, on behalf of the person using it.
  • Approve join requestDestructiveLet a person into a chat that requires approval to join, answering a request that arrived on the Join request received trigger.
  • Approve suggested postDestructiveAccept a post a user suggested in a channel's direct messages chat, so it is published in the channel — at the senddate given here, or at the date proposed with the post.
  • Ban channel senderDestructiveStop a channel from posting in a supergroup or channel — for people who write as one of their channels rather than as themselves, which Ban chat member cannot reach.
  • Ban chat memberDestructiveRemove a user from a group, supergroup or channel and keep them out: in supergroups and channels they cannot rejoin through invite links until unbanned, and untildate makes the ban temporary.
  • Close forum topicDestructiveClose an open topic in a forum supergroup.
  • Close general topicDestructiveClose the open General topic of a forum supergroup.
  • Convert gift to StarsDestructiveTurn a regular gift a Telegram Business account received into Telegram Stars for that account, giving up the gift.
  • Copy messageCopy one message into another chat as a new message from the bot, with no forward header or link to the original; the caption can be replaced and a keyboard attached.
  • Copy messagesCopy 1-100 messages into another chat as new messages from the bot, with no forward header or link to the originals; albums stay grouped.
  • Create forum topicCreate a topic in a forum supergroup, or in a private chat with a user.
  • Create invite linkCreate an additional invite link for a group, supergroup or channel — named, expiring, capped at a number of members, or requiring approval — without touching the primary link.
  • Create invoice linkCreate a payment link for an invoice that can be shared anywhere, instead of sending the invoice into a chat, optionally as a Telegram Stars subscription renewed every 30 days.
  • Create sticker setCreate a sticker set owned by a user, with its first 1-50 stickers, which the bot can then edit.
  • Create subscription invite linkCreate an invite link to a channel that charges Telegram Stars to join and again every 30 days to stay a member.
  • Decline join requestDestructiveRefuse a person's request to join a chat that requires approval, answering a request that arrived on the Join request received trigger.
  • Decline suggested postDestructiveRefuse a post a user suggested in a channel's direct messages chat, optionally telling its author why.
  • Delete bot commandsDestructiveDelete the bot's command list for one scope of users and one language.
  • Delete business messagesDestructiveDelete up to 100 messages from one chat of a Telegram Business account, on behalf of that account.
  • Delete chat photoDestructiveRemove the current profile photo of a group, supergroup or channel.
  • Delete ephemeral messageDestructiveRemove an ephemeral message — one the bot sent with ephemeralmessageparameters to a single member of a group or supergroup, visible to no one else — for example once the private prompt it carried has been answered.
  • Delete forum topicDestructiveDelete a forum topic together with every message in it, in a forum supergroup or a private chat with a user.
  • Delete messageDestructiveDelete one message from a chat, service messages included — the bot's own, or someone else's where the bot has the rights.
  • Delete messagesDestructiveDelete 1-100 messages from one chat in a single call — to clear a run of status messages or a user's recent posts.
  • Delete sticker from setDestructiveRemove one sticker from a set the bot created.
  • Delete sticker setDestructiveDelete a whole sticker set the bot created, with every sticker in it.
  • Delete storyDestructiveDelete a story the bot posted on behalf of a Telegram Business account that connected it.
  • Download fileDownload a file someone sent the bot — a photo, document, voice note, audio, video or sticker — by the fileid its update carried, and get it back as a file reference any file-taking task accepts, such as a transcription, a document reader or a Telegram send action.
  • Edit checklistDestructiveReplace the title, tasks and settings of a checklist the bot sent with Send checklist on behalf of a connected business account.
  • Edit ephemeral message buttonsDestructiveReplace or remove the inline keyboard under an ephemeral message — one the bot sent with ephemeralmessageparameters to a single member of a group or supergroup, visible to no one else, leaving its content as it is — for example after the user presses one of its buttons.
  • Edit ephemeral message captionDestructiveReplace the caption under the photo, video, animation, audio or document in an ephemeral message — one the bot sent with ephemeralmessageparameters to a single member of a group or supergroup, visible to no one else.
  • Edit ephemeral message mediaDestructiveSwap the photo, live photo, video, animation, audio or document in an ephemeral message — one the bot sent with ephemeralmessageparameters to a single member of a group or supergroup, visible to no one else.
  • Edit ephemeral message textDestructiveReplace the text or rich content of an ephemeral message — one the bot sent with ephemeralmessageparameters to a single member of a group or supergroup, visible to no one else.
  • Edit forum topicDestructiveRename a forum topic or change its custom emoji icon, in a forum supergroup or a private chat with a user.
  • Edit general topicDestructiveRename the built-in General topic of a forum supergroup.
  • Edit invite linkDestructiveChange the name, expiry, member limit or approval requirement of a non-primary invite link the bot created.
  • Edit message buttonsDestructiveReplace or remove the inline keyboard (reply markup) under a message without touching its text or media — to disable buttons once one is pressed, or offer the next set of choices.
  • Edit message captionDestructiveReplace the caption of a media message the bot sent — a photo, video, animation, audio or document — to update the text shown with a file without sending it again.
  • Edit message mediaDestructiveSwap the file in a message the bot sent — a photo, live photo, video, animation, audio or document — or turn a text or rich message into a media message.
  • Edit message textDestructiveReplace the text of a message the bot sent — to update a status line, finish a reply that was posted early, or change the buttons under it.
  • Edit Star subscriptionDestructiveStop a person's Telegram Stars subscription to the bot from renewing, or allow them to renew again after the bot stopped it.
  • Edit storyDestructiveReplace the media, caption and clickable areas of a story the bot posted on behalf of a Telegram Business account.
  • Edit subscription invite linkDestructiveRename a subscription invite link the bot created.
  • Forward messageForward one message into another chat, keeping the forward header that shows where it came from and links back to the original.
  • Forward messagesForward 1-100 messages from one chat into another in a single call, keeping their forward headers and their album grouping.
  • Get available giftsList the gifts the bot can send to users and channel chats, with each gift's price in Telegram Stars, its upgrade price and, for limited gifts, how many remain.
  • Get botRead the bot behind this connection — its numeric id, username and name, plus whether it may join groups, whether privacy mode is off (canreadallgroupmessages) and whether it supports inline queries.
  • Get bot commandsRead the bot's command list for one scope of users and one language — exactly what Set bot commands stored there.
  • Get bot descriptionRead the bot's description — the text shown in an empty chat with the bot — for one user language, or the one shown to users whose language has none of its own.
  • Get bot nameRead the bot's display name for one user language, or the name shown to users whose language has none of its own.
  • Get bot short descriptionRead the bot's short description — the text on its profile page and in shared links — for one user language, or the one shown to users whose language has none of its own.
  • Get business account giftsList the gifts a Telegram Business account that connected the bot has received and owns, filtered by kind and sorted by send date or price, one page at a time.
  • Get business connectionRead a Telegram Business connection by its id: which business account connected the bot, whether the connection is still enabled, and the rights the account granted.
  • Get business Star balanceRead how many Telegram Stars a Telegram Business account that connected the bot holds.
  • Get chatRead the current details of a private chat, group, supergroup or channel: its type, title or name, username, description, primary invite link, default member permissions, pinned message and more.
  • Get chat giftsList the gifts a chat such as a channel owns, filtered by kind and sorted by send date or price, one page at a time.
  • Get chat memberLook up one user's standing in a chat — owner, administrator, member, restricted, left or banned — with the rights or restrictions that come with it.
  • Get custom emoji stickersLook up custom emoji by id and get back the sticker behind each one: its emoji, size, format and the set it belongs to.
  • Get default admin rightsRead the administrator rights the bot suggests when someone adds it as an administrator — the set for groups and supergroups, or the set for channels with forchannels.
  • Get fileLook up a file someone sent the bot — a photo, document or voice message — by the fileid the update carried, and learn its size and download path.
  • Get game high scoresRead the high score table around one player in a game message: that player's row, the two closest neighbors on each side, and the top three players when the player and their neighbors are not among them.
  • Get managed bot access settingsRead who may use a managed bot, one a user created through the bot: whether access is restricted to selected users and, if so, which users besides the owner are allowed.
  • Get managed bot tokenRead the token of a managed bot: a bot a user created by pressing a requestmanagedbot button the bot sent, and that the bot controls.
  • Get member countCount the members of a group, supergroup or channel — for a report, or to check a chat's size before posting to it.
  • Get menu buttonRead the menu button set for one private chat with the bot, or the bot's default menu button when no chat is given.
  • Get personal chat messagesRead the latest messages from a user's personal chat — the channel they currently show on their profile — for example to see what someone publishes before approving them.
  • Get profile audiosList the audio tracks a user has added to their profile, with the total count.
  • Get profile photosList a user's profile pictures, each in up to four sizes, with the total count — for example to put a sender's picture on a ticket.
  • Get Star balanceRead how many Telegram Stars the bot currently holds.
  • Get Star transactionsList the bot's Telegram Star transactions in chronological order: incoming payments from users, refunds, withdrawals and other movements.
  • Get sticker setRead a sticker set by its short name: its title, type and every sticker in it.
  • Get topic icon stickersList the custom emoji that can serve as a forum topic icon — the only icons Create forum topic and Edit forum topic accept in iconcustomemojiid.
  • Get user chat boostsList the boosts one user has added to a chat, each with when it was added, when it expires and where it came from — to check or reward a booster, for example after the Chat boost added or changed trigger starts a workflow.
  • Get user giftsList the gifts a Telegram user owns and hosts, filtered by kind and sorted by send date or price, one page at a time.
  • Get webhook statusCheck where Telegram is delivering the bot's updates and whether delivery is failing: the webhook URL, how many updates are waiting, and the last delivery error.
  • Gift Telegram PremiumDestructiveGive a user a Telegram Premium subscription for 3, 6 or 12 months, paid in Telegram Stars by the bot: 1000 Stars for 3 months, 1500 for 6 and 2500 for 12.
  • Hide general topicDestructiveHide the General topic of a forum supergroup; if it is open, it is closed too.
  • Leave chatDestructiveMake the bot leave a group, supergroup or channel, so it stops receiving that chat's updates and can no longer post there.
  • List chat administratorsList the administrators of a group, supergroup or channel, owner included, each with their custom title and administrator rights.
  • Mark business message readMark an incoming message in a Telegram Business account's chat as read, on behalf of that account, so the customer sees it as read.
  • Move sticker in setDestructiveMove a sticker to a new position in a set the bot created, changing the order people see the set in.
  • Pin messageDestructiveAdd a message to a chat's pinned messages so it stays at the top of the chat — rules, a running status or an announcement.
  • Post storyPost a photo or video story on behalf of a Telegram Business account that connected the bot, with an optional caption and clickable areas; it stays up for 6, 12, 24 or 48 hours before moving to the archive.
  • Promote or demote memberDestructiveMake a user an administrator of a supergroup or channel with the rights set true, or demote an administrator by setting every right false.
  • Refund Star paymentGive back a successful Telegram Stars payment to the person who made it, for example when an order cannot be fulfilled.
  • Regenerate primary invite linkDestructiveGenerate a new primary invite link for a group, supergroup or channel; any previous primary link is revoked.
  • Remove bot profile photoDestructiveRemove the bot's current profile photo.
  • Remove business profile photoDestructiveRemove the current profile photo of a Telegram Business account that connected the bot — the main photo, or the public photo shown when privacy settings hide the main one.
  • Remove chat verificationDestructiveTake back a verification the organization the bot represents gave a chat with Verify chat.
  • Remove group sticker setDestructiveRemove the group sticker set from a supergroup, so the group no longer offers stickers of its own.
  • Remove message reactionDestructiveRemove the reaction one user or chat put on a message in a group or supergroup — for moderation, when a reaction is abusive.
  • Remove reactions by userDestructiveRemove up to 10000 recent reactions one user or chat added across a group or supergroup — to undo a burst of spam reactions from one account in a single call.
  • Remove user verificationDestructiveTake back a verification the organization the bot represents gave a user with Verify user.
  • Rename sticker setDestructiveChange the title people see on a sticker set the bot created, to 1-64 characters.
  • Reopen forum topicDestructiveReopen a topic in a forum supergroup that was closed, for example by Close forum topic.
  • Reopen general topicDestructiveReopen the closed General topic of a forum supergroup; a hidden General topic is unhidden as well.
  • Replace managed bot tokenDestructiveRevoke a managed bot's current token and issue a new one, so anything still holding the old token loses control of that bot.
  • Replace sticker in setDestructiveSwap an existing sticker in a set the bot created for a new one, keeping its position.
  • Repost storyRepost a story from one Telegram Business account to another, when the bot manages both accounts and posted or reposted the original itself.
  • Restrict chat memberDestructiveLimit what one user may do in a supergroup — mute them, or block media or link previews — for a set time or indefinitely, without removing them.
  • Revoke invite linkDestructiveDisable an invite link the bot created, so nobody can join through it any more.
  • Save prepared inline messagePrepare a message that one person can send from a Mini App into a chat they choose, for example to share a result or an invitation.
  • Save prepared keyboard buttonPrepare a keyboard button that one person can use inside a Mini App to pick users or a chat to share with the bot, or to create a bot managed by this one.
  • Send animationSend an animation — a GIF, or an H.264/MPEG-4 AVC video without sound — that Telegram clients show as a GIF in the chat.
  • Send audioSend an audio file that Telegram clients show in their music player, with its title, performer and cover thumbnail.
  • Send chat actionShow a status such as "typing…" in a chat while the bot prepares a reply, so the person knows an answer is coming.
  • Send checklistSend a checklist of 1-30 tasks that people can tick off, on behalf of a connected business account — so businessconnectionid is required and the checklist goes into a chat of that account.
  • Send contactSend a phone contact card to a Telegram chat: a first name and phone number, with an optional last name and further details as a vCard.
  • Send diceSend an animated emoji — a die, darts, basketball, football, bowling or a slot machine — that lands on a random value, for games and draws decided in the chat.
  • Send documentSend a file of any type to a Telegram chat as a downloadable document — a PDF, a spreadsheet, an archive, or an image or video that should arrive as a file rather than be shown inline.
  • Send gameSend one of the bot's games into a chat as a game message with a Play button; games cannot be sent to channels.
  • Send giftSend a gift from the bot to a user or a channel chat, costing the gift's starcount in Telegram Stars paid by the bot.
  • Send invoiceSend an invoice into a chat so a person can pay the bot, in Telegram Stars (currency XTR, providertoken empty, one entry in prices) for digital goods, or through a payment provider otherwise.
  • Send live photoSend a live photo to a Telegram chat: a still photo paired with a video of at most 10 seconds and 10 MB.
  • Send locationSend a point on the map to a Telegram chat, or a live location when liveperiod is set.
  • Send media albumSend 2-10 photos, live photos, videos, documents or audio files as one album, grouped together in the chat.
  • Send messageSend a text message from the bot to a Telegram chat — a private chat, a group, a supergroup topic or a channel.
  • Send paid mediaSend up to 10 photos, live photos or videos that people unlock by paying the number of Telegram Stars set in starcount.
  • Send photoSend a photo to a Telegram chat, shown inline with an optional caption and keyboard.
  • Send pollSend a native poll or quiz with 1-12 answer options to a group, channel or private chat.
  • Send rich messageSend a rich message — structured content with headings, lists, tables, block quotations, collapsible blocks, footnotes, formulas and embedded media — given as Markdown, HTML or explicit blocks.
  • Send stickerSend a sticker to a Telegram chat — a static .WEBP, animated .TGS or video .WEBM sticker — by the fileid of an existing sticker, such as one from a message the bot received, or as a new upload.
  • Send venueSend a venue — a named place with an address, pinned on the map — to a Telegram chat, optionally linked to its Foursquare or Google Places entry.
  • Send videoSend a video that Telegram clients play in the chat, with an optional caption, cover image and start point.
  • Send video noteSend a video note — the round video message Telegram clients play in a circle — from a rounded square MPEG4 video of at most one minute.
  • Send voice messageSend audio that Telegram clients show as a playable voice message, such as a spoken reply produced by a text-to-speech step.
  • Set administrator titleDestructiveGive an administrator of a supergroup a custom title of up to 16 characters, or clear it.
  • Set bot commandsDestructiveReplace the list of commands Telegram suggests when someone types / in a chat with the bot, for everyone or for one scope of users and one language.
  • Set bot descriptionDestructiveChange the bot's description — the text a person sees in the chat with the bot while that chat is still empty.
  • Set bot nameDestructiveChange the bot's display name — the name people see in chats and search — for everyone or for users of one language.
  • Set bot profile photoDestructiveReplace the bot's profile photo with a static JPG image or an animated MPEG4 video.
  • Set bot short descriptionDestructiveChange the bot's short description — the text on the bot's profile page, also sent with the link when someone shares the bot.
  • Set business account bioDestructiveChange the bio shown on the profile of a Telegram Business account that connected the bot.
  • Set business account nameDestructiveChange the first and last name shown on a Telegram Business account that connected the bot.
  • Set business account usernameDestructiveChange the public @username of a Telegram Business account that connected the bot.
  • Set business gift settingsDestructiveChoose which kinds of gifts a Telegram Business account that connected the bot accepts, and whether a gift button always shows in the account's message input field.
  • Set business profile photoDestructiveReplace the profile photo of a Telegram Business account that connected the bot with a static JPG or an animated MPEG4 photo, as the main photo or as the public photo shown when privacy settings hide the main one.
  • Set chat descriptionDestructiveReplace the description of a group, supergroup or channel — the about text on its profile — or clear it with an empty description.
  • Set chat permissionsDestructiveSet what every non-administrator member of a group or supergroup may do — send messages, send each kind of media, create polls, invite users, pin messages and so on.
  • Set chat photoDestructiveReplace the profile photo of a group, supergroup or channel with an image from an earlier step.
  • Set chat titleDestructiveRename a group, supergroup or channel.
  • Set custom emoji set thumbnailDestructiveChoose which custom emoji from a custom emoji set the bot created is shown as the set's thumbnail, or drop the choice so the first emoji is shown.
  • Set default admin rightsDestructiveChoose the administrator rights Telegram suggests when someone adds the bot as an administrator of a group or channel.
  • Set game scoreDestructiveRecord a player's score in one of the bot's games and, unless told not to, update the game message to show the current scoreboard.
  • Set group sticker setDestructiveChoose the sticker set a supergroup offers as the group's own stickers.
  • Set managed bot access settingsDestructiveRestrict a managed bot, one a user created through the bot, to selected users, or lift the restriction.
  • Set member tagDestructivePut a short tag of up to 16 characters on a regular, non-administrator member of a group or supergroup, or clear it.
  • Set menu buttonDestructiveChoose what the bot's menu button does in private chats: open the bot's command list, launch a Web App, or fall back to the default.
  • Set message reactionDestructivePut the bot's reaction on a message — a quick, wordless acknowledgement that a request was seen, or a signal that it failed.
  • Set Passport data errorsDestructiveTell a user that Telegram Passport data they shared with the bot does not meet the service's standards, such as an invalid birth date, a blurry scan or signs of tampering.
  • Set sticker emojiDestructiveReplace the emoji assigned to a regular or custom emoji sticker in a set the bot created.
  • Set sticker keywordsDestructiveReplace the search keywords of a regular or custom emoji sticker in a set the bot created, so people find it by searching those words.
  • Set sticker mask positionDestructiveChange where a mask sticker sits on a face by default: the part of the face it anchors to, how far it is shifted and how much it is scaled.
  • Set sticker set thumbnailDestructiveSet or drop the thumbnail shown for a regular or mask sticker set the bot created.
  • Set user emoji statusDestructiveChange or clear the emoji status shown next to a user's name.
  • Show join request Mini AppShow a Mini App to a person whose join request the bot is assigned to process, so they can complete a step such as a questionnaire before the bot decides.
  • Stop live locationDestructiveEnd a live location the bot is sharing before its liveperiod runs out — for example once a delivery arrives — so the message keeps its last position and Update live location no longer applies to it.
  • Stop pollDestructiveClose a poll the bot sent with Send poll so it takes no more votes — for example when the vote's deadline passes — and read its final results.
  • Stream message draftStream a reply into a private chat while it is still being generated: each call replaces the preview the person sees, and calls with the same draftid animate into one another.
  • Stream rich message draftStream a rich message into a private chat while it is still being generated: each call replaces the preview the person sees, and calls with the same draftid animate into one another.
  • Transfer business Stars to botDestructiveMove Telegram Stars from a Telegram Business account's balance into the bot's own balance, 1-10000 at a time.
  • Transfer giftDestructiveHand a unique gift a Telegram Business account owns to another user.
  • Unban channel senderDestructiveLet a previously banned channel post in a supergroup or channel again, reversing Ban channel sender.
  • Unban chat memberDestructiveLift a ban on a user in a supergroup or channel so they can join again through a link; they are not added back.
  • Unhide general topicDestructiveShow the hidden General topic of a forum supergroup again.
  • Unpin all general topic messagesDestructiveUnpin every pinned message in the General topic of a forum supergroup.
  • Unpin all messagesDestructiveClear every pinned message in a chat at once.
  • Unpin all topic messagesDestructiveUnpin every pinned message in one forum topic, in a forum supergroup or a private chat with a user.
  • Unpin messageDestructiveRemove one message from a chat's pinned messages — the given messageid, or the pinned message with the latest sending date when it is empty.
  • Update live locationDestructiveMove the position shown in a live location message — one sent with Send location and a liveperiod — to track a courier, a vehicle or a person as they move.
  • Upgrade giftDestructiveUpgrade a regular gift a Telegram Business account owns into a unique gift.
  • Upload sticker fileUpload a sticker image, animation or video to Telegram once, so it can go into sticker sets by fileid any number of times.
  • Verify chatMark a chat, such as a channel, a supergroup or a bot, as verified on behalf of the organization the bot represents, optionally with a short description.
  • Verify userMark a user as verified on behalf of the organization the bot represents, optionally with a short description of the verification.

Triggers

  • Bot membership changedStarts when the bot's own status changes in a chat — added to or removed from a group or channel, promoted or restricted, or blocked or unblocked by a person in a private chat.
  • Business connection changedStarts when a Telegram Business account connects the bot, disconnects it, or changes what the bot may do on its behalf.
  • Business message editedStarts when a message in a chat of a connected Telegram Business account is edited.
  • Business message receivedStarts when a new message arrives in a chat of a Telegram Business account connected to the bot — from a customer, or sent by the account owner.
  • Business messages deletedStarts when messages are deleted from a chat of a connected Telegram Business account.
  • Button pressedStarts when someone presses an inline-keyboard button with callbackdata on one of the bot's messages.
  • Channel post editedStarts when a post the bot knows about is edited in a channel it is a member of.
  • Channel post publishedStarts when a new post appears in a channel the bot is a member of.
  • Chat boost added or changedStarts when a chat where the bot is an administrator receives a boost or an existing boost changes.
  • Chat boost removedStarts when a boost is removed from a chat where the bot is an administrator.
  • Guest message receivedStarts when someone sends the bot a guest message; answer it with Answer guest query using the message's guestqueryid.
  • Inline query receivedStarts when someone types @yourbot followed by a query in any chat.
  • Inline result chosenStarts when someone picks one of the bot's inline results and sends it.
  • Join request receivedStarts when someone asks to join a chat through an invite link that needs approval, in a chat where the bot has the right to invite users.
  • Managed bot changedStarts when a bot is created to be managed by this bot, or when a managed bot's token or owner changes.
  • Member status changedStarts when a member's status changes in a chat where the bot is an administrator — someone joins, leaves, is promoted, restricted, banned or unbanned.
  • Message editedStarts when a message the bot knows about is edited in a private chat or a group.
  • Message generation stoppedStarts when someone presses the stop button on a draft the bot streamed with Stream message draft and canstop set.
  • Message receivedStarts when someone sends a message the bot can see — in a private chat with it, in a group it is in (only commands, mentions and replies to it while privacy mode is on) or in a forum topic.
  • Messages to the botAnswers as an agent in Telegram: when someone messages the bot in a private chat, or addresses it in a group, the agent replies in that chat.
  • Paid media purchasedStarts when someone buys paid media the bot sent with a payload, in a chat other than a channel.
  • Poll answeredStarts when someone votes, changes or retracts their vote in a non-anonymous poll the bot sent.
  • Poll updatedStarts when the state of a poll changes — votes on a poll the bot sent, or a poll being stopped.
  • Pre-checkout query receivedStarts when a buyer confirms payment, before it is charged; answer with Answer pre-checkout query within 10 seconds or the payment is cancelled.
  • Reaction changedStarts when someone changes their reaction to a message in a chat where the bot is an administrator.
  • Reaction counts changedStarts when the anonymous reaction counts on a channel post or other message with anonymous reactions change, in a chat where the bot is an administrator.
  • Shipping query receivedStarts when a buyer enters a shipping address for an invoice with a flexible price; answer with Answer shipping query.
  • Subscription changedStarts when a person's paid subscription to the bot changes state.
  • Update receivedStarts when Telegram delivers any update to the bot — a message sent to it or in a chat it is in, an edit, a channel post, a button press, a reaction, a change to a member's or the bot's own status in a chat, and every other update type the Bot API defines.

Product names, logos and brands are the property of their respective owners and are used here for identification only. Their use does not imply endorsement by, or affiliation with, those owners.