跳至内容

Telegram节点消息操作#

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

将机器人添加到频道

要使用大多数这些操作，您必须将您的机器人添加到频道中，以便它可以向该频道发送消息。更多信息请参考常见问题 | 将机器人添加到Telegram频道。

该节点可用作AI工具

该节点可用于增强AI智能体的能力。以这种方式使用时，许多参数可以自动设置，或由AI引导信息进行配置 - 更多详情请参阅AI工具参数文档。

s

删除聊天消息#

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

输入以下参数：

  • 连接凭证: 创建或选择现有的Telegram凭证。
  • 资源: 选择 消息.
  • 操作: 选择 删除聊天消息.
  • Chat ID: Enter the Chat ID or username of the channel you wish to delete in the format @channelusername.
  • 消息ID: 输入您想要删除的消息的唯一标识符。

更多信息请参考Telegram Bot API的deleteMessage文档。

编辑消息文本#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择编辑消息文本.
  • Chat ID: Enter the Chat ID or username of the channel you wish to leave in the format @channelusername.
  • 消息ID: 输入您想要编辑的消息的唯一标识符。
  • 回复标记: 选择是否使用内联键盘来显示InlineKeyboardMarkup，选择无则不显示。这将设置reply_markup参数。更多信息请参阅InlineKeyboardMarkup文档。
  • 文本: 输入您想要编辑消息的文本内容。

更多信息请参考Telegram Bot API的editMessageText文档。

编辑消息文本附加字段#

使用附加字段进一步优化节点的行为。选择添加字段可添加以下任意内容：

  • 禁用网页预览: 选择是否要为此消息中的链接启用预览(关闭)或禁用预览(开启)。这将设置link_preview_options参数中的is_disabled值。更多信息请参阅LinkPreviewOptions文档。
  • Parse Mode: Choose whether the message should be parsed using HTML (default), Markdown (Legacy), or MarkdownV2. This sets the parse_mode parameter.

置顶聊天消息#

使用此操作通过Bot API的pinChatMessage方法为聊天固定消息。

输入以下参数：

  • 连接凭证: 创建或选择现有的Telegram凭证。
  • 资源: 选择 消息.
  • 操作: 选择置顶聊天消息.
  • Chat ID: Enter the Chat ID or username of the channel you wish to pin the message to in the format @channelusername.
  • 消息ID: 输入您想要置顶消息的唯一标识符。

更多信息请参考Telegram Bot API的pinChatMessage文档。

置顶聊天消息附加字段#

使用附加字段进一步优化节点的行为。选择添加字段可添加以下任意内容：

  • 禁用通知: 默认情况下，Telegram会通知所有聊天成员该消息已被置顶。如果您不希望发送这些通知，请启用此选项。将disable_notification参数设置为true。

发送动画#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息.
  • 操作: 选择发送动画。
  • Chat ID: Enter the Chat ID or username of the channel you wish to send the animation to in the format @channelusername.
  • 二进制文件: 要从节点本身发送二进制文件，请启用此选项。如果启用此参数，则必须输入包含要发送文件的输入二进制字段。
  • 动画: 如果不使用二进制文件，在此处输入要发送的动画。传递file_id可发送存在于Telegram服务器上的文件（推荐），或传递HTTP URL让Telegram从互联网获取文件。
  • 回复标记: 使用此参数设置更多界面选项。有关这些选项及使用方法的更多信息，请参阅回复标记参数。

更多信息请参考Telegram Bot API的sendAnimation文档。

发送动画附加字段#

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

  • 标题: 输入动画的标题文本，最多1024个字符。
  • 禁用通知: 选择是否静默发送通知（开启）或发送标准通知（关闭）。
  • 持续时间: 输入动画的持续时间（以秒为单位）。
  • 高度: 输入动画的高度。
  • 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。
  • 消息主题ID: 输入论坛目标消息主题（话题）的唯一标识符；仅适用于论坛超级群组。
  • 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格式
    • 小于200 KB大小
    • 宽度和高度小于320像素。
  • 宽度: 输入视频片段的宽度。

发送音频#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择发送音频。
  • Chat ID: Enter the Chat ID or username of the channel you wish to send the audio to in the format @channelusername.
  • 二进制文件: 要从节点本身发送二进制文件，请启用此选项。如果启用此参数，则必须输入包含要发送文件的输入二进制字段。
  • 音频: 如果不使用二进制文件，在此处输入要发送的音频。传递file_id可发送Telegram服务器上已存在的文件（推荐），或传递HTTP URL让Telegram从互联网获取文件。
  • 回复标记: 使用此参数设置更多界面选项。有关这些选项及使用方法的更多信息，请参阅回复标记参数。

