n8n 中文文档

消息操作

使用这些操作可以发送、编辑和删除聊天中的消息;发送文件到聊天室;以及从聊天中固定/取消固定消息。有关 Telegram 节点本身的更多信息,请参阅 Telegram。

提示

Add bot to channel 将机器人添加到频道

要使用其中大部分操作,您必须将机器人添加到频道,以便它可以向该频道发送消息。请参阅常见问题 |将机器人添加到 Telegram 频道 了解更多信息。

提示

This node can be used as an AI tool 该节点可用作AI工具

该节点可用于增强人工智能代理的能力。以这种方式使用时,可以自动设置许多参数,或者使用 AI 指导的信息 - 在 AI 工具参数文档 中了解更多信息。

提示

Human-in-the-loop for AI tool calls AI 工具调用的人机交互

该节点可用作 AI 代理工具调用的人工审核步骤。以这种方式配置时,AI 代理将在执行需要监督的工具之前暂停并通过此服务请求人工批准。如需了解更多信息,请参阅AI 工具调用的人机交互。

删除聊天消息

使用此操作通过 Bot API deleteMessage{:target=_blank .external-link} 方法从聊天中删除消息。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Delete Chat Message 删除聊天消息。
  • Chat ID 聊天ID:以 @channelusername 格式输入您要删除的频道的聊天 ID 或用户名。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Message ID 消息ID:输入要删除的消息的唯一标识符。

请参阅 Telegram Bot API deleteMessage{:target=_blank .external-link} 文档了解更多信息。

编辑消息文本

使用此操作通过 Bot API editMessageText{:target=_blank .external-link} 方法编辑现有消息的文本。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Edit Message Text 编辑消息文本。
  • Chat ID 聊天ID:以 @channelusername 格式输入您要离开的频道的聊天 ID 或用户名。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Message ID 消息ID:输入要编辑的消息的唯一标识符。
  • Reply Markup 回复标记:选择是否使用Inline Keyboard 内联键盘来显示InlineKeyboardMarkup None 无。这将设置 reply_markup 参数。有关详细信息,请参阅 InlineKeyboardMarkup 文档。
  • Text 文字:输入您想要编辑消息的文本。

请参阅 Telegram Bot API editMessageText{:target=_blank .external-link} 文档了解更多信息。

编辑消息文本附加字段

使用 Additional Fields 附加字段 进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:

  • Disable WebPage Preview 禁用网页预览:选择是否要启用此消息中的链接的链接预览(关闭)或禁用此消息中的链接的链接预览(打开)。这将为 is_disabled 设置 link_preview_options 参数。有关详细信息,请参阅 LinkPreviewOptions 文档。
  • Parse Mode 解析模式:选择是否应使用 HTML(默认)、Markdown (Legacy) 降价(旧版) 或 MarkdownV2 解析消息。这将设置 parse_mode 参数。

固定聊天消息

使用此操作通过 Bot API pinChatMessage{:target=_blank .external-link} 方法为聊天置顶消息。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Pin Chat Message 固定聊天消息。
  • Chat ID 聊天ID:以 @channelusername 格式输入您希望将消息固定到的频道的聊天 ID 或用户名。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Message ID 消息ID:输入您要固定的消息的唯一标识符。

请参阅 Telegram Bot API pinChatMessage{:target=_blank .external-link} 文档了解更多信息。

固定聊天消息附加字段

使用 Additional Fields 附加字段 进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:

  • Disable Notifications 禁用通知:默认情况下,Telegram 将通知所有聊天成员该消息已被固定。如果您不希望这些通知消失,请打开此控件。将 disable_notification 参数设置为 true。

发送动画

