Telegram 节点消息操作#
使用这些操作在聊天中发送、编辑和删除消息;向聊天发送文件;以及从聊天中置顶/取消置顶消息。有关 Telegram 节点本身的更多信息,请参阅 Telegram。
将机器人添加到频道
要使用大多数这些操作,您必须将机器人添加到频道,以便它可以向该频道发送消息。有关更多信息,请参阅 常见问题 | 将机器人添加到 Telegram 频道。
此节点可用作 AI 工具
此节点可用于增强 AI 代理的功能。以这种方式使用时,许多参数可以自动设置,或使用 AI 指导的信息设置 - 在 AI 工具参数文档中了解更多信息。
Delete Chat Message 删除聊天消息#
使用此操作通过 Bot API deleteMessage 方法从聊天中删除消息。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Delete Chat Message 删除聊天消息。
- Chat ID 聊天 ID:输入您希望删除消息的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Message ID 消息 ID:输入您要删除的消息的唯一标识符。
请参阅 Telegram Bot API deleteMessage 文档了解更多信息。
Edit Message Text 编辑消息文本#
使用此操作通过 Bot API editMessageText 方法编辑现有消息的文本。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Edit Message Text 编辑消息文本。
- Chat ID 聊天 ID:输入您希望编辑消息的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Message ID 消息 ID:输入您要编辑的消息的唯一标识符。
- Reply Markup 回复标记:选择是否使用 Inline Keyboard 内联键盘 来显示 InlineKeyboardMarkup 或选择 None 无 不使用。这设置了
reply_markup
参数。有关更多信息,请参阅 InlineKeyboardMarkup 文档。 - Text 文本:输入您要将消息编辑为的文本。
请参阅 Telegram Bot API editMessageText 文档了解更多信息。
编辑消息文本附加字段#
使用 Additional Fields 附加字段 进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:
- Disable WebPage Preview 禁用网页预览:选择是否要为此消息中的链接启用链接预览(关闭)或禁用链接预览(打开)。这为
is_disabled
设置了link_preview_options
参数。有关更多信息,请参阅 LinkPreviewOptions 文档。 - Parse Mode 解析模式:选择是否应使用 HTML(默认)、Markdown (Legacy) 或 MarkdownV2 解析消息。这设置了
parse_mode
参数。
Pin Chat Message 置顶聊天消息#
使用此操作通过 Bot API pinChatMessage 方法为聊天置顶消息。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Pin Chat Message 置顶聊天消息。
- Chat ID 聊天 ID:输入您希望置顶消息的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Message ID 消息 ID:输入您要置顶的消息的唯一标识符。
请参阅 Telegram Bot API pinChatMessage 文档了解更多信息。
置顶聊天消息附加字段#
使用 Additional Fields 附加字段 进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:
- Disable Notifications 禁用通知:默认情况下,Telegram 会通知所有聊天成员消息已被置顶。如果您不希望发送这些通知,请打开此控制。将
disable_notification
参数设置为true
。
Send Animation 发送动画#
使用此操作通过 Bot API sendAnimation 方法向聊天发送 GIF 或无声音的 H.264/MPEG-4 AVC 视频,最大 50 MB。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Send Animation 发送动画。
- Chat ID 聊天 ID:输入您希望发送动画的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果您打开此参数,必须输入包含您要发送的文件的 Input Binary Field 输入二进制字段。
- Animation 动画:如果您没有使用 Binary File 二进制文件,请在此处输入要发送的动画。传递
file_id
来发送 Telegram 服务器上存在的文件(推荐)或传递 HTTP URL 让 Telegram 从互联网获取文件。 - Reply Markup 回复标记:使用此参数设置更多界面选项。有关这些选项及其使用方法的更多信息,请参阅 回复标记参数。
请参阅 Telegram Bot API sendAnimation 文档了解更多信息。
发送动画附加字段#
使用 Additional Fields 附加字段 通过 Telegram 的 sendAnimation 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:
- Caption 标题:输入动画的标题文本,最多 1024 个字符。
- Disable Notification 禁用通知:选择是否静默发送通知(打开)或使用标准通知(关闭)。
- Duration 持续时间:输入动画的持续时间(秒)。
- Height 高度:输入动画的高度。
- Parse Mode 解析模式:输入用于任何相关文本的解析器。选项包括 HTML(默认)、Markdown (Legacy)、MarkdownV2。有关这些选项的更多信息,请参阅 Telegram 的 格式化选项。
- Reply To Message ID 回复消息 ID:如果消息是回复,请输入它所回复的消息的 ID。
- Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
- Thumbnail 缩略图:添加已发送文件的缩略图。如果服务器端支持文件的缩略图生成,请忽略此字段。缩略图应满足以下规格:
- JPEG 格式
- 大小小于 200 KB
- 宽度和高度小于 320px。
- Width 宽度:输入视频剪辑的宽度。
Send Audio 发送音频#
使用此操作通过 Bot API sendAudio 方法向聊天发送音频文件并在音乐播放器中显示。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Send Audio 发送音频。
- Chat ID 聊天 ID:输入您希望发送音频的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果您打开此参数,必须输入包含您要发送的文件的 Input Binary Field 输入二进制字段。
- Audio 音频:如果您没有使用 Binary File 二进制文件,请在此处输入要发送的音频。传递
file_id
来发送 Telegram 服务器上存在的文件(推荐)或传递 HTTP URL 让 Telegram 从互联网获取文件。 - Reply Markup 回复标记:使用此参数设置更多界面选项。有关这些选项及其使用方法的更多信息,请参阅 回复标记参数。
请参阅 Telegram Bot API sendAudio 文档了解更多信息。
发送音频附加字段#
使用 Additional Fields 附加字段 通过 Telegram 的 sendAudio 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:
- Caption 标题:输入音频的标题文本,最多 1024 个字符。
- Disable Notification 禁用通知:选择是否静默发送通知(打开)或使用标准通知(关闭)。
- Duration 持续时间:输入音频的持续时间(秒)。
- Parse Mode 解析模式:输入用于任何相关文本的解析器。选项包括 HTML(默认)、Markdown (Legacy)、MarkdownV2。有关这些选项的更多信息,请参阅 Telegram 的 格式化选项。
- Performer 表演者:输入表演者的姓名。
- Reply To Message ID 回复消息 ID:如果消息是回复,请输入它所回复的消息的 ID。
- Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
- Title 标题:输入音频曲目的名称。
- Thumbnail 缩略图:添加已发送文件的缩略图。如果服务器端支持文件的缩略图生成,请忽略此字段。缩略图应满足以下规格:
- JPEG 格式
- 大小小于 200 KB
- 宽度和高度小于 320px。
Send Chat Action 发送聊天动作#
当您需要告诉用户机器人端正在发生某些事情时,使用此操作。状态设置为 5 秒或更短,使用 Bot API sendChatAction 方法。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Send Chat Action 发送聊天动作。
- Chat ID 聊天 ID:输入您希望发送聊天动作的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Action 动作:选择您希望广播机器人正在执行的动作。这里的选项包括:Find Location 查找位置、Typing 输入中、Recording 录制 音频或视频,以及 Uploading 上传 文件类型。
请参阅 Telegram 的 Bot API sendChatAction 文档了解更多信息。
Send Document 发送文档#
使用此操作通过 Bot API sendDocument 方法向聊天发送文档。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Send Document 发送文档。
- Chat ID 聊天 ID:输入您希望发送文档的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果您打开此参数,必须输入包含您要发送的文件的 Input Binary Field 输入二进制字段。
- Document 文档:如果您没有使用 Binary File 二进制文件,请在此处输入要发送的文档。传递
file_id
来发送 Telegram 服务器上存在的文件(推荐)或传递 HTTP URL 让 Telegram 从互联网获取文件。 - Reply Markup 回复标记:使用此参数设置更多界面选项。有关这些选项及其使用方法的更多信息,请参阅 回复标记参数。
请参阅 Telegram 的 Bot API sendDocument 文档了解更多信息。
发送文档附加字段#
使用 Additional Fields 附加字段 通过 Telegram 的 sendDocument 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:
- Caption 标题:输入文件的标题文本,最多 1024 个字符。
- Disable Notification 禁用通知:选择是否静默发送通知(打开)或使用标准通知(关闭)。
- Parse Mode 解析模式:输入用于任何相关文本的解析器。选项包括 HTML(默认)、Markdown (Legacy)、MarkdownV2。有关这些选项的更多信息,请参阅 格式化选项。
- Reply To Message ID 回复消息 ID:如果消息是回复,请输入它所回复的消息的 ID。
- Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
- Thumbnail 缩略图:添加已发送文件的缩略图。如果服务器端支持文件的缩略图生成,请忽略此字段。缩略图应满足以下规格:
- JPEG 格式
- 大小小于 200 KB
- 宽度和高度小于 320px。
Send Location 发送位置#
使用此操作通过 Bot API sendLocation 方法向聊天发送地理位置。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Send Location 发送位置。
- Chat ID 聊天 ID:输入您希望发送位置的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Latitude 纬度:输入位置的纬度。
- Longitude 经度:输入位置的经度。
- Reply Markup 回复标记:使用此参数设置更多界面选项。有关这些选项及其使用方法的更多信息,请参阅 回复标记参数。
请参阅 Telegram 的 Bot API sendLocation 文档了解更多信息。
发送位置附加字段#
使用 Additional Fields 附加字段 通过 Telegram 的 sendLocation 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:
- Disable Notification 禁用通知:选择是否静默发送通知(打开)或使用标准通知(关闭)。
- Reply To Message ID 回复消息 ID:如果消息是回复,请输入它所回复的消息的 ID。
- Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
Send Media Group 发送媒体组#
使用此操作通过 Bot API sendMediaGroup 方法发送一组照片和/或视频。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Send Media Group 发送媒体组。
- Chat ID 聊天 ID:输入您希望发送媒体组的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Media 媒体:使用 Add Media 添加媒体 向您的媒体组添加不同的媒体类型。对于每个媒体,选择:
- Type 类型:这是媒体的类型。从 Photo 照片 和 Video 视频 中选择。
- Media File 媒体文件:输入要发送的媒体文件。传递
file_id
来发送 Telegram 服务器上存在的文件(推荐)或传递 HTTP URL 让 Telegram 从互联网获取文件。 - Additional Fields 附加字段:对于每个媒体文件,您可以选择添加这些字段:
- Caption 标题:输入文件的标题文本,最多 1024 个字符。
- Parse Mode 解析模式:输入用于任何相关文本的解析器。选项包括 HTML(默认)、Markdown (Legacy)、MarkdownV2。有关这些选项的更多信息,请参阅 格式化选项。
请参阅 Telegram 的 Bot API sendMediaGroup 文档了解更多信息。
发送媒体组附加字段#
使用 Additional Fields 附加字段 通过 Telegram 的 sendMediaGroup 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:
- Disable Notification 禁用通知:选择是否静默发送通知(打开)或使用标准通知(关闭)。
- Reply To Message ID 回复消息 ID:如果消息是回复,请输入它所回复的消息的 ID。
- Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
Send Message 发送消息#
使用此操作通过 Bot API sendMessage 方法向聊天发送消息。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Send Message 发送消息。
- Chat ID 聊天 ID:输入您希望发送消息的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Text 文本:输入要发送的文本,实体解析后最多 4096 个字符。
请参阅 Telegram 的 Bot API sendMessage 文档了解更多信息。
发送消息限制
Telegram 将您每秒可以发送的消息数限制为 30 条。如果您预计会达到此限制,请参阅 每秒发送超过 30 条消息 以获取建议的解决方法。
发送消息附加字段#
使用 Additional Fields 附加字段 通过 Telegram 的 sendMessage 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:
- Append n8n Attribution 追加 n8n 归属:选择是否在消息末尾包含短语
This message was sent automatically with n8n
(打开,默认)或不包含(关闭)。 - Disable Notification 禁用通知:选择是否静默发送通知(打开)或使用标准通知(关闭)。
- Disable WebPage Preview 禁用网页预览:选择是否要为此消息中的链接启用链接预览(关闭)或禁用链接预览(打开)。这为
is_disabled
设置了link_preview_options
参数。有关更多信息,请参阅 LinkPreviewOptions 文档。 - Parse Mode 解析模式:输入用于任何相关文本的解析器。选项包括 HTML(默认)、Markdown (Legacy)、MarkdownV2。有关这些选项的更多信息,请参阅 Telegram 的 格式化选项。
- Reply To Message ID 回复消息 ID:如果消息是回复,请输入它所回复的消息的 ID。
- Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
Send and Wait for Response 发送并等待响应#
使用此操作通过 Bot API sendMessage
方法向聊天发送消息并暂停工作流执行,直到用户确认操作。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Send and Wait for Response 发送并等待响应。
- Chat ID 聊天 ID:输入您希望发送消息的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Message 消息:输入要发送的文本。
- Response Type 响应类型:要使用的批准或响应类型:
- Approval 批准:用户可以在消息内批准或拒绝。
- Free Text 自由文本:用户可以通过表单提交响应。
- Custom Form 自定义表单:用户可以通过自定义表单提交响应。
请参阅 Telegram 的 Bot API sendMessage
文档了解更多信息。
发送消息限制
Telegram 将您每秒可以发送的消息数限制为 30 条。如果您预计会达到此限制,请参阅 每秒发送超过 30 条消息 以获取建议的解决方法。
发送并等待响应附加字段#
附加字段取决于您选择的 Response Type 响应类型。
批准#
Approval 批准 响应类型添加以下选项:
- Type of Approval 批准类型:是仅显示批准按钮还是同时显示批准和拒绝按钮。
- Button Label 按钮标签:批准或拒绝按钮的标签。默认选择分别为批准操作的
✅ Approve
和拒绝操作的❌ Decline
。 - Limit Wait Time 限制等待时间:工作流是否会在指定的时间限制后自动恢复执行。这可以是间隔或特定的挂钟时间。
自由文本#
使用自由文本响应类型时,可以使用以下选项:
- Message Button Label 消息按钮标签:用于消息按钮的标签。默认选择是
Respond
。 - Response Form Title 响应表单标题:用户提供响应的表单的标题。
- Response Form Description 响应表单描述:用户提供响应的表单的描述。
- Response Form Button Label 响应表单按钮标签:表单上提交响应按钮的标签。默认选择是
Submit
。 - Limit Wait Time 限制等待时间:工作流是否会在指定的时间限制后自动恢复执行。这可以是间隔或特定的挂钟时间。
自定义表单#
使用自定义表单响应类型时,您可以使用所需的字段和选项构建表单。
您可以使用 n8n 表单触发器的表单元素 中概述的设置自定义每个表单元素。要添加更多字段,请选择 Add Form Element 添加表单元素 按钮。
还可以使用以下选项:
- Message Button Label 消息按钮标签:用于消息按钮的标签。默认选择是
Respond
。 - Response Form Title 响应表单标题:用户提供响应的表单的标题。
- Response Form Description 响应表单描述:用户提供响应的表单的描述。
- Response Form Button Label 响应表单按钮标签:表单上提交响应按钮的标签。默认选择是
Submit
。 - Limit Wait Time 限制等待时间:工作流是否会在指定的时间限制后自动恢复执行。这可以是间隔或特定的挂钟时间。
Send Photo 发送照片#
使用此操作通过 Bot API sendPhoto 方法向聊天发送照片。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Send Photo 发送照片。
- Chat ID 聊天 ID:输入您希望发送照片的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果您打开此参数,必须输入包含您要发送的文件的 Input Binary Field 输入二进制字段。
- Photo 照片:如果您没有使用 Binary File 二进制文件,请在此处输入要发送的照片。传递
file_id
来发送 Telegram 服务器上存在的文件(推荐)或传递 HTTP URL 让 Telegram 从互联网获取文件。 - Reply Markup 回复标记:使用此参数设置更多界面选项。有关这些选项及其使用方法的更多信息,请参阅 回复标记参数。
请参阅 Telegram 的 Bot API sendPhoto 文档了解更多信息。
发送照片附加字段#
使用 Additional Fields 附加字段 通过 Telegram 的 sendPhoto 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:
- Caption 标题:输入文件的标题文本,最多 1024 个字符。
- Disable Notification 禁用通知:选择是否静默发送通知(打开)或使用标准通知(关闭)。
- Parse Mode 解析模式:输入用于任何相关文本的解析器。选项包括 HTML(默认)、Markdown (Legacy)、MarkdownV2。有关这些选项的更多信息,请参阅 Telegram 的 格式化选项。
- Reply To Message ID 回复消息 ID:如果消息是回复,请输入它所回复的消息的 ID。
- Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
Send Sticker 发送贴纸#
使用此方法通过 Bot API sendSticker 方法发送静态 .WEBP、动画 .TGS 或视频 .WEBM 贴纸。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Send Sticker 发送贴纸。
- Chat ID 聊天 ID:输入您希望发送贴纸的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果您打开此参数,必须输入包含您要发送的文件的 Input Binary Field 输入二进制字段。
- Sticker 贴纸:如果您没有使用 Binary File 二进制文件,请在此处输入要发送的照片。传递
file_id
来发送 Telegram 服务器上存在的文件(推荐)或传递 HTTP URL 让 Telegram 从互联网获取文件。 - Reply Markup 回复标记:使用此参数设置更多界面选项。有关这些选项及其使用方法的更多信息,请参阅 回复标记参数。
请参阅 Telegram 的 Bot API sendSticker 文档了解更多信息。
发送贴纸附加字段#
使用 Additional Fields 附加字段 通过 Telegram 的 sendSticker 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:
- Disable Notification 禁用通知:选择是否静默发送通知(打开)或使用标准通知(关闭)。
- Reply To Message ID 回复消息 ID:如果消息是回复,请输入它所回复的消息的 ID。
- Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
Send Video 发送视频#
使用此操作通过 Bot API sendVideo 方法向聊天发送视频文件,Telegram 客户端支持 MPEG4 视频(其他格式可能会作为 文档 发送)。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Send Video 发送视频。
- Chat ID 聊天 ID:输入您希望发送视频的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果您打开此参数,必须输入包含您要发送的文件的 Input Binary Field 输入二进制字段。
- Video 视频:如果您没有使用 Binary File 二进制文件,请在此处输入要发送的视频。传递
file_id
来发送 Telegram 服务器上存在的文件(推荐)或传递 HTTP URL 让 Telegram 从互联网获取文件。 - Reply Markup 回复标记:使用此参数设置更多界面选项。有关这些选项及其使用方法的更多信息,请参阅 回复标记参数。
请参阅 Telegram 的 Bot API sendVideo 文档了解更多信息。
发送视频附加字段#
使用 Additional Fields 附加字段 通过 Telegram 的 sendVideo 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:
- Caption 标题:输入文件的标题文本,最多 1024 个字符。
- Disable Notification 禁用通知:选择是否静默发送通知(打开)或使用标准通知(关闭)。
- Duration 时长:输入以秒为单位的视频时长。
- Height 高度:输入视频高度。
- Parse Mode 解析模式:输入用于任何相关文本的解析器。选项包括 HTML(默认)、Markdown (Legacy)、MarkdownV2。有关这些选项的更多信息,请参阅 Telegram 的 格式化选项。
- Reply To Message ID 回复消息 ID:如果消息是回复,请输入它所回复的消息的 ID。
- Supports Streaming 支持流式传输:选择是否上传的视频适合流式传输。
- Thumbnail 缩略图:添加发送文件的缩略图。如果服务器端支持为文件生成缩略图,请忽略此字段。缩略图应满足以下规格:
- JPEG 格式
- 大小小于 200 KB
- 宽度和高度小于 320px。
- Width 宽度:输入视频宽度。
- Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。
Unpin Chat Message 取消置顶聊天消息#
使用此操作通过 Bot API unpinChatMessage 方法取消置顶聊天中的消息。机器人必须是群组的管理员或者在频道中具有 can_pin_messages 权限。如果不指定 Message ID,则取消置顶所有置顶消息。
输入这些参数:
- Credential to connect with 连接凭据:创建或选择现有的 Telegram 凭据。
- Resource 资源:选择 Message 消息。
- Operation 操作:选择 Unpin Chat Message 取消置顶聊天消息。
- Chat ID 聊天 ID:输入您希望取消置顶消息的频道的 Chat ID 或用户名,格式为
@channelusername
。- 要直接向此节点输入 Chat ID,请使用 Telegram Trigger 节点。有关更多信息,请参阅 常见问题 | 获取 Chat ID。
- Message ID 消息 ID:输入要取消置顶的消息的 ID。如果不指定,则取消置顶所有置顶消息。
请参阅 Telegram 的 Bot API unpinChatMessage 文档了解更多信息。
Reply Markup parameters 回复标记参数#
n8n 的 Telegram 节点支持您通过以下方式发送自定义回复标记:
- Force Reply 强制回复:Telegram 客户端将表现为用户选择了机器人的消息并点击了 Reply 回复,自动为用户显示回复界面。有关此选项的更多指导,请参阅 强制回复参数。
- Inline Keyboard 内联键盘:在消息旁边显示内联键盘。有关此选项的更多指导,请参阅 内联键盘参数。
- Reply Keyboard 回复键盘:显示带有回复选项的自定义键盘。有关此选项的更多指导,请参阅 回复键盘参数。
- Reply Keyboard Remove 移除回复键盘:Telegram 客户端将移除当前的自定义键盘并显示默认的字母键盘。有关此选项的更多指导,请参阅 移除回复键盘参数。
Telegram Business 商业账户
Telegram 在频道和代表 Telegram Business 商业账户发送的消息中限制以下选项:
- Force Reply 强制回复
- Reply Keyboard 回复键盘
- Reply Keyboard Remove 移除回复键盘
Force Reply parameters 强制回复参数#
Force Reply 强制回复 对于在不牺牲隐私模式的情况下创建用户友好的分步界面很有用。
如果您选择 Reply Markup 回复标记 > Force Reply 强制回复,请从以下 Force Reply 强制回复 参数中进行选择:
- Force Reply 强制回复:打开以向用户显示回复界面,如上所述。
- Selective 选择性:如果您只想强制以下用户回复,请打开此选项:
- 在消息文本中被
@提及
的用户。 - 原始消息的发送者,如果此发送动画消息是对某条消息的回复。
- 在消息文本中被
有关更多信息,请参阅 ForceReply。
Inline Keyboard parameters 内联键盘参数#
如果您选择 Reply Markup 回复标记 > Inline Keyboard 内联键盘,请使用 Add Button 添加按钮 选项定义您想要显示的内联键盘按钮。要为键盘添加更多行,请使用 Add Keyboard Row 添加键盘行。
有关更多信息,请参阅 InlineKeyboardMarkup 和 InlineKeyboardButtons。
Reply Keyboard parameters 回复键盘参数#
如果您选择 Reply Markup 回复标记 > Reply Keyboard 回复键盘,请使用 Reply Keyboard 回复键盘 部分定义回复键盘中的按钮和行。
使用 Reply Keyboard Options 回复键盘选项 进一步优化键盘的行为:
- Resize Keyboard 调整键盘大小:选择是否请求 Telegram 客户端垂直调整键盘大小以获得最佳适配(打开)或是否使用与应用程序标准键盘相同的高度(关闭)。
- One Time Keyboard 一次性键盘:选择是否 Telegram 客户端应在用户使用键盘后立即隐藏它(打开)或继续显示它(关闭)。
- Selective 选择性:如果您只想向以下用户显示键盘,请打开此选项:
- 在消息文本中被
@提及
的用户。 - 原始消息的发送者,如果此发送动画消息是对某条消息的回复。
- 在消息文本中被
有关更多信息,请参阅 ReplyKeyboardMarkup。
Reply Keyboard Remove parameters 移除回复键盘参数#
如果您选择 Reply Markup 回复标记 > Reply Keyboard Remove 移除回复键盘,请从以下 Reply Keyboard Remove 移除回复键盘 参数中进行选择:
- Remove Keyboard 移除键盘:选择是否请求 Telegram 客户端移除自定义键盘(打开)或保留它(关闭)。
- Selective 选择性:如果您只想为以下用户移除键盘,请打开此选项:
- 在消息文本中被
@提及
的用户。 - 原始消息的发送者,如果此发送动画消息是对某条消息的回复。
- 在消息文本中被
有关更多信息,请参阅 ReplyKeyboardRemove。