更多信息请参考Telegram Bot API的sendAudio文档。

发送音频附加字段#

使用附加字段通过Telegram的sendAudio方法中的可选字段进一步调整节点的行为。选择添加字段可添加以下任意内容：

  • Caption: 输入音频的标题文本，最多1024个字符。
  • 禁用通知: 选择是否静默发送通知（开启）或发送标准通知（关闭）。
  • 时长: 输入音频的时长（以秒为单位）。
  • 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。
  • 消息主题ID: 输入论坛目标消息主题（话题）的唯一标识符；仅适用于论坛超级群组。
  • 标题: 输入音轨的名称。
  • 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格式
    • 小于200 KB大小
    • 宽度和高度小于320像素。

发送聊天动作#

当需要告知用户机器人端正在执行某些操作时，可使用此功能。通过Bot API的sendChatAction方法设置状态，持续时间不超过5秒。

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择 发送聊天动作.
  • Chat ID: Enter the Chat ID or username of the channel you wish to send the chat action to in the format @channelusername.
  • 操作: 选择您希望机器人展示正在执行的动作。可选操作包括: 查找位置, 正在输入, 录制音频或视频, 以及上传文件类型。

更多信息请参考Telegram的Bot API sendChatAction文档。

发送文档#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择发送文档。
  • Chat ID: Enter the Chat ID or username of the channel you wish to send the document to in the format @channelusername.
  • 二进制文件: 要从节点本身发送二进制文件，请启用此选项。如果启用此参数，则必须输入包含要发送文件的输入二进制字段。
  • 文档: 如果不使用二进制文件，请在此处输入要发送的文档。传递file_id可发送存在于Telegram服务器上的文件（推荐），或传递HTTP URL让Telegram从互联网获取文件。
  • 回复标记: 使用此参数设置更多界面选项。有关这些选项及使用方法的更多信息，请参阅回复标记参数。

更多信息请参考Telegram的Bot API sendDocument文档。

发送文档附加字段#

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

  • Caption: 输入文件的标题文本，最多1024个字符。
  • 禁用通知: 选择是否静默发送通知（开启）或发送标准通知（关闭）。
  • 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。
  • 消息主题ID: 输入论坛目标消息主题（话题）的唯一标识符；仅适用于论坛超级群组。
  • 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格式
    • 小于200 KB大小
    • 宽度和高度小于320像素。

发送位置#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择 发送位置。
  • Chat ID: Enter the Chat ID or username of the channel you wish to send the location to in the format @channelusername.
  • 纬度: 输入该地点的纬度。
  • 经度: 输入该地点的经度。
  • 回复标记: 使用此参数设置更多界面选项。有关这些选项及使用方法的更多信息，请参阅回复标记参数。

更多信息请参考Telegram的Bot API sendLocation文档。

发送位置附加字段#

使用附加字段通过Telegram的sendLocation方法中的可选字段进一步调整节点的行为。选择添加字段可添加以下任意内容：

  • 禁用通知: 选择是否静默发送通知（开启）或发送标准通知（关闭）。
  • 回复消息ID: 如果该消息是回复消息，请输入它所回复的消息ID。
  • 消息主题ID: 输入论坛目标消息主题（话题）的唯一标识符；仅适用于论坛超级群组。

发送媒体组#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择 发送媒体组.
  • 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:
    • 类型: 媒体的类型。可选值包括照片和视频。
    • 媒体文件: 输入要发送的媒体文件。传递file_id来发送存在于Telegram服务器上的文件（推荐），或者提供一个HTTP URL让Telegram从互联网获取文件。
    • Additional Fields: For each media file, you can choose to add these fields:
      • Caption: 输入文件的标题文本，最多1024个字符。
      • 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文档。

发送媒体组附加字段#

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

  • 禁用通知: 选择是否静默发送通知（开启）或发送标准通知（关闭）。
  • 回复消息ID: 如果该消息是回复消息，请输入它所回复的消息ID。
  • 消息主题ID: 输入论坛目标消息主题（话题）的唯一标识符；仅适用于论坛超级群组。

发送消息#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择发送消息.
  • Chat ID: Enter the Chat ID or username of the channel you wish to send the message to in the format @channelusername.
  • 文本: 输入要发送的文本，实体解析后最多4096个字符。

更多信息请参考Telegram的Bot API sendMessage文档。

发送消息限制

Telegram限制每秒最多只能发送30条消息。如果您预计会达到此限制，请参考每秒发送超过30条消息获取建议的解决方案。

