n8n · n8n.io

把 Telegram 接入 n8n

在 n8n 中把 Entergram 添加为 MCP 数据源，自动化你真实的 Telegram 账号——标出你漏看的消息、追回变冷的潜在客户，并把客户反馈分流到该去的地方。

MCP 服务器地址 https://mcp.entergram.com/mcp

n8n 自带一个连接外部 MCP 服务器的 MCP 节点。Entergram 把你的个人 Telegram 账号封装成托管的 MCP 服务器，让 n8n 在全程 OAuth 安全授权下，基于你真实的聊天搭建可视化自动化——无需机器人账号、无需自定义代码。

可直接粘贴的配置

n8n → MCP node → Server URL

https://mcp.entergram.com/mcp

值得搭建的自动化

连上你的个人账号后，n8n 可以监视并操作你的聊天。例如：

每天早上推送一份摘要，列出你漏看的消息和仍在等你回复的客户。
标记那些发了两次消息却没得到回复的潜在客户，并创建一项跟进任务。
当客户发来反馈时，给它打标签并记录到你的 CRM 或电子表格里。
检测已读不回超过 24 小时的提问，给自己发一条提醒。
量化每周错过的机会，并把这个数字推送到 Slack。

三步连接 n8n

适用于 n8n 的 MCP 节点。

01
在 Entergram 中复制你的 MCP 地址
在 Entergram 中打开 Settings → Workspace → Connectors → MCP，复制你的 MCP 服务器地址。
02
在 n8n 中添加 MCP 节点
在你的 n8n 工作流中添加 MCP 节点，并将其指向 Entergram MCP 地址：https://mcp.entergram.com/mcp。
03
授权后开始搭建
点击 Connect，用你的 Entergram 账号登录，然后点击 Allow access，然后把 Telegram 的触发器和动作接入你的 n8n 场景。

在 n8n 里跑 Entergram 的三种方式

n8n Cloud

最短路径。往工作流里放一个 MCP Client 节点，粘贴托管端点，OAuth 往返交给 n8n Cloud 在它自己的回调域名上完成——不用开隧道，也不用管证书。由于 Entergram 服务器是远程的，节点持有的是一份凭证而不是拉起本地进程，因此同一个工作流在每个执行节点上表现完全一致，导出再导入到另一个项目里也照样能跑。

自托管 n8n

同样的节点，只多一个前提：OAuth 握手要跳回你的实例，所以 n8n 必须知道自己的公网地址。在创建凭证之前先设置好 host 和 webhook 变量，否则授权页走完之后会跳到 localhost。此后的一切都和 Cloud 一样，包括跨项目共享凭证。

N8N_HOST=n8n.yourcompany.com
N8N_PROTOCOL=https
WEBHOOK_URL=https://n8n.yourcompany.com/

AI Agent 节点 + MCP 工具

与其手工接线每一次调用，不如把 MCP 客户端作为工具提供方挂到 AI Agent 节点上，让模型自己决定针对某个输入该调用哪些 Entergram 工具。这适合模糊型任务——给一条入站消息分类、判断某件事值不值得开工单——这类分支逻辑描述起来比画出来容易。记得固定你真正想暴露的工具清单；手握七十个工具的智能体偶尔会绕远路，而定时运行的智能体首先就不该让破坏性工具触手可及。

六个能把自己赚回来的工作流

n8n 不是跟你的 Telegram 账号聊天，而是按时间表对它执行任务。下面每一行都是一个真实的工作流形状：一边是触发条件和目标，另一边是满足它的有序 Entergram 调用，以及运行结束后落进你系统里的东西。它们全都不需要有人开着标签页——这正是要在这里搭建而不是在聊天客户端里搭建的理由。

工作流

每晚 02:00，把每个工作区聊天及其流程字段镜像进 Postgres，供 BI 看板使用。

调用的工具

entergram_list_workspace_chatsentergram_list_custom_columnsentergram_get_chat_custom_fields

这次运行的产出

Schedule Trigger 把聊天列表铺进 Loop Over Items 节点，字段结构只读一次以便解析出真实键名而不是靠猜，然后按会话逐行 upsert。第二天早上分析师用 SQL 就能查 Telegram 的流程状态，没人需要打开 Entergram。

