JSON 接口的新条目每 5 分钟发到 Telegram

JSON 接口的新条目每 5 分钟发到 Telegram

一个盯着 JSON 地址的 n8n 工作流，有新东西出现时在 Telegram 上告诉你。它每 5 分钟从你自己的接口读一个 JSON 列表。它只保留比上一次见到的更新、并且符合你所选筛选条件的条目。每个条目作为一条 Telegram 消息发出。它适合错误日志、订单列表、状态源和类似的列表。四个节点完成全部工作。

里面有什么

• workflow.json：n8n 导出的工作流，4 个节点，没有便签。里面没有任何凭据。
• README.md：这份说明。

我们对原始副本做了哪些改动

Mindket 清理并修复了这份副本：

• 原始副本是意大利语的：节点名、代码里的注释和提醒里的字。Mindket 的副本是英文的。筛选字段 tipo 现在是 type，备用标签 evento 现在是 event。
• JSON 列表的地址原来是一个编出来的意大利语“在这里填你的 API”地址。现在是占位符 <YOUR_JSON_FEED_URL>。
• 聊天 ID 原来读自一个 n8n 环境变量，带一个编出来的备用值。现在它是 Telegram 节点里的占位符 <YOUR_TELEGRAM_CHAT_ID>，所以不依赖任何服务器设置。
• Telegram 节点默认把文字当作 Markdown 读，n8n 自己的源码就是这样。JSON 条目里多出一个不成对的 _ 或 *，会让 Telegram 拒绝这条消息。Mindket 的代码现在会在 _、*、一个反引号和 [ 前面加一个反斜杠，这是 Telegram Bot API 页面对旧版 Markdown 的要求。
• 文件里的设置说明现在就是这份 README，文件里空的凭据名也去掉了。
• 里面没有任何凭据。

开始之前

• 一个 n8n 实例，n8n Cloud 或你自己的服务器都行。
• 一个返回对象的 JSON 地址，对象里有一个条目列表，最新的在前，每个条目有时间戳或另一个能按文本排序的字段。
• 一个用 @BotFather 建的 Telegram 机器人，和该收提醒的聊天的 ID。

设置步骤

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 在 Read the JSON feed 里，把 <YOUR_JSON_FEED_URL> 换成你列表的地址。如果它需要密钥，在节点的选项里加上。
3. 在 Only new and filtered entries 里，把代码顶部的四个名字设成和你的响应一致：ARRAY_FIELD、FILTER_VALUES、FILTER_FIELD 和 TIMESTAMP_FIELD。
4. 添加一个填了机器人令牌的 Telegram 凭据，在 Send to Telegram 里选中它。
5. 给你的机器人写一次消息，在机器人的 getUpdates 调用的返回里找到你的聊天 ID，把它填到 Send to Telegram 里 <YOUR_TELEGRAM_CHAT_ID> 的位置。
6. 发布工作流。

一次运行是怎么走的

1. Every 5 minutes 每 5 分钟开始一次运行。
2. Read the JSON feed 取你的地址，最多等 10 秒的响应。
3. Only new and filtered entries 从字段 ARRAY_FIELD 取出列表。它保留 FILTER_FIELD 属于 FILTER_VALUES 的条目，这个列表为空时则保留全部。然后保留时间戳比上一次运行存下的更大（按文本比较）的条目，并把最旧的排在前面。
4. 代码存下它发出的最新条目的时间戳。它把每条提醒写成一个铃铛、筛选字段的值和条目的前 300 个字符。
5. Send to Telegram 为每个条目发一条消息。

想改样子，改这里

• 检查的频率：Every 5 minutes 里的间隔。
• 什么算新消息：代码里的 FILTER_VALUES 和 FILTER_FIELD，比如 ['error','warning']。
• 提醒的样子：代码生成的 text。
• 发到哪里：Send to Telegram 里的聊天 ID，或换成邮件或 Slack 节点。

要知道的

• 发布后的第一次运行没有存下的时间戳，所以它会发出列表里所有通过筛选的条目。先用一个短列表或一个筛选条件。
• 代码按文本比较时间戳，所以请用能按文本排序的字段，比如 ISO 日期。长度不同的纯数字，比如 9 和 10，比较不好。
• 它预期最新的条目在前，并把列表反过来，让提醒从旧到新发出。
• 存下的时间戳是 n8n 的工作流静态数据。n8n 的页面说测试工作流时静态数据不会保存，而且它是实验性功能。测试运行会把同样的条目再发一遍，发布之后记忆才起作用。
• Telegram 节点会加一行，说明消息是用 n8n 发的。不想要的话，在节点的选项里关掉。
• Telegram 在 4096 个字符处截断消息。代码让每条提醒都远低于这个长度。
• 这个 JSON 里没有任何凭据。