Skip to content

Telegram 节点消息操作#

¥Telegram node Message operations

使用这些操作来发送、编辑和删除聊天消息；向聊天发送文件；以及从聊天中置顶/取消置顶消息。有关 Telegram 节点本身的更多信息，请参阅 Telegram。

¥Use these operations to send, edit, and delete messages in a chat; send files to a chat; and pin/unpin message from a chat. Refer to Telegram for more information on the Telegram node itself.

Add bot to channel

要使用大多数操作，你必须将机器人添加到通道，以便它可以向该通道发送消息。有关更多信息，请参阅 常见问题 | 将机器人添加到 Telegram 通道。

¥To use most of these operations, you must add your bot to a channel so that it can send messages to that channel. Refer to Common Issues | Add a bot to a Telegram channel for more information.

This node can be used as an AI tool

This node can be used to enhance the capabilities of an AI agent. When used in this way, many parameters can be set automatically, or with information directed by AI - find out more in the AI tool parameters documentation.

s

删除聊天消息#

¥Delete Chat Message

使用此操作可使用 Bot API deleteMessage 方法从聊天中删除消息。

¥Use this operation to delete a message from chat using the Bot API deleteMessage method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择删除聊天消息。

¥Operation: Select Delete Chat Message.

  • 聊天 ID：以 @channelusername 的格式输入要删除的通道的聊天 ID 或用户名。

¥Chat ID: Enter the Chat ID or username of the channel you wish to delete in the format @channelusername.

¥Message ID: Enter the unique identifier of the message you want to delete.

请参阅 Telegram Bot API deleteMessage 文档了解更多信息。

¥Refer to the Telegram Bot API deleteMessage documentation for more information.

编辑消息文本#

¥Edit Message Text

使用此操作使用 Bot API editMessageText 方法编辑现有消息的文本。

¥Use this operation to edit the text of an existing message using the Bot API editMessageText method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“编辑消息文本”。

¥Operation: Select Edit Message Text.

  • 聊天 ID：以 @channelusername 的格式输入要保留的通道的聊天 ID 或用户名。

¥Chat ID: Enter the Chat ID or username of the channel you wish to leave in the format @channelusername.

¥Message ID: Enter the unique identifier of the message you want to edit.

  • 回复标记：选择是否使用内联键盘显示 InlineKeyboardMarkup（无）。此设置用于设置 reply_markup 参数。请参阅 InlineKeyboardMarkup 文档，了解更多信息。

¥Reply Markup: Select whether to use the Inline Keyboard to display the InlineKeyboardMarkup None not to. This sets the reply_markup parameter. Refer to the InlineKeyboardMarkup documentation for more information.

  • 文本：输入要编辑的消息文本。

¥Text: Enter the text you want to edit the message to.

请参阅 Telegram Bot API editMessageText 文档了解更多信息。

¥Refer to the Telegram Bot API editMessageText documentation for more information.

编辑消息文本附加字段#

¥Edit Message Text additional fields

使用附加字段，进一步细化节点的行为。选择“添加字段”以添加以下任意字段：

¥Use the Additional Fields to further refine the behavior of the node. Select Add Field to add any of the following:

  • 禁用网页预览：选择是否启用此邮件中链接的预览（已关闭）或禁用此邮件中链接的预览（已开启）。此设置用于为 is_disabled 设置 link_preview_options 参数。请参阅 LinkPreviewOptions 文档，了解更多信息。

¥Disable WebPage Preview: Select whether you want to enable link previews for links in this message (turned off) or disable link previews for links in this message (turned on). This sets the link_preview_options parameter for is_disabled. Refer to the LinkPreviewOptions documentation for more information.

  • 解析模式：选择消息应使用 HTML（默认）、Markdown（旧版）还是 MarkdownV2 进行解析。此设置用于设置 parse_mode 参数。

¥Parse Mode: Choose whether the message should be parsed using HTML (default), Markdown (Legacy), or MarkdownV2. This sets the parse_mode parameter.

Pin Chat 消息#

¥Pin Chat Message

使用此操作可通过 Bot API pinChatMessage 方法将消息置顶。

¥Use this operation to pin a message for the chat using the Bot API pinChatMessage method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“置顶聊天消息”。

¥Operation: Select Pin Chat Message.

  • 聊天 ID：请输入你要置顶消息的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to pin the message to in the format @channelusername.

¥Message ID: Enter the unique identifier of the message you want to pin.

请参阅 Telegram Bot API pinChatMessage 文档了解更多信息。

¥Refer to the Telegram Bot API pinChatMessage documentation for more information.

Pin Chat 消息附加字段#

¥Pin Chat Message additional fields

使用附加字段，进一步细化节点的行为。选择“添加字段”以添加以下任意字段：

¥Use the Additional Fields to further refine the behavior of the node. Select Add Field to add any of the following:

  • 禁用通知：默认情况下，Telegram 会通知所有聊天成员该消息已被置顶。如果你不希望收到这些通知，请启用此控件。将 disable_notification 参数设置为 true。

¥Disable Notifications: By default, Telegram will notify all chat members that the message has been pinned. If you don't want these notifications to go out, turn this control on. Sets the disable_notification parameter to true.

发送动画#

¥Send Animation

使用此操作通过 Bot API sendAnimation 方法向聊天发送最大 50 MB 的无声 GIF 或 H.264/MPEG-4 AVC 视频。

¥Use this operation to send GIFs or H.264/MPEG-4 AVC videos without sound up to 50 MB in size to the chat using the Bot API sendAnimation method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“发送动画”。