工作流

当 CI 推来「部署完成」的 webhook 时，通知受本次发布影响的客户群。

调用的工具

entergram_list_groupsentergram_send_message

这次运行的产出

Webhook 节点接收构建负载，Code 节点把服务名映射到关心它的群标题，然后每个群触发一次发送调用。发布沟通不再依赖谁记得去粘 changelog；而且因为消息是用构建元数据拼出来的，它带的永远是真正上线的那个版本。

工作流

每小时关闭那些底层会话已经沉默七天的工单。

调用的工具

entergram_list_ticketsentergram_list_messagesentergram_update_ticket

这次运行的产出

工作流拉取未关闭工单，检查每个关联会话最后一条消息的时间戳，用 IF 节点按沉默时长过滤后再写入状态变更。陈旧的队列项自己消失，而关闭后又有人回复的那些，会在下一条入站消息时自动重开。

工作流

当计费方推来「支付失败」事件时，创建一个催款工单并附上账单明细。

调用的工具

entergram_list_contactsentergram_create_ticketentergram_create_ticket_comment

这次运行的产出

联系人查询把付款人对应到某个 Telegram 会话，工单挂在该聊天上创建，原始账单负载作为评论写进去，于是接手的客服不用打开计费后台就能看到金额和失败原因。催款从此变成带上下文的队列项，而不是一封没人认领的邮件。

工作流

每周日，把 Telegram 群成员与 HR 花名册对账，移除已离职的人。

调用的工具

entergram_list_groupsentergram_list_group_membersentergram_remove_chat_member

这次运行的产出

Merge 节点对两份成员列表求差，只有待移除的那部分往下流。离职流程不再把前外包留在客户群里好几个月，而这次运行的汇总本身就是一份可以交给审计的访问复核材料。

工作流

每十五分钟，把客户丢进聊天里的发票和合同转发到财务频道。

调用的工具

entergram_list_messagesentergram_get_messageentergram_forward_messages

这次运行的产出

轮询分支扫描近期历史里的文档附件，Filter 节点留下符合你命名规则的那些，转发会保留原始发送人署名。财务不用再追问那份签好的 PDF 是不是还躺在谁的私聊里。

n8n 能用你的 Telegram 做什么

—在新消息和事件上触发工作流
—检测未回复的聊天和变冷的潜在客户
—从流程中发送消息和群发
—把联系人和自定义字段同步到其他应用
—定时量化错过的机会
—把 Telegram 数据流转到你的整个技术栈

工作流可调用的工具面

一份已授权的凭证，会向引用它的每个节点开放全部 9 组共 70 个工具。实际做起来，你每个工作流只会固定用到其中几个——轮询分支里用读工具，写工具放在过滤器后面——但这里没有任何东西需要额外的集成或第二份凭证。

账号与工作区

5 个工具

用于确认身份和权限范围。每次消息类调用都必须先通过 list_accounts 取得 account_id——跳过这一步的 AI 客户端会把请求发到错误的 Telegram 账号上。

entergram_get_me
entergram_list_accounts
entergram_get_workspace
entergram_get_member
entergram_list_members

聊天与查找

8 个工具

用于定位会话。工作区视图携带 CRM 状态（工单、评论、自定义字段）；实时视图携带 Telegram 当前的传输状态和未读计数。

entergram_list_chats
entergram_get_chat
entergram_list_live_chats
entergram_get_live_chat
entergram_list_workspace_chats
entergram_get_workspace_chat
entergram_update_workspace_chat
entergram_get_chat_management

消息

9 个工具

读写消息历史，包括编辑、转发和表情回应。发送操作按账号划定范围，因此任何操作都不会跨越你已连接的多个账号生效。

entergram_list_messages
entergram_get_message
entergram_send_message
entergram_send_media_message
entergram_edit_message
entergram_delete_message
entergram_forward_messages
entergram_get_message_reactions
entergram_set_message_reactions

联系人

3 个工具

