Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated Telegram Trigger node docs with all new supported triggers #2750

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -20,16 +20,32 @@ For usage examples and templates to help you get started, refer to n8n's [Telegr

## Events

- **`*`**: Triggers on all updates of any kind.
- **Callback Query**: Triggers on a new incoming callback query.
- **Channel Post**: Triggers on a new incoming channel post of any kind, including text, photo, sticker, and so on.
- **Edited Channel Post**: Triggers when someone edits a channel post that's known to the bot.
- **Edited Message**: Triggers when someone edits a message that's known to the bot.
- **Inline Query**: Triggers on a new incoming inline query.
- **Message**: Triggers on a new incoming message of any kind, including text, photo, sticker, and so on.
- **Poll**: Triggers when the poll state changes. Bots receive updates about polls they've sent and stopped polls.
- **Pre-Checkout Query**: Triggers on a new incoming pre-checkout query. This response contains full information about checkout.
- **Shipping Query**: Triggers on a new incoming shipping query. Only for invoices with a flexible price.
- **`*`**: All updates except "Chat Member", "Message Reaction", and "Message Reaction Count" (default behavior of Telegram API as they produces a lot of calls of updates).
- **Business Connection**: Trigger when the bot was connected to or disconnected from a business account, or a user edited an existing connection with the bot.
- **Business Message**: Trigger on new message from a connected business account.
- **Callback Query**: Trigger on new incoming callback query.
- **Channel Post**: Trigger on new incoming channel post of any kind — text, photo, sticker, etc.
- **Chat Boost**: Trigger when a chat boost was added or changed. The bot must be an administrator in the chat to receive these updates.
- **Chat Join Request**: Trigger when a request to join the chat has been sent. The bot must have the can_invite_users administrator right in the chat to receive these updates.
- **Chat Member**: Trigger when a chat member's status was updated in a chat. The bot must be an administrator in the chat.
- **Chosen Inline Result**: Trigger when the result of an inline query that was chosen by a user and sent to their chat partner. Please see our documentation on the feedback collecting for details on how to enable these updates for your bot.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure what the 'feedback collecting' documentation referred to is. Could we include a link?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed with link to TG API docs

- **Deleted Business Messages**: Trigger when messages were deleted from a connected business account.
- **Edited Business Message**: Trigger on new version of a message from a connected business account.
- **Edited Channel Post**: Trigger on new version of a channel post that is known to the bot and was edited.
- **Edited Message**: Trigger on new version of a channel post that is known to the bot and was edited.
- **Inline Query**: Trigger on new incoming inline query.
- **Message**: Trigger on new incoming message of any kind — text, photo, sticker, etc.
- **Message Reaction**: Trigger when a reaction to a message was changed by a user. The bot must be an administrator in the chat. The update isn't received for reactions set by bots.
- **Message Reaction Count**: Trigger when reactions to a message with anonymous reactions were changed. The bot must be an administrator in the chat. The updates are grouped and can be sent with delay up to a few minutes.
- **My Chat Member**: Trigger when the bot's chat member status was updated in a chat. For private chats, this update is received only when the bot is blocked or unblocked by the user.
- **Poll**: Trigger on new poll state. Bots receive only updates about stopped polls and polls, which are sent by the bot.
- **Poll Answer**: Trigger when user changed their answer in a non-anonymous poll. Bots receive new votes only in polls that were sent by the bot itself.
- **Pre-Checkout Query**: Trigger on new incoming pre-checkout query. Contains full information about checkout.
- **Purchased Paid Media**: Trigger when a user purchased paid media with a non-empty payload sent by the bot in a non-channel chat.
- **Removed Chat Boost**: Trigger when a boost was removed from a chat. The bot must be an administrator in the chat to receive these updates.
- **Shipping Query**: Trigger on new incoming shipping query. Only for invoices with flexible price.

Some **events may require additional permissions**, see [Telegram's API documentation](https://core.telegram.org/bots/api#getting-updates) for more information.

## Related resources

Expand Down