¥Operation: Select Send Animation.

  • 聊天 ID：请输入你要发送动画的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to send the animation to in the format @channelusername.

¥Binary File: To send a binary file from the node itself, turn this option on. If you turn this parameter on, you must enter the Input Binary Field containing the file you want to send.

  • 动画：如果你未使用二进制文件，请在此处输入要发送的动画。传递 file_id 参数以发送 Telegram 服务器上的文件（推荐），或传递 HTTP URL 以便 Telegram 从互联网获取文件。

¥Animation: If you aren't using the Binary File, enter the animation to send here. Pass a file_id to send a file that exists on the Telegram servers (recommended) or an HTTP URL for Telegram to get a file from the internet.

  • 回复标记：使用此参数设置更多接口选项。有关这些选项及其使用方法的更多信息，请参阅 回复标记参数。

¥Reply Markup: Use this parameter to set more interface options. Refer to Reply Markup parameters for more information on these options and how to use them.

请参阅 Telegram Bot API sendAnimation 文档了解更多信息。

¥Refer to the Telegram Bot API sendAnimation documentation for more information.

发送动画附加字段#

¥Send Animation additional fields

使用“附加字段”通过 Telegram 的 sendAnimation 方法中的可选字段进一步细化节点的行为。选择“添加字段”以添加以下任意字段：

¥Use the Additional Fields to further refine the behavior of the node using optional fields in Telegram's sendAnimation method. Select Add Field to add any of the following:

  • 标题：输入动画的字幕文本，最多 1024 个字符。

¥Caption: Enter a caption text for the animation, max of 1024 characters.

  • 禁用通知：选择是否静默发送通知（已启用）或发送标准通知（已禁用）。

¥Disable Notification: Choose whether to send the notification silently (turned on) or with a standard notification (turned off).

  • 持续时间：输入动画持续时间（以秒为单位）。

¥Duration: Enter the animation's duration in seconds.

  • 高度：输入动画的高度。

¥Height: Enter the height of the animation.

  • 解析模式：输入用于解析任何相关文本的解析器。选项包括 HTML（默认）、Markdown（旧版）、MarkdownV2。有关这些选项的更多信息，请参阅 Telegram 的 格式化选项。

¥Parse Mode: Enter the parser to use for any related text. Options include HTML (default), Markdown (Legacy), MarkdownV2. Refer to Telegram's Formatting options for more information on these options.

  • 回复至邮件 ID：如果消息是回复，请输入被回复消息的 ID。

¥Reply To Message ID: If the message is a reply, enter the ID of the message it's replying to.

  • 消息线程 ID：输入论坛目标消息线程（主题）的唯一标识符；仅适用于论坛超级群组。

¥Message Thread ID: Enter a unique identifier for the target message thread (topic) of the forum; for forum supergroups only.

  • 缩略图：添加已发送文件的缩略图。如果服务器端支持文件缩略图生成，则忽略此字段。缩略图应符合以下规范：

¥Thumbnail: Add the thumbnail of the file sent. Ignore this field if thumbnail generation for the file is supported server-side. The thumbnail should meet these specs:

  • JPEG 格式

    ¥JPEG format

  • 小于 200 KB

    ¥Less than 200 KB in size

  • 宽度和高度小于 320 像素。

    ¥Width and height less than 320px.

  • 宽度：输入视频片段宽度。

¥Width: Enter the width of the video clip.

发送音频#

¥Send Audio

使用此操作通过 Bot API sendAudio 方法向聊天发送音频文件并在音乐播放器中显示。

¥Use this operation to send an audio file to the chat and display it in the music player using the Bot API sendAudio method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“发送音频”。

¥Operation: Select Send Audio.

  • 聊天 ID：请输入你要发送音频的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to send the audio to in the format @channelusername.

¥Binary File: To send a binary file from the node itself, turn this option on. If you turn this parameter on, you must enter the Input Binary Field containing the file you want to send.

  • 音频：如果你未使用二进制文件，请在此处输入要发送的音频。传递 file_id 参数以发送 Telegram 服务器上的文件（推荐），或传递 HTTP URL 以便 Telegram 从互联网获取文件。

¥Audio: If you aren't using the Binary File, enter the audio to send here. Pass a file_id to send a file that exists on the Telegram servers (recommended) or an HTTP URL for Telegram to get a file from the internet.

  • 回复标记：使用此参数设置更多接口选项。有关这些选项及其使用方法的更多信息，请参阅 回复标记参数。

¥Reply Markup: Use this parameter to set more interface options. Refer to Reply Markup parameters for more information on these options and how to use them.

请参阅 Telegram Bot API sendAudio 文档了解更多信息。

¥Refer to the Telegram Bot API sendAudio documentation for more information.

发送音频附加字段#

¥Send Audio additional fields

使用“附加字段”通过 Telegram 的 sendAudio 方法中的可选字段进一步细化节点的行为。选择“添加字段”以添加以下任意字段：

¥Use the Additional Fields to further refine the behavior of the node using optional fields in Telegram's sendAudio method. Select Add Field to add any of the following:

  • 标题：输入音频的字幕文本，最多 1024 个字符。

¥Caption: Enter a caption text for the audio, max of 1024 characters.

  • 禁用通知：选择是否静默发送通知（已启用）或发送标准通知（已禁用）。

¥Disable Notification: Choose whether to send the notification silently (turned on) or with a standard notification (turned off).

  • 持续时间：输入音频时长（以秒为单位）。

¥Duration: Enter the audio's duration in seconds.

  • 解析模式：输入用于解析任何相关文本的解析器。选项包括 HTML（默认）、Markdown（旧版）、MarkdownV2。有关这些选项的更多信息，请参阅 Telegram 的 格式化选项。