使用此操作通过 Bot API sendAnimation{:target=_blank .external-link} 方法向聊天发送 GIF 或无声音的 H.264/MPEG-4 AVC 视频,最大 50 MB。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Send Animation 发送动画。
  • Chat ID 聊天ID:以 @channelusername 格式输入您想要将动画发送到的频道的聊天 ID 或用户名。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果打开此参数,则必须输入包含要发送的文件的 Input Binary Field 输入二进制字段。
  • Animation 动画:如果您不使用Binary File 二进制文件,请在此处输入要发送的动画。传递 file_id 来发送 Telegram 服务器上存在的文件(推荐),或传递给 Telegram 的 HTTP URL 以从互联网获取文件。
  • Reply Markup 回复标记:使用此参数设置更多接口选项。有关这些选项以及如何使用它们的更多信息,请参阅回复标记参数。

请参阅 Telegram Bot API sendAnimation{:target=_blank .external-link} 文档了解更多信息。

发送动画附加字段

使用 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 宽度:输入视频剪辑的宽度。

发送音频

使用此操作通过 Bot API sendAudio{:target=_blank .external-link} 方法向聊天发送音频文件并在音乐播放器中显示。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Send Audio 发送音频。
  • Chat ID 聊天ID:输入您想要将音频发送到的频道的聊天 ID 或用户名,格式为 @channelusername。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果打开此参数,则必须输入包含要发送的文件的 Input Binary Field 输入二进制字段。
  • Audio 音频:如果您不使用 Binary File 二进制文件,请在此处输入要发送的音频。传递 file_id 来发送 Telegram 服务器上存在的文件(推荐),或传递给 Telegram 的 HTTP URL 以从互联网获取文件。
  • Reply Markup 回复标记:使用此参数设置更多接口选项。有关这些选项以及如何使用它们的更多信息,请参阅回复标记参数。

请参阅 Telegram Bot API sendAudio{:target=_blank .external-link} 文档了解更多信息。

发送音频附加字段

使用 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。

发送聊天操作

当您需要告诉用户机器人端正在发生某些事情时,使用此操作。状态设置为 5 秒或更短,使用 Bot API sendChatAction{:target=_blank .external-link} 方法。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Send Chat Action 发送聊天操作。
  • Chat ID 聊天ID:输入您希望将聊天操作发送到的频道的聊天 ID 或用户名,格式为 @channelusername。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Action 行动:选择您想要广播机器人所采取的操作。此处的选项包括:Find Location 查找位置、Typing 打字、Recording 录音 音频或视频以及 Uploading 上传中 文件类型。

请参阅 Telegram 的 Bot API sendChatAction{:target=_blank .external-link} 文档了解更多信息。

发送文档

使用此操作通过 Bot API sendDocument{:target=_blank .external-link} 方法向聊天发送文档。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Send Document 发送文件。
  • Chat ID 聊天ID:以 @channelusername 格式输入您想要将文档发送到的频道的聊天 ID 或用户名。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果打开此参数,则必须输入包含要发送的文件的 Input Binary Field 输入二进制字段。
  • Document 文件:如果您不使用 Binary File 二进制文件,请在此处输入要发送的文档。传递 file_id 来发送 Telegram 服务器上存在的文件(推荐),或传递给 Telegram 的 HTTP URL 以从互联网获取文件。
  • Reply Markup 回复标记:使用此参数设置更多接口选项。有关这些选项以及如何使用它们的更多信息,请参阅回复标记参数。

请参阅 Telegram 的 Bot API sendDocument{:target=_blank .external-link} 文档了解更多信息。

发送文档附加字段

使用 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。

发送位置

使用此操作通过 Bot API sendLocation{:target=_blank .external-link} 方法向聊天发送地理位置。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Send Location 发送位置。
  • Chat ID 聊天ID:输入您想要将位置发送到的频道的聊天 ID 或用户名,格式为 @channelusername。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Latitude 纬度:输入位置的纬度。
  • Longitude 经度:输入位置的经度。
  • Reply Markup 回复标记:使用此参数设置更多接口选项。有关这些选项以及如何使用它们的更多信息,请参阅回复标记参数。

请参阅 Telegram 的 Bot API sendLocation{:target=_blank .external-link} 文档了解更多信息。

