消息操作
使用这些操作可以发送、编辑和删除聊天中的消息;发送文件到聊天室;以及从聊天中固定/取消固定消息。有关 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}。