¥Parse Mode: Enter the parser to use for any related text. Options include HTML (default), Markdown (Legacy), MarkdownV2. Refer to Telegram's Formatting options for more information on these options.

  • 执行器：输入执行者的名称。

¥Performer: Enter the name of the performer.

  • 回复至邮件 ID：如果消息是回复，请输入被回复消息的 ID。

¥Reply To Message ID: If the message is a reply, enter the ID of the message it's replying to.

  • 消息线程 ID：输入论坛目标消息线程（主题）的唯一标识符；仅适用于论坛超级群组。

¥Message Thread ID: Enter a unique identifier for the target message thread (topic) of the forum; for forum supergroups only.

  • 标题：输入音频轨道名称。

¥Title: Enter the audio track's name.

  • 缩略图：添加已发送文件的缩略图。如果服务器端支持文件缩略图生成，则忽略此字段。缩略图应符合以下规范：

¥Thumbnail: Add the thumbnail of the file sent. Ignore this field if thumbnail generation for the file is supported server-side. The thumbnail should meet these specs:

  • JPEG 格式

    ¥JPEG format

  • 小于 200 KB

    ¥Less than 200 KB in size

  • 宽度和高度小于 320 像素。

    ¥Width and height less than 320px.

发送聊天操作#

¥Send Chat Action

当你需要告知用户机器人端正在发生某些操作时，请使用此操作。状态使用 Bot API sendChatAction 方法设置，持续时间为 5 秒或更短。

¥Use this operation when you need to tell the user that something is happening on the bot's side. The status is set for 5 seconds or less using the Bot API sendChatAction method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“发送聊天操作”。

¥Operation: Select Send Chat Action.

  • 聊天 ID：请输入你要发送聊天操作的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to send the chat action to in the format @channelusername.

¥Action: Select the action you'd like to broadcast the bot as taking. The options here include: Find Location, Typing, Recording audio or video, and Uploading file types.

有关更多信息，请参阅 Telegram Bot API sendChatAction 文档。

¥Refer to Telegram's Bot API sendChatAction documentation for more information.

发送文档#

¥Send Document

使用此操作通过 Bot API sendDocument 方法向聊天发送文档。

¥Use this operation to send a document to the chat using the Bot API sendDocument method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“发送文档”。

¥Operation: Select Send Document.

  • 聊天 ID：请输入你要发送文档的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to send the document to in the format @channelusername.

¥Binary File: To send a binary file from the node itself, turn this option on. If you turn this parameter on, you must enter the Input Binary Field containing the file you want to send.

  • 文档：如果你未使用二进制文件，请在此处输入要发送的文档。传递 file_id 参数以发送 Telegram 服务器上的文件（推荐），或传递 HTTP URL 以便 Telegram 从互联网获取文件。

¥Document: If you aren't using the Binary File, enter the document to send here. Pass a file_id to send a file that exists on the Telegram servers (recommended) or an HTTP URL for Telegram to get a file from the internet.

  • 回复标记：使用此参数设置更多接口选项。有关这些选项及其使用方法的更多信息，请参阅 回复标记参数。

¥Reply Markup: Use this parameter to set more interface options. Refer to Reply Markup parameters for more information on these options and how to use them.

有关更多信息，请参阅 Telegram Bot API sendDocument 文档。

¥Refer to Telegram's Bot API sendDocument documentation for more information.

发送文档附加字段#

¥Send Document additional fields

使用“附加字段”通过 Telegram 的 sendDocument 方法中的可选字段进一步细化节点的行为。选择“添加字段”以添加以下任意字段：

¥Use the Additional Fields to further refine the behavior of the node using optional fields in Telegram's sendDocument method. Select Add Field to add any of the following:

  • 标题：输入文件的字幕文本，最多 1024 个字符。

¥Caption: Enter a caption text for the file, max of 1024 characters.

  • 禁用通知：选择是否静默发送通知（已启用）或发送标准通知（已禁用）。

¥Disable Notification: Choose whether to send the notification silently (turned on) or with a standard notification (turned off).

  • 解析模式：输入用于解析任何相关文本的解析器。选项包括 HTML（默认）、Markdown（旧版）、MarkdownV2。有关这些选项的更多信息，请参阅 格式化选项。

¥Parse Mode: Enter the parser to use for any related text. Options include HTML (default), Markdown (Legacy), MarkdownV2. Refer to Formatting options for more information on these options.

  • 回复至邮件 ID：如果消息是回复，请输入被回复消息的 ID。

¥Reply To Message ID: If the message is a reply, enter the ID of the message it's replying to.

  • 消息线程 ID：输入论坛目标消息线程（主题）的唯一标识符；仅适用于论坛超级群组。

¥Message Thread ID: Enter a unique identifier for the target message thread (topic) of the forum; for forum supergroups only.

  • 缩略图：添加已发送文件的缩略图。如果服务器端支持文件缩略图生成，则忽略此字段。缩略图应符合以下规范：

¥Thumbnail: Add the thumbnail of the file sent. Ignore this field if thumbnail generation for the file is supported server-side. The thumbnail should meet these specs:

  • JPEG 格式

    ¥JPEG format

  • 小于 200 KB

    ¥Less than 200 KB in size

  • 宽度和高度小于 320 像素。

    ¥Width and height less than 320px.

发送位置信息#

¥Send Location

使用此操作通过 Bot API sendLocation 方法向聊天发送地理位置信息。

¥Use this operation to send a geolocation to the chat using the Bot API sendLocation method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“发送位置”。