发送位置附加字段

使用 Additional Fields 附加字段 通过 Telegram 的 sendLocation 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:

  • Disable Notification 禁用通知:选择是否静默发送通知(打开)或使用标准通知(关闭)。
  • Reply To Message ID 回复消息 ID:如果消息是回复,请输入它所回复的消息的 ID。
  • Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。

发送媒体组

使用此操作通过 Bot API sendMediaGroup{:target=_blank .external-link} 方法发送一组照片和/或视频。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Send Media Group 发送媒体组。
  • Chat ID 聊天ID:输入您想要将媒体组发送到的频道的聊天 ID 或用户名,格式为 @channelusername。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Media 媒体:使用 Add Media 添加媒体 将不同的媒体类型添加到媒体组。 For each medium, select:
  • Type 类型:媒体类型。从 Photo 照片 和 Video 视频 中选择。
  • Media File 媒体文件:输入要发送的媒体文件。传递 file_id 发送 Telegram 服务器上存在的文件(推荐),或传递 Telegram 的 HTTP URL 以从互联网获取文件。
  • Additional Fields 附加字段:对于每个媒体文件,您可以选择添加以下字段:
    • Caption 标题:输入文件的标题文本,最多 1024 个字符。
    • Parse Mode 解析模式:输入用于任何相关文本的解析器。选项包括 HTML(默认)、Markdown (Legacy) 降价(旧版)、MarkdownV2。有关这些选项的详细信息,请参阅格式化选项。

请参阅 Telegram 的 Bot API sendMediaGroup{:target=_blank .external-link} 文档了解更多信息。

发送媒体组附加字段

使用 Additional Fields 附加字段 通过 Telegram 的 sendMediaGroup 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:

  • Disable Notification 禁用通知:选择是静默发送通知(打开)还是使用标准通知(关闭)。
  • Reply To Message ID 回复消息ID:如果消息是回复,请输入正在回复的消息的 ID。
  • Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级组。

发送消息

使用此操作通过 Bot API sendMessage{:target=_blank .external-link} 方法向聊天发送消息。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Send Message 发送消息。
  • Chat ID 聊天ID:以 @channelusername 格式输入您想要发送消息的频道的聊天 ID 或用户名。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Text 文字:输入要发送的文本,实体解析后最多 4096 个字符。

请参阅 Telegram 的 Bot API sendMessage{:target=_blank .external-link} 文档了解更多信息。

警告

Send Message limits 发送消息限制

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{:target=_blank .external-link} 文档。
  • Parse Mode 解析模式:输入用于任何相关文本的解析器。选项包括 HTML(默认)、Markdown (Legacy)、MarkdownV2。有关这些选项的更多信息,请参阅 Telegram 的 格式化选项{:target=_blank .external-link}。
  • Reply To Message ID 回复消息 ID:如果消息是回复,请输入它所回复的消息的 ID。
  • Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级群组。

发送并等待响应

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

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Send and Wait for Response 发送并等待响应。
  • Chat ID 聊天ID:以 @channelusername 格式输入您想要发送消息的频道的聊天 ID 或用户名。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Message 留言:输入要发送的文本。
  • Response Type 响应类型:要使用的批准或响应类型:
  • Approval 批准:用户可以在消息中批准或拒绝。
  • Free Text 自由文本:用户可以通过表单提交回复。
  • Custom Form 定制表格:用户可以使用自定义表单提交回复。

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

警告

Send Message limits 发送消息限制

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

发送并等待响应附加字段

附加字段取决于您选择的 Response Type 响应类型。

批准

Approval 批准 响应类型添加以下选项:

  • Type of Approval 批准类型:是仅显示批准按钮还是同时显示批准和拒绝按钮。
  • Button Label 按钮标签:批准或拒绝按钮的标签。默认选择分别为批准操作的 ✅ Approve 和拒绝操作的 ❌ Decline。
  • Limit Wait Time 限制等待时间:工作流是否会在指定的时间限制后自动恢复执行。这可以是间隔或特定的挂钟时间。
  • Approve Within Chat 聊天内审批:审批者是否可以直接点击消息按钮一次完成响应,而不是在浏览器中打开链接。此选项位于 Advanced Interactivity 高级交互 部分标题下。更多信息请参阅下面的 Approve Within Chat 聊天内审批。

