From fdd8d033fca716831916797cfb6c6a1f1719d0e2 Mon Sep 17 00:00:00 2001 From: Oleg Tsvetkov Date: Mon, 13 Jan 2025 22:33:38 +0300 Subject: [PATCH 1/3] Updated Telegram Trigger node docs with all new supported triggers --- .../n8n-nodes-base.telegramtrigger/index.md | 36 +++++++++++++------ 1 file changed, 26 insertions(+), 10 deletions(-) diff --git a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md index 8660b7bc2d..1036f1482c 100644 --- a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md +++ b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md @@ -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. +- **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 From 53aa0b7e42f247ebbaf4e4bd82ec670d95650c21 Mon Sep 17 00:00:00 2001 From: Nick Veitch Date: Tue, 14 Jan 2025 15:38:14 +0000 Subject: [PATCH 2/3] Update index.md --- .../n8n-nodes-base.telegramtrigger/index.md | 36 +++++++++---------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md index 1036f1482c..ec29f26f2f 100644 --- a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md +++ b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md @@ -21,28 +21,28 @@ For usage examples and templates to help you get started, refer to n8n's [Telegr ## Events - **`*`**: 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. +- **Business Connection**: Trigger when the bot is connected to or disconnected from a business account, or a user edited an existing connection with the bot. +- **Business Message**: Trigger on a 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. -- **Deleted Business Messages**: Trigger when messages were deleted from a connected business account. +- **Channel Post**: Trigger on new incoming channel post of any kind — including text, photo, sticker, and so on. +- **Chat Boost**: Trigger when a chat boost is 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 is 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 is updated. The bot must be an administrator in the chat. +- **Chosen Inline Result**: Trigger when the result of an inline query chosen by a user is sent. Please see our documentation on the feedback collecting for details on how to enable these updates for your bot. +- **Deleted Business Messages**: Trigger when messages are 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. +- **Edited Channel Post**: Trigger on new version of a channel post that is known to the bot is edited. +- **Edited Message**: Trigger on new version of a channel post that is known to the bot is 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. +- **Message**: Trigger on new incoming message of any kind — text, photo, sticker, and so on. +- **Message Reaction**: Trigger when a reaction to a message is 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 are 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 is 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 only receive updates about stopped polls and polls which are sent by the bot. +- **Poll Answer**: Trigger when user changes their answer in a non-anonymous poll. Bots only receive new votes 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. +- **Purchased Paid Media**: Trigger when a user purchases paid media with a non-empty payload sent by the bot in a non-channel chat. +- **Removed Chat Boost**: Trigger when a boost is 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. From c09794bf026d26506cc0301a7ad61605f5eed332 Mon Sep 17 00:00:00 2001 From: Oleg Tsvetkov Date: Tue, 14 Jan 2025 21:28:39 +0300 Subject: [PATCH 3/3] Add missing ref to Telegram API --- .../trigger-nodes/n8n-nodes-base.telegramtrigger/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md index ec29f26f2f..4e889acfb5 100644 --- a/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md +++ b/docs/integrations/builtin/trigger-nodes/n8n-nodes-base.telegramtrigger/index.md @@ -28,7 +28,7 @@ For usage examples and templates to help you get started, refer to n8n's [Telegr - **Chat Boost**: Trigger when a chat boost is 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 is 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 is updated. The bot must be an administrator in the chat. -- **Chosen Inline Result**: Trigger when the result of an inline query chosen by a user is sent. Please see our documentation on the feedback collecting for details on how to enable these updates for your bot. +- **Chosen Inline Result**: Trigger when the result of an inline query chosen by a user is sent. Please see Telegram's API documentation on the [feedback collecting](https://core.telegram.org/bots/inline#collecting-feedback) for details on how to enable these updates for your bot. - **Deleted Business Messages**: Trigger when messages are 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 is edited.