发送消息附加字段#

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

  • 附加n8n归属声明: 选择是否在消息末尾包含This message was sent automatically with n8n这句话（默认开启）或不包含（关闭）。
  • 禁用通知: 选择是否静默发送通知（开启）或发送标准通知（关闭）。
  • 禁用网页预览: 选择是否要为此消息中的链接启用预览(关闭)或禁用预览(开启)。这将设置link_preview_options参数中的is_disabled值。更多信息请参阅LinkPreviewOptions文档。
  • 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。
  • 消息主题ID: 输入论坛目标消息主题（话题）的唯一标识符；仅适用于论坛超级群组。

发送并等待响应#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择发送并等待响应.
  • Chat ID: Enter the Chat ID or username of the channel you wish to send the message to in the format @channelusername.
  • 消息: 输入要发送的文本。
  • Response Type: The approval or response type to use:
    • 审批: 用户可以直接在消息内进行批准或拒绝操作。
    • 自由文本: 用户可以通过表单提交响应。
    • 自定义表单: 用户可以通过自定义表单提交响应。

更多信息请参考Telegram的Bot API sendMessage文档。

发送消息限制

Telegram限制每秒最多只能发送30条消息。如果您预计会达到此限制，请参考每秒发送超过30条消息获取建议的解决方案。

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

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

审批#

Approval响应类型添加了以下选项：

  • 审批类型: 选择仅显示批准按钮，还是同时显示批准和拒绝按钮。
  • 按钮标签: 用于批准或拒绝按钮的标签。默认选项分别为批准操作的✅ Approve和拒绝操作的❌ Decline。
  • 限制等待时间: 工作流是否会在指定时间限制后自动恢复执行。可以是时间间隔或具体的挂钟时间。

自由文本#

使用自由文本响应类型时，提供以下选项：

  • 消息按钮标签: 用于消息按钮的标签文本。默认选项是Respond。
  • 响应表单标题: 用户提供反馈的表单标题。
  • 响应表单描述: 用户提供响应时表单的描述。
  • 响应表单按钮标签: 表单上用于提交响应的按钮标签。默认选项是Submit。
  • 限制等待时间: 工作流是否会在指定时间限制后自动恢复执行。可以是时间间隔或具体的挂钟时间。

自定义表单#

使用自定义表单响应类型时，您可以根据需要选择字段和选项来构建表单。

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

以下选项也可用：

  • 消息按钮标签: 用于消息按钮的标签。默认选项是Respond。
  • 响应表单标题: 用户提供反馈的表单标题。
  • 响应表单描述: 用户提供响应时表单的描述。
  • 响应表单按钮标签: 表单上用于提交响应的按钮标签。默认选项是Submit。
  • 限制等待时间: 工作流是否会在指定时间限制后自动恢复执行。可以是时间间隔或具体的挂钟时间。

发送照片#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择 发送照片.
  • Chat ID: Enter the Chat ID or username of the channel you wish to send the photo to in the format @channelusername.
  • 二进制文件: 要从节点本身发送二进制文件，请启用此选项。如果启用此参数，则必须输入包含要发送文件的输入二进制字段。
  • 照片: 如果不使用二进制文件，在此处输入要发送的照片。传递file_id来发送存在于Telegram服务器上的文件（推荐），或者传递HTTP URL让Telegram从互联网获取文件。
  • 回复标记: 使用此参数设置更多界面选项。有关这些选项及使用方法的更多信息，请参阅回复标记参数。

更多信息请参考Telegram的Bot API sendPhoto文档。

发送照片附加字段#

使用附加字段通过Telegram的sendPhoto方法中的可选字段进一步调整节点的行为。选择添加字段可添加以下任意选项：

  • Caption: 输入文件的标题文本，最多1024个字符。
  • 禁用通知: 选择是否静默发送通知（开启）或发送标准通知（关闭）。
  • 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。
  • 消息主题ID: 输入论坛目标消息主题（话题）的唯一标识符；仅适用于论坛超级群组。

发送贴纸#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择发送贴纸.
  • Chat ID: Enter the Chat ID or username of the channel you wish to send the sticker to in the format @channelusername.
  • 二进制文件: 要从节点本身发送二进制文件，请启用此选项。如果启用此参数，则必须输入包含要发送文件的输入二进制字段。
  • 贴纸: 如果不使用二进制文件，在此处输入要发送的照片。传递file_id来发送存在于Telegram服务器上的文件（推荐），或者传递HTTP URL让Telegram从互联网获取文件。
  • 回复标记: 使用此参数设置更多界面选项。有关这些选项及使用方法的更多信息，请参阅回复标记参数。

更多信息请参考Telegram的Bot API sendSticker文档。

发送贴纸附加字段#