Approve Within Chat 聊天内审批

提示

要求

要使用 Approve Within Chat 聊天内审批,你的 n8n 实例必须可通过互联网以 HTTPS 访问,并使用 Telegram 支持 webhook 的端口 443、80、88 或 8443。无需在 Telegram 端注册任何内容,也无需配置额外密钥:n8n 会使用你现有的 Telegram 凭证 为你注册 webhook。

开启 Approve Within Chat 聊天内审批 后,审批者可以直接点击消息按钮一次完成响应,而不是在浏览器中打开链接:

  • 节点输出会包含响应者的 Telegram user ID、username 和 name。
  • 你可以限制允许谁响应。其他人的点击不会让执行继续,并且该用户会看到一个弹窗,提示他们未被授权。
  • 做出决定后,n8n 会编辑消息:具体行为取决于下面的 After Decision 决定后 选项。

Telegram 每个 bot 只允许一个 webhook。如果你还使用同一个 bot 的 Telegram Trigger,n8n 会自动在该 trigger 和 Approve Within Chat 聊天内审批 之间共享 webhook:你不需要第二个 bot。如果该 trigger 的工作流是在此功能可用之前激活的,请重新激活该工作流(或将其更新到最新版本),以便按钮点击到达 n8n。如果该 bot 的 webhook 已被 n8n 之外的其他系统使用,请为 Approve Within Chat 聊天内审批 使用另一个 bot,或关闭此选项。

提示

回退到链接按钮

如果你的实例无法通过公共 HTTPS 访问,或你关闭 Approve Within Chat 聊天内审批,该节点会回退为发送链接按钮。

提示

私聊、群组和频道

按钮点击在私聊、群组和频道中的行为相同。与任何其他 Message 消息 操作一样,你的 bot 需要是频道成员才能在那里发布和编辑消息。更多信息请参阅常见问题 | 将 bot 添加到 Telegram 频道。

开启 Approve Within Chat 聊天内审批 后,会在同一个 Advanced Interactivity 高级交互 部分下显示这些字段:

  • Restrict Who Can Approve 限制谁可以审批:允许 approve 或 decline 的 Telegram user IDs。多个 ID 用逗号分隔。如果留空,任何能看到消息的人都可以响应。
  • Unauthorized Reply 未授权回复:当不在审批者列表中的人点击按钮时,以 Telegram 弹窗显示的消息。
  • After Decision 决定后:某人响应后,消息会发生什么:
    • Show Outcome and Remove Buttons 显示结果并移除按钮:移除按钮,并添加一行显示是谁 approved 或 declined。
    • Remove Buttons Only 仅移除按钮:移除按钮,但不添加结果行。
    • Keep Message Unchanged 保持消息不变:保持消息原样。

自由文本

使用自由文本响应类型时,可以使用以下选项:

  • 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 限制等待时间:工作流是否会在指定的时间限制后自动恢复执行。这可以是间隔或特定的挂钟时间。

发送照片

使用此操作通过 Bot API sendPhoto{:target=_blank .external-link} 方法向聊天发送照片。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Send Photo 发送照片。
  • Chat ID 聊天ID:以 @channelusername 格式输入您想要将照片发送到的频道的聊天 ID 或用户名。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果打开此参数,则必须输入包含要发送的文件的 Input Binary Field 输入二进制字段。
  • Photo 照片:如果您不使用 Binary File 二进制文件,请在此处输入要发送的照片。传递 file_id 来发送 Telegram 服务器上存在的文件(推荐),或传递给 Telegram 的 HTTP URL 以从互联网获取文件。
  • Reply Markup 回复标记:使用此参数设置更多接口选项。有关这些选项以及如何使用它们的更多信息,请参阅回复标记参数。