你在和谁对话，以及你们还在哪些地方有交集。共同群组查询正是让「我的哪些潜在客户在同一个社群里？」这类问题变得可回答的关键。

entergram_list_contacts
entergram_get_contact
entergram_list_contact_shared_groups

工单

10 个工具

完整的客服工单控制：创建、指派、设置优先级、评论和关闭。工单会关联回它所来自的聊天，因此 AI 客户端可以一步之内从会话转入工单队列。

entergram_list_tickets
entergram_get_ticket
entergram_create_ticket
entergram_update_ticket
entergram_delete_ticket
entergram_list_chat_tickets
entergram_list_ticket_comments
entergram_create_ticket_comment
entergram_update_ticket_comment
entergram_delete_ticket_comment

CRM 自定义字段

11 个工具

你的销售流程结构。写入数值前先读取列定义——复选框接受布尔值，多选字段接受由选项值组成的数组，日期字段接受 ISO 8601 字符串。

entergram_list_custom_columns
entergram_get_custom_column
entergram_create_custom_column
entergram_update_custom_column
entergram_delete_custom_column
entergram_list_custom_column_options
entergram_create_custom_column_option
entergram_update_custom_column_option
entergram_delete_custom_column_option
entergram_get_chat_custom_fields
entergram_patch_chat_custom_fields

工单自定义字段

9 个工具

工单侧的同一套结构控制——分类、严重级别、SLA 等级，以及你的客服团队在状态和优先级之外跟踪的任何字段。

entergram_list_ticket_custom_columns
entergram_get_ticket_custom_column
entergram_create_ticket_custom_column
entergram_update_ticket_custom_column
entergram_delete_ticket_custom_column
entergram_list_ticket_custom_column_options
entergram_create_ticket_custom_column_option
entergram_update_ticket_custom_column_option
entergram_delete_ticket_custom_column_option

内部备注

4 个工具

写在聊天上、客户永远看不到的评论。适合让 AI 客户端把自己的推理过程留下来，交给人类同事接手。

entergram_list_chat_comments
entergram_create_chat_comment
entergram_update_chat_comment
entergram_delete_chat_comment

群组与频道

11 个工具

创建和管理 Telegram 群组与频道——成员、权限、隐私和资料——另外还提供一个原始命令通道，用于处理其余情况。

entergram_list_groups
entergram_get_group
entergram_list_group_members
entergram_create_group_chat
entergram_create_channel
entergram_invite_chat_members
entergram_remove_chat_member
entergram_update_chat_info
entergram_update_chat_permissions
entergram_update_chat_privacy
entergram_run_chat_command

你授权的是一个工作流，而不是一个人

你在 n8n 里创建的凭证，在你关掉浏览器标签页之后依然长期有效——这既是它的用处，也是它的风险。请一开始就想清楚：这个连接是以某个成员的身份行事，还是以整个工作区的身份行事，因为无人值守的运行会持续行使你授予的一切权限。Telegram 会话凭证始终留在 Entergram 内部，n8n 手里只有一个 OAuth 令牌。

个人智能体: 任何工作区成员都可以创建。它可以读取工作区、账号、联系人、聊天、消息和工单，并对属于你的聊天读写自定义字段。做报表或告警的工作流用它就够了，而一份发不出消息的凭证，也就没法在凌晨三点让你难堪。
工作区连接器: 仅限所有者和管理员。这是需要发送的工作流所需的档位——出站消息、跨任意聊天写自定义字段、群组管理——而且它是与团队共享的，同事可以直接维护这套自动化，不必用自己的名义重建凭证。建议把发送类工作流和报表类工作流放在不同项目里，免得这份高权限凭证默认挂在所有东西上。
撤销: 在 Settings → Workspace → Connectors → MCP 里干掉令牌，所有定时执行都会在下一次调用时开始失败，而不是悄无声息地继续跑。在 n8n 里删掉凭证，效果相同，只是方向相反。请在搭这套工作流的人离职之前撤销，而不是之后。

设计工作流时要绕开的约束

这些都不是拦路虎，但每一条都会影响你如何搭一张无人值守运行的节点图。

