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.
将机器人添加到通道
要使用大多数这些操作,你必须将你的机器人添加到一个通道,以便它可以向该通道发送消息。有关更多信息,请参阅 常见问题 | 将机器人添加到 Telegram 通道。
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.
Human-in-the-loop for AI tool calls
This node can be used as a human review step for AI Agent tool calls. When configured this way, the AI Agent will pause and request human approval through this service before executing tools that require oversight. Learn more in Human-in-the-loop for AI tool calls.
删除聊天消息(Delete Chat Message)#
使用此操作通过 Bot API 的 deleteMessage 方法从聊天中删除消息。
🌐 Use this operation to delete a message from chat using the Bot API deleteMessage method.
请输入以下参数:
🌐 Enter these parameters:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择删除聊天消息。
- 聊天ID:请输入要删除的通道的聊天ID或用户名,格式为
@channelusername。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 消息 ID:输入你要删除的消息的唯一标识符。
有关更多信息,请参阅 Telegram 机器人 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:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择编辑消息文本。
- 聊天ID:请输入你希望离开的通道的聊天ID或用户名,格式为
@channelusername。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 消息 ID:输入你要编辑的消息的唯一标识符。
- 回复标记:选择是否使用 内联键盘 来显示 InlineKeyboardMarkup,选择 无 则不显示。这会设置
reply_markup参数。更多信息请参考 InlineKeyboardMarkup 文档。 - 文本:输入你想要编辑为消息的文本。
有关更多信息,请参阅 Telegram 机器人 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 文档。 - 解析模式:选择消息应使用 HTML(默认)、Markdown(旧版) 或 MarkdownV2 进行解析。此设置对应
parse_mode参数。
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:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择固定聊天消息。
- 聊天ID:以
@channelusername格式输入你希望固定消息的通道的聊天ID或用户名。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 消息 ID:输入你想固定的消息的唯一标识符。
有关更多信息,请参阅 Telegram 机器人 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。
发送动画(Send Animation)#
使用此操作可以通过 Bot API 的 sendAnimation 方法向聊天发送 GIF 或不带声音、大小不超过 50 MB 的 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:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择 发送动画。
- 聊天ID:以
@channelusername格式输入你希望发送动画的通道的聊天ID或用户名。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 二进制文件:要从节点本身发送二进制文件,请启用此选项。如果启用此参数,你必须输入包含要发送文件的 输入二进制字段。
- 动画:如果你没有使用二进制文件,请在此输入要发送的动画。传入
file_id以发送 Telegram 服务器上已存在的文件(推荐)或提供一个 HTTP URL 供 Telegram 从互联网获取文件。 - 回复标记:使用此参数可以设置更多界面选项。有关这些选项以及如何使用它们的更多信息,请参阅 回复标记参数。
有关更多信息,请参阅 Telegram 机器人 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个字符。
- 禁用通知:选择是以静默方式发送通知(开启)还是以标准通知方式发送(关闭)。
- 持续时间:输入动画的持续时间(以秒为单位)。
- 高度:输入动画的高度。
- 解析模式:输入要用于相关文本的解析器。选项包括 HTML(默认)、Markdown(旧版)、MarkdownV2。有关这些选项的更多信息,请参阅 Telegram 的格式选项。
- 回复消息ID:如果该消息是回复,请输入所回复消息的ID。
- 消息线程ID:输入论坛目标消息线程(主题)的唯一标识;仅适用于论坛超级群组。
- 缩略图:添加已发送文件的缩略图。如果服务器端支持文件缩略图生成,则忽略此字段。缩略图应符合以下规范:
- JPEG 格式
- 小于 200 KB
- 宽度和高度小于 320 像素。
- 宽度:输入视频剪辑的宽度。
发送音频(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:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择 发送音频。
- 聊天ID:以
@channelusername格式输入你希望发送音频的通道的聊天ID或用户名。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 二进制文件:要从节点本身发送二进制文件,请启用此选项。如果启用此参数,你必须输入包含要发送文件的 输入二进制字段。
- 音频:如果你没有使用 二进制文件,请在此输入要发送的音频。传入
file_id可发送存在于 Telegram 服务器上的文件(推荐),或传入 HTTP URL 供 Telegram 从互联网获取文件。 - 回复标记:使用此参数可以设置更多界面选项。有关这些选项以及如何使用它们的更多信息,请参阅 回复标记参数。
有关更多信息,请参阅 Telegram 机器人 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个字符。
- 禁用通知:选择是以静默方式发送通知(开启)还是以标准通知方式发送(关闭)。
- 时长:输入音频的时长(秒)。
- 解析模式:输入要用于相关文本的解析器。选项包括 HTML(默认)、Markdown(旧版)、MarkdownV2。有关这些选项的更多信息,请参阅 Telegram 的格式选项。
- 表演者:请输入表演者的名称。
- 回复消息ID:如果该消息是回复,请输入所回复消息的ID。
- 消息线程ID:输入论坛目标消息线程(主题)的唯一标识;仅适用于论坛超级群组。
- 标题:输入音频曲目的名称。
- 缩略图:添加已发送文件的缩略图。如果服务器端支持文件缩略图生成,则忽略此字段。缩略图应符合以下规范:
- JPEG 格式
- 小于 200 KB
- 宽度和高度小于320像素。
发送聊天操作(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:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择发送聊天动作。
- 聊天 ID:输入你希望发送聊天操作的通道的聊天 ID 或用户名,格式为
@channelusername。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 操作:选择你希望广播机器人正在执行的动作。这里的选项包括:查找位置、正在输入、录制音频或视频,以及上传文件类型。
有关更多信息,请参阅 Telegram 机器人 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:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择 发送文档。
- 聊天ID:以
@channelusername格式输入你希望发送文档的通道的聊天ID或用户名。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 二进制文件:要从节点本身发送二进制文件,请启用此选项。如果启用此参数,你必须输入包含要发送文件的 输入二进制字段。
- 文档:如果你没有使用 二进制文件,请在此输入要发送的文档。传入
file_id可发送存在于 Telegram 服务器上的文件(推荐),或传入 HTTP URL 供 Telegram 从互联网获取文件。 - 回复标记:使用此参数可以设置更多界面选项。有关这些选项以及如何使用它们的更多信息,请参阅 回复标记参数。
有关更多信息,请参阅 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个字符。
- 禁用通知:选择是以静默方式发送通知(开启)还是以标准通知方式发送(关闭)。
- 解析模式:输入要用于相关文本的解析器。可选项包括 HTML(默认)、Markdown(传统)、MarkdownV2。有关这些选项的更多信息,请参阅 格式化选项。
- 回复消息ID:如果该消息是回复,请输入所回复消息的ID。
- 消息线程ID:输入论坛目标消息线程(主题)的唯一标识;仅适用于论坛超级群组。
- 缩略图:添加已发送文件的缩略图。如果服务器端支持文件缩略图生成,则忽略此字段。缩略图应符合以下规范:
- JPEG 格式
- 小于 200 KB
- 宽度和高度小于 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:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择 发送位置。
- 聊天ID:输入你希望发送位置的通道的聊天ID或用户名,格式为
@channelusername。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 纬度:输入该位置的纬度。
- 经度:输入该位置的经度。
- 回复标记:使用此参数可以设置更多界面选项。有关这些选项以及如何使用它们的更多信息,请参阅 回复标记参数。
有关更多信息,请参阅 Telegram 机器人的 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:
- 禁用通知:选择是以静默方式发送通知(开启)还是以标准通知方式发送(关闭)。
- 回复消息ID:如果该消息是回复,请输入所回复消息的ID。
- 消息线程ID:输入论坛目标消息线程(主题)的唯一标识;仅适用于论坛超级群组。
发送媒体组(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:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择发送媒体组。
- 聊天 ID:输入你希望发送媒体组的通道的聊天 ID 或用户名,格式为
@channelusername。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 媒体:使用 添加媒体 将不同的媒体类型添加到你的媒体组中。对于每种媒体,请选择:
- 类型:此媒体的类型。请选择 照片 或 视频。
- 媒体文件:输入要发送的媒体文件。传递
file_id以发送 Telegram 服务器上已存在的文件(推荐),或者传递一个 HTTP URL 以让 Telegram 从互联网获取文件。 - 附加字段:对于每个媒体文件,你可以选择添加以下字段:
- 标题:为文件输入标题文本,最多1024个字符。
- 解析模式:输入要用于相关文本的解析器。可选项包括 HTML(默认)、Markdown(传统)、MarkdownV2。有关这些选项的更多信息,请参阅 格式化选项。
有关更多信息,请参阅 Telegram 机器人 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:
- 禁用通知:选择是以静默方式发送通知(开启)还是以标准通知方式发送(关闭)。
- 回复消息ID:如果该消息是回复,请输入所回复消息的ID。
- 消息线程 ID:输入目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
发送消息(Send Message)#
使用此操作可以通过 Bot API 的 sendMessage 方法向聊天发送消息。
🌐 Use this operation to send a message to the chat using the Bot API sendMessage method.
请输入以下参数:
🌐 Enter these parameters:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择 发送消息。
- 聊天ID:以
@channelusername格式输入你希望发送消息的通道的聊天ID或用户名。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 文本:输入要发送的文本,实体解析后最多4096个字符。
有关更多信息,请参阅 Telegram 的 Bot API sendMessage 文档。
🌐 Refer to Telegram's Bot API sendMessage documentation for more information.
发送消息限制
Telegram 将你可以发送的消息数量限制为每秒 30 条。如果你预计会达到此限制,请参考 每秒发送超过 30 条消息 获取建议的解决方法。
发送消息附加字段(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(开启,默认)或不包含(关闭)。 - 禁用通知:选择是以静默方式发送通知(开启)还是以标准通知方式发送(关闭)。
- 禁用网页预览:选择是否为此消息中的链接启用链接预览(关闭)或禁用链接预览(开启)。这将为
is_disabled设置link_preview_options参数。有关更多信息,请参阅 LinkPreviewOptions 文档。 - 解析模式:输入要用于相关文本的解析器。选项包括 HTML(默认)、Markdown(旧版)、MarkdownV2。有关这些选项的更多信息,请参阅 Telegram 的格式选项。
- 回复消息ID:如果该消息是回复,请输入所回复消息的ID。
- 消息线程ID:输入论坛目标消息线程(主题)的唯一标识;仅适用于论坛超级群组。
发送并等待响应(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:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择 发送并等待响应。
- 聊天ID:以
@channelusername格式输入你希望发送消息的通道的聊天ID或用户名。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 消息:输入要发送的文本。
- 响应类型:要使用的批准或响应类型:
- 批准:用户可以在消息中进行批准或不批准。
- 自由文本:用户可以通过表单提交回复。
- 自定义表单:用户可以通过自定义表单提交回复。
有关更多信息,请参阅 Telegram 的 Bot API sendMessage 文档。
🌐 Refer to Telegram's Bot API sendMessage documentation for more information.
发送消息限制
Telegram 将你可以发送的消息数量限制为每秒 30 条。如果你预计会达到此限制,请参考 每秒发送超过 30 条消息 获取建议的解决方法。
发送并等待响应附加字段(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:
- 批准类型:是仅显示批准按钮,还是同时显示批准和拒绝按钮。
- 按钮标签:用于批准或拒绝按钮的标签。默认选项分别为
✅ Approve(批准)和❌ Decline(拒绝)。 - 限制等待时间:工作流是否会在指定的时间限制后自动恢复执行。这可以是一个时间间隔或一个具体的实际时间。
自由文本(Free Text)#
使用“自由文本”响应类型时,可以使用以下选项:
🌐 When using the Free Text response type, the following options are available:
- 消息按钮标签:用于消息按钮的标签。默认选择是
Respond。 - 回应表格标题:用户提供回应的表格标题。
- 回应表格说明:用于用户提供回应的表格说明。
- 响应表单按钮标签:表单上用于提交他们回应的按钮标签。默认选择是
Submit。 - 限制等待时间:工作流是否会在指定的时间限制后自动恢复执行。这可以是一个时间间隔或一个具体的实际时间。
自定义表单(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。 - 回应表格标题:用户提供回应的表格标题。
- 回应表格说明:用于用户提供回应的表格说明。
- 响应表单按钮标签:表单上用于提交他们回应的按钮标签。默认选择是
Submit。 - 限制等待时间:工作流是否会在指定的时间限制后自动恢复执行。这可以是一个时间间隔或一个具体的实际时间。
发送照片(Send Photo)#
使用此操作可以通过 Bot API 的 sendPhoto 方法向聊天发送照片。
🌐 Use this operation to send a photo to the chat using the Bot API sendPhoto method.
请输入以下参数:
🌐 Enter these parameters:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择 发送照片。
- 聊天ID:以
@channelusername格式输入你希望发送照片的通道的聊天ID或用户名。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 二进制文件:要从节点本身发送二进制文件,请启用此选项。如果启用此参数,你必须输入包含要发送文件的 输入二进制字段。
- 照片:如果你没有使用二进制文件,请在此输入要发送的照片。传递
file_id以发送 Telegram 服务器上已存在的文件(推荐)或提供一个 HTTP URL 供 Telegram 从互联网获取文件。 - 回复标记:使用此参数可以设置更多界面选项。有关这些选项以及如何使用它们的更多信息,请参阅 回复标记参数。
有关更多信息,请参阅 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个字符。
- 禁用通知:选择是以静默方式发送通知(开启)还是以标准通知方式发送(关闭)。
- 解析模式:输入要用于相关文本的解析器。选项包括 HTML(默认)、Markdown(旧版)、MarkdownV2。有关这些选项的更多信息,请参阅 Telegram 的格式选项。
- 回复消息ID:如果该消息是回复,请输入所回复消息的ID。
- 消息线程 ID:输入目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
发送贴纸(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:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择 发送贴纸。
- 聊天ID:以
@channelusername格式输入你希望发送贴纸的通道的聊天ID或用户名。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 二进制文件:要从节点本身发送二进制文件,请启用此选项。如果启用此参数,你必须输入包含要发送文件的 输入二进制字段。
- 贴纸:如果你没有使用 二进制文件,请输入要发送的照片。传递
file_id可以发送一个已经存在于 Telegram 服务器上的文件(推荐),或者传递一个 HTTP URL 让 Telegram 从互联网上获取文件。 - 回复标记:使用此参数可以设置更多界面选项。有关这些选项以及如何使用它们的更多信息,请参阅 回复标记参数。
有关更多信息,请参阅 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:
- 禁用通知:选择是以静默方式发送通知(开启)还是以标准通知方式发送(关闭)。
- 回复消息ID:如果该消息是回复,请输入所回复消息的ID。
- 消息线程 ID:输入目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
发送视频(Send Video)#
使用此操作通过 Bot API sendVideo 方法将视频发送到聊天中。
🌐 Use this operation to send a video to the chat using the Bot API sendVideo method.
请输入以下参数:
🌐 Enter these parameters:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择 发送视频。
- 聊天ID:以
@channelusername格式输入你希望发送视频的通道的聊天ID或用户名。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 二进制文件:要从节点本身发送二进制文件,请启用此选项。如果启用此参数,你必须输入包含要发送文件的 输入二进制字段。
- 视频:如果你没有使用二进制文件,请在此输入要发送的视频。传递
file_id可以发送 Telegram 服务器上存在的文件(推荐),也可以传递 HTTP URL 以便 Telegram 从互联网上获取文件。 - 回复标记:使用此参数可以设置更多界面选项。有关这些选项以及如何使用它们的更多信息,请参阅 回复标记参数。
有关更多信息,请参阅 Telegram 机器人的 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个字符。
- 禁用通知:选择是以静默方式发送通知(开启)还是以标准通知方式发送(关闭)。
- 时长:输入视频的时长(秒)。
- 高度:输入视频的高度。
- 解析模式:输入要用于相关文本的解析器。选项包括 HTML(默认)、Markdown(旧版)、MarkdownV2。有关这些选项的更多信息,请参阅 Telegram 的格式选项。
- 回复消息ID:如果该消息是回复,请输入所回复消息的ID。
- 消息线程ID:输入论坛目标消息线程(主题)的唯一标识;仅适用于论坛超级群组。
- 缩略图:添加已发送文件的缩略图。如果服务器端支持文件缩略图生成,则忽略此字段。缩略图应符合以下规范:
- JPEG 格式
- 小于 200 KB
- 宽度和高度小于 320 像素。
- 宽度:输入视频的宽度。
取消置顶聊天消息(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:
- 用于连接的凭证:创建或选择一个现有的 Telegram 凭证。
- 资源:选择消息。
- 操作:选择固定聊天消息。
- 聊天 ID:输入你希望取消置顶消息的通道的聊天 ID 或用户名,格式为
@channelusername。- 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。更多信息请参考 常见问题 | 获取聊天 ID。
- 消息 ID:输入你想取消固定的消息的唯一标识符。
有关更多信息,请参阅 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 客户端会表现得像用户点击了机器人的消息并选择了回复,自动向用户显示回复界面。有关此选项的更多指导,请参考 强制回复参数。
- 内联键盘:在消息旁边显示内联键盘。有关此选项的更多指导,请参阅 内联键盘参数。
- 回复键盘:显示带有回复选项的自定义键盘。有关此选项的更多指导,请参阅回复键盘参数。
- 移除回复键盘:Telegram 客户端将移除当前自定义键盘,并显示默认的字母键盘。有关此选项的更多指导,请参阅 回复键盘参数。
电报商务账号
Telegram 在通道以及以 Telegram Business 账户名义发送的消息中限制以下选项:
- 强制回复
- 回复键盘
- 移除回复键盘
强制回复参数(Force Reply parameters)#
强制回复 在你想要创建用户友好的逐步操作界面而又不想牺牲隐私模式时非常有用。
如果你选择 回复标记 > 强制回复,请从这些 强制回复 参数中进行选择:
🌐 If you select Reply Markup > Force Reply, choose from these Force Reply parameters:
- 强制回复:开启后会向用户显示回复界面,如上所述。
- 选择性:如果你只想让这些用户回复,请开启此选项:
- 消息文本中为
@mentioned的用户。 - 如果此“发送动画”消息是对消息的回复,则为原始消息的发送者。
- 消息文本中为
有关更多信息,请参阅 ForceReply。
🌐 Refer to ForceReply for more information.
内联键盘参数(Inline Keyboard parameters)#
如果你选择 Reply Markup > Inline Keyboard,可以使用 Add Button 选项定义你想显示的内联键盘按钮。要为键盘添加更多行,请使用 Add Keyboard Row。
🌐 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.
使用 回复键盘选项 进一步优化键盘的行为:
🌐 Use the Reply Keyboard Options to further refine the keyboard's behavior:
- 调整键盘大小:选择是否请求 Telegram 客户端垂直调整键盘以实现最佳适配(开启)或使用与应用标准键盘相同的高度(关闭)。
- 一次性键盘:选择 Telegram 客户端在用户使用键盘后是立即隐藏键盘(开启)还是继续显示键盘(关闭)。
- 选择性:如果你只想向这些用户显示键盘,请开启此选项:
- 消息文本中为
@mentioned的用户。 - 如果此“发送动画”消息是对消息的回复,则为原始消息的发送者。
- 消息文本中为
有关更多信息,请参阅 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 客户端移除自定义键盘(开启)或保留它(关闭)。
- 选择性:如果你只想为这些用户移除键盘,请开启此项:
- 消息文本中为
@mentioned的用户。 - 如果此“发送动画”消息是对消息的回复,则为原始消息的发送者。
- 消息文本中为
有关更多信息,请参阅 ReplyKeyboardRemove。
🌐 Refer to ReplyKeyboardRemove for more information.