¥Operation: Select Send Location.

  • 聊天 ID：请输入你要发送位置信息的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to send the location to in the format @channelusername.

¥Latitude: Enter the latitude of the location.

  • 经度：输入位置的经度。

¥Longitude: Enter the longitude of the location.

  • 回复标记：使用此参数设置更多接口选项。有关这些选项及其使用方法的更多信息，请参阅 回复标记参数。

¥Reply Markup: Use this parameter to set more interface options. Refer to Reply Markup parameters for more information on these options and how to use them.

有关更多信息，请参阅 Telegram Bot API sendLocation 文档。

¥Refer to Telegram's Bot API sendLocation documentation for more information.

发送位置附加字段#

¥Send Location additional fields

使用“附加字段”通过 Telegram 的 sendLocation 方法中的可选字段进一步细化节点的行为。选择“添加字段”以添加以下任意字段：

¥Use the Additional Fields to further refine the behavior of the node using optional fields in Telegram's sendLocation method. Select Add Field to add any of the following:

  • 禁用通知：选择是否静默发送通知（已启用）或发送标准通知（已禁用）。

¥Disable Notification: Choose whether to send the notification silently (turned on) or with a standard notification (turned off).

  • 回复至邮件 ID：如果消息是回复，请输入被回复消息的 ID。

¥Reply To Message ID: If the message is a reply, enter the ID of the message it's replying to.

  • 消息线程 ID：输入论坛目标消息线程（主题）的唯一标识符；仅适用于论坛超级群组。

¥Message Thread ID: Enter a unique identifier for the target message thread (topic) of the forum; for forum supergroups only.

发送媒体组#

¥Send Media Group

使用此操作可通过 Bot API sendMediaGroup 方法发送一组照片和/或视频。

¥Use this operation to send a group of photos and/or videos using the Bot API sendMediaGroup method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“发送媒体组”。

¥Operation: Select Send Media Group.

  • 聊天 ID：请输入你要发送媒体组的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to send the media group to in the format @channelusername.

¥Media: Use Add Media to add different media types to your media group. For each medium, select:

  • 类型：媒体类型。选择照片或视频。

    ¥Type: The type of media this is. Choose from Photo and Video.

  • 媒体文件：请输入要发送的媒体文件。传递 file_id 参数以发送 Telegram 服务器上的文件（推荐），或传递 HTTP URL 以便 Telegram 从互联网获取文件。

    ¥Media File: Enter the media file to send. Pass a file_id to send a file that exists on the Telegram servers (recommended) or an HTTP URL for Telegram to get a file from the internet.

  • 附加字段：对于每个媒体文件，你可以选择添加以下字段：

    ¥Additional Fields: For each media file, you can choose to add these fields:

    • 标题：输入文件的字幕文本，最多 1024 个字符。

    ¥Caption: Enter a caption text for the file, max of 1024 characters.

    • 解析模式：输入用于解析任何相关文本的解析器。选项包括 HTML（默认）、Markdown（旧版）、MarkdownV2。有关这些选项的更多信息，请参阅 格式化选项。

    ¥Parse Mode: Enter the parser to use for any related text. Options include HTML (default), Markdown (Legacy), MarkdownV2. Refer to Formatting options for more information on these options.

有关更多信息，请参阅 Telegram Bot API sendMediaGroup 文档。

¥Refer to Telegram's Bot API sendMediaGroup documentation for more information.

发送媒体组附加字段#

¥Send Media Group additional fields

使用“附加字段”通过 Telegram 的 sendMediaGroup 方法中的可选字段进一步细化节点的行为。选择“添加字段”以添加以下任意字段：

¥Use the Additional Fields to further refine the behavior of the node using optional fields in Telegram's sendMediaGroup method. Select Add Field to add any of the following:

  • 禁用通知：选择是否静默发送通知（已启用）或发送标准通知（已禁用）。

¥Disable Notification: Choose whether to send the notification silently (turned on) or with a standard notification (turned off).

  • 回复至邮件 ID：如果消息是回复，请输入被回复消息的 ID。

¥Reply To Message ID: If the message is a reply, enter the ID of the message it's replying to.

  • 消息线程 ID：输入论坛目标消息线程（主题）的唯一标识符；仅适用于论坛超级群组。

¥Message Thread ID: Enter a unique identifier for the target message thread (topic) of the forum; for forum supergroups only.

发送消息#

¥Send Message

使用此操作可通过 Bot API sendMessage 方法向聊天发送消息。

¥Use this operation to send a message to the chat using the Bot API sendMessage method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“发送消息”。

¥Operation: Select Send Message.

  • 聊天 ID：请输入你要发送消息的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to send the message to in the format @channelusername.

¥Text: Enter the text to send, max 4096 characters after entities parsing.

有关更多信息，请参阅 Telegram Bot API sendMessage 文档。

¥Refer to Telegram's Bot API sendMessage documentation for more information.

Send Message limits

Telegram 将每秒发送的消息数量限制为 30 条。如果你预计会达到此限制，请参阅 每秒发送超过 30 条消息 获取建议的解决方法。

¥Telegram limits the number of messages you can send to 30 per second. If you expect to hit this limit, refer to Send more than 30 messages per second for a suggested workaround.

发送消息附加字段#

¥Send Message additional fields

使用“附加字段”通过 Telegram 的 sendMessage 方法中的可选字段进一步细化节点的行为。选择“添加字段”以添加以下任意字段：

¥Use the Additional Fields to further refine the behavior of the node using optional fields in Telegram's sendMessage method. Select Add Field to add any of the following:

  • 附加 n8n 归属：选择是否在消息末尾添加短语“This message was sent automatically with n8n”（已开启，默认）或不添加（已关闭）。