请参阅 Telegram 的 Bot API sendPhoto{:target=_blank .external-link} 文档了解更多信息。

发送照片附加字段

使用 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:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级组。

发送贴纸

使用此方法通过 Bot API sendSticker{:target=_blank .external-link} 方法发送静态 .WEBP、动画 .TGS 或视频 .WEBM 贴纸。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Send Sticker 发送贴纸。
  • Chat ID 聊天ID:以 @channelusername 格式输入您想要发送贴纸的频道的聊天 ID 或用户名。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果打开此参数,则必须输入包含要发送的文件的 Input Binary Field 输入二进制字段。
  • Sticker 贴纸:如果您不使用 Binary File 二进制文件,请在此处输入要发送的照片。传递 file_id 来发送 Telegram 服务器上存在的文件(推荐),或传递给 Telegram 的 HTTP URL 以从互联网获取文件。
  • Reply Markup 回复标记:使用此参数设置更多接口选项。有关这些选项以及如何使用它们的更多信息,请参阅回复标记参数。

请参阅 Telegram 的 Bot API sendSticker{:target=_blank .external-link} 文档了解更多信息。

发送贴纸附加字段

使用 Additional Fields 附加字段 通过 Telegram 的 sendSticker 方法中的可选字段进一步优化节点的行为。选择 Add Field 添加字段 来添加以下任何选项:

  • Disable Notification 禁用通知:选择是静默发送通知(打开)还是使用标准通知(关闭)。
  • Reply To Message ID 回复消息ID:如果消息是回复,请输入正在回复的消息的 ID。
  • Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级组。

发送视频

使用此操作通过 Bot API sendVideo{:target=_blank .external-link} 方法向聊天发送视频文件,Telegram 客户端支持 MPEG4 视频(其他格式可能会作为 文档 发送)。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Send Video 发送视频。
  • Chat ID 聊天ID:输入您想要将视频发送到的频道的聊天 ID 或用户名,格式为 @channelusername。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Binary File 二进制文件:要从节点本身发送二进制文件,请打开此选项。如果打开此参数,则必须输入包含要发送的文件的 Input Binary Field 输入二进制字段。
  • Video 视频:如果您不使用 Binary File 二进制文件,请在此处输入要发送的视频。传递 file_id 来发送 Telegram 服务器上存在的文件(推荐),或传递给 Telegram 的 HTTP URL 以从互联网获取文件。
  • Reply Markup 回复标记:使用此参数设置更多接口选项。有关这些选项以及如何使用它们的更多信息,请参阅回复标记参数。

请参阅 Telegram 的 Bot API sendVideo{:target=_blank .external-link} 文档了解更多信息。

发送视频附加字段

使用 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。
  • Message Thread ID 消息线程 ID:输入论坛目标消息线程(主题)的唯一标识符;仅适用于论坛超级组。
  • Thumbnail 缩略图:添加发送文件的缩略图。如果服务器端支持文件缩略图生成,请忽略此字段。缩略图应满足以下规格:
  • JPEG 格式
  • 大小小于 200 KB
  • 宽度和高度小于 320px。
  • Width 宽度:输入视频的宽度。

取消固定聊天消息

使用此操作通过 Bot API unpinChatMessage{:target=_blank .external-link} 方法取消置顶聊天中的消息。机器人必须是群组的管理员或者在频道中具有 can_pin_messages 权限。如果不指定 Message ID,则取消置顶所有置顶消息。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的Telegram凭证。
  • Resource 资源:选择Message 留言。
  • Operation 操作:选择Pin Chat Message 固定聊天消息。
  • Chat ID 聊天ID:输入您想要取消固定消息的频道的聊天 ID 或用户名,格式为 @channelusername。
  • 要将聊天 ID 直接输入此节点,请使用 Telegram Trigger 节点。请参阅常见问题 |获取聊天 ID 了解更多信息。
  • Message ID 消息ID:输入您要取消固定的消息的唯一标识符。

