跳到主要内容

Telegram 触发器节点#

Telegram 是一款基于云的即时通讯和IP语音服务。用户可以发送消息并交换照片、视频、贴纸、音频及任何类型的文件。本页将列出Telegram触发器节点可响应的事件列表及相关资源链接。

认证配置

此节点的身份验证信息请参阅此处

示例与模板

如需查看使用示例和快速入门模板,请访问n8n的Telegram触发器集成页面。

事件#

  • *:接收除"聊天成员"、"消息互动"和"消息互动计数"外的所有更新(Telegram API默认行为,因这些事件会产生大量更新调用)
  • 商务连接:当机器人与商务账号建立/断开连接,或用户编辑现有连接时触发
  • 商务消息:收到关联商务账号的新消息时触发
  • 回调查询:收到新的回调查询时触发
  • 频道帖子:收到任何类型的新频道帖子时触发(包括文本、照片、贴纸等)
  • 聊天加成:当聊天加成被添加或变更时触发(机器人需具备聊天管理员权限)
  • 加群申请:当收到加群请求时触发(机器人需具备can_invite_users管理员权限)
  • 聊天成员:当聊天成员状态更新时触发(机器人需为聊天管理员)
  • 选定内联结果:当用户选定的内联查询结果发送时触发(需参考Telegram的反馈收集文档启用该功能)
  • 删除的商务消息:当关联商务账号的消息被删除时触发
  • 编辑的商务消息:当关联商务账号的消息出现新版本时触发
  • 编辑的频道帖子:当机器人已知的频道帖子被编辑时触发
  • 编辑的消息:当机器人已知的消息被编辑时触发
  • 内联查询:收到新的内联查询时触发
  • 消息:收到任何类型的新消息时触发(文本、照片、贴纸等)
  • 消息互动:当用户变更消息反应时触发(机器人需为聊天管理员,不接收机器人设置的反应)
  • 消息互动计数:当匿名反应消息的互动数变更时触发(机器人需为聊天管理员,更新会分组并可能延迟数分钟发送)
  • 我的聊天成员:当机器人在聊天中的成员状态更新时触发(私聊中仅当用户屏蔽/取消屏蔽机器人时接收)
  • 投票:投票状态更新时触发(机器人仅接收已结束投票及自己发起的投票)
  • 投票答案:用户在非匿名投票中更改答案时触发(机器人仅接收自己发起投票的新投票)
  • 预结算查询:收到新的预结算查询时触发(包含结算完整信息)
  • 付费媒体购买:当用户在非频道聊天中购买机器人发送的非空载荷付费媒体时触发
  • 移除聊天加成:当聊天加成被移除时触发(机器人需具备聊天管理员权限)
  • 运费查询:收到新的运费查询时触发(仅适用于弹性价格发票)

部分事件可能需要额外权限,详见Telegram API文档

选项#

  • 下载图片/文件:是否下载附件中的图片或文件至输出数据
    • 图片尺寸:启用下载功能时配置下载图片尺寸(默认下载大图)
  • 限定聊天ID:仅触发指定聊天ID的事件(支持逗号分隔多个ID)
  • 限定用户ID:仅触发指定用户ID的事件(支持逗号分隔多个ID)

相关资源#

n8n提供Telegram应用节点,节点文档请参阅此处

查看n8n官网的工作流示例及相关内容

API详细信息请参考Telegram官方API文档

常见问题#

常见问题及解决方案请参阅常见问题指南