¥Append n8n Attribution: Choose whether to include the phrase This message was sent automatically with n8n to the end of the message (turned on, default) or not (turned off).

  • 禁用通知：选择是否静默发送通知（已启用）或发送标准通知（已禁用）。

¥Disable Notification: Choose whether to send the notification silently (turned on) or with a standard notification (turned off).

  • 禁用网页预览：选择是否启用此邮件中链接的预览（已关闭）或禁用此邮件中链接的预览（已开启）。此设置用于为 is_disabled 设置 link_preview_options 参数。请参阅 LinkPreviewOptions 文档，了解更多信息。

¥Disable WebPage Preview: Select whether you want to enable link previews for links in this message (turned off) or disable link previews for links in this message (turned on). This sets the link_preview_options parameter for is_disabled. Refer to the LinkPreviewOptions documentation for more information.

  • 解析模式：输入用于解析任何相关文本的解析器。选项包括 HTML（默认）、Markdown（旧版）、MarkdownV2。有关这些选项的更多信息，请参阅 Telegram 的 格式化选项。

¥Parse Mode: Enter the parser to use for any related text. Options include HTML (default), Markdown (Legacy), MarkdownV2. Refer to Telegram's Formatting options for more information on these options.

  • 回复至邮件 ID：如果消息是回复，请输入被回复消息的 ID。

¥Reply To Message ID: If the message is a reply, enter the ID of the message it's replying to.

  • 消息线程 ID：输入论坛目标消息线程（主题）的唯一标识符；仅适用于论坛超级群组。

¥Message Thread ID: Enter a unique identifier for the target message thread (topic) of the forum; for forum supergroups only.

发送并等待响应#

¥Send and Wait for Response

使用此操作可通过 Bot API sendMessage 方法向聊天发送消息，并暂停工作流执行，直到用户确认操作。

¥Use this operation to send a message to the chat using the Bot API sendMessage method and pause the workflow execution until the user confirms the operation.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“发送并等待响应”。

¥Operation: Select Send and Wait for Response.

  • 聊天 ID：请输入你要发送消息的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to send the message to in the format @channelusername.

¥Message: Enter the text to send.

  • 响应类型：要使用的批准或响应类型：

¥Response Type: The approval or response type to use:

  • 审批：用户可以在消息中批准或拒绝。

    ¥Approval: Users can approve or disapprove from within the message.

  • 自由文本：用户可以使用表单提交回复。

    ¥Free Text: Users can submit a response with a form.

  • 自定义表单：用户可以使用自定义表单提交回复。

    ¥Custom Form: Users can submit a response with a custom form.

有关更多信息，请参阅 Telegram Bot API sendMessage 文档。

¥Refer to Telegram's Bot API sendMessage documentation for more information.

Send Message limits

Telegram 将每秒发送的消息数量限制为 30 条。如果你预计会达到此限制，请参阅 每秒发送超过 30 条消息 获取建议的解决方法。

¥Telegram limits the number of messages you can send to 30 per second. If you expect to hit this limit, refer to Send more than 30 messages per second for a suggested workaround.

发送并等待响应附加字段#

¥Send and Wait for Response additional fields

附加字段取决于你选择的响应类型。

¥The additional fields depend on which Response Type you choose.

审批#

¥Approval

“批准”响应类型添加了以下选项：

¥The Approval response type adds these options:

  • 审批类型：是否仅显示批准按钮，还是同时显示批准和拒绝按钮。

¥Type of Approval: Whether to present only an approval button or both an approval and disapproval buttons.

  • 按钮标签：批准或拒绝按钮的标签。默认批准和拒绝操作分别为 ✅ Approve 和 ❌ Decline。

¥Button Label: The label for the approval or disapproval button. The default choice is ✅ Approve and ❌ Decline for approval and disapproval actions respectively.

  • 限制等待时间：工作流是否会在指定的时间限制后自动恢复执行。这可以是时间间隔或特定的运行时间。

¥Limit Wait Time: Whether the workflow will automatically resume execution after a specified time limit. This can be an interval or a specific wall time.

自由文本#

¥Free Text

使用“自由文本”响应类型时，可以使用以下选项：

¥When using the Free Text response type, the following options are available:

  • 消息按钮标签：消息按钮的标签。默认选择 Respond。

¥Message Button Label: The label to use for message button. The default choice is Respond.

  • 响应表单标题：用户提供响应的表单的标题。

¥Response Form Title: The title of the form where users provide their response.

  • 响应表单描述：用户提供响应的表单描述。

¥Response Form Description: A description for the form where users provide their response.

  • 响应表单按钮标签：表单上用于提交响应的按钮的标签。默认选择 Submit。

¥Response Form Button Label: The label for the button on the form to submit their response. The default choice is Submit.

  • 限制等待时间：工作流是否会在指定的时间限制后自动恢复执行。这可以是时间间隔或特定的运行时间。

¥Limit Wait Time: Whether the workflow will automatically resume execution after a specified time limit. This can be an interval or a specific wall time.

自定义表单#

¥Custom Form

使用“自定义表单”响应类型时，你可以构建包含所需字段和选项的表单。

¥When using the Custom Form response type, you build a form using the fields and options you want.

你可以根据 n8n 表单触发器的表单元素 中概述的设置自定义每个表单元素。要添加更多字段，请选择“添加表单元素”按钮。

¥You can customize each form element with the settings outlined in the n8n Form trigger's form elements. To add more fields, select the Add Form Element button.

以下选项也可用：

