send 深入探索 n8n Telegram Bot 消息发送技巧

n8n 是一个强大的工作流自动化工具，允许您连接不同的应用程序和服务，创建复杂的自动化流程。结合 Telegram Bot API，n8n 可以实现各种灵活和自动化的 Telegram 消息发送功能。本指南将深入探讨在 n8n 中使用 Telegram Bot 发送消息的各种“玩法”。

key核心组件：n8n 中的 Telegram 节点

在 n8n 中与 Telegram 交互主要通过 Telegram 节点。要发送消息，您通常会使用其 "Send Message" 或类似的发送操作（如 Send Photo, Send Document 等）。

• vpn_keyBot Token (凭证): 首先，您需要在 n8n 中配置 Telegram Bot API 凭证，这通常涉及到您的 Bot Token。
• person_pinChat ID: 这是消息发送的目标。它可以是用户的 ID、群组 ID (通常为负数) 或频道 ID (通常以 @channelusername 或 -100xxxxxxxxxx 格式)。您可以使用 {{ $json.chatId }} 这样的表达式动态传入 Chat ID。

chat_bubble_outline基础消息类型与发送

n8n 的 Telegram 节点提供了发送多种基础消息类型的功能。

article1. 文本消息 (Text)

最常见的消息类型。在 n8n 节点中：

• edit_noteText 字段: 输入您想发送的文本内容。支持使用 n8n 表达式动态生成，例如 Hello {{ $json.name }}!。
• text_formatParse Mode (解析模式): 这是一个关键选项，决定了文本如何被 Telegram 解析和显示。
  • None: 纯文本，不解析任何特殊格式。
  • MarkdownV2: 使用 MarkdownV2 语法进行格式化。
  • HTML: 使用 HTML 标签进行格式化。

image2. 图片 (Photo)

• linkPhoto 字段: 可以是图片的 URL，也可以是二进制数据 (例如，来自上一个 HTTP Request 节点或 Read Binary File 节点，使用表达式如 ={{ $binary.data }})。
• closed_captionCaption 字段: 图片的说明文字，同样支持 Parse Mode。

audiotrack3. 音频 (Audio), description文档 (Document), videocam视频 (Video), mic语音 (Voice)

这些类型的发送方式与图片类似：

• attach_file通常需要提供文件的 URL 或二进制数据。
• subtitles支持添加 Caption (说明)。
• 对于视频和音频，还可以设置时长 (Duration)、表演者 (Performer)、标题 (Title) 等元数据，通常在 "Additional Fields" 或 "Options" 中配置。

interests交互式消息与键盘

通过键盘可以极大增强 Bot 的交互性。

keyboard1. 内联键盘 (Inline Keyboard)

按钮会直接显示在消息下方，点击后可以发送回调数据 (Callback Data) 或打开 URL。

• settings_ethernet在 n8n 节点的 "Additional Fields" 或 "Options" 下，找到 reply_markup 参数。
• code设置为 JSON 结构，例如：

  
  {
    "inline_keyboard": [
      [
        { "text": "✅ 确认", "callback_data": "confirm_action" },
        { "text": "❌ 取消", "callback_data": "cancel_action" }
      ],
      [
        { "text": "访问网站", "url": "https://n8n.io" }
      ]
    ]
  }
                  

• webhookCallback Data 会通过 n8n 的 Telegram Trigger 节点（设置为 "On Callback Query"）接收和处理。

dialpad2. 回复键盘 (Reply Keyboard)

替换用户输入框下方的标准键盘，提供预设的回复选项。

• settings_ethernet同样在 reply_markup 中配置。
• codeJSON 结构示例：

  
  {
    "keyboard": [
      [{"text": "功能一"}, {"text": "功能二"}],
      [{"text": "帮助文档"}]
    ],
    "resize_keyboard": true,
    "one_time_keyboard": true,
    "selective": false 
  }
                  

• tune选项说明:
  • resize_keyboard: 自动调整键盘大小。
  • one_time_keyboard: 用户点击按钮后键盘自动隐藏。
  • input_field_placeholder: 输入框占位符。
  • selective: (高级) 只对特定用户显示键盘（例如被 @ 提及的用户或消息的发送者）。

keyboard_hide3. 移除键盘 (Remove Keyboard)

发送一条消息并移除当前的自定义回复键盘，恢复到标准键盘。