使用附加字段通过Telegram的sendSticker方法中的可选字段进一步调整节点的行为。选择添加字段可添加以下任意选项：

  • 禁用通知: 选择是否静默发送通知（开启）或发送标准通知（关闭）。
  • 回复消息ID: 如果该消息是回复消息，请输入它所回复的消息ID。
  • 消息主题ID: 输入论坛目标消息主题（话题）的唯一标识符；仅适用于论坛超级群组。

发送视频#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择发送视频.
  • Chat ID: Enter the Chat ID or username of the channel you wish to send the video to in the format @channelusername.
  • 二进制文件: 要从节点本身发送二进制文件，请启用此选项。如果启用此参数，则必须输入包含要发送文件的输入二进制字段。
  • 视频: 如果不使用二进制文件，在此处输入要发送的视频。传递file_id来发送存在于Telegram服务器上的文件（推荐），或者传递HTTP URL让Telegram从互联网获取文件。
  • 回复标记: 使用此参数设置更多界面选项。有关这些选项及使用方法的更多信息，请参阅回复标记参数。

更多信息请参考Telegram的Bot API sendVideo文档。

发送视频附加字段#

使用附加字段通过Telegram的sendVideo方法中的可选字段进一步调整节点的行为。选择添加字段可添加以下任意内容：

  • 标题: 输入视频的标题文本，最多1024个字符。
  • 禁用通知: 选择是否静默发送通知（开启）或发送标准通知（关闭）。
  • 时长: 输入视频的时长（以秒为单位）。
  • 高度: 输入视频的高度。
  • 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。
  • 消息主题ID: 输入论坛目标消息主题（话题）的唯一标识符；仅适用于论坛超级群组。
  • 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格式
    • 小于200 KB大小
    • 宽度和高度小于320像素。
  • 宽度: 输入视频的宽度。

取消置顶聊天消息#

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

输入以下参数：

  • 连接凭证: 创建或选择一个现有的Telegram凭证。
  • 资源: 选择 消息。
  • 操作: 选择置顶聊天消息.
  • Chat ID: Enter the Chat ID or username of the channel you wish to unpin the message from in the format @channelusername.
  • 消息ID: 输入您想要取消置顶的消息的唯一标识符。

更多信息请参考Telegram Bot API的unpinChatMessage文档。

回复标记参数#

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

  • 强制回复: Telegram客户端会表现得像用户已选择机器人的消息并点击了回复按钮，自动向用户显示回复界面。有关此选项的更多指导，请参阅强制回复参数。
  • 内联键盘: 在消息旁边直接显示一个内联键盘。有关此选项的更多指导，请参阅内联键盘参数。
  • 回复键盘: 显示带有回复选项的自定义键盘。有关此选项的更多指导，请参阅回复键盘参数。
  • 移除回复键盘: Telegram客户端将移除当前自定义键盘并显示默认字母键盘。有关此选项的更多指导，请参阅回复键盘参数。

Telegram商务账户

Telegram对频道以及代表Telegram商务账号发送的消息有以下限制：

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

强制回复参数#

强制回复功能非常实用，它可以帮助您创建用户友好的分步界面，同时无需牺牲隐私模式。

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

  • 强制回复: 开启后向用户显示回复界面，如上所述。
  • Selective: Turn this on if you want to force reply from these users only:
    • 在消息文本中被@提及的用户。
    • 原始消息的发送者，如果此发送动画消息是对某条消息的回复。

更多信息请参考ForceReply。

内联键盘参数#

如果选择回复标记 > 内联键盘，可以通过添加按钮选项定义要显示的内联键盘按钮。如需为键盘添加更多行，请使用添加键盘行。

更多信息请参考InlineKeyboardMarkup和InlineKeyboardButtons。

回复键盘参数#

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

使用回复键盘选项进一步调整键盘的行为：

  • 调整键盘大小: 选择是否要求Telegram客户端垂直调整键盘以获得最佳适配（开启）或使用与应用标准键盘相同的高度（关闭）。
  • 一次性键盘: 选择当用户使用后Telegram客户端是否应立即隐藏键盘（开启状态）或保持显示（关闭状态）。
  • Selective: Turn this on if you want to show the keyboard to these users only:
    • 在消息文本中被@mentioned的用户。
    • 原始消息的发送者，如果此发送动画消息是对某条消息的回复。

更多信息请参考ReplyKeyboardMarkup。

回复键盘移除参数#

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

  • 移除键盘: 选择是否要求Telegram客户端移除自定义键盘（开启）或保留键盘（关闭）。
  • Selective: Turn this on if you want to remove the keyboard for these users only:
    • 在消息文本中被@提及的用户。
    • 原始消息的发送者，如果此发送动画消息是对某条消息的回复。

更多信息请参考ReplyKeyboardRemove。

优云智算