¥The following options are also available:

  • 消息按钮标签：消息按钮的标签。默认选择 Respond。

¥Message Button Label: The label to use for message button. The default choice is Respond.

  • 响应表单标题：用户提供响应的表单的标题。

¥Response Form Title: The title of the form where users provide their response.

  • 响应表单描述：用户提供响应的表单描述。

¥Response Form Description: A description for the form where users provide their response.

  • 响应表单按钮标签：表单上用于提交响应的按钮的标签。默认选择 Submit。

¥Response Form Button Label: The label for the button on the form to submit their response. The default choice is Submit.

  • 限制等待时间：工作流是否会在指定的时间限制后自动恢复执行。这可以是时间间隔或特定的运行时间。

¥Limit Wait Time: Whether the workflow will automatically resume execution after a specified time limit. This can be an interval or a specific wall time.

发送照片#

¥Send Photo

使用此操作可通过 Bot API sendPhoto 方法向聊天发送照片。

¥Use this operation to send a photo to the chat using the Bot API sendPhoto method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“发送照片”。

¥Operation: Select Send Photo.

  • 聊天 ID：请输入你要发送照片的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to send the photo to in the format @channelusername.

¥Binary File: To send a binary file from the node itself, turn this option on. If you turn this parameter on, you must enter the Input Binary Field containing the file you want to send.

  • 照片：如果你不使用二进制文件，请在此处输入要发送的照片。传递 file_id 参数以发送 Telegram 服务器上的文件（推荐），或传递 HTTP URL 以便 Telegram 从互联网获取文件。

¥Photo: If you aren't using the Binary File, enter the photo to send here. Pass a file_id to send a file that exists on the Telegram servers (recommended) or an HTTP URL for Telegram to get a file from the internet.

  • 回复标记：使用此参数设置更多接口选项。有关这些选项及其使用方法的更多信息，请参阅 回复标记参数。

¥Reply Markup: Use this parameter to set more interface options. Refer to Reply Markup parameters for more information on these options and how to use them.

有关更多信息，请参阅 Telegram Bot API sendPhoto 文档。

¥Refer to Telegram's Bot API sendPhoto documentation for more information.

发送照片附加字段#

¥Send Photo additional fields

使用附加字段，通过 Telegram 的 sendPhoto 方法中的可选字段，进一步细化节点的行为。选择“添加字段”以添加以下任意字段：

¥Use the Additional Fields to further refine the behavior of the node using optional fields in Telegram's sendPhoto method. Select Add Field to add any of the following:

  • 标题：输入文件的字幕文本，最多 1024 个字符。

¥Caption: Enter a caption text for the file, max of 1024 characters.

  • 禁用通知：选择是否静默发送通知（已启用）或发送标准通知（已禁用）。

¥Disable Notification: Choose whether to send the notification silently (turned on) or with a standard notification (turned off).

  • 解析模式：输入用于解析任何相关文本的解析器。选项包括 HTML（默认）、Markdown（旧版）、MarkdownV2。有关这些选项的更多信息，请参阅 Telegram 的 格式化选项。

¥Parse Mode: Enter the parser to use for any related text. Options include HTML (default), Markdown (Legacy), MarkdownV2. Refer to Telegram's Formatting options for more information on these options.

  • 回复至邮件 ID：如果消息是回复，请输入被回复消息的 ID。

¥Reply To Message ID: If the message is a reply, enter the ID of the message it's replying to.

  • 消息线程 ID：输入论坛目标消息线程（主题）的唯一标识符；仅适用于论坛超级群组。

¥Message Thread ID: Enter a unique identifier for the target message thread (topic) of the forum; for forum supergroups only.

发送贴纸#

¥Send Sticker

使用此方法通过 Bot API sendSticker 方法发送静态 .WEBP、动画 .TGS 或视频 .WEBM 贴纸。

¥Use this method to send static .WEBP, animated .TGS, or video .WEBM stickers using the Bot API sendSticker method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“发送贴纸”。

¥Operation: Select Send Sticker.

  • 聊天 ID：请输入你要发送贴纸的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to send the sticker to in the format @channelusername.

¥Binary File: To send a binary file from the node itself, turn this option on. If you turn this parameter on, you must enter the Input Binary Field containing the file you want to send.

  • 标签：如果你不使用二进制文件，请在此处输入要发送的照片。传递 file_id 参数以发送 Telegram 服务器上的文件（推荐），或传递 HTTP URL 以便 Telegram 从互联网获取文件。

¥Sticker: If you aren't using the Binary File, enter the photo to send here. Pass a file_id to send a file that exists on the Telegram servers (recommended) or an HTTP URL for Telegram to get a file from the internet.

  • 回复标记：使用此参数设置更多接口选项。有关这些选项及其使用方法的更多信息，请参阅 回复标记参数。

¥Reply Markup: Use this parameter to set more interface options. Refer to Reply Markup parameters for more information on these options and how to use them.

有关更多信息，请参阅 Telegram Bot API sendSticker 文档。

¥Refer to Telegram's Bot API sendSticker documentation for more information.

发送贴纸附加字段#

¥Send Sticker additional fields

使用附加字段，通过 Telegram 的 sendSticker 方法中的可选字段，进一步细化节点的行为。选择“添加字段”以添加以下任意字段：

¥Use the Additional Fields to further refine the behavior of the node using optional fields in Telegram's sendSticker method. Select Add Field to add any of the following:

  • 禁用通知：选择是否静默发送通知（已启用）或发送标准通知（已禁用）。