• codereply_markup JSON: { "remove_keyboard": true, "selective": false }

forum4. 强制回复 (Force Reply)

强制用户回复这条消息（用户会看到一个回复图标）。

• codereply_markup JSON: { "force_reply": true, "input_field_placeholder": "请输入您的回复...", "selective": false }

style消息格式化 (Parse Mode)

如前所述，Parse Mode 是控制消息外观的关键。

integration_instructions1. MarkdownV2

使用 MarkdownV2 语法。注意：_, *, [, ], (, ), ~, `, >, #, +, -, =, |, {, }, ., ! 这些字符必须转义 (在前面加 \)，除非它们用于构成 Markdown 实体。

*粗体*
_斜体_
__下划线__ (n8n中可能不直接支持，Telegram支持)
~删除线~
||剧透内容||
`行内代码`
[内联URL](http://www.example.com/)
[内联提及用户](tg://user?id=123456789)
```python
# 预格式化代码块
print("Hello, Telegram!")
```
        

code_ μεγαλύτε2. HTML

支持部分 HTML 标签：

<b>粗体</b>, <strong>粗体</strong>
<i>斜体</i>, <em>斜体</em>
<u>下划线</u>, <ins>下划线</ins> (n8n中可能不直接支持，Telegram支持)
<s>删除线</s>, <strike>删除线</strike>, <del>删除线</del>
<tg-spoiler>剧透内容</tg-spoiler>
<a href="http://www.example.com/">内联URL</a>
<a href="tg://user?id=123456789">内联提及用户</a>
<code>行内代码</code>
<pre>预格式化文本块</pre>
<pre><code class="language-python"># 预格式化代码块
print("Hello, Telegram!")</code></pre>
        

info 提示: 在 n8n 表达式中使用 Markdown 或 HTML 时，如果内容包含特殊字符，务必正确处理转义，否则可能导致发送失败或格式错误。

settings高级发送选项

Telegram 节点通常在 "Additional Fields" 或 "Options" 部分提供更多控制参数：

• notifications_offDisable Notification (disable_notification): 发送静默消息，用户不会收到声音或震动提醒。值为 true 或 false。
• securityProtect Content (protect_content): 保护消息内容，禁止转发和保存。值为 true 或 false。
• replyReply To Message ID (reply_to_message_id): 将消息作为对特定消息的回复。需要提供被回复消息的 ID。
• question_answerAllow Sending Without Reply (allow_sending_without_reply): 如果 reply_to_message_id 指定的消息不存在，仍然发送该消息（而不是报错）。值为 true 或 false。
• forumMessage Thread ID (message_thread_id): (适用于启用了话题功能的群组) 发送到特定话题。

extension其他消息类型玩法

除了基础类型，n8n 的 Telegram 节点通常也支持发送其他特殊类型的消息，具体参数可能在 "Resource" 和 "Operation" 中选择，或通过 "Additional Fields" 配置。

• sticky_note_2Sticker (贴纸): 发送贴纸。需要提供贴纸的 File ID 或 URL。
• location_onLocation (位置): 发送地理位置。需要提供经度 (Longitude) 和纬度 (Latitude)。
• placeVenue (地点): 发送地点信息，包括经纬度、标题、地址等。
• contactsContact (联系人): 分享联系人信息，包括电话号码、名字等。
• pollPoll (投票): 创建普通投票或问答投票。需要设置问题 (Question) 和选项 (Options)。

lann8n 工作流中的 Telegram 应用场景

n8n 的强大之处在于构建完整的工作流，Telegram 消息发送是其中的一个环节。

• notifications_active各类通知推送:
  • rss_feedRSS 更新通知。
  • webhookWebhook 接收到数据后通知。
  • schedule定时任务 (Cron Job) 结果通知。
  • apps其他应用事件通知 (如 Google Sheets 新增行、Trello 卡片移动、GitHub 新 PR 等)。
• alarm定时提醒与报告: 使用 n8n 的 Schedule Trigger 定期执行工作流，发送提醒或数据报告。
• dynamic_feed个性化内容投送: 从数据库或 API 获取数据，为不同用户生成定制化消息。
• smart_toy简单交互式机器人: 结合 Telegram Trigger (接收消息/回调) 和 Switch / IF 节点，根据用户输入或按钮点击做出不同响应。
• campaign消息广播 (谨慎使用): 通过循环遍历用户 ID列表 (例如从数据库获取) 来向多个用户发送消息。 注意: 务必遵守 Telegram 的反垃圾邮件政策和频率限制。

data_objectn8n Telegram 节点参数示例 (发送内联键盘)

这是一个 n8n 工作流中 Telegram 节点参数的 JSON 结构简化示例，展示了如何配置发送带有内联键盘的消息：

{
  "parameters": {
    "chatId": "{{ $json.chatId }}", // 或直接填写 Chat ID
    "text": "请选择一个操作：",
    "additionalFields": {
      "reply_markup": { // 注意：实际n8n界面可能直接提供Inline Keyboard的UI配置
        "inline_keyboard": [
          [
            { "text": "操作 A", "callback_data": "action_a" },
            { "text": "操作 B", "callback_data": "action_b" }
          ],
          [
            { "text": "访问 n8n 官网", "url": "https://n8n.io" }
          ]
        ]
      }
    }
  },
  "name": "Send Interactive Message",
  "type": "n8n-nodes-base.telegram", // 节点类型可能随版本变化
  "typeVersion": 1,
  "credentials": {
    "telegramApi": { // 引用您配置的Telegram凭证
      "id": "YOUR_CREDENTIAL_ID",
      "name": "My Telegram Bot Credentials"
    }
  }
}
        

build_circle 实际操作提示: 在 n8n 的图形化界面中，您通常不需要直接编辑 JSON。对于内联键盘、回复键盘等，n8n 节点会提供专门的 UI 字段来帮助您构建这些结构，例如 "Reply Markup" > "Add Inline Keyboard Row" > "Add Button"。

edit消息管理

除了发送新消息，Telegram API 也允许对已发送的消息进行管理，n8n 的 Telegram 节点通常也支持这些操作，例如：

• drive_file_rename_outlineEdit Message Text (编辑消息文本): 修改已发送消息的文本内容。需要提供 chat_id、message_id 和新的 text。Parse Mode 和 Reply Markup 也可以一同更新。
• edit_attributesEdit Message Caption (编辑消息说明): 修改媒体消息的说明文字。
• burst_modeEdit Message Media (编辑消息媒体): 替换已发送消息的媒体内容 (图片、动图等)。
• touch_appEdit Message Reply Markup (编辑消息键盘): 更新已发送消息的内联键盘。
• delete_sweepDelete Message (删除消息): 删除已发送的消息。需要提供 chat_id 和 message_id。

这些操作通常在 n8n Telegram 节点的 "Operation" 字段中选择，然后填写必要的参数。

gavel重要注意事项

• speedAPI 频率限制: Telegram 对 Bot API 调用有频率限制。频繁发送大量消息可能导致 Bot 被临时限制。设计工作流时要考虑合理的延迟和批量处理策略。
• error_outline错误处理: 在 n8n 工作流中添加错误处理机制。例如，如果 Telegram API 返回错误 (如无效的 Chat ID、消息格式错误)，您的工作流应该能够捕获并妥善处理，而不是意外中止。
• lockBot Token 安全: 妥善保管您的 Bot Token，不要硬编码到工作流中或公开泄露。使用 n8n 的凭证管理功能。
• thumb_up_alt用户体验: 避免滥用 Bot 发送过多无关或骚扰信息。提供清晰的指令和退订机制 (如果适用)。
• help_outline获取 Chat ID:
  • 对于私聊，当用户给您的 Bot 发送消息时，n8n 的 Telegram Trigger 节点会捕获到用户的 Chat ID。
  • 对于群组，可以将 Bot 加入群组并发一条消息，然后通过 Telegram API (如 getUpdates) 或一些第三方 Bot (如 @userinfobot) 获取群组 ID (通常是负数)。
  • 对于频道，需要将 Bot 设置为管理员，然后使用频道用户名 (@channelusername) 或其 ID。

calculate数学公式示例 (MathJax)

为了满足格式要求，这里展示一个 MathJax 渲染的数学公式（与 Telegram 主题无直接关联）：

通过组合 n8n 强大的工作流引擎和 Telegram Bot 灵活的消息功能，您可以创造出各种实用且富有创意的自动化解决方案。不断尝试和探索，发挥您的想象力吧！