请参阅 Telegram 的 Bot API unpinChatMessage{:target=_blank .external-link} 文档了解更多信息。

回复标记参数

n8n 的 Telegram 节点支持您通过以下方式发送自定义回复标记:

  • Force Reply 强制回复:Telegram 客户端将如同用户选择了机器人的消息并点击 Reply 回复 一样,自动向用户显示回复界面。有关此选项的进一步指导,请参阅强制回复参数。
  • Inline Keyboard 内联键盘:在消息旁边显示内联键盘。有关此选项的进一步指导,请参阅内联键盘参数。
  • Reply Keyboard 回复键盘:显示带有回复选项的自定义键盘。有关此选项的进一步指导,请参阅回复键盘参数。
  • Reply Keyboard Remove 回复 键盘删除:Telegram客户端将删除当前的自定义键盘并显示默认的字母键盘。有关此选项的进一步指导,请参阅回复键盘参数。

提示

Telegram Business accounts 电报企业帐户

Telegram 限制频道中的以下选项以及代表 Telegram Business 帐户发送的消息:

  • 强制回复
  • 回复键盘
  • 回复键盘删除

强制回复参数

如果您想创建用户友好的分步界面而不牺牲隐私模式,Force Reply 强制回复 非常有用。

如果您选择 Reply Markup 回复标记 > Force Reply 强制回复,请从以下 Force Reply 强制回复 参数中进行选择:

  • Force Reply 强制回复:开启后向用户显示回复界面,如上所述。
  • Selective 选择性:如果您只想强制这些用户回复,请打开此选项:
  • 消息正文中为 @mentioned 的用户。
  • 如果此发送动画消息是对消息的回复,则原始消息的发送者。

有关更多信息,请参阅 ForceReply{:target=_blank .external-link}。

直插键盘参数

如果您选择 Reply Markup 回复标记 > Inline Keyboard 内联键盘,请使用 Add Button 添加按钮 选项定义您想要显示的内联键盘按钮。要为键盘添加更多行,请使用 Add Keyboard Row 添加键盘行。

有关更多信息,请参阅 InlineKeyboardMarkup{:target=_blank .external-link} 和 InlineKeyboardButtons{:target=_blank .external-link}。

回复 键盘参数

如果您选择 Reply Markup 回复标记 > Reply Keyboard 回复键盘,请使用 Reply Keyboard 回复键盘 部分定义回复键盘中的按钮和行。

使用 Reply Keyboard Options 回复键盘选项 进一步优化键盘的行为:

  • Resize Keyboard 调整键盘大小:选择是否请求 Telegram 客户端垂直调整键盘大小以实现最佳适配(打开),或者是否使用与应用程序标准键盘相同的高度(关闭)。
  • One Time Keyboard 一次性键盘:选择 Telegram 客户端是否应在用户使用键盘时立即隐藏键盘(打开)或继续显示键盘(关闭)。
  • Selective 选择性:如果您只想向这些用户显示键盘,请打开此选项:
  • 消息正文中为 @mentioned 的用户。
  • 如果此发送动画消息是对消息的回复,则原始消息的发送者。

有关更多信息,请参阅 ReplyKeyboardMarkup{:target=_blank .external-link}。

回复键盘删除参数

如果您选择 Reply Markup 回复标记 > Reply Keyboard Remove 移除回复键盘,请从以下 Reply Keyboard Remove 移除回复键盘 参数中进行选择:

  • Remove Keyboard 移除键盘:选择是请求 Telegram 客户端删除自定义键盘(打开)还是保留它(关闭)。
  • Selective 选择性:如果您只想为这些用户删除键盘,请打开此选项:
  • 消息正文中为 @mentioned 的用户。
  • 如果此发送动画消息是对消息的回复,则原始消息的发送者。

有关更多信息,请参阅 ReplyKeyboardRemove{:target=_blank .external-link}。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。