¥Disable Notification: Choose whether to send the notification silently (turned on) or with a standard notification (turned off).

  • 回复至邮件 ID：如果消息是回复，请输入被回复消息的 ID。

¥Reply To Message ID: If the message is a reply, enter the ID of the message it's replying to.

  • 消息线程 ID：输入论坛目标消息线程（主题）的唯一标识符；仅适用于论坛超级群组。

¥Message Thread ID: Enter a unique identifier for the target message thread (topic) of the forum; for forum supergroups only.

发送视频#

¥Send Video

使用此操作可通过 Bot API sendVideo 方法向聊天发送视频。

¥Use this operation to send a video to the chat using the Bot API sendVideo method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“发送视频”。

¥Operation: Select Send Video.

  • 聊天 ID：请输入你要发送视频的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to send the video to in the format @channelusername.

¥Binary File: To send a binary file from the node itself, turn this option on. If you turn this parameter on, you must enter the Input Binary Field containing the file you want to send.

  • 视频：如果你不使用二进制文件，请在此处输入要发送的视频。传递 file_id 参数以发送 Telegram 服务器上的文件（推荐），或传递 HTTP URL 以便 Telegram 从互联网获取文件。

¥Video: If you aren't using the Binary File, enter the video to send here. Pass a file_id to send a file that exists on the Telegram servers (recommended) or an HTTP URL for Telegram to get a file from the internet.

  • 回复标记：使用此参数设置更多接口选项。有关这些选项及其使用方法的更多信息，请参阅 回复标记参数。

¥Reply Markup: Use this parameter to set more interface options. Refer to Reply Markup parameters for more information on these options and how to use them.

有关更多信息，请参阅 Telegram Bot API sendVideo 文档。

¥Refer to Telegram's Bot API sendVideo documentation for more information.

发送视频附加字段#

¥Send Video additional fields

使用附加字段，通过 Telegram 的 sendVideo 方法中的可选字段，进一步细化节点的行为。选择“添加字段”以添加以下任意字段：

¥Use the Additional Fields to further refine the behavior of the node using optional fields in Telegram's sendVideo method. Select Add Field to add any of the following:

  • 标题：输入视频的字幕文本，最多 1024 个字符。

¥Caption: Enter a caption text for the video, max of 1024 characters.

  • 禁用通知：选择是否静默发送通知（已启用）或发送标准通知（已禁用）。

¥Disable Notification: Choose whether to send the notification silently (turned on) or with a standard notification (turned off).

  • 持续时间：输入视频的持续时间（以秒为单位）。

¥Duration: Enter the video's duration in seconds.

  • 高度：输入视频的高度。

¥Height: Enter the height of the video.

  • 解析模式：输入用于解析任何相关文本的解析器。选项包括 HTML（默认）、Markdown（旧版）、MarkdownV2。有关这些选项的更多信息，请参阅 Telegram 的 格式化选项。

¥Parse Mode: Enter the parser to use for any related text. Options include HTML (default), Markdown (Legacy), MarkdownV2. Refer to Telegram's Formatting options for more information on these options.

  • 回复至邮件 ID：如果消息是回复，请输入被回复消息的 ID。

¥Reply To Message ID: If the message is a reply, enter the ID of the message it's replying to.

  • 消息线程 ID：输入论坛目标消息线程（主题）的唯一标识符；仅适用于论坛超级群组。

¥Message Thread ID: Enter a unique identifier for the target message thread (topic) of the forum; for forum supergroups only.

  • 缩略图：添加已发送文件的缩略图。如果服务器端支持文件缩略图生成，则忽略此字段。缩略图应符合以下规范：

¥Thumbnail: Add the thumbnail of the file sent. Ignore this field if thumbnail generation for the file is supported server-side. The thumbnail should meet these specs:

  • JPEG 格式

    ¥JPEG format

  • 小于 200 KB

    ¥Less than 200 KB in size

  • 宽度和高度小于 320 像素。

    ¥Width and height less than 320px.

  • 宽度：输入视频宽度。

¥Width: Enter the width of the video.

取消置顶聊天消息#

¥Unpin Chat Message

使用此操作通过 Bot API unpinChatMessage 方法取消聊天中消息的置顶。

¥Use this operation to unpin a message from the chat using the Bot API unpinChatMessage method.

请输入以下参数：

¥Enter these parameters:

¥Credential to connect with: Create or select an existing Telegram credential.

  • 资源：选择“消息”。

¥Resource: Select Message.

  • 操作：选择“置顶聊天消息”。

¥Operation: Select Pin Chat Message.

  • 聊天 ID：请输入你要取消置顶消息的通道的聊天 ID 或用户名，格式为 @channelusername。

¥Chat ID: Enter the Chat ID or username of the channel you wish to unpin the message from in the format @channelusername.

¥Message ID: Enter the unique identifier of the message you want to unpin.

请参阅 Telegram Bot API unpinChatMessage 文档了解更多信息。

¥Refer to the Telegram Bot API unpinChatMessage documentation for more information.

回复标记参数#

¥Reply Markup parameters

对于大多数消息发送操作（例如发送动画、发送音频），请使用“回复标记”参数设置更多界面选项：

¥For most of the Message Send actions (such as Send Animation, Send Audio), use the Reply Markup parameter to set more interface options:

  • 强制回复：Telegram 客户端将如同用户已选择机器人的消息并点击“回复”一样，自动向用户显示回复界面。请参阅 强制回复参数 以了解有关此选项的更多指导。

¥Force Reply: The Telegram client will act as if the user has selected the bot's message and tapped Reply, automatically displaying a reply interface to the user. Refer to Force Reply parameters for further guidance on this option.

  • 内联键盘：在消息旁边显示内联键盘。请参阅 内联键盘参数 以了解有关此选项的更多指导。