MCP 访问位于 Pro 套餐。凭证在任何档位都能完成授权，所以差额会在后面以定时执行里的工具报错形式暴露出来，而不是在配置阶段。
MCP 是请求—响应，不是推送通道。Entergram 不会向 n8n 打开一条长连接，所谓「事件驱动」的手感来自 Schedule Trigger 轮询得足够频繁——代价是在延迟和执行次数之间做取舍。
没有谁替你审核一次发送。聊天客户端里有人会在每条草稿发出前先读一遍，定时任务没有；所以请把出站分支当生产代码对待，用明确的过滤条件和一个测试模式开关把它挡住。
没有批量接口。向三十个聊天群发就是三十次独立调用，所以请给循环限速、限制重试次数，并且预期上限来自 Telegram 自身的洪水控制，而不是工作流。
失败的运行不是原子的。如果某次执行在循环中途挂掉，已经提交的发送和字段写入依然算数——请把工作流设计成幂等的，并记录已处理的内容，而不是指望能干净回滚。
令牌会过期。跑了几周的自动化可能因为没人重新授权而在一夜之间停摆，所以请加一条错误分支去提醒真人，而不是让它失败进一份没人看的空日志。

n8n 连接器排障

OAuth 完成后却跳转到 localhost

不知道自己公网地址的自托管实例会把回调发给自己。把 host、protocol 和 webhook 变量设成你浏览器实际使用的地址，重启 n8n，然后删除并重建凭证——已有的凭证里烤死的还是旧的回调地址。

节点连上了，却列不出工具

n8n 会在创建凭证时缓存工具清单。重新打开节点并刷新工具列表，或者把节点复制一份；在清单加载完成之前保存的工作流，会一直引用一个空集合。

读节点正常，发送节点返回 403

这就是个人智能体在严格按其权限行事。出站消息属于工作区连接器，必须由所有者或管理员创建——把同一份个人凭证重新授权一次并不会扩大它的权限。如果连读节点也报 403，那就改查套餐：MCP 访问需要 Pro。

工作流发到了错误的 Telegram 账号

每个消息类工具都接收显式的 account_id，没写明就会替你解析一个。在工作流开头调用一次账号列表，把想要的 id 固定成工作流变量，并在下游每个节点里引用它。

跑了几周的定时任务突然失败

几乎总是令牌过期。打开凭证，重新连接并再次确认授权，待执行的任务会在下一个周期恢复。把 MCP 节点的错误输出接到一个通知上，下一次过期就不会由客户先发现。

大批量拉消息时执行超时

在一个节点里读取几百个会话的完整历史会超出执行超时。用 Loop Over Items 拆分聊天列表，限制批次大小，并持久化一个游标，让每次运行从上次停下的地方继续。回填历史应该和每小时跑的增量工作流分开，做成两个工作流。

n8n + Telegram 常见问题

它会取代 n8n 的 Telegram 节点吗？

它是补充。原生 Telegram 节点用的是机器人令牌；Entergram 通过 MCP 连接你真实的个人账号，于是你能在机器人看不到的聊天上做自动化。

自托管还是云端 n8n？

都行。任何装有 MCP 节点的 n8n 实例都能通过 OAuth 连接托管的 Entergram MCP 地址。

它能提醒我漏看的消息吗？

能。搭建一个工作流，定时读取未回复的聊天，并把摘要或提醒发到你想要的任何地方。

安全吗？

安全。OAuth 2.0 加上限定的权限范围；凭证保留在 Entergram 内，访问可随时撤销。

其他连接器

Entergram 适用于任何兼容 MCP 的 AI 工具。

把 Telegram 接入 Claude Anthropic 把 Telegram 接入 ChatGPT OpenAI 把 Telegram 接入 Gemini Google 把 Telegram 接入 Make.com Celonis 把 Telegram 接入 Cursor 与各类 IDE Cursor, Zed, Windsurf 把 Telegram 接入 Perplexity Perplexity AI 把 Telegram 接入 Goose Block 把 Telegram 接入 Raycast Raycast 把 Telegram 接入 Cline Cline (VS Code) 把 Telegram 接入 opencode SST