¥Inline Keyboard: Display an inline keyboard right next to the message. Refer to Inline Keyboard parameters for further guidance on this option.

  • 回复键盘：显示带有回复选项的自定义键盘。请参阅 回复键盘参数 以了解有关此选项的更多指导。

¥Reply Keyboard: Display a custom keyboard with reply options. Refer to Reply Keyboard parameters for further guidance on this option.

  • 移除回复键盘：Telegram 客户端将移除当前自定义键盘并显示默认字母键盘。请参阅 回复键盘参数 以了解有关此选项的更多指导。

¥Reply Keyboard Remove: The Telegram client will remove the current custom keyboard and display the default letter-keyboard. Refer to Reply Keyboard parameters for further guidance on this option.

Telegram Business accounts

Telegram 对通道以及代表 Telegram Business 账户发送的消息限制了以下选项：

¥Telegram restricts the following options in channels and for messages sent on behalf of a Telegram Business account:

  • 强制回复

¥Force Reply

  • 回复键盘

¥Reply Keyboard

  • 移除回复键盘

¥Reply Keyboard Remove

强制回复参数#

¥Force Reply parameters

如果你想创建用户友好的分步界面，同时又不想牺牲隐私模式，强制回复功能非常有用。

¥Force Reply is useful if you want to create user-friendly step-by-step interfaces without having to sacrifice privacy mode.

如果你选择“回复标记”>“强制回复”，请从以下“强制回复”参数中选择：

¥If you select Reply Markup > Force Reply, choose from these Force Reply parameters:

  • 强制回复：启用此功能可向用户显示如上所述的回复界面。

¥Force Reply: Turn on to show the reply interface to the user, as described above.

  • 可选：如果你只想强制以下用户回复，请启用此选项：

¥Selective: Turn this on if you want to force reply from these users only:

  • 消息文本中标记为 @mentioned 的用户。

    ¥Users that are @mentioned in the text of the message.

  • 如果此“发送动画”消息是对消息的回复，则为原始消息的发送者。

    ¥The sender of the original message, if this Send Animation message is a reply to a message.

有关更多信息，请参阅 ForceReply。

¥Refer to ForceReply for more information.

内联键盘参数#

¥Inline Keyboard parameters

如果你选择“回复标记”>“内联键盘”，请使用“添加按钮”选项定义要显示的内联键盘按钮。要向键盘添加更多行，请使用“添加键盘行”。

¥If you select Reply Markup > Inline Keyboard, define the inline keyboard buttons you want to display using the Add Button option. To add more rows to your keyboard, use Add Keyboard Row.

有关更多信息，请参阅 InlineKeyboardMarkup 和 InlineKeyboardButtons。

¥Refer to InlineKeyboardMarkup and InlineKeyboardButtons for more information.

回复键盘参数#

¥Reply Keyboard parameters

如果你选择“回复标记”>“回复键盘”，请使用“回复键盘”部分定义回复键盘中的按钮和行。

¥If you select Reply Markup > Reply Keyboard, use the Reply Keyboard section to define the buttons and rows in your Reply Keyboard.

使用 Reply Keyboard Options 进一步细化键盘行为：

¥Use the Reply Keyboard Options to further refine the keyboard's behavior:

  • 调整键盘大小：选择是否请求 Telegram 客户端垂直调整键盘大小以获得最佳显示效果（已开启）或使用与应用标准键盘相同的高度（已关闭）。

¥Resize Keyboard: Choose whether to request the Telegram client to resize the keyboard vertically for optimal fit (turned on) or whether to use the same height as the app's standard keyboard (turned off).

  • 一次性键盘：选择 Telegram 客户端是否应在用户使用键盘后立即隐藏键盘（开启）或保持显示（关闭）。

¥One Time Keyboard: Choose whether the Telegram client should hide the keyboard as soon as a user uses it (turned on) or to keep displaying it (turned off).

  • 可选：如果你只想向以下用户显示键盘，请启用此选项：

¥Selective: Turn this on if you want to show the keyboard to these users only:

  • 消息文本中标记为 @mentioned 的用户。

    ¥Users that are @mentioned in the text of the message.

  • 如果此“发送动画”消息是对消息的回复，则为原始消息的发送者。

    ¥The sender of the original message, if this Send Animation message is a reply to a message.

有关更多信息，请参阅 ReplyKeyboardMarkup。

¥Refer to ReplyKeyboardMarkup for more information.

移除回复键盘参数#

¥Reply Keyboard Remove parameters

如果你选择“回复标记”>“移除回复键盘”，请从以下“移除回复键盘”参数中选择：

¥If you select Reply Markup > Reply Keyboard Remove, choose from these Reply Keyboard Remove parameters:

  • 从关联方移除元数据选择是否请求 Telegram 客户端移除自定义键盘（已开启）或保留自定义键盘（已关闭）。

¥Remove Keyboard: Choose whether to request the Telegram client to remove the custom keyboard (turned on) or to keep it (turned off).

  • 可选：如果你只想为以下用户移除键盘，请启用此选项：

¥Selective: Turn this on if you want to remove the keyboard for these users only:

  • 消息文本中标记为 @mentioned 的用户。

    ¥Users that are @mentioned in the text of the message.

  • 如果此“发送动画”消息是对消息的回复，则为原始消息的发送者。

    ¥The sender of the original message, if this Send Animation message is a reply to a message.

有关更多信息，请参阅 ReplyKeyboardRemove。

¥Refer to ReplyKeyboardRemove for more information.